Auto-éditer un wikilivre

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche
Quoi de mieux que de se lancer à écrire un programme en bash pendant cette période de confinement. (mars-avril 2020)

C'est un peu comme un puzzle. On croit que la commande que l'on vient d'écrire va marcher immédiatement, mais non ! Au bout de quelque temps on donne sa langue au chat et on va interroger les forums en espérant trouver une solution; ne serait-ce que pour comprendre la différence entre les parenthèse et double parenthèses : (...) ((...)) [...] {...} toutes ces parenthèses se ressemblent et n'expriment pas le même concept.

Voila donc un bon passe-temps pour remplir des journées vides de sens.

Les codes informatiques de ces articles ne sont pas prévus pour être intégrés dans un livre. Ils sont présentés pour être expliqués, voire corrigés. Chacun pourra les copier et faire des essais personnels d'encodage. L'encodage paraît facile, chaque ligne un peu compliquée demande parfois des heures de travail; alors, ne changez pas ces codes sans être absolument certain que cela en vaut la peine.

Les documents imprimables de ces articles, en Version imprimable ou Version compilée, sont (ou seront) imprimés sans le code informatique. Il en est (en sera) de même pour les manuels html et man de linux avec la version internationalisée du programme Annexer ou Annex ou encore AddAppendix; le nom pertinent n'est pas encore trouvé. Modifier le texte introductif

Sommaire[modifier | modifier le wikicode]

  • Auto-éditer_un_wikilivre
  • La compréhension des pages de ce wiki-livre peut être difficile, les articles sont, à priori, destinés aux éditeurs de livres habitués à la syntaxe WikiMedia.

Documentation et ressources pour ce wiki-livre[modifier | modifier le wikicode]

Ressources WikiMedia[modifier | modifier le wikicode]

      Aide:Syntaxe[1]
      Help:Extension:ParserFunctions[2]
      Help:Magic_words[3]

Ressources OpenOffice LibreOffice[modifier | modifier le wikicode]

      https://www.openoffice.org/fr/
      LibreOffice est livré en standard dans le système d'exploitation linux Ubuntu.

Autres ressources[modifier | modifier le wikicode]

Modèles[modifier | modifier le wikicode]

      {{Modèle:Créer_un_livre_traditionnel}}[4]
      {{Couverture de version imprimable}}[5]
      {{Couverture d'un wikilivre}}[6]
      {{Couverture d'un livret}}[7]
      {{Canevas sclti manuel}}[8]
      {{Canevas SCLTI manuel}}[9]
      {{Page de faux-titre}}[10]
      {{Verso de faux-titre}}[11]
      {{Page de titre}}[12]
      {{Colophon}}[13]

Qu'est-ce qu'un livre, un article, une page ?
Livres : Dictionnaires de latin dans la salle de lecture de la w:bibliothèque de l'université de Graz.

Qu'est-ce qu'un livre, un article, une page, selon WikiMedia[modifier | modifier le wikicode]

Note : Les renvois vers d'autres wikis apparaissent en début de lien tel celui vers Wikipédia : « w: ». Cette présentation est volontaire pour faciliter la recherche lors d'une lecture en version papier.

Le livre[modifier | modifier le wikicode]

« Un livre est un w:document écrit formant unité et conçu comme tel, composé de pages reliées les unes aux autres. Il a pour fonction d'être un support de l'écriture, permettant la diffusion et la conservation de textes de nature variée.

Sur le plan matériel, un livre est un volume de pages reliées, présentant un ou des textes sous une page de titre commune. Sa forme induit une organisation linéaire (pagination, chapitres, etc.). Un livre comporte généralement des outils favorisant l'accès à son contenu : table des matières, w:sommaire, index. Il existe une grande variété de livres selon le genre, les destinataires, ainsi que selon le mode de fabrication et les formats, ou selon les usages. Sauf exception, tel le w:livre d'artiste, un livre est publié en plusieurs exemplaires par un éditeur, comme en témoignent les éléments d'identification qu'il comporte obligatoirement.

Œuvre de l'esprit conçue par un auteur, le livre sert d'interface avec un lecteur. Objet culturel lié à l'histoire humaine, il permet de transmettre du sens selon une forme matérielle particulière au-delà de l'espace et du temps. Pour le lecteur, « un livre est une extension de la mémoire et de l'imagination ». »[14]

L'article[modifier | modifier le wikicode]

On l'appelle aussi « page », la page devrait plutôt être la version matérielle : « les pages d'un article ». Cela vient probablement du fait qu'une « page web » est continue, dépourvue de la notion de « page papier » numérotée.

« Un article est un texte traitant d'un sujet particulier dans une revue ou un ouvrage en comportant plusieurs.

Dans une w:encyclopédie, l'article est une entrée qui comporte du texte et d'autres informations sur un sujet (par exemple, une biographie, la description d'un événement ou une étude succincte sur l'influence d'un courant artistique) »[15]

La page[modifier | modifier le wikicode]

« On appelle page chacune des deux faces d'un feuillet de w:papier, de w:parchemin ou d'une autre matière pouvant recevoir un texte ou des illustrations.

La page destinée à être vue en premier est appelée recto, tandis que la page qui lui est opposée est appelée verso. Dans les ouvrages réunissant plusieurs feuillets (livres, magazines, etc), le « recto » est aussi appelé « belle page », car c'est la page la mieux perçue par le lecteur, et le verso est également appelé « fausse page ». Si l'ouvrage se lit de gauche à droite, les belles pages sont les pages de droite, et portent des numéros impairs. Le titre et le début d’un chapitre se trouvent généralement en « belle page ». Le raisonnement est inversé pour les langues d'écriture sinistroverse (w:arabe et w:hébreu). »[16]

Qu'est-ce qu'une « Version imprimable » de Wiki-livres ?[modifier | modifier le wikicode]

Un wiki-livre est composé d'articles, il contient au moins les articles suivants :
      Les pages de ces articles sont indexées et foliotées.

  1. Page « Contenus », ce sont les articles "contenus" dans l'article de base, c'est une liste de liens vers les pages et sous-pages qui le composent.
  2. Article « Base », fait référence à basepagename. L'article de base est composé d'articles transclus de la forme {{:Nom de la page}}.
  3. Page « Annexe » ou « Annexes » avec les références comme indiqué dans le chapitre Annexer et indexer un livre ou un livret.
  4. Page « Index », la page d'index liste, au minimum, les chapitres et sous-chapitres du livre.

Viennent s'y ajouter les pages suivantes :
      Ces pages ne sont pas indexées et ne sont pas foliotées.

  1. Deux pages de « Couverture » : Première et deuxième de couverture. (Une seule feuille recto-verso)
  2. Deux pages de « Garde » (facultatives). Ce sont des pages vierges en papier un peu plus épais.
  3. Deux pages de « Faux-titre » (facultatives), avec une page recto impaire suivie d'une page « Verso de faux-titre ». (Une seule feuille).
  4. Une page de « Titre » (page impaire) avec sous-titre et nom de l'éditeur.
    Remarque : « Un éditeur c'est à la fois un lecteur et un promoteur d'auteurs. » Il est l'intermédiaire entre un texte et des lecteurs.
  5. Une page d'« Édition » ou « Colophon ». Le colophon anciennement page de titre, puis achevé d'imprimer à la fin du livre, se situe de nos jours au verso de la page de « Titre ».
    Cette page rappelle la page de titre et précise les conditions de production du livre, titre, sous-titre, éditeur, date de production, responsabilités, droits de copie etc.
  6. Deux pages (ou plus) de « Sommaire » ou « Table des matières » (recto en page impaire).
    Remarque : Le sommaire se trouve plutôt en début de livre et la table des matières plutôt à la fin du livre.
  7. La page « Achevé d'imprimer » dernière page du livre ou du livret (page paire).
  8. Deux pages de « Garde » (facultatives).
  9. Deux pages de « Couverture » : Troisième et Quatrième de couverture.

{{Créer un livre traditionnel |livre= |titre= |sous-titre= |éditeur= |produit par= |du même auteur= |liste des œuvres= |image de couverture= | auteur-image= |couleur de couverture= |couleur du texte= |code-CDU= |sous-code-CDU= |référence manuelle= |}}

Pour plus de détails voir : Modèle:Créer_un_livre_traditionnel.

Test du modèle Créer un livre traditionnel[modifier | modifier le wikicode]

{{Créer un livre traditionnel |livre= Monlivre |titre=Montitre |sous-titre= Mon-sous-titre|éditeur=Toto |produit par= |du même auteur= |liste des œuvres= |image de couverture= | auteur-image= |couleur de couverture= |couleur du texte= |code-CDU= |sous-code-CDU= |référence manuelle= |}}


Ce modèle « Créer un livre traditionnel » doit être placé dans la sous-page « Version imprimable » du « Livre » Monlivre, ou dans la sous-page « Version PDF » disposant d'une sous-page « Version PDF/Colophon ».

Pour plus de détails voir : Modèle:Colophon/Documentation.
Exemple
Test du modèle avec : Goélette_Cardabela/Référencement_automatique/Version_imprimable

{{Créer un livre traditionnel | livre={{PRINTABLEBOOKNAME}} | titre=Référencement des livres de MediaWiki | sous-titre=Référencement automatique | éditeur=Édité par un wikipédien | produit par=Un wikipédien | du même auteur= | liste des œuvres='''Des mêmes auteurs''' <br />Référencement manuel <br />Référencement semi-automatique | image de couverture=Brochage des cahiers d'un livre de la goélette Cardabela.jpg | auteur-image=Goelette Cardabela | texte={{/Texte de la quatrième}} | couleur de couverture=#FFFFF0 | couleur du texte=black | code-CDU=0 | sous-code-CDU=| référence manuelle= |}}

Structure spéciale de cette page : Annexer_(Version_internationalisée)
L'article est structuré pour faciliter les téléchargements des codes sans perte d'information, directement ou grâce aux programmes mis à disposition.
Les applications de téléchargement disposent leurs propres programmes d'installation.
Le but final est de générer les pages Annexe des livres de wikibooks.
Notez que la page Index des livres n'est possible qu'à l'aide de programmes spécialisés comme OpenOffice, LibreOffice, ou autres.


Généralités[modifier | modifier le wikicode]

Structure simple des répertoires d'installation pour les tests, valable pour tous les systèmes d'exploitation
Le répertoire racine est ~/Annexer
Il n'y a aucun sous répertoire, les fichiers sources exécutables y sont téléchargés. Les fichiers de projets d'annexes sont automatiquement créés par l'application comme dans l'exemple ~/Annexer/LivreTest. Le fichier d'installation INSTALLER.sh peut créer des sous répertoires comme tmp ou ressources dans lesquel on peut trouver des fichiers pour démarrer.
Installation rapide pour les tests
Copier le code ci-dessous (ctrl-c) coller ce code dans un terminal (ctrl-shift-v)
cd; mkdir Annexer; mkdir Annexer/src
Surligner les codes sources disponibles dans les sections suivantes,les copier et les enregistrer dans src avec l'aide d'un éditeur de texte,
Copier dans src : header.inc.sh, annex.sh, list.sh, download.sh, add_sclt.sh, add_sclic.sh, add_sclip.inc.sh, sclipco.sh, sclipw.sh.
Ensuite, dans le terminal :
cd; cd Annexer; cp src/*.sh .*; chmod 755 *
Dans le répertoire Annexer se trouvent maintenant tous les fichiers exécutables que l'on peut tester successivement, pour terminer par annex
Essayer successivement : './header.inc', 'header.inc LivreTest' et examiner ce qui se passe dans le répertoir Annexer.
Télécharger les codes LivreTest.compilé que l'on doit coller dans /Annexer.LivreTest
Essayer tous les modules : './list LivreTest', './download LivreTest', etc. et finir par './annex LivreTest'
Structure plus technique, des répertoires d'installation sous linux

Répertoires de base à l'installation

  • Le répertoire de travail pour créer les annexes : $Workdir doit être ~/Add_appendix
  • Le répertoire de travail de production de l'application et des tests : ~/Annexer
  • Les répertoires d'installation $Installdir peuvent être :
  • exceptionnellement : /usr
  • traditionnel, pour tous les utilisateurs : /usr/local quand tout sera vérifié.
  • par défaut, dans le répertoire personnel pour les essais : ~/Annexer

Répertoires corollaires

  • Les codes sources internationalisés se trouvent dans le répertoire $Installdir/src
  • Répertoire des traductions des messages : $Installdir/share/locale
  • Fichiers de bases des traductions $Installdir/share/locale/en/header.inc.pot et $Installdir/share/locale/en/annex.pot.
Remarques :
Les fichiers des traductions s'éditent avec Poedit
xgettext : est l'outil nécessaire pour extraire les messages repérées avec gettext dans les fichiers sources afin de les traduire avec Poedit.
faire attention, à ne pas oublier la ligne '. gettext.sh' en tête des fichiers sources à traduire.
Pour démarrer sous linux
Copier le fichier de commandes ci-dessous :
  1. Surligner le code de install_annex.sh ci-dessous puis le mettre en mémoire avec les touches Ctrl et c (Ctrl-c).
  2. Ouvrir un éditeur des textes, y coller le code (Ctrl-v).
  3. Enregistrer ce code sous le nom intall_annex.sh dans votre répertoire d'utilisateur.
  4. Ouvrir un terminal et modifier son mode d'exécution pour qu'il soit exécutable (chmod 755 intall_annex.sh)
  5. Exécuter ./intall_annex.sh qui créera la structure des répertoires dans ~/Annexer par défaut.
  6. Copier ce code dans le répertoire sbin existant ou créé dans ~/Annexer.
  7. Supprimer ce code du répertoire utilisateur.
  8. Lorsque l'on est assuré que tout fonctionne, on peut relancer la commande avec le paramètre /usr/local :
    ~/annexer/sbin/install_annex.sh /usr/locaL. On aura alors automatiquement accès aux manuels et aux langues étrangères.
Attention: ce programme d'installation est en cours d'essais et n'est pas terminé.

Auto-éditer un wikilivre/install annex.sh


Remarque
Par convention dans l'installation de l'appication annex, les fichiers shell *.sh ne doivent pas être exécutables, ce sont des références d'installation, ils peuvent contenir de la documentation. Ces fichiers peuvent être différents des fichiers de même nom, exécutables sans l'extension .sh
Télécharger les logiciels de dépendances et d'installation
  • Poedit et xgettext se trouvent en standard dans les bibliothèque des systèmes linux.
  • Pour les autres programmes, consulter : Install and dependency files



Annexer (Version internationnalisée)[modifier | modifier le wikicode]

Cette version est à utiliser sous linux.

(Fichiers d'installation et de dépendances)[modifier | modifier le wikicode]

mkd et mkddocu[modifier | modifier le wikicode]

  • Le logiciel mkd est utilisé dans l'exécution du programme annex
  • mkddocu est utilisé avec la liste des modules de programme annex.prj pour dresser la liste des messages à traduire en d'autres langues. La langue de références est l'anglais.

Installer l'application Annexer[modifier | modifier le wikicode]

Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#src.orig_en_français

INTERNATIONALISATION

Codes sources (internationalized source code)[modifier | modifier le wikicode]

  • Localement, on peut copier ces fichiers dans le répertoire de production de l'application, dans :
~/Annexer/src/ pour les sources, et ~/Annexer/bin/ pour les exécutables, dans ce cas, ajouter le chemin ~/Annexer/bin/ dans le path de l'environnement env du terminal.
Ouvrir un terminal et taper la commande suivante, ou l'inclure dans une commande d'exécution du terminal[17] :
 export PATH=$PATH:~/Annexer/bin
Dans ce cas on met tous les exécutables dan ce même répertoire bin et on peut générer les fichiers Annexe dans le répertoire ~/Add_appendix ou ailleurs.
Ce path ajouté prend fin avec la clôture du terminal.

header.inc.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/header.inc.sh - Version="200615"

annex.sh[modifier | modifier le wikicode]

Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/annex.sh - Version"200524



Les codes ci-dessous sont destinés à être transformés en fonctions et à être intégrés dans la librairie annex.lib

findbook.sh[modifier | modifier le wikicode]

modifier la page src/findbook.sh Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/bin/findbook Version 200626 en cours de modification.

list.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/src/list.sh

download.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/src/download.sh

add_sclt.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/src/add sclt.sh

add_sclic.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/src/add sclic.sh

add_sclip.inc.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/src/add sclip.inc.sh

sclipco.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/src/sclipco.sh

sclipwb.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/src/sclipbw.sh

src.orig en français[modifier | modifier le wikicode]

Information sur les fichiers de listes contenus dans les codes[modifier | modifier le wikicode]

  • *.list contiennent les liens complets vers les pages : (https:{{FULLURL:<page>)}}
Exemple 1 d'une url iso : https:{{FULLURL:Auto-éditer_un_wikilivre/Auto-référencer/header.sh}}
https://fr.wikibooks.org/wiki/Auto-%C3%A9diter_un_wikilivre/Auto-r%C3%A9f%C3%A9rencer/header.sh
Exemple 2 de la même url en utf-8 : https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/header.sh
  • *.prj contiennent l'adresse des pages et sous-pages wiki.
Exemple : Auto-éditer_un_wikilivre/Auto-référencer/header.sh
  • *.pj contiennent le dernier champ d'un lien :
Exemple : header.sh

Éditer la page originale[18]

codes de l'application en français avec les manuels[modifier | modifier le wikicode]

Ce projet est bien avancé, il est à utiliser avec indulgence.
Dans cette version, les images téléversées sur wiki-Commons sans passer par wikibooks ne sont pas reconnues.
Votre contribution est souhaitée. Vous pouvez rédiger vos remarques et vos recommandations dans la page Discussion.
Il est possible de télécharger cette application expérimentale à but éducatif à l'adresse ci-dessous
Annexer-fr_200701.zip Copies des articles avec le lien ci-dessous.
md5sum : c4825faa84eef1514d72edb0bd7b394e Annexer-fr_200701.zip.
Les droits de copies et de partages sont ceux des articles de wikilivres téléchargés.
Le serveur est situé dans la vallée de la Vésubie et peut être en dérangement suite à la tempête Alex et aux orages.

Les codes suivants sont utilisables pour les tests de la façon suivante :
1 . Copier le contenu de la page du premier module header.inc.sh dans un éditeur de texte comme Notepadqq,
---> l'enregistrer sous le nom header.inc dans le répertoire des tests ~/Annexer que vous aurez créé.
2 . Ouvrir un terminal. Dans le répertoire 'Annexer', modifier le mode de lecture-écriture-exécution
     du fichier header.inc de la façon suivante : chmod 755 header.inc
3 . Exécuter le module sans paramètre : ./header.inc puis avec le paramètre LivreTest: ./header.inc LivreTest
4 . Éditer la page LivreTest.contenu, copier la partie éditée et l'enregistrer sous le nom LivreTest.contenu
     dans le répertoire Annexer/LivreTest qui vient d'être créé par l'exécution de ./header.inc LivreTest.
5 . Copier, le module lister.sh et l'enregitrer sous le nom lister dont il faudra changer le mode en exécutable et l'éprouver.
      Observer à chaque fois les modifications du répertoire Annexer/LivreTest.
6 . ... et ainsi-de-suite. Le dernier fichier à créer est le fichier d'exécution globale annexer.
7 . Annexes que l'on doit obtenir : Annexe globale - Annexe personnalisée wb - Annexe personnalisée co.

Annexe obtenue avec la version 200623 de l'application Faire_fleurir_le_sel/Annexe
Les fichiers suivants doivent être installés dans le répertoire ~Annexer/src puis installés avec l'installateur.

Auto-éditer_un_wikilivre/Auto-référencer/header.inc.sh Fichier d'entête inclus dans tous les modules. Version 200623

Auto-éditer_un_wikilivre/Auto-référencer/lister.sh Crée les fichiers de listes pour les modules suivants. Version 200701

Auto-éditer_un_wikilivre/Auto-référencer/télécharger.sh Télécharge les pages de Wikilivres selon les listes générées. Version 200623

Auto-éditer_un_wikilivre/Auto-référencer/ajouter_sclt.sh Ajoute l'entête pour les textes et les articles de l'Annexe. Version 200623

Auto-éditer_un_wikilivre/Auto-référencer/ajouter_sclic.sh Ajoute l'entête globale pour les images et illustration, etc. Version 200623''

Auto-éditer_un_wikilivre/Auto-référencer/ajouter_sclip.inc.sh Ajoute les textes des conditions de copie des images. Version 200623

Auto-éditer_un_wikilivre/Auto-référencer/sclipwb.sh Ajoute, par article, les liens vers les images selon Wikilivres. Version 200623

Auto-éditer_un_wikilivre/Auto-référencer/sclipco.sh Ajoute, par article, les liens vers les images selon Commons. Version 200623

↑ Ce module sclipco.sh utilise des données produites par le module sclipwb sclipco.sh est à réviser. Avis du 30 juillet 2020.

Auto-éditer_un_wikilivre/Auto-référencer/annexer.sh Commande globale. Version 200626

Auto-éditer_un_wikilivre/Auto-référencer/md5sum_src-orig Somme de contrôle des fichiers depuis la Version 200623


Auto-éditer_un_wikilivre/Auto-référencer/cp-localsrc-2-localbin . Version 200623

↑ L'Installateur ci-dessus installe les fichiers de commandes dans le répertoire d'exécution ~/Annexer,
il doit d'être installé en mode exécutable dans le répertoire des sources ~/Annexer/src.
Les fichiers suivants doivent être installés dans le répertoire ~Annexer/man puis installés avec makeman_annexer.sh

Auto-éditer_un_wikilivre/Auto-référencer/annexer_fr.1 Fichier nroff avec un aperçu, pour l'installation du manuel français version 200626

Auto-éditer_un_wikilivre/Auto-référencer/annexer_fr.html Fichier html avec un aperçu, pour l'installation du manuel français version 200626

Auto-éditer_un_wikilivre/Auto-référencer/makeman_annexer.sh Cet exécutable installe le manuel unix/linux en français.


INSTALLER.sh

Cette commande télécharge tous les fichiers de commandes et installe l'application dans les répertoires du PC.

Syntaxe
INSTALLER.sh [ liste | pour moi | pour tous | pour admin ]
Exemples dans le répertoire d installation : ~/tmp
-> exemple ./INSTALLER.sh annexer.list, pour télécharger les articles depuis wikilivres.
-> exemple ./INSTALLER.sh pour moi, pour copier les codes dans ~/Annexer.
-> exemple ./INSTALLER.sh pour tous, pour copier les codes exécutables dans /usr/local/bin.
-> exemple ./INSTALLER.sh pour admin, pour copier les codes exécutables dans /usr/local/sbin.

Attention : la commande suivante fonctionne, cependant, elle doit être perfectionnée.
Les corrections et tests ne pourront pas se faire dans l'immédiat (juin 2020).
Sauf si des wikipédiens se dévouent.
Essayer et comparer les codes des sources obtenues avec les codes des pages wiki.
Dans l'attente, préférer l'installation des codes de tous les fichiers par copier-coller.

Fichier original à copier-coller pour télécharger l'application Annexer, avec le fichier annexer.list qui contient la liste des fichiers à télécharger :
Auto-éditer_un_wikilivre/Auto-référencer/INSTALLER.sh

Auto-éditer_un_wikilivre/Auto-référencer/annexer.list

Auto-éditer_un_wikilivre/Auto-référencer/html_data_conversions Copie pour contrôle du fichier INSTALLER.sh
md5sum : c7a7e6eb3347e2f0d614df29029d5578

Auto-éditer_un_wikilivre/Auto-référencer/html_url_conversions Copie pour contrôle du fichier INSTALLER.sh
md5sum : a01327f2138adeffea16e446be79e917

Voir aussi[modifier | modifier le wikicode]

Auto-éditer_un_wikilivre/Auto-référencer Cet article concerne l’étude préliminaire de l'application Annexer.
Les modules en sous-pages peuvent avoir été modifiés. Il est possible de consulter les pages d’origine par consultation de l'historique de l'article et l'historique du module en sous-page concerné.

Codes pour l'installation et les tests[modifier | modifier le wikicode]

Fichiers nécessaires à l'installation[modifier | modifier le wikicode]

Auto-éditer_un_wikilivre/Auto-référencer/LivreTest/LivreTest.contenu Fichier pour les tests avec LivreTest

Auto-éditer_un_wikilivre/Auto-référencer/LivreTest/LivreTest.compilé Fichier pour les tests avec LivreTest

Auto-éditer_un_wikilivre/Auto-référencer/annexer.list Fichier pour l'installation avec INSTALLER.sh

Auto-éditer_un_wikilivre/Auto-référencer/annexer.prj Exemple

Auto-éditer_un_wikilivre/Auto-référencer/annexer.pj Exemple

Installer les fichiers de l'application[modifier | modifier le wikicode]

Préinstaller l'application sur le PC
Note : BASH doit être installé sur le PC; il existe en standard sous linux.
1. Copier le code suivant dans un terminal de votre PC, et exécuter la commande.
   mkdir ~/tmp ~/Annexer ~/Annexer/LivreTest;
2. La méthode d'installation manuelle est la plus simple. Copier et coller les codes de l'application, ci-dessus, dans un éditeur de texte, puis les enregistrer dans le répertoire ~/Annexer que vous venez de créer.
3. Autre possibilité de copies : Utiliser les convertisseurs à disposition comme https://documentcyborg.com/. Il vous suffit de coller l'adresse html de la page dans le cadre approprié, de cliquer sur le format désiré : Get TXT, puis télécharger Download Document. Le document sera téléchargé dans la page habituelle de téléchargement. Il faut, malgré tout, éditer le document et probablement supprimer les ligne commençant par le caractère '*', et aussi; commenter la dernières lignes :
# Document converted to txt via Document Cyborg ( https://documentcyborg.com )
4. Installer presque automatiquement avec INSTALLER.sh En cours de corrections
Le répertoire d'installation des copies est ~/tmp ('~' représente la racine du répertoire utilisateur)
Copier le contenu de la page INSTALLER.sh et annexer.list dans le répertoire ~/tmp.
Entrer dans le répertoire tmp et lancer la commande INSTALLER.sh annexer.list
Si tout s'est bien passé il vous sera proposé quatre choix :
  1. choix 0 : ne rien faire, les fichiers restent dans le répertoire ~/tmp pour être examinés.
    Il sera toujours possible d'installer ultérieurement par la commande ./INSTALLER.sh [options]
    les options sont 4me (for me), 4all (for all), 4adm (for admin's).
  2. choix 1 : installer les fichiers dans le répertoire utilisateur ~/Annexer pour les tests.
  3. choix 2 : installer les fichiers pour tous dans /usr/local/bin (src, bin, man, share/doc).
  4. choix 3 : installer les fichiers pour les administrateurs (root, su, sudo) dans /usr/local/sbin.
Le répertoire ~/tmp pourra être nettoyé dès que les fichiers auront été copiés.

Installer les fichiers de tests[modifier | modifier le wikicode]

Procéder comme à l'étape précédente; copier les fichiers LivreTest.contenu et LivreTest.compilé dans le répertoire ~/Annexer/LivreTest.

Fichiers de traductions (Translations files)[modifier | modifier le wikicode]

header.pot et annex.pot (sources en anglais)[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/po/header.pot

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/po/annex.pot

header.po et annex_es.po espagnol[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/po/header_es.po

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/po/annex_es.po

header.po et annex_fr.po français[modifier | modifier le wikicode]

Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/lang/po/header_fr_FR.po

Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/lang/po/annex_fr_FR.po

Manuels (Manuals)[modifier | modifier le wikicode]

annex.1 anglais[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/man/annex.1

annex_es.1 espagnol[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/man/annex_es.1

annex_fr.1 français[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/man/annex_fr.1

doc2html.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/lang/man/doc2html.sh Crée les manuels en versions html et txt.gz.

Fichiers généraux (General files)[modifier | modifier le wikicode]

documentation[modifier | modifier le wikicode]

Auto-éditer un wikilivre/doc

icons[modifier | modifier le wikicode]

Auto-éditer un wikilivre/icons

locale[modifier | modifier le wikicode]

Auto-éditer un wikilivre/locale

mime[modifier | modifier le wikicode]

Auto-éditer un wikilivre/mime

manuels[modifier | modifier le wikicode]

Auto-éditer un wikilivre/man1

maintenance[modifier | modifier le wikicode]

Auto-éditer un wikilivre/share/maintenance

Références[modifier | modifier le wikicode]

  1. https://fr.wikipedia.org/wiki/Aide:Syntaxe
  2. https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions
  3. https://www.mediawiki.org/wiki/Help:Magic_words/fr#Fonctions_de_parseur
  4. https://fr.wikibooks.org/wiki/Modèle:Créer_un_livre_traditionnel
  5. https://fr.wikibooks.org/wiki/Modèle:Couverture_de_version_imprimable
  6. https://fr.wikibooks.org/wiki/Modèle:Couverture_d'un_wikilivre
  7. https://fr.wikibooks.org/wiki/Modèle:Couverture_d'un_livret
  8. https://fr.wikibooks.org/wiki/Modèle:Canevas_sclti_manuel
  9. https://fr.wikibooks.org/wiki/Modèle:Canevas_SCLTI_manuel
  10. https://fr.wikibooks.org/wiki/Modèle:Page_de_faux-titre
  11. https://fr.wikibooks.org/wiki/Modèle:Verso_de_faux-titre
  12. https://fr.wikibooks.org/wiki/Modèle:Page_de_titre
  13. https://fr.wikibooks.org/wiki/Modèle:Colophon
  14. https://fr.wikipedia.org/wiki/Livre_(document)
  15. https://fr.wikipedia.org/wiki/Article
  16. https://fr.wikipedia.org/wiki/Page_(livre)
  17. https://www.linuxtricks.fr/wiki/personnaliser-son-shell-alias-couleurs-bashrc-cshrc
  18. Installer les fichiers de l'application originale en français