Goélette Cardabela/Références

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche


Création de l'annexe des livres
Nuvola-inspired File Icons for MediaWiki-fileicon-ps.png

Une version imprimable de Référencement des livres est disponible.version en test (voir/modifier)

Sweden road sign A10.svg Ce wikilivre est bien avancé et peut être utilisé avec précaution.
Sciences humaines.svg Ce livre a été classé comme étant accessible aux lecteurs de niveau 12.

Introduction[modifier | modifier le wikicode]

Pourquoi créer une page Annexe avec le nom des auteurs et les licences d'utilisation du texte et des images ? Cela n'a sans doute aucun intérêt pour les lecteurs et pour les impressions personnelles car le lecteur a accès par le réseau internet aux origines des textes et des images.
Cependant, si un livre doit être imprimé et distribué on ne peut pas faire fi du nom des contributeurs et du droit de copie.

Les livres peuvent être imprimés par PediaPress qui imprime cette Annexe mais; lors de l'édition des livres de La goélette Cardabela il n'a pas été possible de remédier à la disposition et à la taille des images.

Une solution à ce problème consiste à faire imprimer les livres par un imprimeur. Les imprimeurs peuvent assembler les feuilles et produire des livres mais il faut leur fournir tout le matériel au format PDF et l'éditeur du livre (vous, moi) doit lui fournir cette Annexe.

Le compilateur qui créait (aussi) la page Annexe n'est pas disponible actuellement. Cette page est difficile à produire car il faut chercher dans l'historique de chaque article et aussi recopier l'origine des images avec les noms des auteurs et les licences d'utilisation.

Une solution en attente pourrait être celle ou une de celles qui pourront être proposées dans le wiki-livre Référencement des pages et livres de MediaWiki.

Pour les articles 
Une première solution consiste à créer une sous page sclti de chaque article à l'aide du « canevas sclti » :
{{PAGENAME}}/sclti où {{PAGENAME}} est le titre de l'article.
Il est possible d'utiliser le modèle {{Référencer la page}} à placer à la fin de l'article, et à supprimer lorsque l'annexe aura été créée.
Pour les livres 
Un wiki-livre est normalement composés d'articles.
Pour créer l'annexe d'un livre on utilise le « canevas SCLTI » où {{BASEPAGENAME}} est le nom de base de l'article « Livre »
Voir l'exemple : Goélette Cardabela/Références/Introduction

Sections

Référencement manuel[modifier | modifier le wikicode]

Cet article peut être consulté et imprimé séparément. L'annexe a été construite avec avec le modèle {{Référencer la page}} : Goélette Cardabela/Référencement manuel/Version imprimable


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 Discussion:Goélette Cardabela/Références

Le canevas sclti[modifier | modifier le wikicode]

sclti signifie : sources, contributeurs, licences, textes et images

Il s'agit de produire la sous-page {{PAGENAME}}/sclti 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 {{PAGENAME}}/Sommaire.

Disponibilité du canevas sclti : Références/Canevas_sclti pour les articles disposant d'un Sommaire

Exemple de création d'une sous-page {{PAGENAME}}/sclti : Goélette_Cardabela/Après/L'entretien/sclti
« 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 ?[modifier | modifier le wikicode]

Si le livre n'est pas trop compliqué on pourra créer directement la sous-page {{BASEPAGENAME}}/Annexe par extraction les lignes des sous-pages {{PAGENAME}}/sclti

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/Canevas 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
L'index est habituellement construit à l'aide de la sous-page {{PAGENAME}}/Contenu.

Exemple de création d'une sous-page {{BASEPAGENAME}}/SCLTI : Collection des livrets techniques de la goélette Cardabela/SCLTI Elle apparaît à la fin de la version imprimable : Collection des livrets techniques de la goélette Cardabela/Version imprimable débarrassée de la structure des repères d'extraction.
Remarque : Dans cet exemple la sous-page SCLTI est utilisée directement sans produire la sous-page Annexe.

Les canevas des référencements manuels[modifier | modifier le wikicode]

Les canevas sont proposés pour créer la documentation d'un article ou d'un Wiki-livre.

Utiliser le canevas sclti[modifier | modifier le wikicode]

Le En cours de finition 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.
La création simplifiée est manuelle.
La création est semi-automatique avec les fichiers de commandes

Utiliser le canevas SCLTI[modifier | modifier le wikicode]

Le En cours de finition Canevas_SCLTI permet de créer une section ou une sous-page SCLTI non imprimable d'un livre qui sera transformé en Annexe imprimable.

Copier les résultats dans la page Annexe[modifier | modifier le wikicode]

Exemple dans l'espace de noms Utilisateur[modifier | modifier le wikicode]

Référencement semi automatique[modifier | modifier le wikicode]

Les fichiers de commandes[modifier | modifier le wikicode]

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[modifier | modifier le wikicode]

Aperçu explicatif des fichiers de commandes[modifier | modifier le wikicode]

Commuer la section concaténée ou la sous-page SCLTI en sous-page Annexe[modifier | modifier le wikicode]

Commuer les sous-pages du livre, les articles, en sous-page Annexe[modifier | modifier le wikicode]

Référencement automatique[modifier | modifier le wikicode]

Face-sad.svg Ce wikilivre est encore à l'état d'ébauche, tout reste à faire.

Automatiser l'ensemble des tâches de la documentation des livres n'est pas facile car rien n'est prévu lors de la création des pages et de leur assemblage pour en faire les livres.

Jusqu'en 2017 le menu Créer une compilation permettait de créer une image PDF du livre avec sa documentation ajoutée en annexe.

Automatiser la documentation sans changer les habitudes Wikimédia[modifier | modifier le wikicode]

Il n'est pas possible d'agir sur une page Wiki à l'aide de commandes externes, il faut donc créer des fichiers sur lesquels on peut agir.

L'idée première est de créer un fichier html copie de la page à documenter. Cela peut se faire avec les commandes spéciales wget disponibles en standard sous Linux et PowerShell

Équivalence des commandes shell selon les systèmes d'exploitation[modifier | modifier le wikicode]

Comparaison des commandes Windows_PowerShell, DOS et UNIX

Pour extraire la documentation nous disposons des commandes grep, mkd, etc. Mais comment faire pour que le contributeur puisse créer la documentation de son livre avec un minimum de clics.

Code d'essai avec wget[modifier | modifier le wikicode]

Code des commandes d'essais avec une liste fullurl des pages à traduire en code html
wget.bash 
clear
#echo "Ce fichier de commandes "$0" 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 de liste contenant les liens vers les textes sources."
#echo "Le deuxième argument "$2" est le fichier texte cible."
read -p "Appuyer sur une touche pour continuer ..."
wget -i $1 -o wget-log

Fichier de liste pour wget[modifier | modifier le wikicode]

LivreTest.list
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleUn
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleDeux
https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/ArticleTrois

Code ArticleUn.1 résultant pour la page ArticleUn[modifier | modifier le wikicode]

Les liens sont relatifs à la page, sur le serveur de wikibooks, ce code html n'est pas exploitable tel quel sur un navigateur local. ... Voir ci-après.