Annexes de wikibooks

Une version imprimable du livre « Annexes de wikibooks » est disponible. (voir/modifier)

Avant-propos

Pourquoi titrer Annexes_de_wikibooks plutôt que Annexes_de_wikilivres sur un site en français ?

Wikilivres peut désigner :
* Wikibooks, un projet de la Wikimedia Foundation, aussi connu en français sous le pseudo « Wikilivres »
* Wikilivres, un site web hébergeant des livres passés dans le domaine public (propriété intellectuelle) selon la loi canadienne.

Pourquoi « vouloir » créer une page Annexe aux livres de Wikibooks ?

* Cette page Annexe n'a d'intérêt que pour les livres publiés, elle est automatiquement créée lors des commandes à PediaPress.
* Éditer et imprimer un livre par ses propres moyens peut avoir plusieurs raisons: être perfectionniste ou/et être déçu par la recomposition automatique des pages par PediaPress

Sommaire

modifier
    1 Sommaire
    2 Genèse
        2.1 Résumé introductif (mars-avril 2020)
        2.2 Tests de faisabilité ( et tests des premiers modules )
    3 Développement des scripts en français
        3.1 Premier programme ( Annexer )
            3.1.1 Version imprimable
            3.1.2 Codes de l'application en français avec les manuels
            3.1.3 Copier les codes sources avec la version imprimable
    4 Développement international des scripts
        4.1 Deuxième programme ( Annexer / Add_appendix )
            4.1.1 *** Copier les codes sources avec la version imprimable
            4.1.2 Installations
                4.1.2.1 Une première installation en version personnelle
                4.1.2.2 Une deuxième installation en version administrateur
                4.1.2.3 Une troisième installation en version tous-utilisateurs
                4.1.2.4 Une dernière installation (Makefile)
                4.1.2.5 Installation par paquets
    5 Notion d'empaquetage
        5.1 Exemple avec le paquet mkaddappendixdocu.deb
            5.1.1 Généralités sur l'empaquetage Linux-ubuntu
                5.1.1.1 Structure de l'archive bêta mkaddapendixdocu
                5.1.1.2 mkaddapendixdocu
                5.1.1.3 changelog.debian
                5.1.1.4 copyright
                5.1.1.5 changelog
                5.1.1.6 README
                5.1.1.7 postrm
                5.1.1.8 control
                5.1.1.9 postinst
                5.1.1.10 ./empaqueter
                5.1.1.11 ./installer
                5.1.1.12 ./desinstaller
                5.1.1.13 ./KONSOLE
                5.1.1.14 Création de la structure
            5.1.2 script pour faciliter la création de mk-addapendix-docu.bash
    6 Dépôt d'un paquet linux-ubuntu sur un site de confiance
    7 Références

Genèse

modifier

C'est arrivé comme ça.
Créer une application pour générer automatiquement la page Annexe des livres de Wikibooks, semblable à celle produite par PediaPress.
PediaPress utilise une application spéciale accessible par les utilisateurs sur le panneau gauche de l'éditeur:
Créer une compilation

L'idée est d'utiliser le contenu édité de cette compilation.

La page de compilation sur le site français a cette forme [[Wikilivres:Compilations/TITRE DU LIVRE]]

Exemple de page:
Wikilivres:Compilations/Faire_fleurir_le_sel
Exemple de contenu de page: ce sont des liens vers des sous-pages
:[[Faire fleurir le sel/Couverture|Faire sa fleur de sel]]
:[[Faire fleurir le sel/Introduction|Introduction]]
:[[Faire fleurir le sel/Préparation|Préparation]]
:[[Faire fleurir le sel/Filtrer et aseptiser|Filtrer et aseptiser]]
:[[Faire fleurir le sel/Récolter|Récolter]]

[[Catégorie:Compilations|Faire fleurir le sel]]
[[Catégorie:Versions imprimables]]
[[Catégorie:Minilivres]]
[[Catégorie:Brochure]]

Pour créer le livre il faut lancer un terminal et créer un répertoire que l'on a appelé "Annexe" dans notre expérience. Ensuite il faut créer l'application qui va décortiquer les sous-pages du livre pour en extraire tous les renseignements utiles à l'édition de l'Annexe du livre.

Wikibooks se veut accessible à tous. Le langage de programmation que nous avons choisi est le Bash sous linux ubuntu.
Linux ubuntu est installable en auto-démarrage (autoboot) sur une clé usb.

Résumé introductif (mars-avril 2020)

modifier
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, il décrit en détail la progression de la programmation.

Français:
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.
Voila donc un bon passe-temps pour remplir des journées vides de sens.

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

It is a good pastime to fill empty days of meaning.


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é. [1]

Tests de faisabilité ( et tests des premiers modules )

modifier
  • Choix du langage de programmation, et tests des premiers modules.

Auto référencer [2]

Auto référencer Version imprimable (36 pages) [3]

Développement des scripts en français

modifier

Premier programme ( Annexer )

modifier
  • Avec les tests de tous les modules

Version imprimable

modifier
  • Cette version du logiciel Annexer reprend les scripts et complémente le livre pour être exploitable tel quel.

Annexer (92 pages) [4]

  • Ce logiciel de démonstration est téléchargeable par ftp

Codes de l'application en français avec les manuels

modifier

Auto-éditer_un_wikilivre#codes_de_l'application_en_français_avec_les_manuels[5]

Copier les codes sources avec la version imprimable

modifier

Auto-éditer_un_wikilivre#Copier_les_codes_sources_avec_la_version_imprimable [6]

Développement international des scripts

modifier
  • Les messages et les manuels doivent être en anglais et traduits en français et autres langues.
  • Les codes sources sont habituellement écrits en anglais afin d'assurer la maintenance universelle.

Deuxième programme ( Annexer / Add_appendix )

modifier
  • Au mois de mai 2020 l'idée de partager cette application dans la communauté internationale s'est imposée.
Dans un premier temps
Les modules de programmes ont les mêmes que ceux du programme Annexer. Ils ont été réécrits pour être utilisés à la fois en langue française avec Annexer et anglaise avec Add_appendix dans les versions ultérieures la version double sera probablement être supprimée lorsque les traductions auront été effectuées.
Dans un deuxième temps
Les modules pré-annex, annexer et addapendix ont été ajoutés et la librairie annex.lib s'est étoffée.
Avec le programme bêta
Nous avons voulu produire des scripts selon la tradition de Wikibooks:
  1. qu'ils soient pédagogiques (? pas facile)
  2. qu'ils soient publics et lisibles, donc sans compilations pour leurs exécutions, cependant nous voulons qu'ils soient utilisables sur d'autres systèmes d'exploitation. Seuls les scripts destinés aux administrateurs peuvent être compilés et copiés dans sbin avec shc pour linux ou exécutables sous windows avec mingw
  3. que les messages soient traduisibles avec gettext dans toutes les langues et adaptables pour d'autres systèmes d'exploitation.
  4. Les scripts seront produits sous linux ubuntu

*** Copier les codes sources avec la version imprimable ***

modifier
Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/Version_imprimable[7]

Installations

modifier
  • Exception faite pour l'installation par paquets, ces installations sont fastidieuses.
  • Il est possible d’installer ce logiciel sous Windows avec Cygwin

Une première installation en version personnelle

modifier
  • users_install_annex.sh: permet de créer la structure de base des répertoires. et de suivre les indications de l’installation_utilisateur:
installation utilisateur[8]

Une deuxième installation en version administrateur

modifier
  • On fait de mème avec le script admin_install_annex.sh cette installation plus compliquée est plutôt destinées aux familiers de la programmation sous Linux.
installation administrateur[9] script à revoir

Une troisième installation en version tous-utilisateurs

modifier
  • Cette installation est possible avec 'install_annex.sh' script à revoir après une expérience avec une des installations précédentes.
  • Le nombre de répertoires est réduit dans le répertoire utilisateur. Le logiciel est entièrement installé dans le système Linux.
dans: /usr/local/bin, /usr/local/lib /usr/local/sbin, /usr/share/man, /usr/share/locale etc.

Une dernière installation (Makefile)

modifier
  • Installation avec le Makefile_d'installation_de_Add-appendix_proposé_aux_tests[10]. Cette installation remplace avantageusement la troisième installation.

Désinstallation

modifier
  • La désinstallation concerne tous les logiciels énumérés ci-dessus

Note: La désinstallation des paquets est incluse dans les paquet et ne nécessite pas une désinstallation séparée

Désinstallation du logiciel Annexer (juin 2020)
if [ /usr/share/man/fr.UTF-8/man1/annex.1.gz -ot /usr/share/man/fr.UTF-8/man1/annexer.1.gz ]; then sudo rm /usr/share/man/fr.UTF-8/man1/annex.1.gz; fi
if test -e /usr/share/man/fr.UTF-8/man1/annexer.1.gz; then sudo rm /usr/share/man/fr.UTF-8/man1/annexer.1.gz; fi
gzip ~/Annexer
rm -rf ~/Annexer
Désinstallation du logiciel Add_appendix (Novembre 2021)
if test -e /usr/share/man/fr.UTF-8/man1/annexer.1.gz; then sudo rm /usr/share/man/fr.UTF-8/man1/annexer.1.gz; fi
if test -e /usr/share/man/fr.UTF-8/man1/annex.1.gz; then sudo rm /usr/share/man/fr.UTF-8/man1/annex.1.gz; fi
if test -e /usr/share/man/man1/annex.1.gz; then sudo rm /usr/share/man/man1/annex.1.gz; fi
gzip ~/Add_Appendix
rm -rf ~/Add_appendix
Désinstallation de l'installation par Makefile
  • Le Makefile contient tous les fichiers d'installation et doit inclure sa propre désinstallation « ./désinstall »

Installation par paquets

modifier
  • C'est l'installation facile sous linux. Les paquets .deb et .rpm et sont en cours d'écriture, en fin décembre 2021 pour la version bêta-1.

Notion d'empaquetage

modifier

Exemple avec le paquet mkaddappendixdocu.deb

modifier
Apprendre à empaqueter

Généralités sur l'empaquetage Linux-ubuntu

modifier

Structure de l'archive bêta mkaddapendixdocu

modifier


Dépôt d'un paquet linux-ubuntu sur un site personnel de confiance (PPA)

modifier

La finalité se trouve dans ce Wikilivre technique avec la construction du paquet addappendix

Références

  1. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Résumé_introductif
  2. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer
  3. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/Version_imprimable
  4. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_orignale)/Version_imprimable
  5. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre#codes_de_l'application_en_français_avec_les_manuels]]
  6. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre#Copier_les_codes_sources_avec_la_version_imprimable
  7. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)/Version_imprimable
  8. https://fr.wikibooks.org/w/index.php?title=Annexes_de_wikibooks/installation_utilisateur
  9. https://fr.wikibooks.org/wiki/Annexes_de_wikibooks/installation_administrateur
  10. https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#Makefile_d'installation_de_Add-appendix_proposé_aux_tests