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

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


GénéralitésModifier

Structure simple des répertoires d'installation pour les tests, valable pour tous les systèmes d'exploitation
Le répertoire racine de la version française est ~/Annexer
Il n'y a aucun sous répertoire, les fichiers exécutables (sans l'extension .sh 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, src, ou ressources dans lesquels 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). Ce code crée aussi le sous-répertoire src qui n'est pas indispensable mais est pratique pour l'installation.
cd; mkdir Annexer; mkdir Annexer/src
Surligner les codes sources disponibles dans les sections suivantes,les copier et les enregistrer dans Annexer/src avec l'aide d'un éditeur de texte,
Copier les fichiers obtenus dans src : header.inc.sh, annexer.sh, list.sh, download.sh, add_sclt.sh, add_sclic.sh, add_sclip.inc.sh, sclipco.sh, sclipw.sh.
Ensuite, dans copier un terminal la ligne suivante (ctrl-shift + v):
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 annexer
Essayer successivement : './header.inc', 'header.inc LivreTest' et examiner ce qui se passe dans le répertoire de travail Annexer et Annexer/LivreTest.
Télécharger les codes LivreTest.compilé que l'on doit coller dans le répertoire LivreTest
Essayer tous les modules : './list LivreTest', './download LivreTest', etc. et finir par './annexer LivreTest'
 Si tout va bien vous pourrez alors supprimer les répertoires et fichiers inutiles.
Structure plus technique, des répertoires d'installation sous linux pour les mainteneurs

Répertoires de base pour l'installation internationalisée

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

Répertoires corollaires

  • Les codes sources internationalisés se trouvent dans le répertoire $Installdir/src
  • Répertoire des messages traduits : $Installdir/share/locale/en,es,fr/LC_MESSAGES/*.mo
  • Fichiers de bases pour les traductions $Workdir/resources/lang/po/header.inc.pot et $Workdir/resources/lang/po//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 + 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, ~/tmp par exemple.
  4. Ouvrir un terminal et modifier son mode d'exécution pour que ce code soit exécutable (chmod 755 intall_annex.sh)
  5. Exécuter ./intall_annex.sh qui créera la structure des répertoires dans ~/Add_appendix par défaut.
  6. Copier ce code dans le répertoire sbin existant, sous le nom re-insttall_annex.sh et le rendre exécutable.
  7. Supprimer ce code d'installation install_annex.sh du répertoire utilisateur.
  8. Lorsque l'on est assuré que tout fonctionne, on peut relancer la commande avec le paramètre /usr/local
    On aura alors automatiquement accès aux manuels et aux langues étrangères.
~/annexer/sbin/install_annex.sh /usr/locaL. 
Attention: ces programmes d'installation sont encore cours d'essais le 28 mars 2021.
Ce programme est très complet pour assurer la maintenance

Modifier le script install_annex.sh

#! /bin/bash
#H File install_annex.sh in ~/tmp or re-install_annex.sh in /usr/local/sbin directory
#H Codage UTF-8 sans BOM
#H Syntax : ~/Add_appendix/sbin/install_annex.sh [Install directory | ? ]
#H   The installation directory can be /usr/local or /usr or ~/Annexer or ~/Add_appendixby default
#P Creation date     : 2020/06/10 by GC
#P Modification date : 2020/06/12 by GC 
#P Modification date : 2021/05/19 by GC
#P Last test date    : 2021/05/19 by GC
#P This program installs the directory structure for the annex program of wikibooks.
#P

#O clean screen
   clear;
   
#O Version
    VERSION=210519
    if [ "$1" = "--v" ]; then echo "Version of install_annex.sh $VERSION"; exit 0; fi

#O If the first parameter '$1' is empty or '?' print syntax.  
    if [ "$1" = "?" ]; then echo "Syntax : $0 [ <Install-directory> ]"; exit 0; fi
    if [ -z $1 ]; 
    then 
      echo "Syntax ~/Tmp/install_annex.sh [ --v | ? | Add_appendix | Annexer | /usr/local ]"; exit 0
    fi

#P Do not use sudo
    if [ $USER = "root" ]; then echo "USER = $USER"; echo "Do not use 'sudo' please."; exit -1; fi
  
#O Go to home directory and print the current directory.
    cd ~
    echo""; echo -n "current directory = "; pwd; echo ""
    
#O If the first parameter is not empty  
    if [ $1 ];
    then 
      if [ $1 = "/usr" ]; then Installdir=$1; echo "Installdir = /usr";
      elif [ $1 = "/usr/local" ]; then  Installdir=$1; echo "Installdir = /usr/local";
      elif [ $1 = "Annexer" ]; then Installdir=~/Annexer; echo "Installdir = "$Installdir
      elif [ $1 = "Add_appendix" ]; then Installdir=~/Add_appendix; echo "Installdir = "$Installdir
      fi
    fi
    
#O Test if Install directory exist
    if [ -d $Installdir ];
    then echo " is ok, $Installdir is present." 
    else echo " $Installdir not exist, i create it"; mkdir $Installdir;
    fi    

#O Create variables : Workdir, Bindir, Testdir,
    if [ $1 = "Add_appendix" ] && [ $1 != "Annexer" ]; then Workdir=~/Add_appendix; echo "Workdir = "$Workdir; fi
    if [ $1 = "Annexer" ] && [ $1 != "Add_appendix" ]; then Workdir=~/Annexer; echo "Workdir = "$Workdir; fi
    if [ $1 = "/usr" ] || [ $1 = "/usr/local" ]; then Workdir=~/Add_appendix; echo "Workdir = "$Workdir; fi 
    if [ -d $Workdir ]; then echo " $Workdir is present."; else echo " $Workdir is not present, i create it."; mkdir $Workdir; fi
    
    Bindir="$Installdir/bin"; echo "Bindir : "$Bindir; 
    if test -d $Bindir; 
      then echo " is ok."; 
      else echo " not present, create it"; mkdir $Installdir; 
    fi
    
    Testdir="$Workdir/tests"; echo "Units-Tests directory Testdir = "$Testdir; 
    if test -d $Testdir; 
      then echo " is ok."; 
      else echo " is not present, create it"; mkdir $Testdir;
    fi
#T Breakpoint exit 0

#O Create or recreate directory hierarchy
    cd $Workdir
    echo -n "The current directory to create $Workdir sub directories = "; pwd
    mkdir -p datas resources resources/{lang,lang/po,lang/man,man,man/de,man/en,man/fr}
    mkdir -p bin books lib lib/src resources sbin share src temp vars man man/{man1,fr,fr/man1,fr.UTF8,fr.UTF8/man1,es,es/man1}
    cd share
    echo "Share is the current directory to create sub share directories."; pwd
    mkdir -p doc icons mime locale locale/{en,fr,es,fr/LC_MESSAGES,es/LC_MESSAGES}
#T Breakpoint exit 0

#O If findbook.sh, ecfpb.sh, ecfpc.sh, exist in the lib/src directory, build the annex.lib file
    if test -e $Workdir/lib/src/findbook.sh && test -e $Workdir/lib/src/ecfpb.sh && test -e $Wordir/lib/src/ecfpc;
    then
      cat $Workdir/lib/src/findbook.sh | grep -v "#O\|#P\|#T" > $Workdir/lib/annex.lib
      cat $Workdir/lib/src/ecfpb.sh | grep -v "#O\|#P\|#T" >> $Workdir/lib/annex.lib
      cat $Workdir/lib/src/ecfpc.sh | grep -v "#O\|#P\|#T" >> $Workdir/lib/annex.lib
    else echo "annex.lib is not builded or not updated in $Workdir/lib/annex.lib"
    fi

#O Cd home directory and print the current directory.
    cd ~
    echo""; echo -n "current directory = "; pwd; echo ""
    
#O If the file annex.sh exist in the sources directory print OK annex.sh is in src dir.
    if [ -r $Installdir/src/annex.sh ];
    then 
      echo " annex.sh is OK in src directory $Installdir/src";
#O Else print 'install all annex program files in Installdir/src'
    else 
      echo " annex.sh not found in src directory $Installdir/src";
      echo " Please copy all annex internationalized files in $Installdir/src directory";
      echo "   and re-run this command to product pot files."
      exit -1;
    fi
    
#O List the Installdir/src directory and recreate the tmp/shell_files.prj
    rm -r ./tmp
    mkdir ./tmp 
    Srcdir=$Installdir/src
    ls $Srcdir/*.sh > ./tmp/shell_files.prj
#T Breakpoint exit 0

#O While line read in shell_files.prj
    while read line
    do
#O   Read $line, delete comments, write the result in Testdir directory for the Units Tests.
      echo $line | awk -F "/" '{print $NF}' > tmpfile.txt
      read file < tmpfile.txt
#T	  echo " file = "$file
      mkdir $Testdir/$file
      cp $Srcdir/$file $Testdir/$file/$file; chmod 755 $Testdir/$file/$file
    done < ./tmp/shell_files.prj
#O Clean tmpfile
    rm tmpfile.txt
    #rm -r ./tmp

#O Create .pot files to translate messages.
    #xgettext -L shell -o $Installdir/share/locale/en/header.inc.pot --from-code=UTF-8 $Installdir/src/header.inc.sh
    #xgettext -L shell -o $Installdir/share/locale/en/annex.pot --from-code=UTF-8 $Installdir/src/annex.sh
    xgettext -L shell -o $Workdir/resources/lang/po/header.inc.pot --from-code=UTF-8 $Installdir/src/header.inc.sh
    xgettext -L shell -o $Workdir/resources/lang/po/annex.pot --from-code=UTF-8 $Installdir/src/annex.sh
    echo "-----"    
    echo "You find Pot-files in $Workdir/resources/lang/po for translations :"
    ls $Workdir/resources/lang/po/*.pot

#O Message of the tasks to be accomplished.  
    echo "-----"
    echo "Tasks to be accomplished :"
	echo "Modify these files as functions"
    echo "Integrate functions in the librairie $Installdir/lib/annex.lib"
    echo "Copy include functions in $Installdir/lib and include files in $Installdir/bin"
    echo "Copy install_annex.sh in $Installdir/sbin"
    echo "See also users_install_annex.sh, best command for user"
    
#O Put install dirs to  /vars/installdir.var   
    rm $Workdir/vars/installdir.var
    echo "Installdir=$Installdir" > $Workdir/vars/installdir.var
    echo "Workdir=$Workdir" >> $Workdir/vars/installdir.var    
    echo; echo "Content of file $Workdir/vars/installdir.var"
    cat $Workdir/vars/installdir.var
   
#O End 'install_annex.sh'
L'exécutable cp-src2bin.sh vient en complément de la création de la structure des répertoires par le fichier de commandes install_annex.sh
la commande install_annex.sh ou re-install_annex.sh doit ensuit être ré-exécutée pour créer les fichier de traductions .pot

Modifier le script cp-src2bin.sh

Install this executable shell code in sbin ( /usr/local/sbin | ~/Add_appendix/sbin | ~/Annexer/sbin )
Installer ce code shell éxécutable dans sbin
espagnol ; Instale este código de shell ejecutable en sbin
#! /bin/bash
#P File : .../sbin/cp-src2bin.sh. This file must be copied in executable mode
#P Copy the source files to the executables directory.
#P The tests directory is used to individual test bash files from annex programm.

clear

VERSION=210419

if [ "$1" = "-v" ]; then echo "cp-src2bin.sh : VERSION $VERSION"; exit 0; fi

#P Find the current directory
    pwd > pwd.txt
    read Currentdir < pwd.txt

#P Find the working name directory
    cat pwd.txt | cut -d "/" -f4 > workname.txt
    read Workname < workname.txt
	echo -n "Working name directory= $Workname"
	if [ $Workname = "Annexer" ] || [ $Workname = "Add_appendix" ]
	then echo " is found"; 
	else echo " is not a working name directory"; exit -1
	fi
	
#P Find full directories install, working etc.
	source ~/$Workname/datas/installdir.var
    echo "Install directory : $Installdir"
	echo "Working dir : $Workdir"
	echo "Bin dir : $Bindir"
    echo "Lib dir : $Libdir"
    echo "Sbindir : $Sbindir"
#T Test break exit 0

#P Make list files.pj 
    echo "Make files list from src directory in files.pj"
    ls $Installdir/src/*.sh > files.pj

#P If files.pj is not empty copy all files *.sh to executable directory
    if [ -s "files.pj" ];
    then
      echo "files in files.pj :"
      cat files.pj
    else
      echo "files.pj is empty, exit from cp-src2bin.sh"
      exit 1
    fi

#P Copy copy without extension .sh, and make files executables
    while read line
    do
#T      echo "copy the ligne $line from files.pj '.sh' in the file exename without extension .sh"
      echo $line | sed s/.sh//g | awk -F "/" '{print $NF}'> exename.txt

#P   Affect the value in 'exename.txt' at the variable $Exename
      read Exename < exename.txt
      echo "copy $Installdir/src/$Exename.sh to $Installdir/bin/$Exename"
      cat $Installdir/src/$Exename.sh | grep -v "#O\|#P\|#T" >  $Installdir/bin/$Exename
      echo "Add mode 755 'executable' at file $Installdir/bin/$Exename"
      chmod 755 $Installdir/bin/$Exename
      echo "----"
    done < files.pj
#T Breakpoint exit 0

#P clean sbin directory
    rm files.pj pwd.txt exename.txt

#P End cp-src2bin


Remarque
Par convention dans l'installation de l’application 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 internationalisée)Modifier

Cette version est à utiliser sous linux.

(Fichiers d'installation et de dépendances)Modifier

Ces processus avec mkd et mkddoccu vont probablement être abandonnés très prochainement. (Commentaire du 9 avril 2021 à 17:29 (CEST))

mkd et mkddocuModifier

  • 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 AnnexerModifier

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

INTERNATIONALISATION

Codes sources (internationalized source code)Modifier

  • Globalement, les répertoires des binaires des systèmes unix/linux sont naturellement intégrés dans l'environnement de travail.
  • Localement, on peut copier les fichiers dans le répertoire racine de l'application,
    dans :
~/Annexer/src/ pour les sources, et ~/Annexer/bin/ pour les exécutables,
auquel cas, ajouter le chemin ~/Annexer/bin/ dans le path de l'environnement de travail.
Ouvrir un terminal et taper la commande suivante, ou l'inclure dans une commande d'exécution du terminal[1] :
 selon le répertoire racine 
 export PATH=$PATH:~/Annexer/bin
 ou
 export PATH=$PATH:~/Add_appendix/bin 
Dans ce cas on met tous les exécutables dans ce même répertoire bin et on peut générer les Annexes dans le répertoire Annexer/projet ou Add_appendix/projet, projet est habituellement le nom du livre.
Ce path ajouté prend fin avec la clôture du terminal.


Les codes ci-dessous doivent être installés dans le répertoire 'lib'

annex.libModifier

  vβ 210514 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/annex.lib
La fontion findbook est validée, les fonctions ecfp* sont à réviser. 17 mai 2021 à 11:38 (CEST)
* Si vous désirez éprouver ces codes, vous pouvez les installer dans les répertoires ~/Add_appendix/tests/1-annex.lib/<sous-répertoires : 11-findbook.sh/, 12-ecfpb.sh/, 13-ecfpc.sh/ >
  β-210514 - Tester le code source de la fonction findbook avec le programme test_findbook.bash (extrait les lien (urls) du Sommaire, du Contenu ou de la Compilation pour préparer la création de l'annexe des livres)
  β-210409 - Tester le code source de la fonction ecfpb avec test_ecfpb.bash] (extrait le contenu des livres imprimables)
  β-210415 - Tester le code source de la fonction ecfpc function with test_ecfpc.bash (extrait le contenu des livres compilés)


Les codes sources ci-dessous doivent être installés dans le répertoire d'installation src, ils peuvent avoir été compilés nettoyés des commentaires, sans l'extension .sh dans le répertoire bin, ou selon la version, aussi dans les répertoires lib ou encore dans le répertoire local tests/1-annex.lib

pre-annex.shModifier

  vβ 210516 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/pre-annex.sh
L'internationalisation des messages reste à faire

header.inc.shModifier

  vβ 210519 Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/header.inc.sh
L'internationalisation des messages est à reprendre

annex.shModifier

  vβ 210326 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/annex.sh
L'internationalisation des messages est à reprendre

list.shModifier

  vβ 210523 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/list.sh

download.shModifier

 vβ 210528 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/download.sh

add_sclt.shModifier

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

add_sclic.shModifier

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

add_sclip.inc.shModifier

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

sclipco.shModifier

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

sclipwb.shModifier

  [Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/sclipbw.sh]]



Les codes d'installation ou/et de réinstallation de la version internationalisée sont habituellement installées dans le répertoire_d'installation/sbin.
En cas d'installation du programme annex dans /usr/local il est possible d'installer ces deux fichiers de commandes directement dans le répertoire /usr/local/sbin

install_annex.shModifier

À exécuter deux fois !
install_annex.sh Installe la structure des répertoires du programme add_appendix pour les programmeurs et la maintenance.
La commande est exécutée une première fois lors de l'installation et une deuxième fois pour générer les fichiers de traduction après l'exécution de cp-src2bin.sh
Cette commande peut être ré-exécutée à volonté.
  vβ 210519 install_annex.sh
users_install_annex.sh Installe la structure des répertoires du programme add_appendix pour les utilisateurs.
Cette commande peut être ré-exécutée à volonté.
  vβ 210519 users_install_annex.sh

cp-src2bin.shModifier

cp-src2bin.sh installe les fichiers exécutables du programme dans le répertoire bin à partir des fichiers sources.
  vβ 210419 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/cp-src2bin.sh

src.orig en françaisModifier

Information sur les fichiers de listes contenus dans les codesModifier

  • *.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[2]

codes de l'application en français avec les manuelsModifier

Ce projet est bien avancé pour linux ou mingw-windows, 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.
Remarque concernant l'état du serveur de téléchargements
Les codes suivants sont utilisables pour les tests des mainteneurs 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.sh dans le répertoire des tests ~/Annexer/tests/header.inc.sh/header.inc.sh
    que vous aurez créé.
  2. Y copier également des programmes de test ctrl-header.inc.bash et test-header.inc.bash
  3. Ouvrir un terminal. Dans le répertoire '~/Annexer/test/header.inc.sh/', modifier le mode de lecture-écriture-exécution
    des programmes de contrôle et de tests de header.inc.sh de la façon suivante : chmod 755 *.bash
    Exécuter le module sans paramètre : ./ctrl-header.inc.bash puis avec le paramètre 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 ./ctrl-header.inc.bash LivreTest.

  1. Copier le contenu de la page du module lister.sh, pour les tests, et l’enregistrer sous le nom
    '~/Annexer/tests/lister.sh/lister.sh '. Y copier également les programmes ctrl-lister.bash, et test-lister.bash
    Faire les test du module et observer les modifications du répertoire Annexer/LivreTest.
  2. ... et ainsi-de-suite. Le dernier fichier à créer est le fichier d'exécution globale annexer.
  3. Annexes que l'on doit obtenir : 1) Annexe globale - 2) Annexe personnalisée wb - 3) Annexe personnalisée co.

Annexe obtenue avec la version 200623 de l'application Faire_fleurir_le_sel/Annexe
Les fichiers suivants, en cours de réécritures, devront ê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 210505

  Auto-éditer_un_wikilivre/Auto-référencer/lister.sh Crée les fichiers de listes pour les modules suivants. Version obsolète 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 obsolète 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 obsolète 210125

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

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

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

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

↑ Ce module sclipco.sh utilise des données produites par le module sclipwb sclipco.sh l’exécutable est à réviser. Avis du 30 juillet 2020 et du 25/01/2021.

  Auto-éditer_un_wikilivre/Auto-référencer/annexer.sh Commande globale. Version obsolète 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 210504

↑ 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 dans la sructure 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 :
  vβ 200604 Auto-éditer_un_wikilivre/Auto-référencer/INSTALLER.sh shell exécutable

  vβ 210419 Liste des fichiers à copier Texte pour mémoire, préférer lancer les copies avec la page wikilivres

  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 aussiModifier

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 testsModifier

Fichiers nécessaires à l'installationModifier

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'applicationModifier

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 testsModifier

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

header.pot et annex.pot (sources en anglais)Modifier

  Ces fichiers se placent dans le répertoire_de_travail/resources/lang, pas dans le répertoire src/lang/po comme la page pourrait le suggérer.

header.pot

annex.pot

header.po et annex_es.po espagnolModifier

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çaisModifier

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

annex.1 anglaisModifier

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

annex_es.1 espagnolModifier

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

annex_fr.1 françaisModifier

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

doc2html.shModifier

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

documentationModifier

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

iconsModifier

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

localeModifier

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

mimeModifier

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

manuelsModifier

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

maintenanceModifier

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

RéférencesModifier

  1. https://www.linuxtricks.fr/wiki/personnaliser-son-shell-alias-couleurs-bashrc-cshrc
  2. Installer les fichiers de l'application originale en français