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

Auto-éditer un wikilivre
Add_appendix Version internationalisée
Éditeur : wikibooks users

# Table des matières par chapitres
## Progammes de maintenance 117

Add appendix
Programmes d'installation et de dépendances
Éditeur : Goelette Cardabela

# install_annex.sh

Ces programmes sont à exécuter deux fois afin de générer les fichiers de traduction ! 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}$

## Description - Recommandations

* install_annex.sh is tested with test_install_annex.bash and Copy2Tmp.bash
* This script install Add_appendix or Annexer for single user or Add_appendix for all users
* Syntax to install and tests: The scripts to tests are all in user working tests directory
* Syntax to install directly:

## Copy2Tmp.bash
# users_install_annex.sh

users_install_annex.sh Installe la structure des répertoires du programme annex pour produire les pages Annexe des wikilivres. Cette commande peut être ré-exécutée à volonté. $^{vβ210722}$

## test_users_uninstall_annex.sh
### Install this executable shell code in tests directory or in ~/Tmp

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.

## uploadfromTmp.sh
### Install this executable script in tests directory 00-install_annex/.

Add appendix
annex.lib, (findbook), (ecfpb), (ecfpc)
Éditeur : Goelette Cardabela

# annex.lib

La fontion findbook est validée, les fonctions ecfp* sont à réviser. 17 mai 2021 à 11:38 (CEST) $^{vβ210514}$
* 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/
* Cette librairie est à mettre à jour dans les répertoires : ~/Annexer/lib/ et/ou ~/Add_appendix/lib/ et/ou /usr/local/lib/
Tester le code source de la fonction findbook avec test_findbook.bash Tester le code source de la fonction ecfpb avec ecfpb.sh (extract contents from printable book) Tester le code source de la fonction ecfpc avec ecfpc.sh (extract contents from compiled book) Tester le code source de la fonction cpcleaned2bin avec test_cpcleaned2bin Tester le code source des fonctions de killalldoc avec test_killalldoc.bash

## Fonction findbook

$^{β-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)

## Fonction ecfpb.sh

$^{β-210409}$ - Tester le code source de la fonction ecfpb avec test_ecfpb.bash] (extrait le contenu des livres imprimables)

## Fonction ecfpc.sh

$^{β-210415}$ - Tester le code source de la fonction ecfpc function with test_ecfpc.bash (extrait le contenu des livres compilés)
Add appendix
pre-annex.sh
Éditeur : Goelette Cardabela

# addappendix + annexer

L'internationalisation des messages est faite pour les deux scripts $^{vβ210516}$

## add_appendix.sh

addappendix.sh doit être converti en add_appendix.sh
* français: add_appendix est le programme qui lance tout le programme de création de l'annexe des livres de wikibooks
** Il fait appel au programme pre-annex pour créer les répertoire et condition d'exécution du script annex
* anglais: add_appendix is ​​the program that launches the entire program for creating the appendix of wikibooks books
* espagnol: add_appendix es el programa que lanza todo el programa para crear el apéndice de libros de wikilibros

## annexer.sh

* annexer est le programme qui lance tout le programme de création de l'annexe des livres de wikibooks
** annexer permet de créer la documentation en français, vérifie la validité de la ligne de commandes et fait appel à add_appendix.
** les traductions de add_appendix en français font de annexer un programme en langue française
https://fr.wikibooks.org/wiki/Auto-%C3%A9diter_un_wikilivre/Annexer_(Version_internationalis%C3%A9e)/src/addappendix.sh%2Bannexer.sh

# pre-annex.sh

L'internationalisation des messages est faite $^{vβ210516}$

## pre-annex.sh
### unrecognized_links.dat

Data file in $Datasdir to remove unwanted links

## test_pre-annex.bash

Install this code in ~/Add_appendix/tests/prannex.sh to test preannex.sh

### sitelist.sh

Install this code in /Add_appendix/tests, to product sitelist.txt

### sitelist.txt
#### sitelist.txt to test program annex sub-programs

Add appendix
header.inc.sh
Éditeur : Goelette Cardabela

# header.inc.sh

L'internationalisation des messages est faite $^{vβ210519}$
Ce fichier d'entête doit être inclus dans tous les modules par la commande 'source' : source $Bindir/header.inc Dans ses dernières versions : - header.inc.sh est un fichier source et header.inc est un script exécutable dont les commentaires d'organigramme #O #P et #T pour les programmeurs sont supprimés. Les commentaires de structure #S ont été réduits au minimum. - Les messages en anglais sont introduits pour l'internalisation avec gettext. En deuxième partie: exemple de fichier de commande d'un test tests/header.inc/test_header.inc.bash

## List to tests header.inc

sitelist.sh

### text list for tests

Sitelist.txt
Add appendix
annex.sh
Éditeur : Goelette Cardabela

# annex.sh

L'internationalisation des messages est faite $^{vβ210616}$ français: Avant d'utiliser cette commande en mode exécutable,
* la structure des répertoires du programme doit être correctement installée ou mise à jour avec la commande: ~/Tmp/users_install_annex.sh,
* les livres doivent avoir été initialisés avec la commande: bin/pre-annex du répertoire de travail de l'application Annexer ou Add_appendix.
anglais: To use this annex command,
* you must have initialized the program directories with: ~/Tmp/users_install_annex.sh or reset with sbin/users_install_annex.sh,
* the books must have been initialized with the command: bin/pre-annex from the working directory of the Add_appendix application

## Global test

Add appendix
list.sh
Éditeur : Goelette Cardabela

# list.sh

$^{vβ210523}$
Les messages en anglais sont introduits pour l'internalisation avec gettext. les commentaires #P pour les programmeurs sont en anglais, les autres commentaires ont été réduits au minimum.

## content_cleaner.dat

Ce fichier supprime l'espace après ';' et ": ", ':', "* ", '*' "# ", '#' devant la parenthèse '['
S'utilise de la façon suivante :
echo "Chaîne de caractères" | sed -f $Datasdir/content_cleaner.dat
ou :
cat "$Bookname.$Suffix" | sed -f $Datasdir/content_cleaner.dat > "$Bookname.$Suffix.cleaned"
Add appendix
download.sh
Éditeur : Goelette Cardabela

# download.sh

$^{vβ210528}$

## tests_download.sh

Add appendix
add_sclt.sh
Éditeur : Goelette Cardabela

# add_sclt.sh

$^{vβ}$

## add_sclt.sh

cette commande se décompose en un programme principal et des sous programmes en français et en anglais d'autres langues peuvent s'ajouter en fonction des livres de sites wikibooks autres que français et anglais

## en_sclt.inc

Version pour l'internatioalistion avec gettext

## See results
### LivreTest

LivreTest.sclt

### TestBook

TestBook.sclt
Add appendix
scli.inc.sh
Éditeur : Goelette Cardabela

# scli.inc.sh

$^{vβ}$

## scli.inc.sh

Ce fichier est l'entête des fichiers d'images scli, il est inclus dans toutes les commandes scli : add_sclic, add_sclipco, add_sclipwb
This file is included in all scli image commands, add_sclic, add_sclipco, add_sclipwb

## Sources des images licences et contributeurs

Les sources listées pour chaque illustration fournissent des informations de licence plus détaillées, y compris le statut des droits d'auteurs, les détenteurs de ces droits et les conditions de licence.

### For books in English
## Images sources licenses and contributors

The sources listed for each illustration provide more detailed licensing information, including copyright status, the holders of these rights and the license conditions.
Add appendix
add_sclic.sh
Éditeur : Goelette Cardabela

# add_sclic.sh

$^{vβ}$

## add-sclic.sh

Cette commande appelle en_scli.inc ou fr_scli.inc selon l'origine de wikibooks

## tests_add_sclic.bash

Add appendix
add_sclipco.sh
Éditeur : Goelette Cardabela

# add_sclipco.sh

$^{vβ}$

## Add_sclipco.sh

This is the master command for personified source, copyright, license for images on wikibooks (sclipco) and include en_sclipco.inc or fr_sclipco.inc

### en_sclipco.inc content gettext for translations.
## tests_add_sclipco.bash

Add appendix
add_sclipwb.sh
Éditeur : Goelette Cardabela

# add_sclipwb.sh

$^{vβ}$ Les images sont téléchargées depuis le site wikibooks
Illustrations are downloaded from wikibooks

## add_sclipwb.sh

This is the master command for personified source, copyright, license for images on wikibooks (sclipwb) and include en_sclipwb.inc or fr_sclipwb.inc

### en_sclipwb.inc content gettext for translations.
## tests_add_sclipwb.bash

Add appendix
Programmes de maintenance
Éditeur : Goelette Cardabela

# copy sources to sbin/src

cp-src2bin.sh installe les fichiers exécutables du programme dans le répertoire bin à partir des fichiers sources. $^{vβ210419}$

## Compil2bin.sh

* Attention this script is common for lib, sbin, and src for Add_appendix software
* this script is used in package addappendix-O~210927

## test_compil2bin.bash

* test program is in $Testdir/01-sbsrc/O11/compil2bin.sh/
* This test program also makes the manual copyable to /usr/share/man/man1/.
* syntax: sudo cp compil2bin_en.1.gz /usr/share/man/man1/compil2bin.1.gz

## Manuel
# copy all tested commands to src and bin directories

cp_all_to_Add_appendix.bash copie toutes les commandes testées vers les répertoires src et bin de Add_appendix. $^{vβ210616}$ Ce script commande la mise à jour, ou l'installation, de tous les fichiers éprouvés dans le répertoire des tests de l'application Add_appendix