Template:Sfn Legifrance/doc

This is a documentation subpage for Template:Sfn Legifrance.
It may contain usage information, categories and other content that is not part of the original template page.

May be used to create a short citation to a French law or legal text indexed in Légifrance. The generated short citation links to a full citation generated by template {{Cite Legifrance}}.

Usage edit

Some fact.{{sfn Legifrance|base|number}}
Allegation.{{sfn Legifrance|base|number|text=display text}}
Assertion.{{sfn Legifrance|text=display text|url=url}}

.
.
.

== Works cited ==
{{Cite Legifrance}}

Parameters edit

Two parameters are required with each transclusion, but not always the same two. If params 1 and 2 are included, the others are optional. Alternatively, param |text= and param |url= may be used, in which case the first two are not needed. Basic parameter descriptions follow; param interactions are described in the Notes section.

|1= – a shortcut token, indicating which portion ('base') of the Legifrance database applies; e.g. CP for the penal code, JORF for the Journal officiel, CC for the Civil Code, and so on. Required. See § TemplateData for list of possible values, and § Param notes for a description of them.
|2= – article number in the given database; e.g, 121-3, 1137. Normally paired with the 'base' token.
|3= – display text: visible text underlying the wikilink to the article at Légifrance. May be used with '1' and '2' as an override; or may be paired with |url=. Default: <base> 'art.' <number> (if they are both present). Alias: |text=.
|url= – optional url of the Légifrance article to display. Omit this param when using '1' (base) and '2' (number), as the url value is calculated by the template as a function of base and number. However, if base and number are omitted, |url= may be paired with '3' (text) to create a link to a Legifrance page. This is especially useful for grouping several related articles, or for particular sections of the Legifrance database (mostly recent) for which the 'base' + 'number' values fail to provide an accurate link..

Param notes edit

The following explains how to choose the value of the |number= parameter: 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. 1234 ⟶ L1234.
for regulatory acts beginning with R. – drop the space and punct., i.e., R. 5678 ⟶ R5678
for embedded spaces prior to a suffix, url encode the space; e.g., 4 bis ⟶ 4%20bis
for alphabetic suffix, sometimes you need to add a slash, instead of url-encoded space, e.g., L. 80 A ⟶ L80/A

The following explains how to choose the value of |1= (the 'base' token). 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 the 'base' parameter . 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 edit

Law database to search	Detail	'base' value	Example
Journal officiel de la République française Journal officiel	by NOR number (alphabetic + numeric)	JORF	CSCL0508635S JUSX9800048L
	by JORF id number (numeric; often with many zeroes)	JORFID	000000476688 000000671775
Code de l'action sociale et des familles Social action and family code	Legislative part	CACTSOCL
Code de l'aviation civile Civil aviation code	Legislative part	CAVIAL
	decrees by the Conseil d'État	CAVIAR
	Simple decrees part	CAVIAD
Code civil Civil code		CC	9-1 1137
Code de commerce Commercial code		CCOM	L121-4 L420-2
Code de la consommation Consumer code	Legislative part	CONSO
	decrees of the Conseil d'État	CONSO(R)
	Simple decrees part	CONSO(D)
Code de la construction et de l'habitation Construction and housing code	Legislative part	CCONSTRL
	Regulatory part - décrets en Conseil d'État	CCONSTRR
Code de la défense Defense code	Legislative part	CDEF
Code de la défense Defense code	Regulatory part	CDEF(R)
Code de l'éducation Education code	Legislative part	CEDU	L111-1 L312-9-2 D112-1 R633-24
Code de l'éducation Education code	Regulatory part	CEDU(R)
Code de l'entrée et du séjour des étrangers et du droit d'asile Entry, foreign residence, and right of asylum code	Legislative part	CESEDA(L)
	Regulatory part	CESEDA(R)
Code de l'environnement Environment code	Legislative part	CE
Code de l'environnement Environment code	Regulatory part	CE(R)
Code électoral Electoral code	Legislative part	CELE
Code électoral Electoral code	Regulatory part	CELE(R)
Code général des collectivités territoriales General code of Territorial Authorities code	Legislative part	CGCT	LO1114-1
	Regulatory part	CGCT(R)
Code général des impôts General tax code		CGI
Code général de la propriété des personnes publiques General code of public property		CGPPP
Code des juridictions financières Financial jurisdiction code	Legislative part	CJF(L)
	Regulatory part	CJF(R)
Code de justice administrative Administrative justice code	Legislative part	CJA	L113-1 L213-5 D222-33 R222-30
Code de justice administrative Administrative justice code	Regulatory part	CJA(R)
Code monétaire et financier Monetary and financial code	Legislative part	CMONFIL
Code monétaire et financier Monetary and financial code	Regulatory part	CMONFIR
Code de l'organisation judiciaire Judicial Organization code	new Legislative part	COJ	L211-9
	Legislative part	COJ(L)
	Regulatory part	COJ(R)
Code du patrimoine Heritage code		CPAT
Code pénal Penal code	Legislative part	CP	121-3
Code pénal Penal code	Regulatory part	CP(R)
Code pénal (ancien) Penal code of 1810		CP1810
Code pénitentiaire Penitentiary code		CPEN	L3 L112-1 D112-1
Code des postes et des communications électroniques Post and electronic communications code	Legislative part	CPOSTESL
	Regulatory part	CPOSTESR
Code de procédure civile Civil procedure code		NCPC	4 1136-1 1568
Code de procédure civile (ancien) Civil procedure code (old)		CPC
Code de procédure pénale Criminal procedure code	Legislative part	CPP	62-2 75 to 78
	Regulatory part	CPP(R)
	Simple decrees part	CPP(D)
	partie arrêtés	CPP(A)
Code de la propriété intellectuelle Intellectual property code	Legislative part	CPROINTL
	Regulatory part	CPROINTR
Code de la route Highway code	new Legislative part	CRO
	Legislative part	CROUTEL
	new regulatory part	CRO(M)
	Regulatory part	CROUTER
Code rural et de la pêche maritime Rural and maritime fisheries code	Legislative part	CR
	Regulatory part	CR(R)
Code de la santé publique Public health code	new legislative part	CSP
	Legislative part	CSP(L)
	Regulatory part	CSP(R)
	nouvelle Regulatory part	CSP(NR)
Code de la Sécurité sociale Social security code	Legislative part	CSS(L)
	Simple decrees part	CSS(D)
	Regulatory part	CSS(R)
Code du sport Sports code	Legislative part	CSPORTPL
	Regulatory part	CSPORTPR
	partie arrêtés	CSPORTPA
Code du travail Labor code	new legislative part from 1 May 2008	CT(NL)
	Legislative part	CT	L5429-2 D2122-6 R7343-16
	Regulatory part	CT(R)
	Simple decrees part	CT(D)
Code des transports Transport code		CTRANSP	L1000-2 D1112-1 R1112-11
Code de l'urbanisme Urban planning code	Legislative part	URBA(L)
Code de l'urbanisme Urban planning code	Regulatory part	URBA(R)
Code de la voirie routière Roads and highways code	Legislative part	CVOIRIEL
Code de la voirie routière Roads and highways code	Regulatory part	CVOIRIER
Livre des procédures fiscales Tax procedure book	Legislative part	CGLIVP
	Regulatory part	CGLIVPFM
	partie arrêtés	CGLIVPFA

Other codes edit

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)

Usage notes edit

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

Alternatives to this template edit

To create a short citation to a Legifrance law or legal text, the recommended way is by using this {{Sfn Legifrance}} template. An alternative "brute force" method (not recommended) that creates a short citation without using this template is described below.

This example generates two short citations, each linking the "Legifrance" label to a full citation in the References section, but with the specific named laws named in the |loc= parameter in unlinked plain text:

Mens rea{{sfn|Legifrance|loc=CP 121-3}} and police custody.{{sfn|Legifrance|loc=CPP 62-2}}

This can be improved by linking the named law as well, using {{Sfn Legifrance}}. The following method is equivalent to using {{Sfn Legifrance}}, and works by embedding the {{Legifrance}} template in the value of the |loc= param:

Mens rea{{sfn|Legifrance|loc={{legifrance|base=CP|number=121-3}}} and police custody.{{sfn|Legifrance|loc={{legifrance|base=CPP|number=62-2}} }}

== Works cited ==

* {{cite web |author=République française |date=19 October 2022 |title=Légifrance Le service public de la diffusion du droit |publisher=Secrétariat général du gouvernement |url=https://www.legifrance.gouv.fr |ref={{harvid|Legifrance}} }}

Note the use of the |ref= param in the {{cite web}} template whose {{harvid}} value matches param one of the {{sfn}}; this is required to establish linkage from the short footnote to the full citation, regardless whether {{legifrance}} is used or not. Establishing linkage using the |ref= param in the citation is a standard feature of short footnotes; see the description of handling the "no author name" case.

References edit

Notes

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

Citations

Works cited

République française; Secrétariat général du gouvernement (19 October 2022). "Légifrance Le service public de la diffusion du droit" [The public service for dissemination of the law]. Légifrance. Direction de l'information légale et administrative. ISSN 2270-8987. OCLC 867599055.

TemplateData edit

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

TemplateData for Sfn Legifrance

No description.

Template parameters
Parameter		Description	Type	Status
base	`1`	base: Legislation Database name Suggested values `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` Example JORF	String	required
number	`2`	Article number in the given code base Example 121-3	String	required
display text	`3`	Display text for the link to the article at Légifrance Example Article 121-3 of the Penal code	String	optional
url	`url`	Override url to link the display text to the Légifrance article	String	optional

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

[a]

[b]