# Add appendix (experimental software)

Created by : User:Goelette_Cardabela for wikibooks the 24 march 2022 Wiki Manual, see also: French Add_appendix wiki manual Last update : 30/03/2022
Révision : 25 mars 2022

## DESCRIPTIONS

    The appendix (VO), annex, add_appendix/annexer (VI), addappendix softwares creates Appendix pages for books from wikibooks.
    Requirements for all versions: The mkd must be installed.

## VERSIONS

* Lexicon: (VO): Original version in french. (VI): Internationalized version. Compiled book: Collection of article obtained through the menu Create a collection to print with PediaPress or to create an Appendix of books with addappendix.
* annexer (VO) is the original version of this appendix page creator software series:
annex, add_appendix, addappendix. The messages of the executable scripts are in French, they are executable in the following order: lister, télécharger, ajouter_sclt, ajouter_sclic, ajouter_sclip.inc, sclipwb, sclipco, or, globally : annexer The construction of the appendix page can thus be controlled step by step as provided in the "directive destinée à l'apprentissage de la programmation bash". - Note - The appendix pages of the books and booklets of the schooner Cardabela were produced with this version of June 2020.
* annex follows the version annexer (VO). This internationalized version can be used in all languages. The original language of the messages is English as it should be for internationalization with gettext. Scripts are executable successively and are translated individually.
* add_appendix/annexer (VI) is the final version after annex. It is composed of the basic files of the annex version to which we have added two scripts intended to facilitate the creation of the book directory containing the files necessary for the execution of the program annex which is a component of it. In the same way the scripts are executable successively, starting with pre-annex The Makefile add_appendix.mak facilitates the installation of this version in the user directory ~/Add_appendix
* addappendix is the packaged version for easy installation on linux. The ubuntu package can be converted for other systems like fedora, red hat, and others. The Makefile addappendix.mak facilitates the installation of this version in the user directory ~/Add_appendix and in the /usr/local system without going through the package.
    Characteristics of each software:
   * annexer (VO) is simple, exclusively in French.
   * annex requires a manual action to create the book directory and copy the contents of book to it.You can use pre-annex to create the contents of the book directory.
   * add_appendix/annexer (VI) creates the directory of the book and copies there the files necessary for the execution of the program, it takes into account the summaries, contents, collections.
   * addapendix creates program execution conditions and runs exclusively whith a URL from compiled book$^{SeeLexicon}$

## annexer (VO)

    Reference pages: Annexer (Version_orignale)
    Revision date: 01/07/2020
    Lang: French
    Download: yes
    Manual installation: possible (easy): Copy scripts from wikibooks to files in ~/Annexer directory
    Traditional linux manual: French. 'annexer_fr.1'
    Usage: annexer < BookName | ? > [ -v ] [ -pb | -pc ]
    Options:
       ? : help
       -v : Verbose mode
       -pb : Search the images of the book in fench wikibooks.
       -pc : Search images in commons
    Example: LivreTest
* Open a terminal and verify if mkd$^{software}$ is present; (man mkd or mkd \?)
* Create the directory ~/Annexer/LivreTest.
* Enter in directory Annexer.
* Edit https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/contenu
* Copy edited part to ~/Annexer/LivreTest/LivreTest.contenu
* Run ./annexer LivreTest
* Compare with ./annexer LivreTest -pb and ./annexer LivreTest -pc
    - Note: - To integrate the images of the root of the book you can add the address of the book at the beginning of the file LivreTest.contenu :
    Note that the appendix software only knows the site https://fr.wikibooks.org, we are not looking for the name of the site of origin of the book.

## annex

    Reference pages: Software development
    Revision date: 04/10/2021
    Lang: English, French
    Download: No. You can copy scripts from wikibooks to files(.sh) in ~/Add_appendix/src/Add_appendix directory
    Manual installation: yes or whith add_appendix.mak which includes annex
    Traditional linux manual: English annex_en.1, French annex_fr.1
    Usage: annex < BookName | ? > [ -v ] [ -pb | -pc ]
    Options:
       ? : Help
       -v : Verbose mode
       -pb : Find the pictures in site wikibooks.
       -pc : Find the pictures in site wikimedia commons
    Exemple: Project TestBook
Since May 2021 we use pre-annex to configure the book directory:

### Documentation of program pre-annex

* Open a terminal
* Enter in ~/Add_appendix directory
* Éxécute bin/pre-annex https://en.wikibooks.org/wiki/User:Goelette_Cardabela/Sandbox/TestBook
* Éxécute bin/annex TestBook
* Compare with bin/annex TestBook -pb and bin/annex TestBook -pc
    - Note: - To integrate the images of the root of the book check that the address of the book is present inAdd_appendix/books/TestBook/TestBook.contents.

## add_appendix/annexer (VI)

    Référence pages: Software development
    Revision date: 04/03/2022
    Lang: English, French
    Download: No. See https://en.wikibooks.org/wiki/User:Goelette_Cardabela/Sandbox/Add_appendix. You can copy scripts from wikibooks to files(.sh) in ~/Add_appendix/src/Add_appendix directory
    Manual installation: yes, with add_appendix.mak
    Traditional linux manual: {{{1}}}, {{{1}}}.
    Usage: add_appendix < Full URL of book | ? > [ -v ] [ -pb | -pc ]
       or annexer < Full URL of book | ? > [ -v ] [ -pb | -pc ]
    Options:
       ? : Help
       -v : Vervose mode
       -pb : Search the images of the book in fench wikibooks.
       -pc : Search images in commons
    Example 1: project TestBook. Compare ease of execution against previous examples with annex (VO) and annex
* Open a terminal
* Enter in the executables directory (Bindir) ~/Annexer/bin or ~/Add_appendix/bin
* Éxecute ./add_appendix https://en.wikibooks.org/wiki/User:Goelette_Cardabela/Sandbox/TestBook/Content
* The directory structure of the book is created, you can exécute in bin directory : ./annex TestBook -pb and ./annex TestBook -pc, and Compare the results.
    - Note: - To integrate the images of the root of the book you can add the address of the book at the beginning of the file LivreTest.content :
    Example 2: project Hélices de navires à déplacement
       Bindir = directories ~/Annexer/bin or ~/Add_appendix/bin
       Éxecute Bindir/annexer https://fr.wikibooks.org/wiki/Hélices_de_navires_à_déplacement/Sommaire
    - Note: - If the executables files are in /usr/local/bin it is useless to specify Bindir

## addapendix

At date 28/03/2022 the addappendix software is not completely tested.
    References pages: addappendix
    Date of revision: jj/mm/2022
    Lang: English, French
    Download: --> package ubuntu in april or may 2022
    Usage: addappendix < Full URL of compiled-book| ? > [ --v ]
    Options:
       ? : Help
       --v : addappendix version
    Example: Faire sa fleur de sel compilé
* Open a terminal
* exécute this command : addappendix https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel
    - Note: -
       The addappendix command is in directory /usr/local/bin.
       The working directory is ~/Add_apendix
       After executing the previous command the book directory will be ~/Add_apendix/books/Faire_sa_fleur_de_sel

## SEE ALSO
### Add_appendix directories

    structure of add_appendix directories

### Manuals

Usages: 'man man1 manuel' if the manual is installed, otherwise: 'nroff -man manuel.1 | less'
    'nroff -man manuel.1 | col -b > manuel.txt' (Text manual to correct spelling)
    'nroff -man -Tps manuel.1 > manuel.ps' (Postscript or PDF)
    'man2html manuel.1 > manuel.html'
Général:
    If the manual is installed it can be displayed in the declared language of the environment (echo $LANG) else in english.
man1: $^{26/03/2022:greeninprogress,blueinreview,orangeincreation}$
* Users manuals
    bin: annexer, annex, add_appendix, addappendix, header.inc, lister, télécharger, ajouter_sclt, ajouter_sclic, ajouter_sclip.inc, sclipwb.
    sbin: compil2bin, docu2html, htmlman, install_datasfiles, textman, updt-manuals, userman, users_install_annex
man3:
* Sub routines, library functions .
    lib: findbook, cpcleaned2bin.sh, ecfpc.sh, killalldoc.sh
man7:
* Miscellaneous, packages, conventions, etc.
    Makefiles: add_appedix, addapendix
    Packages: addappendix

### Lang

Directory: Add_appendix/share/resources/lang/po
    References files in english (.pot): add_appendix.pot, add_sclic.pot, add_sclipco.pot, add_sclipwb.pot, add_sclt.pot, annexer.pot,annex.pot, en_sclic.inc.pot,en_sclipco.inc.pot, en_sclt.inc.pot, header.inc.pot, list.pot, pre-annex.pot, scli.inc.pot
Directory: Add_appendix/share/resources/lang/po/fr
    French translation files (.po): add_sclic.po, add_sclipco.po, add_sclipwb.po, add_sclt.po, annexer.po, annex.po, en_sclic.inc.po, en_sclipco.inc.po, en_sclipwb.inc.po, en_sclt.inc.po, fr_FR_addappendix.po, header.inc.po, scli.inc.po
    Files translated into French (.mo): addappendix.mo, add_sclic.mo, add_sclipco.mo, add_sclipwb.mo, add_sclt.mo, annexer.mo, annex.mo, en_sclic.inc.mo, en_sclipco.inc.mo, en_sclipwb.inc.mo, en_sclt.inc.mo, fr_FR_addappendix.mo, header.inc.mo, scli.inc.mo
directories of translated files .mo
* Directory: Add_appendix/share/locale/fr/LC_MESSAGES, for user files translated into French, for TEXTDOMAINDIR="~/Add_appendix/share/locale" in the header of the executable files.
* Directory: /usr/share/locale/fr/LC_MESSAGES, for files translated into French, for all users for TEXTDOMAINDIR="/usr/share/locale" in headers of executables files.

### Documents

In directories: Add_appendix/share/doc/Add_appendix, usr/local/share/doc/Add_apendix, /usr/share/doc/addappendix
    Copyright
    README
and more

## REFERENCES

* ↑ https://en.wikipedia.org/wiki/mkd_(software)
* ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer
* ↑ https://fr.wikibooks.org/wiki/Goélette_Cardabela
* ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/Annexer_(Version_orignale)
* ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/télécharger_par_ftp
* 1 2 https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#Développement_du_logiciel
* ↑ https://fr.wikibooks.org/wiki/addappendix
* ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Structure_du_répertoire_Add_appendix