Extension:Labeled Section Transclusion/fr

L'extension Labeled Section Transclusion permet la transclusion sélective de sections cochées, en faisant une analyse syntaxique wikitext normale. Sa fonctionnalité est similaire à une version améliorée de l'étiquette  avec une transclusion wiki normale, laquelle selectionne des sections pour inclusion. Elle est disponible pour tous les wikis Wikimedia.

Tandis que la transclusion normale est destinée principalement à transclure de grandes portions de petits modèles, l'extension Labeled Section Transclusion est destinée pour petites portions de grandes pages.

Pourtant, il y a quelques différences. Dans la transclusion du modèle natif, les sections sont marquées par comportement; donc seules des sections (possiblement non adjacentes) peuvent être incluses ou omises.

Ici, les sections sont marqués par leur nom, et le comportement est choisi par l'appelant, lequel peut inclure ou omettre des sections selon besoin. nécessaire. Différentes pages peuvent inclure ou exclure des sections sélectionnées; il peut y avoir un nombre arbitraire de sections, qui peuvent aussi se chevaucher arbitrairement.

En marquant les sections avec un nom plutôt que d'après leur comportement, on peut modifier les liens de section pour les générer de manière plus adaptée pour l'extraction de plus grandes parties de texte, depuis que l'extension peut maintenant compter les sections embarquées au début de la page, permettant aux sections transcluses d'être indexées correctement.

Etape 1: marquage des sections
Marquez les sections du texte en utilisant les balises  comme ceci :

this is a chapter 1

Notez que ces balises ne sont pas du HTML/XML, et n'utilisent pas la syntaxe normale des attributs. Pour cette raison, et parce que les marqueurs begin et end sont dissociés plutôt que d'avoir des balises standard ouvrantes et fermantes XML, ceci permet d'avoir des sections imbriquées ou qui se recouvrent. Vous pouvez ainsi insérer des balises de section sans vous préoccuper de l'interférence avec les autres sections.

Etape 2a: transclure la section
Appeler la fonction d'analyseur #lst pour la transclure, c'est à dire pour transclure une section appelée chapter1 d'une page appelée articleX :

L'article cible définit l'emplacement de la section; son comportement est déterminé par la fonction d'analyse.

Etape 2b: transclure la page en excluant la section
Pour transclure une page, mais en excluant une section spécifique, utilisez la fonction #lstx :

Optionnellement, vous pouvez ajouter un texte de remplacement à la section exclue.

Exemple:

Le texte de remplacement apparaîtra dans la zone où la section est sautée (exclue).

Section discontinues
Il est possible d'avoir des sections multiples ayant le même nom; dans ce cas, chaque section qui a ce nom sera inclue/exclue. Ceci est particulièrement utile pour marquer différentes discussions.

Eventail des sections
Ces fonctions ont un argument supplémentaire et facultatif pour spécifier un intervalle de sections; par exemple, pour inclure tout ce qui se trouve entre le début du chapître 1 jusqu'à la fin du chapître 3. Ceci permet d'utiliser des paires de marqueurs vides pour marquer une fin de section, éventuellement dans un modèle. Un mécanisme similaire est utilisé actuellement dans le Wikisource français.

Substitution
Ceci fonctionnne également avec la substitution; il est même possible pour un article de se substituer une de ses sections. Une utilisation de ceci fournit une manière élégante d'archiver les pages de discussion : marquez le texte à archiver en utilisant, etc. Puis créez une page d'archive avec le texte en utilisant archive , ce qui copie les sections archivées. Enfin remplacez le contenu de la page de discussion avec archive pour supprimer ces sections.

Transclure les sections par le titre
Ceci est un support facultatif pour transclure les sections de texte marquées avec les titres habituels, par exemple. Si elle est installée, cela se fait à l'aide de la fonction lsth.

Transclure l'introduction
Pour transclure l'introduction d'une page (par exemple le contenu avant le premier titre), utilisez

Transclure une section spécifique
Vous pouvez également transclure le contenu complet de la sectionX (qui inclut toutes ses sous-sections et exclut le titre de sectionX lui même).

Eléments à prendre en compte:


 * 1) Seule la première occurence de la sectionX est transclue s'il y a plusieurs sections de même nom.
 * 2) Assurez-vous de bien entrer le titre de sectionX tel qu'il figure dans le  wikicode, et non pas tel qu'il est affiché. Par exemple si le titre de la section est  , vous devez entrer «   » et non pas «   ».
 * 3) Si vous transcluez une section à partir d'une page marquée à traduire, en utilisant l'extension Translate, transcluez à partire de la version spécifique à la langue. Par exemple, à partir de pagename/en plutôt que de pagename.
 * 4) La correspondance est indépendante de la casse pour éviter d'avoir des liens non trouvés à cause des changements de casse.

Transclure plusieurs sections
You can also transclude from the first occurrence of sectionX (excluding the heading of sectionX itself) until it reaches the next occurrence of sectionY. Note that sectionY acts as a stop point so the transclusion doesn't contain the content of sectionY.

Notes concernant les titres sautés
Since the traditional transclusion in MediaWiki isn't intended to transclude sections, it doesn't account for skipped headings. As a result, if you were to transclude a template with multiple headings, and skip the first heading, then all of the edit sections links would point to the wrong section in the template.

When this extension is used (with MediaWiki 1.9 or later), the #lst and #lsth functions count headings in the "skipped" beginning part, and offset transcluded headings appropriately. This will allow these links to point to the correct section in the simple case.

Note that #lstx does not count skipped headings, and that skipped headings within discontiguous sections are not offset. '''Mais il semble que cela soit maintenant corrigé (en parallèle avec le portage sur le nouveau préprocesseur MediaWiki). Les titres transclus peuvent être liés correctement aux sections'''.

Internationalisation
Internally, the parser functions all use the lst prefix, for consistency with the name of the extension. Since this acronym may be confusing to non-developers, readable English variants have been introduced, so the functions can currently be called from either name.

Additionally, the tag can now be localised (currently English, German, and Hebrew), i.e.:


 *  ... 
 * (RTL): <קטע התחלה=א> ... <קטע סוף=א> ("start" code to the right and "end" code to the left)
 *  ...
 *  ...

Limitations

 * While it is possible to use this extension across namespaces, interwiki references are not resolved. It is not yet possible, for example, to include part of a Wikisource page into a remote MediaWiki installation.
 * Section tags cannot themselves be transcluded in order to work on other pages.  and   work only if section tags appear directly in the wikitext of the transcluded page. This means, for instance, that these tags cannot be embedded in a template using template parameters and parser functions. The   magic word does not work with section tags.   produces balanced tags, while the section tags uses singular tags. See.
 * As of 2014, section tags don't have any effect when used inside a template parameter. If page A contains a text, there's no way  can access X.

Installation
There is also a Gadget in use on various Wikisources that makes it possible to define sections with a simplified  syntax. Son code peut être trouvé sur Wikisource:MediaWiki:Gadget-Easy_LST.js.

Exemples

 * wikisource:user:sanbeg/Includer is an early demonstration that shows several of the basic features.

Voir aussi

 * DynamicPageList (third-party) includes a slightly modified built-in version of Labeled Section Transclusion