Auto-éditer un wikilivre/addappendix/manual Add appendix en

Attention : modification en cours !link={{{link}}}

Un contributeur est en train de retravailler en profondeur cette page. Vous êtes prié(e) d'éviter de le modifier pour limiter les risques de conflit de versions jusqu'à disparition de cet avertissement. Merci.

Created by : User:Goelette_Cardabela for wikibooks the 24 march 2022
Wiki Manual: https://fr.wikibooks.org/w/index.php?title=Auto-%C3%A9diter_un_wikilivre/addappendix/manuel_Add_appendix_en
Last update : jj/mm/aaa

Add_appendix SOFTWARES
DESCRIPTIVE MANUAL

Révision : 25 mars 2022

DESCRIPTIONS modifier

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

VERSIONS modifier

  • 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.
  1. 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"[2].
    - Note -
    The appendix pages of the books and booklets of the schooner Cardabela[3] were produced with this version of June 2020.
  2. 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.
  3. 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
  1. 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 bookSee Lexicon

annexer (VO) modifier

Reference pages: Auto-éditer un wikilivre/Auto-référencer/Annexer (Version orignale)[4]
Revision date: 01/07/2020
Lang: French
Download: yes[5]
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
  1. Open a terminal and verify if mkdsoftware is present; (man mkd or mkd \?)
  2. Create the directory ~/Annexer/LivreTest.
  3. Enter in directory Annexer.
  4. Edit https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/contenu
  5. Copy edited part to ~/Annexer/LivreTest/LivreTest.contenu
  6. Run ./annexer LivreTest
  7. 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 :
; Article maître du livre
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest|LivreTest]]
; Contenus
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleUn|ArticleUn]]<br />
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleDeux|ArticleDeux]]<br />
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleTrois|ArticleTrois]]
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 modifier

Reference pages: Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#Développement_du_logiciel[6]
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:

Header documentation pre-annex.sh
#H Workdir is ~/Add_appendix or ~/Annexer
#H Executable file : Workdir/bin/pre-annex
#H Syntax : pre-annex <Full-url-of-book >
Documentation of program pre-annex
#F Ce programme pré-annexe la construction de l'annexe du livre
#F Si ce programme s'est bien exécuté, le répertoire de projet aura été créé
#F - le fichier projet.suffixe et un fichier html local auront été créés dans
#F - le répertoire du projet
#F Il est proposé d'éditer la page 'Contenu' ou 'Sommaire' ou de 'Compilation'
#F   afin d'être éventuellement recopiée manuellement dans le fichier 
#F   projet.suffixe
  1. Open a terminal
  2. Enter in ~/Add_appendix directory
  3. Éxécute bin/pre-annex https://en.wikibooks.org/wiki/User:Goelette_Cardabela/Sandbox/TestBook
  4. Éxécute bin/annex TestBook
  5. 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) modifier

Référence pages: Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#Développement_du_logiciel[6]
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: anglais, français.
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
  1. Open a terminal
  2. Enter in the executables directory (Bindir) ~/Annexer/bin or ~/Add_appendix/bin
  3. Éxecute ./add_appendix https://en.wikibooks.org/wiki/User:Goelette_Cardabela/Sandbox/TestBook/Content
  4. 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 modifier

At 28.03/2022 the addappendix software is not completely tested.

References pages: Auto-éditer un wikilivre/addappendix[7]
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é
  1. Open a terminal
  2. 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 modifier

Add_appendix directories modifier

structure of add_appendix directories[8]

Manuals modifier

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: vert en cours, bleu en révision, orange en création

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

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 modifier

In directories: Add_appendix/share/doc/Add_appendix, usr/local/share/doc/Add_apendix, /usr/share/doc/addappendix

Copyright
README

and more

REFERENCES modifier

  1. https://en.wikipedia.org/wiki/mkd_(software)
  2. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer
  3. https://fr.wikibooks.org/wiki/Goélette_Cardabela
  4. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/Annexer_(Version_orignale)
  5. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/télécharger_par_ftp
  6. 6,0 et 6,1 https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#Développement_du_logiciel
  7. https://fr.wikibooks.org/wiki/addappendix
  8. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Structure_du_répertoire_Add_appendix