Format:TOC început

Documentație format[vizualizează] [modifică] [istoric] [regenerează]

Acest format utilizează TemplateStyles:

Format:Formate TOC/styles.css

Utilizare

Aceste formate sunt concepute pentru a ajuta la crearea cuprinsurilor (în engleză Table of contents, de unde TOC) folosind un set standardizat de secțiuni de tabel. Întotdeauna se vor folosi formatele {{TOC început}} la început și {{TOC sfârșit}} la sfârșit.

TOC început

Parametri

aliniere: alinierea tabelului în pagină, în mod implicit la centru (opțional)
lățime: lățimea tabelului (opțional, orice unități CSS), | lățime = 100%
lățime-max: lățimea maximă a tabelului (opțional, orice unități CSS), | lățime-max = 35em
sc: aplică opțiunea de majuscule reduse întregului tabel (opțional), | sc = da
asc: transformă toate literele din tabel în majuscule reduse (opțional), | asc = da
stil: aplică orice alt stil dorit întregului tabel (opțional/fără valoare implicită), | stil = line-height:1
plus: permite adăugarea de cod separat (opțional), de ex. pentru a seta atributele tabelului | plus = id {{=}} "tabel-exemplu" (vezi mw:Help:Extension:ParserFunctions#Raw_equal_signs)
descriere: Adăugați o descriere tabelului

Convenție de denumire

Formatele sunt denumite după colspan-ul celulelor lor (în ordine) și caracteristica principală a oricărei celule care nu este „normală”.

De exemplu, un rând format din trei celule simple este {{TOC rând 1-1-1}}, iar un rând cu o celulă colspan-2 urmată de o celulă simplă este {{TOC rând 2-1}}. Dacă o celulă nu are colspan, dar are o caracteristică proeminentă, cifra „1” care se referă la acea celulă este omisă: {{TOC rând 1-punct-1}}.

Parametri

Parametrii poziționali 1, 2 etc. primesc conținutul primei, celei de-a doua etc. celule a tabelului.
Majoritatea formatelor pentru rânduri au un parametru opțional clasă care poate fi utilizat pentru a aplica stiluri CSS suplimentare acelui rând.
- Clasa wst-toc-aux formatează rândul cu un fundal verde pentru a indica faptul că rândul este o adăugire Wikisource, de exemplu pentru o prefață care nu se afla în cuprinsul original.

Cazuri speciale

{{TOC rând s}}: o singură celulă, text aliniat la stânga, cu un colspan dat în primul parametru și conținutul în al doilea.
{{TOC rând c}}: o singură celulă, text centrat, cu colspan specificat în primul parametru și conținutul în al doilea.
{{TOC rând d}}: o singură celulă, text aliniat la dreapta, cu un colspan dat în primul parametru și conținutul în al doilea.

Tabele cu 3 coloane

Tabelele cu 3 coloane sunt probabil cele mai comune. Condiția „normală” este ca prima și ultima coloană să fie aliniate la dreapta, iar coloana din mijloc să fie aliniată la stânga.

{{TOC rând 1-1-1}}: trei celule simple, aliniate dreapta-stânga-dreapta, respectiv
{{TOC rând 2-1}}: o celulă colspan=2 și o celulă normală. Aliniate la stânga și, respectiv, la dreapta.

Alineate negative

{{TOC rând 1-an-1}}: trei celule simple, dar celula din mijloc are aplicată un {{alineat negativ}}.
{{TOC rând 2an-1}}: la fel ca „2-1”, dar prima celulă are un alineat negativ.
{{TOC rând 1-an-1}}: la fel ca „1-an-1”, dar celula din mijloc are și o linie punctată
- Opțional: utilizați simbol pentru a seta caracterul (sau caracterele) și spații pentru a seta numărul de spații utilizate în linia punctată (implicit: un punct la 5 spații)

{{TOC rând 2punct-1}}: la fel ca „2an-1”, dar prima celulă este celula „principală” și are o linie punctată.

Aliniere diferită a celulei principale

{{TOC rând 1-d-1}}: trei celule simple, aliniate respectiv stânga-dreapta-dreapta.
{{TOC rând 1-c-1}}: trei celule simple, aliniate respectiv stânga-centru-dreapta.

=Exemplu

Aceasta este descrierea
Cuprins: {{TOC rând c}}
Introducere și Prefață: {{TOC rând 2-1}}		1
1	Capitolul 1: {{TOC rând 1-1-1}}	2
2	Capitolul 2: {{TOC rând 1-1-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.	3
{{TOC rând d}} Diverse figuri și ilustrații Format:TOC rând 1-an-1 Format:TOC rând 2an-1
4	Capitolul 4: {{TOC rând 1-punct-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	6
{{TOC rând 2punct-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		7

Tabele cu 4 coloane

Condiția „normală” este ca prima, a doua și ultima coloană să fie aliniate la dreapta, iar a treia coloană să fie aliniată la stânga. A treia coloană este de obicei (nu întotdeauna) celula „principală”.

{{TOC rând 1-1-1-1}}
{{TOC rând 2-1-1}}
{{TOC rând 1-2-1}}
{{TOC rând 1-2punct-1}}
{{TOC rând 1-2an-1}}
{{TOC rând 3-1}}
{{TOC rând 1-1-punct-1}}
{{TOC rând 3punct-1}}
{{TOC rând 2punct-1-1}} (utilizează prima coloană dublă ca celulă principală, astfel încât, de obicei, nu este compatibilă cu rândurile care au celule inițiale „scurte”)
{{TOC rând 2punct-punct-1}}

Cuprins: {{TOC rând c}} Format:TOC rând 3-1
Introducere		{{TOC rând 2-1-1}}	1 Format:TOC rând 1-1-1-1 Format:TOC rând 1-1-1-1 Format:TOC rând 1-2-1
3	{{TOC rând 1-2punct-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		5 Format:TOC rând 1-2an-1 Format:TOC rând 3-1
{{TOC rând 3punct-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			7

Cuprins: {{TOC rând c}}
{{TOC rând 2punct-1-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		1	2

Tabele cu rânduri neregulate

Unele lucrări au cuprinsuri care au coloana din dreapta de dimensiuni variabile, coloana din stânga a altor rânduri suprapunându-se uneori peste aceasta. Acest lucru se întâlnește adesea în periodicele în care mai multe părți ale unei lucrări seriale sunt enumerate pe aceeași linie.

{{TOC rând neregulat}}:
- 1 este conținutul principal aliniat la stânga
- 2 este „coloana” din dreapta.
- colspan este colspan-ul întregului rând pentru a permite funcționarea cu alte șabloane de rânduri. Valoarea implicită este 3 (astfel încât va funcționa în mod implicit bine cu {{TOC rând 1-1-1}}, de exemplu).
- margine este mărimea alineatului întregului paragraf, considerat de la marginea din stânga. Valoarea implicită este 2em.
- alineat este mărimea alineatului negativ al primului rând, considerat față de alineatul întregului paragraf. Valoarea implicită este 2em.

Format:TOC rând neregulat Format:TOC rând neregulat

Dacă o singură intrare neregulat se întinde pe mai multe pagini, trebuie utilizate șabloanele {{TOC rând neregulat/s}} și {{TOC rând neregulat/e}}, cu numerele paginilor specificate ca parametrul 1 al formatului {{TOC rând neregulat/e}}. Parametrii pentru margine ai {{TOC rând neregulat/e}} și {{TOC rând neregulat/s}} trebuie să fie identici.

{{TOC rând punctneregulat}}: versiune cu linie punctată

Conținut auxiliar (adăugat)

Câteodată cuprinsul original al operei nu include și o parte din conținut, precum prefața. Cu toate acestea, tot trebuie să fie creată o legătură către acest conținut pe pagina principală a lucrării, astfel încât programul de export să îl poată prelua și include în rezultatul final atunci când se rulează o exportare. Clasa CSS wst-toc-aux permite o marcare vizuală (și semantică) a unui rând drept „conținut auxiliar”. Se poate adăuga și text pentru a explica acest lucru în mod clar.

Exemplu: Marcarea conținutului auxiliar

{{TOC început|lățime=35em}}
|+ CUPRINS
{{TOC rând 2-1|clasă=wst-toc-aux|Prefață {{mai mic|(lipsea în cuprinsul original)}}}}
{{TOC rând 2-1|Capitolul 1 | 1}}
{{TOC rând 2-1|...}}
{{TOC sfârșit}}
}}

CUPRINS
Prefață (lipsea în cuprinsul original)
Capitolul 1		1
...

Întreruperi de pagină

Dacă un tabel este împărțit pe mai multe pagini, așa cum se întâmplă de obicei în cazul cuprinsurilor lungi, trebuie să adăugați {{nop}} în partea de sus a corpului fiecărei pagini, pentru a împiedica transcluderea din a uni ultimul rând al paginii anterioare cu primul rând al paginii curente. De asemenea, trebuie să introduceți un {{TOC început}} în antetul paginii pentru ca aceasta să se afișeze corect în spațiul de nume Pagină:, și trebuie să închideți tabelul în subsolul fiecărei pagini, cu excepția ultimei:

Prima pagină	corp	{{TOC început}} {{TOC rând.....}}
Prima pagină	subsol	{{TOC sfârșit}}
Pagina din mijloc	antet	{{TOC început}}
	corp	{{nop}} {{TOC rând.......}} {{TOC rând.......}}
	subsol	{{TOC sfârșit}}
Ultima pagină	antet	{{TOC început}}
Ultima pagină	corp	{{nop}} {{TOC rând....}} {{TOC sfârșit}}

Export

Aceste șabloane ar trebui să se comporte bine la export:

Ele produc un singur tabel contiguu, ceea ce înseamnă că alinierea ar trebui să fie menținută chiar și în motoarele HTML simple.

Codul CSS este conceput pentru a permite o proiectare rezonabil de receptivă în comparație cu tabelele „minim stilizate”. De exemplu:

- Se aplică o max-width:100%; pentru a împiedica tabelul din a se extinde în afara marginii drepte a unei pagini înguste.

- Încadrarea textului este dezactivată în mod implicit pentru celulele „mici”: unele motoare vor încerca să separe numerele mai lungi, cum ar fi „1234” sau „xxxviii”. Acest lucru se poate întâmpla oricum pe unele dispozitive.

Liniile punctate sunt dezactivate automat la export, ca și în celelalte formate cu linii punctate, deoarece niciun motor de cititor electronic cunoscut nu afișează altceva decât un câmp de puncte. Cu toate acestea, în rest tabelul se va exporta corect.

Urmărire

Some common issues are tracked by special categories:

Utilizări ale formatului TOC început cu erori: când parametrul stil conține ghilimele (probabil o greșeală)
Utilizări ale formatului TOC început cu lățimi în px sau procente: o setare a parametrului lățime în unități procentuale sau în pixeli, care ar trebui cel mai bine transformată într-o unitate relativă la dimensiunea textului, precum em

Vezi și

Ajutor:Formate

Documentația de mai sus a fost transclusă de la Format:Formate TOC/doc.
Editorii pot experimenta în paginile teste și cazuri de test ale acestui format.
Subpagini ale acestui format.