|
= Référencement semi automatique =
{{Boîte déroulante début|titre=:{{75BASEPAGENAME}}/Référencement semi automatique|styleFrame=width:100%;|fondtitre=#F0F0F0<!--|styleTitre=color:white;<!|style=headerbleu-->}}
== Les fichiers de commandes ==
Les fichiers de commandes servent à automatiser la création des fichiers ''Annexe.doc'' des livres.
Ces fichiers seront recopiés sous formes de pages ou de sous-pages dans l'environnement Wiki
=== Où trouver la documentation des fichiers de commandes ===
{{Boîte déroulante début|titre=Où trouver la documentation des fichiers de commandes|styleFrame=width:100%;|fondtitre=#FFFFF0<!--|styleTitre=color:white;<!|style=headerbleu-->}}
<small>
;Où trouver la commande mkd ? : Sur le serveur de l'EELL : ftp://91.162.11.71:44227/pub<br />Sur wikilivres : [[Mkd_(Extracteur_de_documents)|mkd (extracteur de documents)]] Documentation complète.
;Où trouver les commandes batch : Sur Wikipedia : [[w:Commande_DOS|Liste des commandes DOS]]<br />Sur wikilivres : [[DOS]]
;Où trouver les commandes PowerShell (Windows 10): Sur wikipedia : [[w:Windows_PowerShell|PowerShell]]<br />Sur wikilivres : [[Programmation PowerShell]] [[Wikilivres:Niveaux_généraux|''Livre de niveau 12'']]
;Où trouver les commandes Shell : Sur Wikipedia : [[w:Shell_Unix|Shell]] - [[w:Tcsh|Tcsh et Mas OS]]
;Où trouver les commandes Bash : Sur wikipedia : [[w:Bourne-Again_shell|bash]] <br />Sur Wikilivres : [[Programmation_Bash|Programmation Bash]]
;Où trouver un comparatif entre ces langages en lignes de commandes : [[Windows_PowerShell#Comparaison_du_langage_PowerShell_et_des_langages_de_script_UNIX|Comparaison du langage PowerShell et des langages de script UNIX]]
;Installation de ''electron-render-service'' dans le système d'exploitation Debian : Simple PDF/PNG/JPEG render service, accepts webpage URL and returns the resource.<br />''Malheureusement ce service n’inclut pas la numérotation des pages PDF.''<br />''Les pages Wiki incluent le service de création de fichiers PDF avec les liens internet dans le menu ''{{Bleu|Télécharger comme PDF}}.<br />https://github.com/wikimedia/mediawiki-services-electron-render/blob/master/README.md
</small>
{{Boîte déroulante fin}}
{{Nouvelle page imprimée}}
=== Aperçu explicatif des fichiers de commandes ===
{{Boîte déroulante début|titre=Aperçu explicatif des fichiers de commandes|styleFrame=width:100%;|fondtitre=#FFF0FF<!--|styleTitre=color:white;<!|style=headerbleu-->}}
Ces fichiers en tests permettent d'évaluer la possibilité de créer des fichiers intermédiaires ''sclti'' :
: De quelle manière on crée la structure de ces fichiers et comment on en extrait la documentation finale.
Pour comparer les les commandes des fichiers ci-dessous, consulter la [[w:Windows_PowerShell#Comparaison_du_langage_PowerShell_et_des_langages_de_script_UNIX|Liste des commandes PowerShell, DOS et UNIX/Linux]]
{{Orange|Remarquer que l'on obtient les mêmes résultats avec les trois fichiers de commandes ''DOS, PoweShell'' testés sous Windows 10 et sous'' Linux'' testé avec Fedora et Ubuntu.}}
On verra par la suite que les commandes utilisées dans ces fichiers ne sont pas tout à fait équivalentes. <br />- ''PowerShell'' est plus sécurisé mais plus compliqué à utiliser, il est par exemple nécessaire de créer une session DOS pour lancer mkd qui n'est pas un membre de PowerShell. <br />- ''MS DOS'' a une liste de commandes plus réduite. <br />D'ores et déjà après ces premiers tests il semble que les shells ''UNIX/Linux'' nous permettront de créer des fichiers de commandes plus complets et plus faciles à utiliser.
{{Orange|Ceci est une première évaluation. Si nous ne parvenons pas à créer des fichiers de commandes acceptables il nous restera la possibilité d'arriver à nos fins par la programmation.}}
==== Fichier de première évaluation avec les commandes DOS de Windows ====
<small><small>
;Exemple :
<syntaxhighlight lang ="dos" style="border:1px solid blue;background-color:#EFF;">
cls
@echo off
@echo Ce fichier de commandes tests-1.bat est un fichier de tests
@rem fond noir=1, texte jaune=7
@color 1E
@echo "tests"
@echo = Annexe = > Annexe.txt
@echo /*1 >> Annexe.txt
@echo Blabla */ >> Annexe.txt
@echo .
@echo Contenu du fichier cree : Annexe.txt :
@echo ----
@type Annexe.txt
@echo ----
@rem
@rem mkd extrait le bloc 1 de annexe.txt au format
@rem langage c (directive C)
@rem texte seul (option t), et
@rem force (option w) l'écriture dans Annexe.doc
@mkd -Cwt 1 Annexe.txt Annexe.doc
@echo .
@echo Contenu du fichier Annexe.doc après extraction par la Commande DOS mkd.exe :
@echo ----
@type Annexe.doc
@echo ----
@rem
@pause "Retour chariot pour quitter"
exit
</syntaxhighlight>Résultat :<br />
'''Création''' du fichier Annexe.txt : La couleur du texte est jaune sur fond noir (Color 1E). Les couleurs sont modifiées ici pour ne pas saturer l'imprimante avec le fond noir.
<pre style="color:black;background-color:#EFF;">
= Annexe =
/*1
Blabla */
</pre>
'''Extraction''' du Fichier Annexe.doc avec mkd :
<pre style="color:black;background-color:#EFF;">
Blabla
</pre>
</small></small>
==== Fichier de première évaluation avec les commandes PowerShell ====
<small><small>
<source lang="powershell" style="border:1px solid blue;background-color:#FEF;">
cls
echo "Ce fichier de commandes tests-1.ps1 est un fichier de tests"
#
echo "= Annexe =" > Annexe.txt
echo "/*1" >> Annexe.txt
echo "Blabla */" >> Annexe.txt
#
echo "Contenu du fichier créé : Annexe.txt :"
echo "----"
Cat Annexe.txt
echo "----"
# "mkd extrait le bloc 1 de annexe.txt au format"
# "langage c (directive C)"
# "texte seul (option t), et"
# "force (option w) l'écriture dans Annexe.doc"
Start-Process cmd
".\mkd.exe -Cwt 1 Annexe.txt Annexe.doc"
#
echo " Contenu du fichier Annexe.doc après extraction par la Commande DOS mkd.exe :"
echo "----"
Cat Annexe.doc
echo "----"
# Il ne faut arrêter le process cmd qu'après exécution complète des commandes DOS.
Pause
Get-Process cmd | Stop-Process
echo "Retour chariot pour quitter"
</source></small></small>
==== Fichier de première évaluation avec les commandes Unix - Linux ====
<small><small>
{{Orange|Remarque: Permettre l'exécution du fichier de commande. (sudo chmod 777 ./tests-1.bash)}}
<source lang="bash" style="border:1px solid blue;background-color:#FFE;">
#!/bin/bash
# Ce fichier de commandes tests-1.bash est un fichier de tests
clear
echo "tests"
echo "= Annexe =" > Annexe.txt
echo "/*1 " >> Annexe.txt
echo "Blabla */" >> Annexe.txt
#
echo "Contenu du fichier créé : Annexe.txt :"
echo "----"
cat Annexe.txt
echo "----"
#
mkd -Cwt 1 Annexe.txt Annexe.doc
#
echo " Contenu du fichier Annexe.doc après extraction par la commande Linux mkd :"
echo "----"
cat Annexe.doc
echo "----"
#
read -p "Appuyer sur une touche pour continuer ..."
</source></small></small>
{{Boîte déroulante fin}}
=== Commuer la section concaténée ou la sous-page ''SCLTI'' en sous-page ''Annexe'' ===
{{Boîte déroulante début|titre=SCLTI vers Annexe|styleFrame=width:100%;|fondtitre=#F0FFFF<!--|styleTitre=color:white;<!|style=headerbleu-->}}
'''Remarques : '''<br />
L' ''Annexe'' d'un livre peut être ajoutée à la fin d'une ''Version imprimable'' du livre. Elle est généralement créée sous forme de sous-page Annexe du livre.
Il est à noter que les livres compilés ont une page ''Annexe'' et une page de ''Contenu'' créées par le compilateur. <br />Par conséquent il est inutile d'ajouter la ''sous-page Contenu'' et la ''sous-page Annexe'' à la compilation, d'où aussi l'intérêt de créer des sous-pages de livres.
La sous-page Annexe est inclue dans les sections de la sous-page SCLTI. <br />Par conséquent, on peut créer la sous-page Annexe en lieu et place de la sous-page SCLTI avec l'inconvénient d'avoir des difficultés pour réécrire cette page après les éventuelles modifications de la composition du livre.
{{Orange|Note importante : On peut se dispenser de procéder à cette transformation si la sous-page Annexe ne doit pas être imprimée. Certains caractères contenus dans les Sommaires peuvent être mal formatées pour l'impression :<br /><nowiki>Les lignes qui commencent par ';' ou ':' ou '#', les parties de texte entre <pre> et </pre> ou entre <poem> et </poem> etc.</nowiki>}}
'''Préparation à l'extraction par des commandes extérieures : '''<br />
La sous-page SCLTI est composée de parties repérées pour être extraites par un extracteur de documents.
Les repères de chaînes de caractères sont de la forme /*A ou 1 ou B etc. et se termine par */
Ces repères sont les repères d'usage pour les commentaires en langage C
L'extracteur de document extrait le contenus qui se trouve entre ces repères.
Il est nécessaire de :
# Surligner et copier le texte contenant les repères et de coller ce texte dans un éditeur de texte (Notepad, Bluefish, etc..)
# Enregistrer ce texte au format texte avec un nom qui ne soit pas Annexe.doc
# Si vous ne l'avez pas encore installé, télécharger la commande mkd pour Windows ou pour Linux : [[Goélette_Cardabela/Références#Où_trouver_la_documentation_des_fichiers_de_commandes]]
; Exemple de concaténation de Canevas_SCLTI à la fin d'un livre : [[Utilisateur:Goelette_Cardabela/Sandbox#Créer_le_livre_avec_trois_Articles_et_trois_chapitres_par_article]]
==== Code pour l'extraction ====
<syntaxhighlight lang="Bash">
#!/bin/bash
echo "Ce fichier de commandes SCLTI2Annexe.bash est un fichier d'extraction de la documentation des livres."
echo " "
echo "Le fichier de commandes "$0" doit être en mode lecture, écriture et exécution : Commande : chmod 777 "$0
echo " "
echo "Le fichier (Argument "$1") en lecture est un fichier texte, copie de la dernière partie de l'édition du livre, la section SCLTI ajoutée."
read -p "Appuyer sur une touche pour continuer ..."
clear
echo "tests de : "$0
echo "Argument : "$1
echo "{{#ifeq:{{SUBPAGENAME}}|Version imprimable||= Annexe =}}" > Annexe.doc
echo "== Références ==" >> Annexe.doc
echo "{{#ifeq:{{SUBPAGENAME}}|Version imprimable|<references />|" >> Annexe.doc
mkd -Cta 1 $1 Annexe.doc
echo "}}" >> Annexe.doc
echo "{{Nouvelle page imprimée}}" >> Annexe.doc
echo "== Sources et contributeurs des articles ==" >> Annexe.doc
echo "'''''Source de cette édition : <br />" >> Annexe.doc
mkd -Cta 2 $1 Annexe.doc
echo "'''''Sources des articles :''''' <br />" >> Annexe.doc
mkd -Cta 3 $1 Annexe.doc
echo "{{Nouvelle page imprimée}}" >> Annexe.doc
echo "== Source des images, licences et contributeurs ==" >> Annexe.doc
mkd -Cta 4 $1 Annexe.doc
echo "{{Nouvelle page imprimée}}" >> Annexe.doc
echo "== Licence ==" >> Annexe.doc
mkd -Cta 5 $1 Annexe.doc
echo "{{Nouvelle page imprimée}}" >> Annexe.doc
echo "= Index =" >> Annexe.doc
mkd -Cta 6 $1 Annexe.doc
echo "#####################################################"
echo "# Résultat de l'extraction dans le fichier Annexe.doc"
echo "#####################################################"
</syntaxhighlight>
==== Fichier texte en lecture LivreTest.txt ====
Extrait de la section SCLTI ou Annexe ajoutée à la fin du livre :
<pre style="color:black;background-color:#EFF;">
= Annexe =
== Références ==
<references />
<noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
/*1
https://fr.wikivoyage.org/wiki/Carthagène des Indes. (Colombie)<br />
https://fr.wikivoyage.org/wiki/Leticia et Tabatinga<br />
https://fr.wikipedia.org/wiki/Fernando_Botero */</noinclude>
{{Nouvelle page imprimée}}
== Sources et contributeurs des articles ==
'''''Source de cette édition : <br />'''''{{Canonicalurl:{{FULLPAGENAME}}}}
<noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
/*2
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest */</noinclude>
'''''Sources des articles :''''' <br />
<noinclude>{{Orange|Partie destinée à la création du fichier sclti. Le '''Nom du premier article''' est la première ligne, etc.<br />}}
{{#ifexist:{{FULLPAGENAME}}/Contenu|
{{:{{FULLPAGENAME}}/Contenu}}|
{{Rouge|La page {{FULLPAGENAME}}/Contenu n'est pas trouvée.}}
}}</noinclude>
'''{{FULLPAGENAME}}/ArticleUn'''<br />
''Source : ''{{canonicalurl:{{FULLPAGENAME}}/ArticleUn}},<br />
/*3
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleUn''',
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleUn,
''Licence : ''Creative Commons Attribution-Share Alike 3.0,
''Contributeurs : ''Goelette Cardabela},
''Page : ''{{Vert|Numéro de page dans l'article}}. */
'''{{FULLPAGENAME}}/ArticleDeux'''<br />
''Source : ''{{canonicalurl:{{FULLPAGENAME}}/ArticleDeux}},<br />
/*3
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleDeux''',
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleDeux,
''Licence : ''Creative Commons Attribution-Share Alike 3.0,
''Contributeurs : ''Goelette Cardabela,
''Page : ''{{Vert|Numéro de page dans l'article}}. */
'''{{FULLPAGENAME}}/ArticleTrois'''<br />
''Source : ''{{canonicalurl:{{FULLPAGENAME}}/ArticleTrois}},<br />
/*3
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleTrois''',
''Source :'' https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleTrois
''Licence : ''Creative Commons Attribution-Share Alike 3.0,
''Contributeurs : ''Goelette Cardabela,
''Page : ''{{Vert|Numéro de page dans l'article}}. */
{{Nouvelle page imprimée}}
== Source des images, licences et contributeurs ==
<!--=== A1-i1 ===-->
'''{{FULLPAGENAME}}/ArticleUn'''<br />
''Article : ''{{canonicalurl:{{FULLPAGENAME}}/ArticleUn}},<br />
/*4
''Article : ''Article : https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleUn, */
/*4
'''Image 1 : Gabriel Garcia Marquez - Fresque de Pohline Blast''',
''Source : ''https://commons.wikimedia.org/wiki/File:Gabriel_Garcia_Marquez_-_Fresque.jpg,
''Licence : ''CC BY-SA 4.0,
''Contributeurs : Pohline Blast Clm,
''Page : ''4. */
<!--
'''Image 2 : {{Vert|Titre}}''', ''Source : ''{{Vert|Lien}}, ''Licence : ''{{Vert|Licence}}, ''Contributeurs : ''{{Vert|Liste}}, ''Page : ''{{Vert|Numéro de la page où se trouve l'image}}.
<noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
-->
<!--=== A2-i1 ===-->
'''{{FULLPAGENAME}}/ArticleDeux'''<br />
''Article : ''{{canonicalurl:{{FULLPAGENAME}}/ArticleDeux}},<br />
/*4
''Article : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleDeux, */
/*4
'''Image 1 : Commerce de communautés indigènes''', ''Source : ''https://commons.wikimedia.org/wiki/File:Commerce_de_communaut%C3%A9s_indig%C3%A8nes.JPG, ''Licence : ''CC BY-SA 3.0, ''Contributeurs : ''Goelette.Cardabela, ''Page : 6. */
<!--
'''Image 2 : {{Vert|Titre}}''', ''Source : ''{{Vert|Lien}}, ''Licence : ''{{Vert|Licence}}, ''Contributeurs : ''{{Vert|Liste}}, ''Page : ''{{Vert|Numéro de la page où se trouve l'image}}.
<noinclude>{{Orange|<br />Partie réservée à l'extracteur de documents.<br />}}
-->
<!--=== A3-i1 ===-->
'''{{FULLPAGENAME}}/ArticleTrois'''<br />
''Article : ''{{canonicalurl:{{FULLPAGENAME}}/ArticleTrois}},<br />
/*4
''Article : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleTrois */
/*4
'''Image 1 : Fernando Botero (2018)''',
''Source : ''https://commons.wikimedia.org/wiki/File:Fernando_Botero_(2018).jpg,
''Licence : ''CC BY 4.0,
''Contributeurs : '' Sylvain van Eeckhout
''Détenteur du droit d'auteur : '' Culturespaces,
''Page : ''7. */
<!--=== A3-i2 ===-->
/*4
'''Image 2 : Pano Plazo Botero''', ''Source : ''https://commons.wikimedia.org/wiki/File:Pano_Plazo_Botero.jpg, ''Licence : ''Domaine public, ''Contributeurs : ''Scabredon~commonswiki, ''Page : ''8. */
{{Nouvelle page imprimée}}
== Licence ==
'''''Article : ''{{FULLPAGENAME}}'''<br />
''Source : ''{{canonicalurl:{{FULLPAGENAME}}}},<br />
/*5
'''''Article : ''LivreTest''',
''Source : '' https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest ,
''Licence :'' Creative Commons Attribution-Share Alike 3.0<br />//creativecommons.org/licenses/by-sa/3.0/
''Contributeurs : ''Goelette Cardabela. */
{{Nouvelle page imprimée}}
= Index =
<!-- ... Partie longue suprimée ... -->
/*6
<syntaxhighlight lang="text">
Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleUn
ArticleUn/Sommaire :
Chapitre 1 ''Page : ''...
Chapitre 2 ''Page : ''...
Chapitre 3 ''Page : ''...
Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleDeux
ArticleDeux/Sommaire :
Chapitre 1 ''Page : ''...
Chapitre 2 ''Page : ''...
Chapitre 3 ''Page : ''...
Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleTrois
Table des matières :
Sections
1 Chapitre 1 ''Page : ''...
2 Chapitre 2 ''Page : ''...
3 Chapitre 3 ''Page : ''... */
</syntaxhighlight>
</pre>
==== Page extraite ====
Ce fichier extrait pourra être copié dans la sous-page Annexe du livre.
<pre style="color:black;background-color:#FFE;">
{{#ifeq:{{SUBPAGENAME}}|Version imprimable||= Annexe =}}
== Références ==
{{#ifeq:{{SUBPAGENAME}}|Version imprimable|<references />|
https://fr.wikivoyage.org/wiki/Carthagène des Indes. (Colombie)<br />
https://fr.wikivoyage.org/wiki/Leticia et Tabatinga<br />
https://fr.wikipedia.org/wiki/Fernando_Botero
}}
{{Nouvelle page imprimée}}
== Sources et contributeurs des articles ==
'''''Source de cette édition : <br />
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest
'''''Sources des articles :''''' <br />
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleUn''',
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleUn,
''Licence : ''Creative Commons Attribution-Share Alike 3.0,
''Contributeurs : ''Goelette Cardabela},
''Page : ''{{Vert|Numéro de page dans l'article}}.
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleDeux''',
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleDeux,
''Licence : ''Creative Commons Attribution-Share Alike 3.0,
''Contributeurs : ''Goelette Cardabela,
''Page : ''{{Vert|Numéro de page dans l'article}}.
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleTrois''',
''Source :'' https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleTrois
''Licence : ''Creative Commons Attribution-Share Alike 3.0,
''Contributeurs : ''Goelette Cardabela,
''Page : ''{{Vert|Numéro de page dans l'article}}.
{{Nouvelle page imprimée}}
== Source des images, licences et contributeurs ==
''Article : ''Article : https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleUn,
'''Image 1 : Gabriel Garcia Marquez - Fresque de Pohline Blast''',
''Source : ''https://commons.wikimedia.org/wiki/File:Gabriel_Garcia_Marquez_-_Fresque.jpg,
''Licence : ''CC BY-SA 4.0,
''Contributeurs : Pohline Blast Clm,
''Page : ''4.
''Article : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleDeux,
'''Image 1 : Commerce de communautés indigènes''', ''Source : ''https://commons.wikimedia.org/wiki/File:Commerce_de_communaut%C3%A9s_indig%C3%A8nes.JPG, ''Licence : ''CC BY-SA 3.0, ''Contributeurs : ''Goelette.Cardabela, ''Page : 6.
''Article : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleTrois
'''Image 1 : Fernando Botero (2018)''',
''Source : ''https://commons.wikimedia.org/wiki/File:Fernando_Botero_(2018).jpg,
''Licence : ''CC BY 4.0,
''Contributeurs : '' Sylvain van Eeckhout
''Détenteur du droit d'auteur : '' Culturespaces,
''Page : ''7.
'''Image 2 : Pano Plazo Botero''', ''Source : ''https://commons.wikimedia.org/wiki/File:Pano_Plazo_Botero.jpg, ''Licence : ''Domaine public, ''Contributeurs : ''Scabredon~commonswiki, ''Page : ''8.
{{Nouvelle page imprimée}}
== Licence ==
'''''Article : ''LivreTest''',
''Source : '' https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest ,
''Licence :'' Creative Commons Attribution-Share Alike 3.0<br />//creativecommons.org/licenses/by-sa/3.0/
''Contributeurs : ''Goelette Cardabela.
{{Nouvelle page imprimée}}
= Index =
<syntaxhighlight lang="text">
Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleUn
ArticleUn/Sommaire :
Chapitre 1 ''Page : ''...
Chapitre 2 ''Page : ''...
Chapitre 3 ''Page : ''...
Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleDeux
ArticleDeux/Sommaire :
Chapitre 1 ''Page : ''...
Chapitre 2 ''Page : ''...
Chapitre 3 ''Page : ''...
Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleTrois
Table des matières :
Sections
1 Chapitre 1 ''Page : ''...
2 Chapitre 2 ''Page : ''...
3 Chapitre 3 ''Page : ''...
</pre>
{{Boîte déroulante fin}}
=== Commuer les sous-pages du livre, ''les articles'', en sous-page ''Annexe'' ===
{{Boîte déroulante début|titre=Sous-pages sclti d'articles vers sous-page ''Annexe'' du livre|styleFrame=width:100%;|fondtitre=#F0FFFF<!--|styleTitre=color:white;<!|style=headerbleu-->}}
Un livre est composé de sous-pages aussi appelées ''Articles''.
Il est possible de créer une sous-page sclti de ces articles ou de concaténer le canevas_sclti à la fin de chaque article.
: ''L'avantage de la sous-page sclti est de bénéficier des directives de transclusion ''noinclude'' ''
: ''L'avantage de la section ''Annexe'' avec le ''Canevas_sclti'' concaténé est de conserver la mis en page Wiki.''
; Exemple de concaténations d'articles d'un livre avec le Canevas_sclti : [[Utilisateur:Goelette_Cardabela/Sandbox#Recréer_le_livre_pour_la_version_semi_automatique]]
; Nous allons extraire les informations de la partie concaténée pour créer la sous-page annexe du livre :
: ''Il est à noter qu'après avoir construit la documentation dans la partie concaténée il n'est plus nécessaire qu'elle soit visible dans le livre. On peut la mettre en commentaire sans effet nuisible à l'extraction de la documentation.''
: Il faut recopier dans des fichiers texte la fin des articles auxquels on avait ajouté le canevas sclti. ''Les sections sclti doivent avoir été complétée.''
: Créer un fichier Annexe.pj dans lequel on va ajouter les noms des fichiers recopiés précédemment.
Manuel de la commande mkd : [[Mkd_(Extracteur_de_documents)/mkd-Manuel_(fr)]]
; Exemple de contenu fichier Annexe.pj
<pre>
Carthagène_des_Indes_Colombie.txt
Frontière_triple_au_sud_de_la_Colombie-copie.txt
Medellin_(Colombie).txt
</pre>
; Syntaxe de la ligne de commande :
./LivreTestSA2Annexe.bash Annexe.pj LivreTestSA.sclti
Le fichier LivreTestSA.sclti peut être copié dans la sous-page Annexe du LivreTestSA : LivreTestSA/Annexe
==== Code bash-linux pour l'extraction ====
Adapter ce code pour les autres systèmes d'exploitation Windows, DOS ou Mac.
<syntaxhighlight lang="Bash">
#!/bin/bash
clear
echo "Ce fichier de commandes LivreTestSA2Annexe.bash est un fichier d'extraction de la documentation du livre en test : LivreTestSA."
echo " "
echo "Le fichier de commandes "$0" doit être en mode lecture, écriture et exécution : Commande : chmod 777 "$0
echo " "
echo "Le premier argument "$1" est un fichier texte source."
echo "Le deuxième argument "$2" est le fichier texte cible."
read -p "Appuyer sur une touche pour continuer ..."
clear
echo "Fichier de commandes : "$0
echo "Fichier source : "$1
echo "Fichier cible : "$2
echo "{{#ifeq:{{SUBPAGENAME}}|Version imprimable||= Annexe =}}" > $2
echo "== Références ==" >> $2
echo "{{#ifeq:{{SUBPAGENAME}}|Version imprimable|<references />|" >> $2
mkd -Cajt 1 $1 $2
echo "}}" >> $2
echo "{{Nouvelle page imprimée}}" >> $2
echo "== Sources et contributeurs des articles ==" >> $2
echo "'''''Source de cette édition : <br />" >> $2
mkd -Cajt 2 $1 $2
echo "'''''Sources des articles :''''' <br />" >> $2
mkd -Cajt 3 $1 $2
echo "{{Nouvelle page imprimée}}" >> $2
echo "== Source des images, licences et contributeurs ==" >> $2
mkd -Cajt 4 $1 $2
echo "{{Nouvelle page imprimée}}" >> $2
echo "== Licence ==" >> $2
mkd -Cajt 5 $1 $2
echo "{{Nouvelle page imprimée}}" >> $2
echo "= Index =" >> $2
mkd -Cajt 6 $1 $2
echo "#####################################################"
echo "# Résultat de l'extraction dans le fichier" $2
echo "#####################################################"
</syntaxhighlight>
==== Page extraite ====
Annexe obtenue près quelques corrections peu importantes de mise en forme wiki, dues aux codes des fichiers sources incomplets.
: [[Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Annexe]]
Vous pouvez détecter ces défauts dans le code obtenu non corrigé ci-dessous :
<pre style="color:black;background-color:#FFE;">
{{#ifeq:{{SUBPAGENAME}}|Version imprimable||= Annexe =}}
== Références ==
{{#ifeq:{{SUBPAGENAME}}|Version imprimable|<references />|
https://fr.wikivoyage.org/wiki/Carthagène des Indes. (Colombie)
https://fr.wikivoyage.org/wiki/Leticia et Tabatinga
https://fr.wikipedia.org/wiki/Fernando_Botero
}}
{{Nouvelle page imprimée}}
== Sources et contributeurs des articles ==
'''''Source de cette édition : <br />
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Cartag%C3%A8ne_des_Indes_(Colombie)
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Fronti%C3%A8re_triple_au_sud_de_la_Colombie-copie
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Medellin_(Colombie)
'''''Sources des articles :''''' <br />
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie)'''<br />
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Cartag%C3%A8ne_des_Indes_(Colombie), ''Licence : ''Creative Commons Attribution-Share Alike 3.0, ''Contributeurs : ''Goelette Cardabela, Page : Numéro de page dans l'article.
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Frontière triple au sud de la Colombie-copie'''<br />
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Fronti%C3%A8re_triple_au_sud_de_la_Colombie-copie, ''Licence : ''Creative Commons Attribution-Share Alike 3.0, ''Contributeurs : ''Goelette Cardabela, ''Page : 6.
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Medellin (Colombie)<br />
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Medellin_(Colombie)}}, ''Licence : ''Creative Commons Attribution-Share Alike 3.0, ''Contributeurs : ''Goelette Cardabela, ''Page : ''9.
{{Nouvelle page imprimée}}
== Source des images, licences et contributeurs ==
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie)'''<br />
'''File:Gabriel_Garcia_Marquez_-_Fresque.jpg''', ''Source : ''https://commons.wikimedia.org/wiki/File:Gabriel_Garcia_Marquez_-_Fresque.jpg, ''Licence : ''Pohline Blast Clm [CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0)], de Wikimedia Commons, ''Contributeurs : ''Pohline Blast Clm, Page : Numéro de la page où se trouve l'image.
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Frontière triple au sud de la Colombie-copie'''<br />
'''Image 1 : Commerce_de_communaut%C3%A9s_indig%C3%A8nes''', ''Source : ''https://commons.wikimedia.org/wiki/File:Commerce_de_communaut%C3%A9s_indig%C3%A8nes.JPG, ''Contributeurs et Licence : ''Goelette.Cardabela [CC BY-SA 3.0 (https://creativecommons.org/licenses/by-sa/3.0)], de Wikimedia Commons, ''Page : ''8.
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Medellin (Colombie)'''<br />
'''''Image 1 : ''https://commons.wikimedia.org/wiki/File:Fernando_Botero_(2018).jpg''', ''Source : ''https://upload.wikimedia.org/wikipedia/commons/6/6a/Fernando_Botero_%282018%29.jpg, ''Licence : ''Culturespaces [CC BY 3.0 (https://creativecommons.org/licenses/by/3.0)], via Wikimedia Commons, ''Contributeurs : ''Jan Arkesteijn , ''Page : ''11.
'''''Image 2 : ''File:Pano_Plazo_Botero.jpg''', ''Source : ''https://commons.wikimedia.org/wiki/File:Pano_Plazo_Botero.jpg, ''Licence : ''Public, ''Contributeurs : ''Pas d’auteur lisible par la machine identifié. Scabredon~commonswiki supposé (étant donné la revendication de droit d’auteur). [Public domain], via Wikimedia Commons, ''Page : ''11.
{{Nouvelle page imprimée}}
== Licence ==
'''''Article : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie)'''''<br />
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Cartag%C3%A8ne_des_Indes_(Colombie), ''Licence : ''Creative Commons Attribution-Share Alike 3.0, ''Contributeurs : ''Coelette Cardabela
'''''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Frontière triple au sud de la Colombie-copie'''<br />
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Fronti%C3%A8re_triple_au_sud_de_la_Colombie-copie, ''Licence : ''Creative Commons Attribution-Share Alike 3.0
//creativecommons.org/licenses/by-sa/3.0/, Contributeurs : Goelette Cardabela
''Article : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Medellin (Colombie)<br />
''Source : ''https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTestSA/Medellin_(Colombie), ''Licence : ''Creative Commons Attribution-Share Alike 3.0
//creativecommons.org/licenses/by-sa/3.0/, ''Contributeurs : ''Goelette Cardabela
{{Nouvelle page imprimée}}
= Index =
''Source : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie)/Sommaire<br />
Carthagène ''Page : ''
Gabriel Garcia Marquez ''Page : ''
'''''Source : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Frontière triple au sud de la Colombie-copie/Sommaire'''<br />
Leticia ''Page : ''7.
Le commerce indigène ''Page : ''8.
'''''Source : ''Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Medellin (Colombie)/Sommaire'''<br />
Medellin ''Page : ''10.
Fernando Botero ''Page : ''11.
</pre>
{{Boîte déroulante fin}}
{{Boîte déroulante fin}}
{{Nouvelle page imprimée}}
= Référencement automatique =
{{:{{FULLPAGENAME}}/Référencement automatique}}
| 