# Goélette Cardabela/Référencement semi-automatique
## Sommaire

Les fichiers de commandes
    Où trouver la documentation des fichiers de commandes
    Aperçu explicatif des fichiers de commandes
       Fichier de première évaluation avec les commandes DOS de Windows
       Fichier de première évaluation avec les commandes PowerShell
       Fichier de première évaluation avec les commandes Unix - Linux
    Commuer la section concaténée ou la sous-page SCLTI en sous-page Annexe
       Code pour l'extraction
       Fichier texte en lecture LivreTest.txt
       Page extraite
       Page "Annexe" concaténée telle qu'elle apparaitra
       Présentation_de_la_page_"Annexe"_et_"Index"_finale_

## 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

Où trouver la documentation des fichiers de commandes

#### Où trouver la commande mkd ?

    Sur le serveur de l'EELL : ftp://91.162.11.71:44227/pub Sur wikilivres : mkd (extracteur de documents) Documentation complète.

#### Où trouver les commandes batch

    Sur Wikipedia : Liste des commandes DOS Sur wikilivres : DOS

#### Où trouver les commandes PowerShell (Windows 10)

    Sur wikipedia : PowerShell Sur wikilivres : Programmation PowerShell Livre de niveau 12

#### Où trouver les commandes Shell

    Sur Wikipedia : Shell - Tcsh et Mas OS

#### Où trouver les commandes Bash

    Sur wikipedia : bash Sur Wikilivres : Programmation Bash

#### Où trouver un comparatif entre ces langages en lignes de commandes

    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. Malheureusement ce service n’inclut pas la numérotation des pages PDF. Les pages Wiki incluent le service de création de fichiers PDF avec les liens internet dans le menu Télécharger comme PDF. https://github.com/wikimedia/mediawiki-services-electron-render/blob/master/README.md

### Aperçu explicatif des fichiers de commandes

Aperçu explicatif des fichiers de commandes
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 Liste des commandes PowerShell, DOS et UNIX/Linux
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.
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
##### Résultat

    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.

##### Extraction du Fichier Annexe.doc avec mkd
#### Fichier de première évaluation avec les commandes Unix - Linux

Remarque: Permettre l'exécution du fichier de commande. (sudo chmod 777 ./tests-1.bash)

### Commuer en sous-pages "Annexe" et "Index" le texte concaténé ou transclus ou en sous-page

SCLTI vers Annexe
Remarques :
L'annexe d'un livre peut être ajoutée à la fin d'une version imprimable du livre, elle peut être :
* Concaténée. Le texte du canevas SCLTI est copié puis collé à la fin de la dernière page. Cette méthode est plutôt réservée au "canevas sclti" pour les pages ou les articles séparés.
* Le "canevas SCLTI" transclus comme une sous-page du livre.
* Une sous-page "Annexe" transclue après avoir été retravaillée et corrigée.
Noter que les livres compilés, lorsqu'ils sont publiés par PediaPress, ont une page "Annexe" une page "Index" et une page "Contenus". Il est inutile d'ajouter ces éventuelles sous-pages avec l'éditeur de compilation.
Les sections "Annexe" et "Index" sont pré-écrites dans le canevas "SCLTI".

#### Extraire les informations contenues dans la sous-page SCLTI

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 dans différents langages de programmation.
L'extracteur de document extrait le texte qui se trouve entre ces repères.
Pour extraire les lignes avec l'extracteur de documents il est nécessaire de :
* Surligner et copier tout le texte repéré /* ... */ y compris les /* et */, puis coller ce texte dans un éditeur de texte (Notepad, Bluefish, etc..)
* Enregistrer ce texte au format texte avec un nom quelconque d'extension ".txt"
* Pour extraire l'annexe : Si vous ne l'avez pas encore installé, téléchargez 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

Ce code crée un fichier d'extension "Annexe.doc". Il recrée toute la structure de l'annexe et inclut le texte recopié au sous-chapitre précédent.

##### Fichier intermédiaire LivreTest.txt pour l'extraction

Extrait de la section SCLTI ou Annexe ajoutée à la fin du livre :

##### Page extraite

Ce fichier extrait pourra être copié dans la sous-page Annexe du livre.

#### Pages "Annexe" et "Index" telles qu'elles apparaitront à la fin du livre
# Annexe
## Références

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

## Sources et contributeurs des articles

Source de cette édition :
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 :
Article : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie) 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 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) 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.

## Source des images, licences et contributeurs

Article : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie) 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 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) 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.

## Licence

Article : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie) 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 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) 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

# Index

Source : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie)/Sommaire Carthagène Page :
Gabriel Garcia Marquez Page :
Source : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Frontière triple au sud de la Colombie-copie/Sommaire Leticia Page : 7.
Le commerce indigène Page : 8.
Source : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Medellin (Colombie)/Sommaire Medellin Page : 10.
Fernando Botero Page : 11.

### Commuer les sous-pages sclti du livre, les articles, en sous-page Annexe

Sous-pages sclti d'articles vers sous-page Annexe du livre
Un livre est composé de sous-pages aussi appelées Articles.
Il est possible de créer une sous-page sclti de chacun 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 mise 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
##### Syntaxe de la ligne de commande

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.

#### 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 :

#### Présentation de la page "Annexe" et "Index" finale (ci après)
# Annexe
## Références

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

## Sources et contributeurs des articles

Source de cette édition :
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 :
Article : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie) 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 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) 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.

## Source des images, licences et contributeurs

Article : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie) 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 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) 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.

## Licence

Article : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie) 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 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) 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

# Index

Source : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Cartagène des Indes (Colombie)/Sommaire Carthagène Page :
Gabriel Garcia Marquez Page :
Source : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Frontière triple au sud de la Colombie-copie/Sommaire Leticia Page : 7.
Le commerce indigène Page : 8.
Source : Utilisateur:Goelette Cardabela/Sandbox/LivreTestSA/Medellin (Colombie)/Sommaire Medellin Page : 10.
Fernando Botero Page : 11.