Ajuda:Inclusió de seccions mitjançant marques

El juny de 2007 fou activada l'extensió Labeled Section Transclusion del Mediawiki^[1].

La finalitat és similar a la de les plantilles: inserir text que s'ha definit en una altra pàgina. Però amb l'ús de les marques hom pot agafar diferents seccions de diferents pàgines sense cap ordre de continuïtat.

Com funciona

Primer cal definir la secció o seccions en un text d'una pàgina o pàgines. Cada secció ha de rebre un nom concret.

<section begin=Nom_de_la_secció />secció_de_text<section end=Nom_de_la_secció />

, o bé ^[2]:

## Nom_de_la_secció ## secció_de_text ####

En el següent exemple s'ha marcat 6 seccions, i hem d'imaginar que està escrit a la pàgina anomenada "Crònica de Bernat Muntaner":

<section begin=Capítol1 />Això és un capítol<section end=Capítol1 />
<section begin=Capítol2 />Això és un altre capítol<section end=Capítol2 />
<section begin=Capítol3 />Això és el capítol 3<section end=Capítol3 />
<section begin=3:Frase3 />Això és una frase del capítol 3<section end=3:Frase3 />
<section begin=Capítol4 />Això és el capítol 4<section end=Capítol4 />
<section begin=Capítol5 />Això és el capítol 5<section end=Capítol5 />
Això són més capítols que no s'han marcat de cap manera.

I després cal afegir en una altra pàgina, la crida al text abans marcat, com si es tractés d'una plantilla, però amb la següent nomenclatura:

{{#lst:Nom_de_la_pàgina|Nom_de_la_secció}}
{{#lst:Nom_de_la_pàgina|Nom_de_la_secció}}

Seguint l'exemple anterior:

{{#lst:Crònica de Bernat Muntaner|Capítol2}}
{{#lst:Crònica de Bernat Muntaner|3:Frase3}}

, i ens apareixerà el text del capítol 2 abans marcat seguit d'una frase del capítol 3:

Això és un altre capítol
Això és una frase del capítol 3

Si desitgem posar tot allò marcat entre dues senyals, hem de fer referència a la secció inicial i a la secció final:

{{#lst:Nom_de_la_pàgina|Nom_de_la_secció_inicial|Nom_de_la_secció_final}}

Seguint l'anterior exemple:

{{#lst:Crònica de Bernat Muntaner|Capítol1|Capítol5}}

, i ens pareixerà tot això:

Això és un capítol
Això és un altre capítol
Això és el capítol 3
Això és una frase del capítol 3
Això és el capítol 4
Això és el capítol 5

Possibles usos

Seccions en pàgines de transcripció

Aprofitant que disposem de les pàgines de transcripció, basta amb incloure l'esmentada transcripció entre les marques de secció damunt dites, per a poder ser escrites en una nova pàgina sense gaire dificultat.

Per exemple, imaginem que disposem un llibre anomenat "Llibre:Tirant lo Blanc.djvu" i que volem transcloure el capítol primer que va des de les pàgines 10 a la 15, però la pàgina 10 conté també el final del pròleg i la pàgina 15 conté també l'inici del capítol 2:

• Tirant lo Blanc.djvu/10: final del pròleg i inici del capítol 1
• Tirant lo Blanc.djvu/11: continua capítol 1
• Tirant lo Blanc.djvu/12: continua capítol 1
• Tirant lo Blanc.djvu/13: continua capítol 1
• Tirant lo Blanc.djvu/14: continua capítol 1
• Tirant lo Blanc.djvu/15: continua capítol 1 i comença capítol 2

Caldrà afegir seccions a 2 pàgines:

• Tirant lo Blanc.djvu/10: caldrà acotar el text del capítol 1 entre les etiquetes <section begin="nom_de_la_secció_inicial"/> i <section end="nom_de_la_secció_inicial"/>
• Tirant lo Blanc.djvu/15: caldrà acotar el text del capítol 1 entre les etiquetes <section begin="nom_de_la_secció_final"/> i <section end="nom_de_la_secció_final"/>

Finalment, a la pàgina on anem a transcloure el capítol 1 caldrà codificar el següent:

<pages index="Tirant lo Blan.djvu" from="10" to="15" fromsection="Nom_de_la_secció_inicial" tosection="Nom_de_la_secció_final" />

En casos on no sigui possible usar el mètode anterior, es pot fer servir la plantilla {{Pàgina}} i el seu paràmetre de secció. Per exemple, si estem en una pàgina que es diu "Pàgina:Poemes varis.djvu/4" i que conté 3 poesies, podríem posar això:

<section begin="poesia1" />
poesia 1

això és una poesia 1
això és una poesia 1
això és una poesia 1
<section end="poesia1" /><section begin="poesia2" />
poesia 2

això és una poesia 2
això és una poesia 2
això és una poesia 2
<section end="poesia2" /><section begin="poesia3" />
poesia 3

això és una poesia 3
això és una poesia 3
això és una poesia 3
<section end="poesia3" />

Per una altra banda, podríem crear tres pàgines (de l'espai de noms principal) de la següent manera:

Poesia 1 ==> Posar només: {{Pàgina|Poemes varis.djvu/4|section=poesia1}}
Poesia 2 ==> Posar només: {{Pàgina|Poemes varis.djvu/4|section=poesia2}}
Poesia 3 ==> Posar només: {{Pàgina|Poemes varis.djvu/4|section=poesia3}}

Reaprofitar textos

De vegades podem trobar-nos amb obres que inclouen unes altres obres. Per exemple, una obra escrita per un autor A1 que tracta sobre poesia feta per un autor A2. Podem marcar la secció de text a l'obra que farà de font o referència, i expandir-la a la pàgina o pàgines que volguem.

Amb un exemple es veurà més clar. La pàgina Pàgina:Antologia d'autors catalans.djvu/46 conté un poema que es diu L'ovella i l'inici d'un altre poema. En acotar el primer amb seccions, el podem transcloure com a poema independent a la pàgina "L'ovella", i també el podem transcloure a la pàgina de capítol "Antologia d'autors catalans/Joan Draper". Tot canvi a la pàgina original es veurà reflectit en la resta de pàgines que la transclouen.

Referències

1. mw:Extension:Labeled Section Transclusion
2. La nova sintaxi fou activada l'octubre de 2010, i reemplaça a l'anterior sintaxi de forma automàtica en desar els canvis o en fer una previsualització. Hi ha alguns problemes en seccions aniuades. Es pot desactivar globalment afegint self.proofreadpage_raw_lst=true; al MediaWiki:Common.js.