Template:Legifrance/doc

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
Note: parameter aliases are provided to make it possible to copy-paste directly from French Wikipedia, so the following is equivalent to the above:

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. for the penal code,  for the Journal officiel,  for the Civil Code, and so on. Required. See the table below for list of possible values. (See  for an explanation of these values (in French) ).
 * number – article number in the given code base; e.g,, . Required. Aliases: 'numéro', 'num'.
 * text – display text; visible text underlying the wikilink to the article at Légifrance. Optional.Default: &lt;base> 'art.' &lt;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: or ; default:.


 * Param notes

As a general rule, drop punctuation and embedded spaces in the 'number' param, with some special cases of note:
 * base – see the table in.
 * number – the following adjustments should be used for the value of param 'number':
 * for legislative acts beginning with –  drop the punctuation and embedded space:   ⟶.
 * for regulatory acts beginning with –  drop the space and punct., i.e.,  ⟶
 * for embedded spaces prior to a suffix, url encode the space; e.g., ⟶
 * for alphabetic suffix, sometimes you need to add a slash, instead of url-encoded space, e.g.,  ⟶ 

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  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 &lt;ref>...&lt;/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:
 * 1a.
 * 1b.


 * 2.

Or, use with only two params, and allow the template to default the value of param text:
 * 3a.
 * 3b.
 * 3c.

The following demonstrates the use of optional param url to supply a link to a group of related articles:
 * 4. →

Add the fr param, if you want the base token to expand in French instead:
 * 5a
 * 5b
 * 5c
 * 5d

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.
 * 6a
 * 6b

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) :
 * 7a
 * 7b
 * 7c

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, 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 the 'base' parameter base. Note: these tokens apply only to portions of the Legifrance database that existed in 2008 or earlier. 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.

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.)

Other codes
The following codes are not yet covered:
 * Code de la sécurité intérieure (2012)
 * Code des relations entre le public et l'administration (2016)
 * Code des procédures civiles d'exécution (2012)
 * Code de la justice pénale des mineurs (2021)
 * Code des impositions sur les biens et services (2022)
 * Code général de la fonction publique (2022)
 * Code forestier (nouveau) (2012)
 * Code de l'énergie (2011)
 * Code de la commande publique (2019)

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 }	} }