Format:Documentație citare/doc

Aceasta este pagina de documentație pentru Format:Documentație citare. Pagina descrie modul de folosire al formatului și conține categoriile de care acesta aparține, precum și orice altceva ce nu face parte din formatul propriu-zis.

Utilizare

Acest format este folosit pentru construirea de pagini de documentație consistente pentru formatele de citare CS1.

De exemplu: {{documentație citare|author}} va prezenta documentația pentru parametrii legați de autor.

Acolo unde o anume secțiune din documentație nu este relevantă pentru un anume format, doar adăugați textul manual sau creați un nou subformat.

Fiecare modul de text este un subformat care poate fi editat.

Utilizarea secțiunilor

Când creați o documentație de format, folosiți următoarea ordine a secțiunilor:

• Introducerea: prezentare generală a intențiilor formatului
• Utilizare: eșantioane de formate cu parametri enumerați, dar neprecizați, pentru copy-paste
• Exemple: exemple de diferite utilizări
• Parametri: descrieri detaliate ale fiecărui parametru
  • Sintaxă: generalități despre sintaxa formatului
  • Deprecated: listă de parametri învechiți
  • Descriere: descrierile parametrilor pe funcționalități în următoarea ordine generală:
    • Autori
    • Titlu
    • Date
    • Editură
    • Ediție, serie, volum
    • Localizări în interiorul sursei
    • URL
    • Ancore
    • Identificatori
    • Citat
    • Editori
    • Sumar
    • Opțiuni de afișare

Lead section

Folosiți {{csdoc|lead|content}} pentru a crea conținut consistent pentru introducere:

Sintaxa	Rezultat
{{csdoc|lead|books}}	Acest format Citation Style 1 este utilizat pentru a crea citări pentru books.

Secțiunea utilizare

Începeți secțiunea utilizare cu {{csdoc|usage}}:

Copiați o versiune fără argumente. Toate numele parametrilor trebuie să fie cu litere mici. Folosiți caracterul „|” (pipe) între fiecare parametru. Ștergeți parametrii nefolosiți pentru a evita aglomerarea ferestrei de editare. Câteva exemple pot include și data curentă. Dacă data nu este cea curentă, atunci regenerați pagina.

Parametrii de copiat sunt incluși în tabelele create de subformate.

Stil complet orizontal

• Începeți cu {{csdoc|usage full}}
• Precedați porțiunea cu : ca să înceapă mai din interior
• Includeți porțiunea în <code><nowiki>...</nowiki></code>
• Închideți tabelul cu {{end}}

{{csdoc|usage full}}
:<code><nowiki>{{cite book |last1= |first1= |author1-link= |last2= |first2= |author2-link= |editor1-first= |editor1-last= |editor1-link= |others= |title= |trans-title= |url= |archive-url= |archive-date= |format= |access-date= |type= |edition= |series= |volume= |date= |year= |orig-year= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |page= |pages= |at= |trans-chapter= |chapter= |chapter-url= |quote= |ref= |bibcode= |lay-url= |lay-source= |lay-date= |author-mask= |display-authors= |postscript= |last-author-amp=}}</nowiki></code>
{{end}}

Setul complet de parametri în format orizontal

{{cite book |last1= |first1= |author1-link= |last2= |first2= |author2-link= |editor1-first= |editor1-last= |editor1-link= |others= |title= |trans-title= |url= |archive-url= |archive-date= |format= |access-date= |type= |edition= |series= |volume= |date= |year= |orig-year= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |page= |pages= |at= |trans-chapter= |chapter= |chapter-url= |quote= |ref= |bibcode= |lay-url= |lay-source= |lay-date= |author-mask= |display-authors= |postscript= |last-author-amp=}}

Cel mai frecvent utilizat stil orizontal

• Începeți cu {{csdoc|usage common}}
• Precedați porțiunea cu : ca să înceapă mai din interior
• Includeți porțiunea în <code><nowiki>...</nowiki></code>
• Închideți tabelul cu {{end}}

{{csdoc|usage common}}
:<code><nowiki>{{cite book |last= |first= |author-link= |title= |url= |access-date= |year= |publisher= |location= |isbn= |page= |pages=}}</nowiki></code>
{{end}}

Cei mai frecvent folosiți parametri în format orizontal

{{cite book |last= |first= |author-link= |title= |url= |access-date= |year= |publisher= |location= |isbn= |page= |pages=}}

Stil complet vertical

Stilul complet vertical este creat pe trei coloane: Listă verticală, prerequisite și scurte instrucțiuni, note.

• Începeți cu:

{{csdoc|usage vertical}}
<pre style="margin:0px;">

• Creați coloana listei verticale
• Separați următoarea coloană prin:

</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">

• Creați coloana de prerequisite; liniile goale trebuie să includă un  
• Separați coloana următoare cu:

</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">

• Creați coloana de instrucțiuni; liniile goale trebuie să includă un  
• Terminați cu:

</pre>
{{csdoc|usage vertical end}}

Exemplu:

{{csdoc|usage vertical}}
<pre style="margin:0px;">
{{cite book
| last                  =
| first                 =
| author-link           =
}}
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
&nbsp;
last
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
ca și last1
ca și first1
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical end}}

Parametrii compleți în format vertical

Listă verticală	Prerequisites	Scurte note / instrucțiuni
{{cite book | last = | first = | author-link = }}	last	ca și last1 ca și first1

• Dacă un nume de câmp este listat în coloana Prerequisites, atunci este necesară prezența lui pentru câmpul din stânga.

Subformate

Utilizare

Format:Documentație citare/edit |}

Utilizare completă

Format:Documentație citare/edit |}

Utilizare comună

Format:Documentație citare/edit |}

Utilizare verticală

Format:Documentație citare/edit |}

Utilizare verticală mijloc

Format:Documentație citare/edit |}

Secțiune exemple

Folosiți {{markup2}} pentru a formata exemplele (vezi documentația formatului pentru utilizare).

{{markup2 |t=Utilizare simplă cu url (și accessdate) șiediție
|m={{cite book |title=Mysterious book}}
|r={{cite book |title=Mysterious book}}
}}

Basic usage with url (and accessdate) and edition

• {{cite book |title=Mysterious book}}

Mysterious book.