« Goélette Cardabela/Références » : différence entre les versions

Contenu supprimé Contenu ajouté
→‎Référencement semi automatique : Conversion des sections en sous-pages
→‎Référencement manuel : Conversion des sections en sous-pages
Balise : Contenu remplacé
Ligne 23 :
{{Nouvelle page imprimée}}
= Référencement manuel =
{{:{{BASEPAGENAME}}/Référencement manuel}}
{{Boîte déroulante début|titre={{75}}Référencement manuel dans l'espace de noms « principal »|styleFrame=width:100%;|fondtitre=#F0F0F0<!--|styleTitre=color:white;<!|style=headerbleu-->}}
'''Avec le référencement manuel on ne sort pas de l'environnement Wiki'''
 
Dans l'environnement semi automatique ou complètement automatisé il est nécessaire d'utiliser des programmes sous Windows ou Linux.
 
À ce jour, 17 décembre 2018, nous ne savons pas encore si d'autres options sont possibles.
 
Votre aide serait appréciée. Voyez [[{{TALKPAGENAME}}]]
 
== Le canevas sclti ==
''sclti signifie :'' '''sources, contributeurs, licences, textes et images'''
 
Il s'agit de produire la sous-page '''<nowiki>{{PAGENAME}}/sclti</nowiki>''' de chaque article. La création est assez facile lorsqu'il n'y a qu'un auteur et peu d'images mais c'est plus compliqué lorsqu'il y a de nombreuses images.
 
Dans le cas où il y a de nombreuses images il faut extraire les liens, rechercher les attributions, les licences, trouver les pages où elles apparaissent.
 
'''L'index''' est construit à l'aide de la sous page '''<nowiki>{{PAGENAME}}/sommaire</nowiki>'''.
 
'''Disponibilité''' du canevas sclti : [[Goélette_Cardabela/Références/Canevas_sclti|Références/Canevas_sclti]] pour les articles disposant d'un ''Sommaire''
 
'''Exemple''' de création d'une sous-page <nowiki>{{PAGENAME}}/sclti</nowiki> : [[Goélette_Cardabela/Après/L'entretien/sclti]]<br />« L'entretien » est la sous page Elle apparaît à la fin de la version imprimable : [[Goélette_Cardabela/Après/L'entretien/Version imprimable]] débarrassée de sa structure d'extractions.
 
== Le canevas SCLTI ou l'Annexe ? ==
Si le '''livre''' n'est pas trop compliqué on pourra créer directement la sous-page <nowiki>{{BASEPAGENAME}}/Annexe</nowiki> par extraction les lignes '''des''' sous-pages <nowiki>{{BASEPAGENAME}}/sclti</nowiki>
 
On pourra utiliser un canevas SCLTI pour produire l'Annexe à défaut de disponibilité des sous pages sclti.
 
'''Disponibilité''' du canevas SCLTI : [[Goélette_Cardabela/Références/SCLTI]]
 
Ce canevas se distingue du canevas sclti par le fait qu'un livre est constitué d'articles avec un Sommaire qui s'appelle '''Contenu''' qui est la liste des articles du livre, semblable à la liste créée par le compilateur. C'est cette liste qui doit nous servir pour créer la sous-page Annexe
 
'''Exemple''' de création d'une sous-page <nowiki>{{BASEPAGENAME}}/SCLTI</nowiki> : [[Goélette_Cardabela/Collection des livrets techniques de la goélette Cardabela/SCLTI|Collection des livrets techniques de la goélette Cardabela/SCLTI]] Elle apparaît à la fin de la version imprimable : [[Goélette_Cardabela/Collection des livrets techniques de la goélette Cardabela/Version imprimable|Collection des livrets techniques de la goélette Cardabela/Version imprimable]] débarrassée de la structure des repères d'extraction.<br />''Remarque : ''Dans cet exemple la sous-page SCLTI est utilisée directement sans produire la sous-page Annexe.
 
== Référencements manuels ==
Les canevas sont proposés pour créer la [[w:Documentation|''documentation'']] d'un [[w:Article|''article'']] ou d'un [[w:Wiki|''Wiki'']]-[[w:Livre_(document)|''livre'']].
 
=== Utiliser le canevas sclti ===
Le {{75}}[[wikibooks:fr:Goélette_Cardabela/Références/Canevas_sclti|''Canevas_sclti'']] est proposé pour créer la sous page sclti des articles simples, ou composés de peu de sous-pages et de peu d'images. <br />La création simplifiée est manuelle. <br /> La création est semi-automatique avec [https://fr.wikibooks.org/w/index.php?title=Goélette_Cardabela/Références#Les_fichiers_de_commandes les fichiers de commandes]
 
{{Boîte déroulante début|titre={{75}}Utiliser le canevas sclti|styleFrame=width:100%;|fondtitre=#F0FFFF<!--|styleTitre=color:white;<!|style=headerbleu-->}}
'''La procédure consiste à [[wikt:fr:transclure|''transclure'']] la sous-page sclti en bas-de-page de l'article <nowiki>{{PAGENAME}}</nowiki>''' : <br />
# ''Copier le texte :'' '''<nowiki>{{:{{PAGENAME}}/sclti}}</nowiki>''' ''et le coller'' en bas-de-page de l'article. <br />Le lien doit apparaître en rouge à la prévisualisation si il n'a pas déjà été créé. <br />Cliquer sur le lien en rouge pour créer la page <nowiki>{{PAGENAME}}/sclti</nowiki>
# Éditer la page [https://fr.wikibooks.org/w/index.php?title=Go%C3%A9lette_Cardabela/R%C3%A9f%C3%A9rences/Canevas_sclti&action=edit '''Canevas_sclti'''] ''(Cliquer sur ce lien)'' <br />Copier le code du canevas et le coller dans la sous-page <nowiki>{{PAGENAME}}/sclti</nowiki> puis ''Enregistrer les modifications.
 
'''Remarque''' :
# '''Si l'article ne doit jamais être inclus dans un livre il n'est pas nécessaire de créer une nouvelle sous-page sclti.''' <br />Il suffit de copier le Canevas_sclti en bas de l'article et de procéder de la même façon que pour la sous-page. De cette manière on aura créé une nouvelle section dans l'article qui sera l'Annexe de l'article : ''=&nbsp;Annexe&nbsp;='' <br />Procéder ainsi :<br />
## Éditer la page [https://fr.wikibooks.org/w/index.php?title=Go%C3%A9lette_Cardabela/R%C3%A9f%C3%A9rences/Canevas_sclti&action=edit '''Canevas_sclti'''] ''(Cliquer sur ce lien)''
## Copier le code et coller ce code à la fin de l'article.
# Pour utiliser ce Canevas_sclti assurez-vous que l'article n'est pas composé de plusieurs articles. <br />Pour les livres utiliser le Canevas_SCLTI qui est très semblable mais qui tient compte des articles [[wikt:fr:transclus|''transclus'']]. <br />Les articles composés sont souvent des livres avec une sous-page ''Contenu''. <br />La liste des articles est habituellement donnée dans la sous-page de <nowiki>{{BASEPAGENAME}}/Contenu</nowiki>.
 
'''Description de la page ou de la section créée''' :<br />
Lignes 1 à 6 du canevas :
<pre style="color:black;background-color:#FFE;">
1 = Annexe =
2 == Références ==
3 <references />
4 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
5 /*1
6 {{Vert|Prévisualiser, copier les références ci-dessus, les coller ici (remplacer ce texte vert).}}*/</noinclude>
</pre>
* La ligne 1 est la tête du chapitre (Annexe)
* La ligne 2 est la première section (Références)
* La ligne 3 place la balise <references /> en dessous de laquelle viendront se placer automatiquement les références qui n'ont pas été prises en compte dans l'article <nowiki>{{PAGENAME}}</nowiki>, volontairement ou non. On peut y ajouter d'autres références.
* Les lignes 4 à 6 sont réservées à la recopie des lignes qui apparaissent sous la balise <references />. Ces lignes entre les balises <nowiki></nowiki> n'apparaîtront pas dans la publication de la page source <nowiki>{{PAGENAME}}</nowiki>.
* La ligne 6 pourra être copiée dans la section Annexe d'un livre avec la commande [[w:mkd (commande unix)|mkd]].
<pre style="color:black;background-color:#FFE;">
7
8 {{Nouvelle page imprimée}}
9 == Sources et contributeurs des articles ==
10 '''''Source de cette édition : <br />'''''{{Canonicalurl:{{PAGENAME}}}}
11 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
12 /*2
13 {{Vert|Prévisualiser, copier le lien ci-dessus, le coller ici (remplacer ce texte vert).}}*/</noinclude>
</pre>
* La ligne 8 introduit le modèle [[Modèle:Nouvelle_page_imprimée|Nouvelle page imprimée]] destiné à l'imprimante.
* La ligne 9 définit la deuxième section (Sources et contributeurs des articles)
* La ligne 10 fixe l'origine de la page en cours
* Les lignes 11 à 13, ont le même rôle que les lignes 4 à 6, en vue de copier la ligne 13 dans la page Annexe d'un livre. Ces lignes n’apparaîtront pas lors de la publication de la page source <nowiki>{{PAGENAME}}</nowiki>.
<pre style="color:black;background-color:#FFE;">
14
15 '''''Sources des articles :''''' <br />
16 <noinclude>{{Orange|Partie destinée à la création du fichier sclti.<br />}}
17 {{#ifexist:{{BASEPAGENAME}}/Contenu|
18 {{Canonicalurl:{{BASEPAGENAME}}/Contenu}}|
19 {{Canonicalurl:{{BASEPAGENAME}}}}
20 }}</noinclude>
21 quasi
22 '''''Article : ''{{BASEPAGENAME}}'''<br />
23 ''Source : ''{{Vert|Prévisualiser, copier le lien ci-dessus, le coller ici (remplacer ce texte vert)}},
24 ''Licence : ''{{Vert|Suggestion : Creative Commons Attribution-Share Alike 3.0}},
25 ''Contributeurs : ''{{Vert|Liste des auteurs}},
26 ''Page : ''{{Vert|Numéro de page dans l'article}}.
27 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
28 /*3
29 {{Vert|Prévisualiser, copier le bloc de lignes ci-dessus, les coller ici.}}*/</noinclude>
</pre>
* La ligne 15 définit une sous-section de la section ''Sources et contributeurs des articles''
* {{orange|Les lignes 16 à 20 sont cachée lors de la publication. Ces lignes sont précisées à l'attention de l'éditeur de la sous-page sclti.}}
* {{orange|La ligne 17 permet de savoir si il s'agit d'un article composé de plusieurs articles, voire d'un livre : <br />'''Si il existe une sous page ''Contenu'' d'une page de base''' c'est que la page est composée d'articles et que le la liste des articles est donnée dans la page de contenu, (tout au moins dans la série des articles de la goélette Cardabela) et si il s'agit d'un article composé <br />'''alors : '''la ligne 18 affiche le lien complet (l'URL canonique) de la page de contenu, <br />'''sinon : '''la ligne 19 affiche le lien complet (l'URL canonique) de la page de base.}}
* La ligne 22 Nous examinons ici le cas d'un article non composé ni d'un livre. Il nous suffira donc de nommer la page de base.
* La ligne 23 Copier l'adresse canonique (voir : ligne 18 et 19) de l'article après Source :
* La ligne 24 Lors de l'impression d'un article, à la dernière page une licence est précisée et on peut s'en inspirer (Exemple) :
Récupérée de « https://fr.wikibooks.org/w/index.php?title=Goélette_Cardabela/Après/La_cuisine_à_bord&oldid=608272 »
La dernière modification de cette page a été faite le 24 novembre 2018 à 11:55.<br />
Les textes sont disponibles sous licence Creative Commons attribution partage à l’identique ; d’autres termes peuvent s’appliquer.
Voyez les termes d’utilisation pour plus de détails.
* La ligne 25
'''Les auteurs - contributeurs de la page : '''Voyez l'historique de la page. On trouve les noms des contributeurs dans ''Outils externes et statistiques :''.
Copier et coller dans votre page : <nowiki>https://xtools.wmflabs.org/articleinfo/fr.wikibooks.org/{{PAGENAMEE}}</nowiki>
{{Orange|Notez qu'il sagit bien de <nowiki>{{PAGENAMEE}}</nowiki> et non de <nowiki>{{PAGENAME}}</nowiki>}}
Pour la page actuelle on obtient :
https://xtools.wmflabs.org/articleinfo/fr.wikibooks.org/Go%C3%A9lette_Cardabela/R%C3%A9f%C3%A9rences
* Les lignes 26 à 29 servent comme précédemment à la création de la page Annexe
 
Les lignes 31 à 46 peuvent être supprimées si il n'y a pas d'image dans l'article.<br />
Ci-dessous les lignes sont prévues pour deux images. <br />
Il suffit de copier les lignes 33 à 37 et de les coller à la suite pour les images supplémentaires.
Pour remplir ces lignes il faut cliquer sur les images et noter les Titre, Lien, Licence, Auteur(s) et, à la condition que les numéros de pages soient présents, de repérer le numéro de la page PDF où elles apparaissent, sinon laisser vide.
<pre style="color:black;background-color:#FFE;">
30
31 == Source des images, licences et contributeurs ==
32 '''''Article : ''{{BASEPAGENAME}}'''<br />
33 '''Image 1 : {{Vert|Titre}}''',
34 ''Source : ''{{Vert|Lien}},
35 ''Licence : ''{{Vert|Licence}},
36 ''Contributeurs : ''{{Vert|Liste}},
37 ''Page : ''{{Vert|Numéro de la page où se trouve l'image}}.
38
39 '''Image 2 : {{Vert|Titre}}''',
40 ''Source : ''{{Vert|Lien}},
41 ''Licence : ''{{Vert|Licence}},
42 ''Contributeurs : ''{{Vert|Liste}},
43 ''Page : ''{{Vert|Numéro de la page où se trouve l'image}}.
44 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
45 /*4
46 {{Vert|Prévisualiser, copier le bloc de lignes ci-dessus, les coller ici.}}*/</noinclude>
</pre>
* Ligne 46 Éditer et copier puis coller dans le code Wiki. Cela nécessite d'avoir deux fenêtres d'édition dans le navigateur.
<pre style="color:black;background-color:#FFE;">
47
48 {{Nouvelle page imprimée}}
49 == Licence ==
50 '''''Article : ''{{BASEPAGENAME}}'''<br />
51 {{Vert|Suggestion : Creative Commons Attribution-Share Alike 3.0<br />//creativecommons.org/licenses/by-sa/3.0/}}
52 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
53 /*5
54 {{Vert|Prévisualiser, copier les lignes ci-dessus, les coller ici.}}*/</noinclude>
</pre>
* Ligne 54 Éditer et copier puis coller dans le code Wiki. Cela nécessite d'avoir deux fenêtres d'édition dans le navigateur.
<pre style="color:black;background-color:#FFE;">
55
56 {{Nouvelle page imprimée}}
Il est possible que la sous-page Sommaire n'ait pas été créée, auquel cas on peut copier le sommaire qui est créé automatiquement.<br />
On peut forcer la création d'un sommaire avec le mot magique __TOC__, au moins provisoirement, pour en recopier le bloc.
57 = Index =
58 {{#ifexist:{{BASEPAGENAME}}/Sommaire|'''''Article : ''{{BASEPAGENAME}}'''<br />{{:{{BASEPAGENAME}}/Sommaire}}|
59 <noinclude>{{Rouge|La page « {{BASEPAGENAME}}/Sommaire » n'est pas trouvée.}}
60 __TOC__</noinclude>}}
61 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
62 /*6
63 {{Vert|Prévisualiser, copier le bloc de lignes ci-dessus, les coller ici.}}*/</noinclude>
</pre>
{{Boîte déroulante fin}}
 
=== Utiliser le canevas SCLTI ===
Le {{75}}[[Goélette_Cardabela/Références/Canevas_SCLTI|''Canevas_SCLTI'']] permet de créer une section ou une sous-page SCLTI non imprimable d'un livre qui sera transformé en '''Annexe''' imprimable.
{{Boîte déroulante début|titre={{75}}Utiliser le canevas SCLTI|styleFrame=width:100%;|fondtitre=#F0FFFF<!--|styleTitre=color:white;<!|style=headerbleu-->}}
'''Exemples de sous-pages :'''<br />
Exemple de sous-page de travail SCLTI : <br />[[Goélette_Cardabela/Collection_des_livrets_techniques_de_la_goélette_Cardabela/SCLTI]]<br />
Exemple de sous-page finale Annexe obtenue : <br />[[Goélette_Cardabela/Collection_des_livrets_techniques_de_la_goélette_Cardabela/Annexe]]
 
'''Avertissement Pour utiliser ce canevas :''' Il faut disposer de la liste les articles du livre. Cette liste peut être trouvée dans une sous-page du livre. <br />La sous page peut être nommée '''Contenu ou Sommaire'''. <br />Si elle n'existe pas il faut la créer : '''<nowiki>{{:{{PAGENAME}}/Contenu}}</nowiki>''' On y écrira ligne par ligne, la liste des sous-pages ou des articles qui composent le livre.
 
'''La procédure''' consiste à [[wikt:transclure|''transclure'']] la sous-page SCLTI en bas-de-page de l'article <nowiki>{{PAGENAME}}</nowiki> : <br />
# Copier : '''<nowiki>{{:{{PAGENAME}}/SCLTI}}</nowiki>''' et coller la copie en bas-de-page de la version ''Livre'' ou de la ''Version imprimable''. Le lien doit apparaître en rouge à la prévisualisation si il n'est pas déjà créé.
# Cliquer sur le lien en rouge pour créer la page <nowiki>{{PAGENAME}}/SCLTI</nowiki>
# Éditer la page [https://fr.wikibooks.org/w/index.php?title=Go%C3%A9lette_Cardabela/R%C3%A9f%C3%A9rences/Canevas_sclti&action=edit '''Canevas_SCLTI'''] ''(Cliquer sur ce lien)''
# Créer la sous-page SCLTI après y avoir copié le code wiki du canevas
 
'''Remarque''' :
Il est possible de créer directement la sous-page Annexe
 
'''Description de la page ou de la section créée''' :<br />
Lignes 10 à 16 du canevas :
<pre style="color:black;background-color:#FFE;">
10 /*A
11 = Annexe =
12 == Références ==
13 <references />
14 <br /> */
15 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
16 /*1
17 {{Vert|Prévisualiser, copier les références ci-dessus, les coller ici (remplacer ce texte vert).}}*/</noinclude>
</pre>
* Les lignes 10 à 14 sont destinées à être recopiées dans la page Annexe avec la commande "mkd -Ctw A <nom du fichier.SCLTI> Annexe.txt"
* La ligne 11 est la tête du chapitre (Annexe)
* La ligne 12 est la première section (Références)
* La ligne 13 place la balise <references /> en dessous de laquelle viendront se placer automatiquement les références qui n'ont pas été prises en compte dans l'article <nowiki>{{PAGENAME}}</nowiki>, volontairement ou non. On peut y ajouter d'autres références.
* Les lignes 14 à 16 sont réservées à la recopie des lignes qui apparaissent sous la balise <references />. Ces lignes entre les balises <noinclude></noinclude> n'apparaîtront pas dans la publication de la page source <nowiki>{{PAGENAME}}</nowiki>.
* La ligne 16 pourra être copiée dans la section Annexe d'un livre avec la commande [[w:mkd (commande unix)|mkd]].
 
<pre style="color:black;background-color:#FFE;">
18
19 /*B
20 {{Nouvelle page imprimée}}
21 == Sources et contributeurs des articles ==
22 <small>Les sources listées pour chaque article fournissent des informations de licence plus détaillées, y compris le statut des droits d'auteur, les détenteurs de ces droits et les conditions de licence.</small><br />
23 '''''Source de cette édition : '''''<br /><small>{{Canonicalurl:{{PAGENAME}}}}</small> */
24 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
25 /*2
26 <small>{{Vert|Prévisualiser, copier le lien ci-dessus, le coller ici (remplacer ce texte vert).}}</small><br />*/</noinclude>
27
28 /*C
29 '''''Sources des articles :'''''<br /> */
30 <div class="noprint">{{Orange|... introduire ici la liste des sources et compléter avec le nom des Contributeurs et les Licences des Sources.}}
31 <small>
32 {{#ifexist:{{BASEPAGENAME}}/Contenu|{{BASEPAGENAME}}/Contenu
33 |{{#ifexist:{{BASEPAGENAME}}/Sommaire|{{BASEPAGENAME}}/Sommaire
34 |{{Rouge|La liste des article n'est pas trouvée. Introduire la liste manuellement ou créer la sous-page {{BASEPAGENAME}}/Contenu}}}}}}</small>
35 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
36 /*3
37 <small><small>{{Vert|Prévisualiser, copier le bloc ci-dessus, le coller ici (remplacer ce texte vert).}}</small></small><br />*/</noinclude>
</pre>
 
<pre style="color:black;background-color:#FFE;">
38
39 /*D
40 {{Nouvelle page imprimée}}
41 == Source des images, licences et contributeurs ==
42 <small>Les sources listées pour chaque image fournissent des informations de licence plus détaillées, y compris le statut des droits d'auteur, les détenteurs de ces droits et les conditions de licence.</small> */
43 <div class="noprint">{{Orange|... introduire ici la liste des sources avec Contributeurs et les Licences des images.}}
44 <small>
45{{#ifexist:{{BASEPAGENAME}}/Contenu|{{BASEPAGENAME}}/Contenu
46 |{{#ifexist:{{BASEPAGENAME}}/Sommaire|{{BASEPAGENAME}}/Sommaire
47 |{{Rouge|La liste des article n'est pas trouvée. Introduire la liste manuellement ou créer la sous-page {{BASEPAGENAME}}/Contenu}}}}}}</small>
48 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
49 /*3
50 <small><small>{{Vert|Prévisualiser, copier le bloc ci-dessus, le coller ici (remplacer ce texte vert).}}</small></small><br />*/</noinclude>
</pre>
 
<pre style="color:black;background-color:#FFE;">
51
52 /*E
53 == Licence ==
54 <small>Creative Commons Attribution-Share Alike 3.0<br />
55 //creativecommons.org/licenses/by-sa/3.0/</small> */
</pre>
 
<pre style="color:black;background-color:#FFE;">
56
57 /*F
58 == Index == */
59 <div class="noprint">{{Orange|... introduire ici la liste des ''Sommaires'' des articles.}}
60<small>
61 {{#ifexist:{{BASEPAGENAME}}/Contenu|{{BASEPAGENAME}}/Contenu
62 |{{#ifexist:{{BASEPAGENAME}}/Sommaire|{{BASEPAGENAME}}/Sommaire
63 |{{Rouge|La liste des article n'est pas trouvée. Introduire la liste manuellement ou créer la sous-page {{BASEPAGENAME}}/Contenu}}}}}}</small>
64 <noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
65 /*4
66 <small><small>{{Vert|Prévisualiser, copier le bloc ci-dessus, le coller ici (remplacer ce texte vert).}}</small></small><br />*/</noinclude>
67
68
69</small></small>
70
</pre>
{{Boîte déroulante fin}}
 
=== Copier les résultats dans la page Annexe ===
 
 
=== Exemple dans l'espace de noms ''Utilisateur'' ===
{{Boîte déroulante début|titre={{75}}Exemple de documentation manuelle dans l'espace de noms ''Utilisateur''|styleFrame=width:100%;|fondtitre=#F0FFFF<!--|styleTitre=color:white;<!|style=headerbleu-->}}
==== Créer un livre et sa documentation ====
La documentation : s'entend « ''La page Annexe du livre'' »
 
[[Wikilivres:Bac_à_sable]] est communautaire et ne convient pas pour cet exercice qui doit avoir un minimum de pérennité.
 
 
==== Bac à sable personnel pour les essais ====
Si vous ne l'avez pas déjà fait créez votre « bac à sable » voir : [[Wikilivres/Créer_un_compte_utilisateur]]
 
: Créez et éditez votre page Utilisateur:<Votre pseudo>/Sandbox (Sandbox peut aussi s'appeler ''Bac_à_sable''
 
 
==== Notion d'espace de noms ====
Documentation : https://www.mediawiki.org/wiki/Help:Magic_words/fr
 
La préservation des pages Wiki fonctionne en nuage qui permet un accès rapide aux fichiers. Il y a {{NUMBEROFPAGES}} pages sur ce wiki et {{NUMBEROFARTICLES}} articles.
 
Toutes les pages sont au même niveau et l'utilisation de la barre oblique '/' peut faire croire à un répertoire racine avec avec des sous-répertoires. La barre oblique est un choix qui peut être remplacé par d'autres caractères comme le tiret '-' ou le point '.' etc.
 
À l'intérieur de ce nuage il y a les espaces de noms : Utilisateur, Modèle, Aide, etc.<br />
Ces espaces de nom sont tous au même niveau que les pages c'est à dire sous la racine wiki/
 
Si on ne connaît pas bien son fonctionnement on peu faire des erreurs parfois difficiles à interpréter.
 
Lorsque l'on est '''dans l'espace de noms Utilisateur''' on peut être tenté de créer une sous page ainsi :
: <nowiki>{{PAGENAME}}/NouvellePage</nowiki>
: ''<nowiki>{{PAGENAME}}</nowiki> est le titre complet de la page (incluant tous les niveaux des sous-pages) '''sans l'espace de noms.'''''
'''''Cette page ne sera pas créée dans l'espace de noms Utilisateur''''' mais dans l'espace de noms ''principal'', à la racine du Wiki<br />Pour que la NouvellePage soit créée dans l'espace de noms Utilisateur il faut écrire :
: <nowiki>{{NAMESPACE}}:{{PAGENAME}}/NouvellePage</nowiki>
: On peut aussi écrire :
: <nowiki>{{FULLPAGENAME}}/NouvellePage</nowiki>
 
'''''Cette page sera créée dans l'espace de noms racine incluant tous les niveaux des sous-pages''''' mais cette fois '''''avec l'espace de noms.'''''
 
Pour bien comprendre, éditez cette section. Copiez le bloc ci-dessous et collez-le dans une page en mode édition de votre espace personnel et prévisualisez.<br />
Sans soulignements : (Notez que l'espace racine est une chaîne vide.)
<nowiki>{{PAGENAME}}</nowiki> = {{PAGENAME}}
<nowiki>{{BASEPAGENAME}}</nowiki> = {{BASEPAGENAME}}
<nowiki>{{SUBPAGENAME}}</nowiki> = {{SUBPAGENAME}}
<nowiki>{{NAMESPACE}}</nowiki> = {{NAMESPACE}}
<nowiki>{{NAMESPACE}}:{{PAGENAME}}</nowiki> = {{NAMESPACE}}:{{PAGENAME}}
<nowiki>{{FULLPAGENAME}}</nowiki> = {{FULLPAGENAME}}
<nowiki>{{TALKPAGENAME}}</nowiki> = {{TALKPAGENAME}}
<nowiki>{{ROOTPAGENAME}}</nowiki> = {{ROOTPAGENAME}}
Avec des soulignements :
<nowiki>{{PAGENAMEE}}</nowiki> = {{PAGENAMEE}}
<nowiki>{{FULLPAGENAMEE}}</nowiki> = {{FULLPAGENAMEE}}
 
Exemple : [[Utilisateur:Goelette_Cardabela/Sandbox#Tests_de_l'espace_de_noms_Utilisateur]]
 
 
==== Créer le livre avec trois Articles et trois chapitres par article ====
Vous allez créer un Livre simple contenant trois Articles avec des images. <br />
La page principale sera automatiquement catégorisée dans la catégorie cachée : ''Pages_non_indexées'' grâce au mot magique <nowiki>__NOINDEX__</nowiki>
: Pour une meilleure compréhension évitez les modèles <nowiki>{{Livre}} et {{Sommaire}}</nowiki> pour cette fois.
: En mode édition de votre page ''Sandbox'' collez les blocs suivants et supprimez les éventuelles balises "pre" du premier bloc.
<pre>
__NOINDEX__
Utilisateur:<Votre pseudo>/Sandbox/LivreTest<br />
Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleUn<br />
Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleDeux<br />
Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleTrois<br />
Utilisateur:<Votre pseudo>/Sandbox/LivreTest/Contenu<br />
Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleUn/Sommaire<br />
Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleDeux/Sommaire<br />
L'Article trois est sans sous-page Sommaire.
</pre>
 
La page Utilisateur:<Votre pseudo>/Sandbox/LivreTest/Contenu doit contenir le nom des Articles sur trois lignes
<pre>
[[Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleUn|ArticleUn]]<br />
[[Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleDeux|ArticleDeux]]<br />
[[Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleTrois|ArticleTrois]]
</pre>
<pre>[[Utilisateur:<Votre pseudo>/Sandbox/LivreTest/Contenu]]</pre>
 
<pre>La page Utilisateur:<Votre pseudo>/Sandbox/LivreTest/ArticleUn peut contenir plusieurs chapitres :
== Chapitre 1 ==
== Chapitre 2 ==
== Chapitre 3 ==
Le Sommaire de cet Article doit contenir les titres des chapitres</pre>
 
On fait la même chose avec l'ArticleDeux et avec l'ArticleTrois dans lesquels on ajoutera des images.
 
On a déjà un livre conséquent pour faire nos essais.
 
Voir l'exemple [[Utilisateur:Goelette_Cardabela/Sandbox]]
 
 
==== Documentation manuelle ====
Nous allons copier le [[Goélette_Cardabela/Références/Canevas_SCLTI|''Canevas_SCLTI'']] à la fin du livre « LivreTest ».<br />Cette solution est très pratique pour éviter de créer la sous-page SCLTI ou Annexe, mais a l'inconvénient de ne pas tenir compte des directives de transclusions <noinclude> </noinclude>.
: [[Utilisateur:<Votre pseudo>/Sandbox/LivreTest]]
: Exemple : [[Utilisateur:Goelette Cardabela/Sandbox/LivreTest]]
 
: À ce point il n'est pas nécessaire de copier les champs de texte dans les espaces réservé à la documentation automatique (Les champs de couleur verte).
 
Nous allons créer la sous page ''Annexe''
[[Utilisateur:<votre pseudo>/Sandbox/LivreTest/Annexe]]
: Exemple : [[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/Annexe]]
 
Première solution : Éditer et prévisualiser la section Annexe du livre ''LivreTest''
: Copier la prévisualisation dans la sous-page Annexe.
: Le texte est maintenant pur, délivré des liens de construction.
: Rétablir la forme Wiki de la sous page avec les balises de titre et de sous titre, les retour chariots les numéros de pages manquants etc.
 
Deuxième solution : Copier la section éditée avec tous les codes Wiki et faire le tri ...
 
On peut maintenant créer la version imprimable de LivreTest et supprimer la section de construction de la page principale du livre.
: Exemple : [[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/Version imprimable]]
 
{{Boîte déroulante fin}}
{{Boîte déroulante fin}}
 
= Référencement semi automatique =