Auto-éditer un wikilivre

Un livre de Wikilivres.
Aller à la navigation Aller à la recherche
Quoi de mieux que de se lancer à écrire un programme en bash pendant cette période de confinement. (mars-avril 2020)
It is good to started learning and writing a program in bash during this containment period. (introduction trancrite en anglais)
Cette étude a été initiée avec l'article Auto-éditer un wikilivre/Auto-référencer. cet article décrit en détail la progression de la programmation.

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.

It's kind of like a puzzle. We believe that the command line we just wrote will work immediately, but no! After some time we will go to the forums hoping to find a solution; even if hope only to understand the difference between brackets and double brackets: (...) ((...)) ... {...} all these brackets are similar and do not express the same concept. (texte français trancrit en anglais)|

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

It is a good pastime to fill empty days of meaning. (texte français trancrit en anglais)

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 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/04/25 by GC
#P Last test date    : 2021/04/20 by GC
#P This program installs the directory structure for the annex program of wikibooks.
#P

#O clean screen
   clear;
   
#O Version
    VERSION=210425
    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 lib lib/src sbin share src 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 End 'install_annex.sh'
exit 0
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
#H File users_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/users_install_annex.sh [Install directory | ? ]
#H   The installation directory can be /usr/local or /usr or ~/Annexer or ~/Add_appendixby default
#P Creation date     : 2021/04/16 by GC
#P Modification date : 2021/04/18 by Clara
#P Modification date : 
#P Last test date    : 2021/04/19 by Clara
#P This program install the directory structure for the annex program of wikibooks.
#P

#O clean screen
   clear;
   
#O Version
    VERSION=210419
    if [ "$1" = "-v" ]; then echo "Version of users_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/users_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
    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
#T Breakpoint exit 0

#O Create or recreate directory hierarchy
    cd $Workdir
    echo -n "The current directory to create $Workdir sub directories = "; pwd
    mkdir bin datas lib resources sbin share src
    cd share
    echo "$Workdir/share is the current directory to create sub share directories."; pwd
    mkdir man doc doc/html 
    mkdir -p man man/{man1,fr,fr/man1,fr.UTF8,fr.UTF8/man1,es,es/man1}
#T Breakpoint exit 0
    
#O If the install dir is '/usr/local' and if the number of files in /usr/local/src dir is not 9 files
#O   print copy all source files to appropriate directory
    rm -r ~/tmp; mkdir ~/tmp
    if test "$1"="/usr/local/" 
    then
      ls -l /usr/local/src > ~/tmp/src.txt
      wc -l ~/tmp/src.txt | cut -d ' ' -f1 > ~/tmp/nblines.txt
      read nblines < ~/tmp/nblines.txt
      if test "$nblines" != "10" 
      then 
        echo " Nuber of files '$nblines' in /usr/local/src is incorrect" 
        echo " Please copy all nine annex internationalized sources files in $Workdir/src directory to update $Installdir/bin";
      fi 
    fi

#T Test if  working/src dir empty   
    ls -l $Workdir/src | grep total | cut -d ' ' -f 2 > ~/tmp/n.txt
    read n < ~/tmp/n.txt
    if test "$n" = "0" 
    then 
      echo " Nb files in $Workdir/src is '$n'"
      echo; echo " Directory $Workdir/src is empty"
      echo " If you want install or update $Installdir/bin directory, copy all nine annex internationalized sources files in $Workdir/src directory";
    else
      ls -l $Workdir/src > ~/tmp/src.txt
      wc -l ~/tmp/src.txt | cut -d ' ' -f1 > ~/tmp/nblines.txt
      read local nblines < ~/tmp/nblines.txt
      if "$nblines" != "10" 
      then 
        echo " Nuber of files '$nbline' in /usr/local/src is incorrect" 
        echo " Please copy all nine annex internationalized sources files in $Workdir/src directory to update bin directory"
      else
        echo " Want you update $Bindir files ?"
        read -s -n1 -pinkey  inkey
        if test "$inkey"="y"
        then
#O       *** Copy src files from install directory to bin directory
#P        1-annex.lib,2-annex.sh,3-header.inc.sh,4-list.sh,5-dowload.sh,6-add_sclt.sh,7-add_sclic.sh,8-add_sclip.inc.sh,9-sclipco.sh,10-sclipwb.sh
          cd $Workdir/src
          Lbindir=$Workdir/bin
          echo "$Workdir/src is the current directory to copy source files to $LBindir directories"
          if ! test -e annex.sh; then cat annex.sh | grep -v "#o\|#P\|#T" > $LBindir/annex; chmod 755 $LBindir/annex; fi
          if ! test -e header.inc.sh; then cat header.inc.sh | grep -v "#o\|#P\|#T" > $LBindir/header.inc; chmod 755 $Bindir/header.inc; fi
          if ! test -e list.sh; then cat list.sh | grep -v "#o\|#P\|#T" > $Bindir/list; chmod 755 $LBindir/list; fi 
          if ! test -e download.sh; then cat download.sh | grep -v "#o\|#P\|#T" > $Bindir/download; chmod 755 $LBindir/download; fi
          if ! test -e add_sclt.sh; then cat add_sclt.sh | grep -v "#o\|#P\|#T" > $Bindir/add_sclt; chmod 755 $LBindir/add_sclt; fi
          if ! test -e add_sclic.sh; then cat add_sclic.sh | grep -v "#o\|#P\|#T" > $Bindir/add_sclic; chmod 755 $LBindir/add_sclic; fi
          if ! test -e add_sclip.inc.sh; then cat add_sclip.inc.sh | grep -v "#o\|#P\|#T" > $Bindir/add_sclip.inc; chmod 755 $LBindir/add_sclip.inc; fi
          if ! test -e src/sclipco.sh; then cat src/sclipco.sh | grep -v "#o\|#P\|#T" > $Bindir/src/sclipco; chmod 755 $LBindir/sclipco; fi
          if ! test -e sclipwb.sh; then cat sclipwb.sh | grep -v "#o\|#P\|#T" > $Bindir/sclipwb; chmod 755 $LBindir/sclipwb; fi
#O       Copy user bin files from working directory to installdir bin directory if install directory is /usr/local
          if [ "$Bindir" = "/usr/local" ]; then sudo mv $Lbindir*.* $bindir/.; cp -f *.sh /usr/local/src/.; fi
        else echo " $LBindir directorie is not updated"
      fi
    fi
  fi
      
    rm $Workdir/datas/installdir.var
    echo "Installdir=$Installdir" > $Workdir/datas/installdir.var
    echo "Workdir=$Workdir" >> $Workdir/datas/installdir.var
    echo "Bindir=$Bindir" >> $Workdir/datas/installdir.var
    
    if ! test -e /usr/local/lib/annex.lib  ||  ! test -e $Workdir/lib/annex.lib 
    then
      if  ! test -e /usr/local/lib/annex.lib ; then Libdir=/usr/local/lib; elif  ! test -e $Workdir/lib/annex.lib ; then Libdir=$Workdir/lib; fi
      echo "Libdir=$Libdir" >> $Workdir/datas/installdir.var
      echo; echo "Found in $Libdir : "; ls $Libdir
    else echo; echo "Lib directory not found"
    fi
    
    if  ! test -e /usr/local/sbin/users_install_annex.sh  ||  ! test -e $Workdir/sbin/users_install_annex.sh ;
    then
      if  ! test -e /usr/local/sbin/users_install_annex.sh ; then Sbindir=/usr/local/sbin; elif  ! test -e $Workdir/sbin/users_install_annex.sh ; then Sbindir=$Workdir/sbin; fi
      echo "Sbindir=$Sbindir" >> $Workdir/datas/installdir.var
      echo; echo "annex.lib found in $Sbindir : "; ls $Sbindir; echo
    else echo "sbin directory not found" 
    fi
    
    echo; echo "Content of file $Workdir/datas/installdir.var"
    cat $Workdir/datas/installdir.var
	
	if [ $1 = "Annexer" ]; 
	then 
	  echo; echo "Commande = $1"
	  echo; echo "Se connecter à l'url :"
	  echo "https://fr.wikibooks.org/wiki/Autoéditer_un_wikilivre/Annexer_(Version_internationalisée)#src.orig_en_français"
	  echo "Copier les pages de codes, les coller dans un éditeur de texte et les enregistrer dans les répertoires spécialisés"
	  echo "Les fichiers : "
	  echo " sources, dans le répertoire $1/src"
	  echo " de données dans $1/datas"
	  echo " de librairies, dans $1/lib"
	  echo " d'exécutables de maintenance, dans  $1/sbin (chmod 755 * dans sbin)"
	  echo " de documentation dans $1/share/doc"
	  echo " de manuels dans $1/share/man"
	  echo; echo "Finalement rééxécuter cette commande $1/sbin/users_install_annex.sh"
	fi
	  
	if [ $1 = "Add_appendix" ] || [ "$1" = "/usr/local" ];
	then 
	  echo; echo "Command = $1"
	  echo; echo "Login to url :"
	  echo "https://fr.wikibooks.org/wiki/Autoéditer_un_wikilivre/Annexer_(Version_internationalisée)#Codes_sources_(internationalized_source_code)"
      echo "Copy code pages in memory, paste them in a text editor and save in the specialized directory"
	  echo "The files :"
	  echo " sources in the directory Add_appendix/src"
	  echo " datas in Add_appendix/datas"
	  echo " library in Add_appendix/lib"
	  echo " executable for maintenance, in Add_appendix/sbin (chmod 755 * in sbin)"
	  echo " documentation in Add_appendix/share/doc"
	  echo " manuals in Add_appendix/share/man"
	  echo; echo "Finaly reexecute this command Add_appendix/sbin/users_install_annex.sh"
	  if [ "$1" = "/usr/local" ]; then echo "copy all files and directories to /usr/local :"; echo "  sudo cp -R Add_appendix/* $1/.";fi
	fi

#O Clean tmpfiles
    rm -r ~/tmp


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

Cette version est à utiliser sous linux.

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

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

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]

  • 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[17] :
 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.lib[modifier | modifier le wikicode]

Bien avancé vβ 210415 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/annex.lib


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

pre-annex.sh[modifier | modifier le wikicode]

Complet vβ 210512 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/pre-annex.sh

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

À moitié réalisé vβ 210421 Auto-éditer un wikilivre/Annexer (Version internationalisée)/src/header.inc.sh - Version="210421"

annex.sh[modifier | modifier le wikicode]

À moitié réalisé vβ 210326 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/annex.sh

list.sh[modifier | modifier le wikicode]

À moitié réalisé vβ 210321 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/list.sh

download.sh[modifier | modifier le wikicode]

Non commencé Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/src/download.sh

add_sclt.sh[modifier | modifier le wikicode]

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

add_sclic.sh[modifier | modifier le wikicode]

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

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

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

sclipco.sh[modifier | modifier le wikicode]

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

sclipwb.sh[modifier | modifier le wikicode]

Non commencé [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.sh[modifier | modifier le wikicode]

À 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é.
En finition/En voie de finition? terminaison? vβ 210417 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é.
En finition/En voie de finition? terminaison? vβ 210418 users_install_annex.sh

cp-src2bin.sh[modifier | modifier le wikicode]

cp-src2bin.sh installe les fichiers exécutables du programme dans le répertoire bin à partir des fichiers sources.
En finition/En voie de finition? terminaison? vβ 210328 Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/cp-src2bin.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é 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.

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

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

En cours 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

En cours 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

En cours 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

En cours 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

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

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

En cours 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

Une version complète existe 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

Une version complète existe 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

Une version complète existe 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 :
En finition/En voie de finition? terminaison? vβ 200604 Auto-éditer_un_wikilivre/Auto-référencer/INSTALLER.sh shell exécutable

En finition/En voie de finition? terminaison? vβ 210419 Liste des fichiers à copier Texte pour mémoire, préférer lancer les copies avec la page wikilivres

Une version complète existe Auto-éditer_un_wikilivre/Auto-référencer/html_data_conversions Copie pour contrôle du fichier INSTALLER.sh
md5sum : c7a7e6eb3347e2f0d614df29029d5578

Une version complète existe 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]

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