Auto-éditer un wikilivre/Annexer (Version internationalisée)

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche
Structure spéciale de cette page
La page est structurée pour faciliter son téléchargement complet avec ses sous-pages sans perte d'information, grâce aux outils mis à la disposition des programmeurs.
Il suffira ensuite d'installer cette application, avec son programme d'installation inclus, pour disposer d'un programme complet de génération de pages Annexe des livres.
Notez que la page Index des livres n'est possible qu'à l'aide de programmes spécialisés comme OpenOffice, LibreOffice, ou autres.
En travauxlink={{{link}}}

Cette page est en travaux. Tant que cet avis n'aura pas disparu, veuillez en considérer le plan et le contenu encore incomplets, temporaires et sujets à caution. Si vous souhaitez participer, il vous est recommandé de consulter sa page de discussion au préalable, où des informations peuvent être données sur l'avancement des travaux.


Extraire les chaînes des messages
Les codes sources internationalisés se trouvent dans le répertoire ~/Add_appendix/src
Répertoire des traductions : ~/Add_appendix/src/lang
Fichiers de bases des traductions ~/Add_appendix/src/Lang/header.pot et ~/Add_appendix/src/Lang/annex.pot.
Les fichiers des traductions s'éditent avec Poedit
xgettext : est l'outil 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.
Pour démarrer
Copier la commande ci-dessous (Ctrl-c). Ouvrir une fenêtre 'Terminal' y coller le code (Ctrl-shift-v)
 cd ~; mkdir Add_appendix; mkdir Add_appendix/Install_files; mkdir Add_appendix/src

Surligner les codes sources et les copier dans Add_appendix/src avec l'aide d'un éditeur de texte,

y copier header.sh, annex.sh, list.sh, download.sh, add_sclt.sh, add_sclic.sh, add_sclip.inc.sh, sclipco.sh, sclipw.sh.
 cd Add_appendix/src; echo -n "Répertoire des sources : "; pwd; ls

Créer les répertoires dépendants des fichiers sources et d'installation :

 cd ~/Add_appendix/src; mkdir doc icons lang lang/po lang/man locale maintenance man mime prj

Générer les fichiers .pot

 Documentation : xgettext --help ou man xgettext
 cd ~/Add_appendix/src; xgettext -L shell -o lang/po/header.inc.pot --from-code=UTF-8 header.inc.sh
 cd ~/Add_appendix/src; xgettext -L shell -o lang/po/annex.pot --from-code=UTF-8 annex.sh
Remarque
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

Créer les répertoire d'exécutions et des tests :

 cd ~/Add_appendix; mkdir usr usr/local usr/local/bin
Remarque
Ce programme est exécuté par la succession de sous programmes, contrairement à un programme global; où tous les sous-programmes sont assemblés(compilés) en un seul par inclusions successives.
De ce fait, chaque sous programme est exécutable séparément pour effectuer des tests.
Il est possible de créer un programme assemblé; il suffit de transformer les modules en fonctions.
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
Télécharger l'ensemble du programme
plus tard !


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 et 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]

En cours d'écriture

Codes sources (Sources codes)[modifier | modifier le wikicode]

  • Ces codes source <code>.sh doivent être copiés dans /usr/local/src/Add_appendix/
    Les exécutables <code> doivent être copiés dans /usr/local/bin/ ou, dans : /usr/local/bin/Add_appendix avec un lien vers la commande annex dans le répertoire /usr/local/bin/
 ln -s /usr/local/bin/Add_appendix/annex /usr/local/bin/annex
La commande annex tient compte de son propre chemin d'exécution pour atteindre et exécuter les modules suivants.




  • localement, on peut copier ces fichiers dans ~/Add_appendix/usr/local/src/ et ~/Add_appendix/usr/local/bin/ à condition d'ajouter le chemin ~/Add_appendix/usr/local/bin/ dans le path de l'environnement env.
Ouvrir un terminal et taper la commande suivante, ou l'inclure dans une commande d'exécution du terminal[1] :
 export PATH=$PATH:~/Add_appendix/usr/local/bin
Dans ce cas on met tous les exécutables dan ce même répertoire bin
Ce path ajouté prend fin avec la clôture du terminal.
  1. https://www.linuxtricks.fr/wiki/personnaliser-son-shell-alias-couleurs-bashrc-cshrc




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

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

annex.sh[modifier | modifier le wikicode]

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

list.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/list.sh

download.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/download.sh

add_sclt.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/add sclt.sh

add_sclic.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/add sclic.sh

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

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/add sclip.inc.sh

sclipco.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/sclipco.sh

sclipwb.sh[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/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 : 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 : 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

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

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 766 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.

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

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

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.

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

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

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

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

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

Ce module sclipco.sh utilise des données produites par le module sclipwb

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


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 :
Auto-éditer_un_wikilivre/Auto-référencer/INSTALLER.sh

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

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

Codes pour l'installation et les tests[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

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

documentation[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/doc

icons[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/icons

locale[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/locale

maintenance[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/maintenance

mime[modifier | modifier le wikicode]

Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/mime

projets (pojects)[modifier | modifier le wikicode]

annex.prj[modifier | modifier le wikicode]

annex.sh list.sh download.sh add_sclt.sh add_sclic.sh add_sclip.inc.sh slipco.sh slipwb.sh