Template:Legifrance/doc

From the AARoads Wiki: Read about the road before you go
Jump to navigation Jump to search

Use this template when you wish to create an external link to French legal text as provided by Légifrance, the official website of the French government for publication of legislation, regulations, and legal information.

Usage

{{Legifrance|base=database|number=article number|text=Display text for link}}

Note: parameter aliases are provided to make it possible to copy-paste directly from French Wikipedia, so the following is equivalent to the above:

{{Légifrance|base=database|numéro=article number|texte=Display text for link}}

Note on spelling

In French, the name of the website is Légifrance, including the accented "e" letter. To make it easier to use this template with English qwerty keyboards, and in conformity with the majority of English sources that refer to the website without the accented letter, the name of this template is "Legifrance", without the accent. In order to facilitate ease of use by copy-pasting directly from sources on French Wikipedia, the accented version is available as a redirect, and can be used as well.

Parameters

There are five named parameters, two required and three optional. Either base and number, or text and url must be present.

  • |base= – a token indicating which part of the code, e.g. CP for the penal code, JORF for the Journal officiel, CC for the Civil Code, and so on. Required. See the table below for list of possible values. (See :fr:Modèle:Légifrance § Codes juridiques for an explanation of these values (in French) ).
  • |number= – article number in the given code base; e.g, 1, 1137. Required. Aliases: 'numéro', 'num'.
  • |text= – display text; visible text underlying the wikilink to the article at Légifrance. Optional.Default: <base> 'art.' <number>. Alias: 'texte'.
  • |url= – optional url of the Légifrance article to display. Normally this param should be omitted, as the url value is calculated by the template as a function of base and number. However if required, |url= may be used to override the default value, such as to create a link to a page grouping several related articles; see Example 4 below.
  • |lang= – optional language code to use to generate the default value for |text=, when only base and number are given, and text is omitted. Values: en or fr; default: en.
Param notes

<section begin=param-number />As a general rule, drop punctuation and embedded spaces in the 'number' param, with some special cases of note:

  • for legislative acts beginning with L.  – drop the punctuation and embedded space: L. 1234L1234.
  • for regulatory acts beginning with R.  – drop the space and punct., i.e., R. 5678R5678
  • for embedded spaces prior to a suffix, url encode the space; e.g., 4 bis4%20bis
  • for alphabetic suffix, sometimes you need to add a slash, instead of url-encoded space, e.g., L. 80 AL80/A<section end=param-number />

In footnotes

Two templates are available for generating footnotes related to Légifrance:

  • {{Cite Legifrance}} – generates a full citation for the Légifrance website (wraps {{cite web}} ); may be used either for inline citations, or in the reference list to anchor a short citation;
  • {{Sfn Legifrance}} – generates a short citation to a French law or legal text indexed in Légifrance (wraps {{sfn}} ).

Usage notes

Why use this template?

The Légifrance website provides a search interface to the entire body of French law going back to 1529, including every version and every amendment of every bill. The underlying database is comprehensive, but this also means finding a specific law may be difficult; simple keyword search may turn up thousands of similar results. This template, in many cases, will do the work of finding the correct item for you, and create a link to it. Three templates are available: this one to create an external link to the law, one to create a full citation to the Légifrance website appropriate for the "References" section, and one to generate a short citation.

If you know how to find the law you are interested in on the Légifrance website and how to create a citation for it using either an inline reference, or a short citation ({{sfn}}), then you don't need this template, although it makes the procedure easier, as it does much of the work for you.

What's the relation between this template and the other Legifrance templates?
  • {{Legifrance}} – generates an external link (not a citation) to a specific law, calculating the external link based on the 'base' and 'number' params to locate a specific law. It could be used in the External links section, and is used by the other two templates to calculate the external link to the law on the Légifrance website. It could also be used with template {{rp|at=}} to link a specific law, when appended after a general instance of {{Cite legifrance}} that doesn't itself link a particular law.
  • {{Sfn Legifrance}} wraps template {{sfn}} to generate a short citation. It links the short citation to the full citation lower on the page as defined by the {{cite Legifrance}} template, and also names the externally defined French law, and links to it.
  • {{Cite Legifrance}} – generates a full citation to the Legifrance website. This may be used in two ways: when used with no parameters and placed in the "References" or "Works cited" section, it fully specifies the Légifrance website and provides an anchor for short citations generated by {{Sfn Legifrance}}; when used this way, it is paired with {{Sfn Legifrance}} and provides automatic linkage for it. Secondly, when used inline with parameters 'base' and 'number', and embedded in <ref>...</ref> tags, it generates a full, inline citation to a specific law, suitable for pairing with named references inline, if desired.
Which one should I use?

This depends on whether your article is new, or exists already and has an existing referencing style, such as inline citations, or short footnotes. If it exists, then follow the existing style: this would call for using {{Cite Legifrance}} if the article already uses inline citations, and {{Sfn Legifrance}} if it already uses short footnotes.

If your article is new and only refers to a French law text once (or the same law several times), you could choose inline style, and then {{Cite Legifrance}} would be the one to use. Place it between ref tags, and include params |base= and |number= with it.

If your article is new and refers to several different French laws, then your best bet may be to use short footnote style. In this case, include template {{Cite Legifrance}} *just once* (with no parameters) in your "Works cited" or "References" section, and then use {{Sfn Legifrance}} throughout the article, whenever you need to cite a particular legal code item.

Abrogated laws

The template does not currently link to abrogated laws. That may be added in forthcoming versions.

Examples

To cite article 62-2 of the CPP (French criminal procedure code) about garde à vue, or the law about dol, you could code:

You can use the accented "é" version, and param aliases to generate the same link as above, using original French param names, if you've copy/pasted directly from an article on French Wikipedia to generate the same link:

Or, use with only two params, and allow the template to default the value of param |text=:

The following demonstrates the use of optional param |url= to supply a link to a group of related articles:

Add the |lang=fr param, if you want the base token to expand in French instead:

Some content not associated with a given code base and having multiple articles can be linked either via |text= and |url= to the main element, or using the indefinite base code "ARTI", direct to a given article, e.g.

Some error cases: if the value of |base= is not valid, you get this:

If the value of |number= is not a real article in the code, for pre-2008 codes (pre-modernization), you get a link that looks legitimate, but clicking it goes to an "Erreur 500" page at Légifrance:

For post-2008 codes (e.g., Transport, Penitentiary, etc.), you get a link that also gives an "Erreur 500" if you click, but the error is detected in advance, and the article id is all zeroes (mouse over to see it) (this behavior will change going forward):

Legifrance databases and 'base' values

This template creates a direct link to a legal text or law. There are numerous different portions of French legal code which can have long names, like the Code général des collectivités territoriales. To avoid having to have such a long name as a template parameter, this template uses a short token, like CGCT, for the 'base' parameter instead of the long name. This base token is shown in all caps in the table below. Choose one of these tokens as the value for parameter |base=. Note: these tokens apply only to portions of the Legifrance database that existed in 2008 or earlier.[a] As a result, the syntax described here cannot be used to create links to portions of the code created since 2008, such as the code de transport.[b]

To create a link to a legal text or law which is part of one of the post-2008 codes, find the link to the law of interest at Légifrance, and use optional template parameter |url= to specify its value. (Or, just use the url directly, in template {{Cite Legifrance}} or {{Sfn Legifrance}}.)

Table

Other codes

The following codes are not yet covered:

See also

Notes

  1. ^ The rules regarding the permanence of pre-2008 urls were formerly indicated at the following address: Anciennes et nouvelles adresses ('Old and new addresses'; dead link). Currently, the page Etablir-un-lien ('Establish a link') indicates that the permanence of pre-2008 urls is guaranteed for two types of documents: texts published in the Journal officiel having a NOR number on the one hand, and codes or specific articles of codes existing in January 2008 on the other hand (which, apparently, does not include consolidated texts).
  2. ^ "Cannot be used to create links to portions of the code created since 2008" – the post-2008 codes are slowly being converted so they can be used with this template, and ctransp is the first one of these to be implemented, and is now available through this template.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Legifrance in articles based on its TemplateData.

TemplateData for Legifrance

<templatedata> { "params": { "base": { "description": "Legislation Database name", "example": "JORF", "type": "string", "suggestedvalues": [ "JORF", "avant90", "CASS", "INCA", "JADE", "CONSTIT", "CACTSOCL", "CAVIAL", "CAVIAR", "CAVIAD", "CC", "CCOM", "CONSO", "CONSO(R)", "CONSO(D)", "CCONSTRL", "CCONSTRR", "CDEF", "CDEF(R)", "CEDU", "CEDU(R)", "CESEDA(L)", "CESEDA(R)", "CE", "CE(R)", "CELE", "CELE(R)", "CGCT", "CGCT(R)", "CGI", "CGPPP", "CJF(L)", "CJF(R)", "CJA", "CJA(R)", "CMONFIL", "CMONFIR", "COJ", "COJ(L)", "COJ(R)", "CPAT", "CP", "CP(R)", "CP1810", "CPOSTESL", "CPOSTESR", "NCPC", "CPC", "CPP", "CPP(R)", "CPP(D)", "CPP(A)", "CPROINTL", "CPROINTR", "CRO", "CROUTEL", "CRO(M)", "CROUTER", "CR", "CR(R)", "CSP", "CSP(L)", "CSP(R)", "CSP(NR)", "CSS(L)", "CSS(D)", "CSS(R)", "CSPORTPL", "CSPORTPR", "CSPORTPA", "CT(NL)", "CT", "CT(R)", "CT(D)", "URBA(L)", "URBA(R)", "CVOIRIEL", "CVOIRIER", "CGLIVP", "CGLIVPFM", "CGLIVPFA" ], "suggested": true }, "url": { "description": "Override url to use to link to the Légifrance article", "type": "string", "suggested": false }, "text": { "description": "Display text for the link to the article at Légifrance", "example": "Article 121-3 of the Penal code", "type": "string", "suggested": true, "aliases": ["texte"] }, "number": { "label" : "number", "description": "Article number in the given code base", "type": "string", "example": "121-3", "aliases": ["num", "numéro"] }, "lang": { "label" : "language", "description": "Language in which the database section should be named when no 'text' param is provided", "type": "string", "suggestedvalues": ["en", "fr"], "suggested": false } } } </templatedata>

External links