# Goélette Cardabela/Référencement automatique

Un contributeur est en train de retravailler en profondeur cette page. Vous êtes prié(e) d'éviter de le modifier pour limiter les risques de conflit de versions jusqu'à disparition de cet avertissement. Merci.
Merci de suivre les recommandations et de ranger ce livre. Bon courage aux auteurs !
Veuillez laisser ce bandeau posé pendant un mois après son dépôt.
L'annexion et l'indexation des wiki-livres est en cours d'étude. Pour en savoir plus consultez la sous-page : Référencement automatique en pré-étude.
Une version imprimable est à l'étude avec le Modèle:Couverture d'un wikilivre.

## Introduction

Automatiser la mise en page d'un livre ou d'un livret pour l'impression est difficile depuis que PediaPress n'est plus en mesure de proposer ce travail. Si on avait la possibilité de corriger leur mise en page automatisée ce serait une très bonne avancée.
Avec le référencement manuel et le référencement semi-automatique on a déjà progressé vers le référencement des pages de MediaWiki et créé des pages « Annexe, licences et index ». Il reste maintenant à automatiser la création des Versions imprimables et Versions PDF.
La création automatique des versions imprimables et PDF se résout facilement grâce aux Modèles de Wikilivres et aux modèles créés pour le référencement automatique.
Le référencement automatique est encore en cours d'étude et s'oriente vers la programmation shell sous linux, ou MinGw sous windows.
Lorsque tout sera automatique, il faudra encore améliorer et corriger les processus, voire changer ces processus pour d'autres méthodes.
Références de la page
* ↑ https://fr.wikibooks.org/wiki/Goélette_Cardabela/Référencement_manuel
* ↑ https://fr.wikibooks.org/wiki/Goélette_Cardabela/Référencement_semi-automatique
* ↑ https://fr.wikibooks.org/w/index.php?title=Catégorie:Modèles_pour_les_livres
* ↑ https://fr.wikibooks.org/w/index.php?title=Goélette_Cardabela/Sommaire#Modèles

## Sommaire

* Introduction
* Initialiser un livre ou un livret
** Créer un livre pour naviguer dans les pages
** Créer un livre imprimable traditionnel
* Outils pour le référencement

## Initialiser un livre ou un livret

Selon que l'on désire publier un livre pour le consulter sur un écran, l'imprimer avec une structure simple, ou imprimer un livre traditionnel avec une couverture, on utilisera à des modèles de création de livres différents.

### Créer un livre pour naviguer dans les pages

Les meilleurs exemples de création se trouvent dans les modèles proposés dans Wikilivres, à savoir :
Modèle:Livre, c'est un modèle très simple qui inclut les modèles :  {{Moteur}}  {{version imprimable}} sous_page à créer.  {{version PDF}} page à créer.  {{Sommaire|large}} page à créer.  et propose de créer un résumé introductif, sous-page « Introduction » de la page de base.
Les deux modèles associés suivants sont: un “modèle pour la navigation” dans les pages d'un livre avec une option d'impression, et un modèle « imprimable ». Ces modèles écrits en langage LUA sont assez rigides et ne conviennent pas pour créer un livre, ou un livret, avec un “Nom de la page de base” prise dans une sous-pages comme c'est le cas pour ce livret.
Modèle:Sommaire de navigation Crée un cadre à droite avec des liens de navigation vers les sous-pages, la création se fait automatiquement, à l'aide du contenu de la page « Sommaire ». Par défaut le modèle utilise pour nom de titre la première partie tronquée du nom de la page. Exemple pour cette page : {{BOOKNAME}} = Goélette Cardabela, il convient de préciser {{Sommaire de navigation|Nom de la page de base/Sommaire}}.
Modèle:imprimable La construction d'une version imprimable du livre est automatique avec le contenu de la page « Sommaire ». Cette version imprimable n'est pas Modifiable avec l'aide du menu, il faut intervenir sur les articles pour exécuter un saut de page par exemple. Il convient de préciser {{Imprimable|Nom de la page de base/Sommaire}}.

### Créer un livre imprimable traditionnel

Le modèle suivant {{Créer un livre traditionnel}} est à placer dans la sous-page « Version imprimable » ou « Version PDF » du « Livre ». La version PDF se distingue de la version imprimable par sa page spéciale « Colophon », la page PDF obtenue dépend de sa méthode d'impression; directement sur l'imprimante PDF ou par l'intermédiaire d'un logiciel tiers comme OpenOffice.
Modèle:Créer un livre traditionnel avec sa « Version imprimable » ou sa « Version PDF ». Exemples de version imprimable et version PDF créées avec le modèle Créer un livre traditionnel.
{{Créer un livre traditionnel |livre= |titre= |sous-titre= |éditeur= |du même auteur= |liste des œuvres= |image de couverture= | auteur-image= |couleur de couverture= |couleur du texte= |code-CDU=0 |sous-code-CDU=0 |référence manuelle= |}}
| Couverture d'un livre Le brochage | composé des modèles ci-après :   Modèle:Couverture d'un wikilivre première de couverture.   Modèle:CDU sur les pages de garde des livres classés.   Modèle:Page de faux-titre   Modèle:Verso de faux-titre   Modèle:Page de titre   Modèle:Colophon verso de titre.     Contenus contenu, semblable à un contenu de compilation.     Table des matières avec Open Office ou « Sommaire ».   Modèle:Annexer et indexer en automatique ou,    occasionnellement, Modèle:Référencer le livre manuellement.   Modèle:Quatrième de couverture avec troisième de couverture vierge. |
* ↑ Exemple de version imprimable créée avec {{Créer un livre traditionnel}}
* ↑ Exemple de version PDF créée avec {{Créer un livre traditionnel}}
* ↑ Compiler
* ↑ Exemples de livres compilés

## Outils pour le référencement

Cette page est considérée comme une ébauche à compléter . Si vous possédez quelques connaissances sur le sujet, vous pouvez les partager en éditant dès à présent cette page (en cliquant sur le lien « »).
Ressources suggérées : Aucune (vous pouvez indiquer les ressources que vous suggérez qui pourraient aider d'autres personnes à compléter cette page dans le paramètre « ressources » du modèle engendrant ce cadre)

## Outils pour le référencement
### Le wiki-texte pour le référencement

Les outils pour le référencement manuel et le référencement semi-automatique sont entièrement en wiki-texte, l'extraction des documents en semi-automatique fait appel à de la programmation.

### La programmation informatique

Elle est nécessaire pour exécuter toutes les tâches automatiques avec pour seul renseignement les liens vers les pages du livre (le contenu du livre). Les liens vers ces pages se trouvent dans une des pages spéciales « Sommaire » ou « Contenus ». La page “Sommaire” est souvent utilisée pour faire le lien avec les chapitres du livre. Les numéros des pages peuvent être ajoutés dans les versions imprimables ou les versions PDF. La page de “Contenus” pour le référencement doit à aider au référencement, tout comme la page de “contenus” pour la compilation doit aider à la création d'un livre avec PediaPress. Cette page de “Contenus” est naturellement au pluriel.

#### Exemple de page “Sommaire” de navigation de la page principale

Le lien renvoie vers une section de la page principale
* Introduction
* Initialiser un livre ou un livret
** Créer un livre pour naviguer dans les pages
** Créer un livre imprimable traditionnel
* Outils pour le référencement
Note : La page “Sommaire” est parfois utilisée pour automatiser la création d'un sommaire de navigation lié à une version imprimable (avec le même sommaire).

#### Exemple de page “Contenus” pour la version imprimable

Le lien renvoie vers l'URL des pages et sous-pages
Note : La page “Contenus” sert au référencement des pages et à la création de la “Version imprimable” du livre.

#### Exemple de contenu pour une version compilée
## Logiciels de programmation

Pour profter pleinement de ces langages il faut programmer sous Linux

### Lua

Le langage Lua avec sa bibliothèque MediaWiki semble tout indiqué pour créer un modèle de référencement automatique.

### C/C++

Le langage Lua communique avec les langages C/C++ et permet de compléter les codes Lua avec une partie des codes du logiciel mkd pour extraire les commentaires et les liens tels que [[Image: ... ]], [[File: ... ]], etc.

## Outils de référencement bibliographiques et d'extraction de données

Certaines applications doivent fonctionner avec Java qui n'est pas compatible avec les versions récentes du navigateur Mozilla-Firefox.

### Base bibliographique personnelle et partagée
#### Zotero (Logiciel)

Zotero$^{Wikipedia}$ « est un logiciel de gestion de références gratuit, libre et open source qui s'inscrit dans la philosophie du Web 2.0. Il permet de gérer des données bibliographiques et des documents de recherche. » Langage de programmation : JavaScript

### Outils d'extration de données
#### Les fichiers de commandes

Ils ont été vus dans l'article “Référencement semi-automatique”.

#### OpenRefine (Logiciel)

OpenRefine$^{Wikidata}$ « est un outil libre d'extraction de données qui peut être utilisé pour nettoyer des tableaux, et les connecter à des bases de connaissances, dont Wikidata. » Programmé en Java Voir aussi : Modèle:Bibliographie « Le modèle a pour vocation d'être un équivalent de {{Ouvrage}} et {{Article}} généré à partir d'un élément Wikidata. » https://fr.wikibooks.org/wiki/OpenRefine

#### mkd (Logiciel)

mkd$^{Wikipedia}$ « est un logiciel permettant d'extraire des lignes de commentaires pré-codés afin de générer la documentation logicielle d'après le standard ISO » Programmé en C, il peut être recompilé pour extraire les noms de fichiers (pages en wikitexte [[Texte]]). Il peut extraire, par exemple, tous les fichiers d'images qui commencent par [[File: ... ]], [[Image: ... ]]. Notez que les commentaires du langage Lua utilisent aussi les double crochets longs, --[[ ... ]]. Voir aussi, en détail : https://fr.wikibooks.org/wiki/Mkd_(Extracteur_de_documents)
Dans un premier temps : Programmer et compiler en C getwikifiles.c pour extraire tous les liens [[ ... ]] et trier [[File:...]] etc. à l'aide des pages “Contenus” ou “Sommaire”. Programmer et compiler en C wikisclti.c pour extraire les noms des contributeurs et les licences. Dans un deuxième temps : Voir ce que l'on peut en faire avec Lua. (intégrer du C/c++ dans Lua ?)

##### mkd-getwikifiles

getwikifiles.c est un module expérimental destiné à être intégré dans un programme Lua Au 15 février 2020 la compilation du programme de test de ce module getwikifile compilé avec mkdmain.c a été éprouvé, et voici les résultats pour les pages du livrestest Utilisateur:Goelette_Cardabela/Sandbox/LivreTest
mkd-getwikifiles --ts Contenus donne :
mkd-getwikifiles --ts -FI ArticleUn donne :
mkd-getwikifiles --ts -FI ArticleDeux donne :
mkd-getwikifiles --ts -FI ArticleTrois donne :
... à ce jour il reste à corriger les liaisons entre les mots séparés par un espace.15 février 2020 à 11:30 (CET)

## Outils de mise en page et d'indexations autonomes
### OpenOffice et LibreOffice

Avec OpenOffice OOo (ou AOO pour Apache) et LibreOffice, la mise en page et l'indexation est facilitée. Zotero et l'analyseur-correcteur syntaxique Antidote (anglais et français) fonctionnent avec ces deux éditeurs-formateurs. Note : Les formules mathématiques ne sont pas correctement reproduites sans un support complémentaire.
* ↑ https://fr.wikibooks.org/w/index.php?title=Goélette_Cardabela/Sommaire#Nouveautés Chapitre #Outils_pour_le_référencement_manuel_et_semi-automatique
* ↑ https://www.supinfo.com/articles/single/1647-introduction-au-dialogue-c-lua-creation-une-surcouche-c-api-c-existante