Auto-éditer un wikilivre/addappendix

Un livre de Wikilivres.
Aller à la navigation Aller à la recherche
En travauxlink={{{link}}}

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.






AA256x256.png





Logiciel addapendix
imprimable

 

 

Ce livre technique fait suite à une série d'articles dont le sujet est la création des annexes de Wikibooks.

Un historique de ces travaux est décrit dans le livre technique Annexes de wikibooks

On peut examiner scripts de faisabilité et de la version française originale imprimable

 

 

Table des matières[modifier | modifier le wikicode]

À faire...link={{{link}}}

À la fin, après copie du TOC ajouter les numéros des pages puis supprimer le TOC ou créer la table des matières avec OpenOffice.

 

 



Documents et directives[modifier | modifier le wikicode]

Ébauche vβ 220109 Éditer





Généralités[modifier | modifier le wikicode]

  • Les messages et les manuels doivent être écrits en anglais puis traduits dans d'autres langues.

Directives libres de programmation[modifier | modifier le wikicode]

Directive de programmation établie par Goelette Cardabela et J Clara . Janvier 2022
  1. Le langage de programmation est le shell BASH non compilé afin d'être facilement lisible.
  2. L'indentation des lignes de scripts est à la discrétion des programmeurs.
  3. Les fichiers de commandes pour sbin/ pourront éventuellement être compilés avec shc sans l'extension .sh.x
  4. Les fichiers sources bash auront l'extension .sh
  5. Les fichiers exécutables seront obtenus par extraction du code shell, les messages seront extraits en fichiers .pot
  6. Les fichiers .pot devront rester à la disposition des des mainteneurs et des utilisateurs pour assurer les traductions dans d'autres langues.
  7. Les scripts doivent être largement documentés en anglais pour assurer la maintenance universelle.
  8. Les organigrammes commencent par #O en première colonne.
  9. Les commentaires pour les programmeurs commencent par #P en première colonne.
  10. Les points particulier d'attention commencent par #w en première colonne
  11. Les entêtes commencent par #H en première colonne

Convention d'entêtes :

#!/bin/bash
#H Header doc
#H -------------------------------
#H File : <source>/<file>.sh
#H Syntax : <executable> [ ?  | -v ]
#H Created : AAMMDD by <wikibooks user>
#H Updated : AAMMDD by ... for
#O Organizational chart
#O -------------------------------
#P Programmers notes
#P -------------------------------
VERSION=AAMMDD
TEXTDOMAIN=<executable>
TEXTDOMAINDIR="/usr/share/locale"
export TEXTDOMAINDIR
#P . gettext for translation
. gettext.sh
#O Script begin here
....
#O Script end
Encodage du programme principal
Directive d'encodage établie par J Clara . Janvier 2022
  1. Le logiciel addappendix n'aura qu'un seul programme principal par opposition aux logiciels Annexer et Add_appendix qui disposaient de plusieurs point d'entrée dont la principale était annex.
  2. La ligne de commandes contiendra uniquement le lien vers le livre compilé et les deux options « ? » et « -v » la commande sera détaillée dans le manuel.
  3. Le script addappendix pourra être constitué de parties des scripts déjà éprouvés du logiciel Add_appendix.
  4. Les fichiers qui ne contiennent pas de texte traductible avec gettext pourront être inclus dans le script addappendix.sh avec la directive « source » ou « . ». Ces scripts devront être accessibles dans la librairie addappendix.lib (/usr/lib/addappendix.lib ou /usr/local/lib/addapendix.lib) selon la directive d'installation du paquet.
  5. Les scripts seront éprouvés dans le répertoire des tests puis assemblés progressivement en un seul. Noter que les scripts ont déjà été éprouves avec Add_apendix.

Documents pour l'utilisateur[modifier | modifier le wikicode]

manuel traditionnel[modifier | modifier le wikicode]

code[modifier | modifier le wikicode]

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.

  • Le code comprimé addappendix.1.gz en anglais doit être placé dans le répertoire par défaut /usr/share/man/man1/.
  • Le code comprimé addappendix.1.gz traduit en français doit être placé dans /usr/share/man/fr.UTF-8/man1/.
.\" Création par Utilisateur:Goelette_Cardabela pour wikilivres le 26 juin 2020
.\" Vérifications UTF-8 par Clara le 6 novembre 2012
.\" Mise à jour par GC le 28 août 2021 pour Add_appendix
.\" Mise à jour par GC le 14 décembre 2021 Retouches
.\" .
.\" FILE manuel annex_fr.1 to edit in UTF-8 format

.TH annex 1 "14 Décembre 2021"

.SH NOM
annex \- Crée la page Annexe des livres de wikilivres.

.SH RÉSUMÉ
\fBannex\fP  < \fBnom du livre  |  ? \fP >   [ -v ]  [ -pb | -pc ]

.SH DESCRIPTION
\fBannex\fP permet de créer les pages \fIAnnexe\fP des livres de Wikilivres.

.SH PRÉ-REQUIS
Les répertoires de l'application doivent  être créés grâce à la commande users_install_annex.sh 
.TP
Le logiciel mkd doit être installé: https://en.wikipedia.org/wiki/Mkd_(software)
.TP
Le répertoire du livre doit être créé et contenir les wikicodes de la compilation ou du sommaire ou encore du contenu du livre. \
Pour les livres de wikibooks anglais et français ce travail peut être simplifié grâce à la commande pre-annex <url> complète du livre ou de la compilation. \
\fIannexer\fP et \fIaddappendix\fP sont aussi des commandes simplifiées

.SS Options
.TP
\fB ?\fR
Affiche la syntaxe de la commande.
.TP
\fB-v\fR
Mode bavard (Verbose mode)
.TP
\fB-pb\fR
Crée une version personnalisée du classement des images avec les données du serveur Mediawiki  \fIWikilivres\fP.
.TP
\fB-pc\fR
Crée une version personnalisée du classement des images avec les données du serveur Mediawiki \fICommons\fP

.SH "EXIT STATUS"
L'application renvoie normalement la valeur 0 et une valeur différente en cas d'erreur

.SH ERREURS
Les erreurs les plus fréquentes peuvent être causées par des débordement de la capacité de la ligne de commandes. \
Il peut être intéressant, à titre exceptionnel, de créer une page à la racine du serveur et de créer une redirection \
vers une page plus longue, afin de débloquer la ligne de commande. Il serait plus judicieux de renommer le nom de\
la page trop longue vers la racine du site Wikibooks avec un nom plus court.

.SH FICHIERS
Il existe de nombreux fichiers dont les versions peuvent changer lorsque des améliorations sont souhaitées. \
Reportez votre attention, pour cette version française vers la section 19 :\
\fIhttps://fr.wikibooks.org/w/index.php?title=Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)&section=19\fP

.SH VERSIONS
Les versions sont notée AAMMJJ - AA pour année, MM pour mois, JJ pour jour, de la dernière modification.

.SH HISTOIRE
.PP
2020 - Début de l'histoire avec les confinements au domicile à cause du virus COVID-19 : 
\fIhttps://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre\fP
2021 - Internationalisation des codes et des messages avec les versions \fIAdd_appendix\fP et \fIAnnexer\fP
 
.SH TELECHARGEMENTS
.PP
https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#src.orig_en_français

.SH AUTEURS
.PP
Manuel créé par le wikipédien  : Goelette Cardabela

.SH NOTES
.PP
La  version 211214 de Add_appendix est une version bêta

.SH BUGS
.PP
Il est possible de créer une discussion sur l'ensemble du projet et également pour chaque article de ce logiciel, \
il suffit se connecter sur wikibooks : https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée) \
et de consulter la page de discussion de l'article concerné.

.SH EXEMPLES
Exécuter dans le répertoire Add_appendix/bin :
.TP
"./pre-annex https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel"
.TP 
"./annex Faire_sa_fleur_de_sel -pb"
.TP
Consulter le fichier "Faire_sa_fleur_de_sel.appendix"

.SH VOIR AUSSI
https://fr.wikibooks.org/wiki/Goélette_Cardabela/Référencement_manuel

aperçu[modifier | modifier le wikicode]

annex(1)                   General Commands Manual                   annex(1)

NOM
       annex - Crée la page Annexe des livres de wikilivres.

RÉSUMÉ
       annex  < nom du livre  |  ?  >   [ -v ]  [ -pb | -pc ]

DESCRIPTION
       annex permet de créer les pages Annexe des livres de Wikilivres.

PRÉ-REQUIS
       Les  répertoires  de l'application doivent  être créés grâce à la com‐
       mande users_install_annex.sh

       Le        logiciel        mkd        doit        être        installé:
       https://en.wikipedia.org/wiki/Mkd_(software)

       Le  répertoire du livre doit être créé et contenir les wikicodes de la
       compilation ou du sommaire ou encore du contenu  du  livre.  Pour  les
       livres de wikibooks anglais et français ce travail peut être simplifié
       grâce à la commande pre-annex <url> complète du livre ou de la  compi‐
       lation. annexer et addappendix sont aussi des commandes simplifiées

   Options
        ?     Affiche la syntaxe de la commande.

       -v     Mode bavard (Verbose mode)

       -pb    Crée  une  version  personnalisée du classement des images avec
              les données du serveur Mediawiki  Wikilivres.

       -pc    Crée une version personnalisée du classement  des  images  avec
              les données du serveur Mediawiki Commons

EXIT STATUS
       L'application renvoie normalement la valeur 0 et une valeur différente
       en cas d'erreur

ERREURS
       Les erreurs les plus fréquentes peuvent être causées par des  déborde‐
       ment   de  la  capacité  de  la  ligne  de  commandes.  Il  peut  être
       intéressant, à titre exceptionnel, de créer une page à  la  racine  du
       serveur et de créer une redirection vers une page plus longue, afin de
       débloquer la ligne de commande. Il serait plus judicieux  de  renommer
       le  nom dela page trop longue vers la racine du site Wikibooks avec un
       nom plus court.

FICHIERS
       Il existe de nombreux  fichiers  dont  les  versions  peuvent  changer
       lorsque  des  améliorations sont souhaitées. Reportez votre attention,
       pour cette version française  vers  la  section  19  :https://fr.wiki‐
       books.org/w/index.php?title=Auto-éditer_un_wikilivre/Annexer_(Ver‐
       sion_internationalisée)&section=19

VERSIONS
       Les versions sont notée AAMMJJ - AA pour année, MM pour mois, JJ  pour
       jour, de la dernière modification.

HISTOIRE
       2020  -  Début de l'histoire avec les confinements au domicile à cause
       du virus COVID-19 :  https://fr.wikibooks.org/wiki/Auto-éditer_un_wik‐
       ilivre  2021 - Internationalisation des codes et des messages avec les
       versions Add_appendix et Annexer

TELECHARGEMENTS
       https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Ver‐
       sion_internationalisée)#src.orig_en_français

AUTEURS
       Manuel créé par le wikipédien  : Goelette Cardabela

NOTES
       La  version 211214 de Add_appendix est une version bêta

BUGS
       Il  est  possible  de créer une discussion sur l'ensemble du projet et
       également pour chaque article de ce logiciel, il suffit  se  connecter
       sur   wikibooks   :  https://fr.wikibooks.org/wiki/Auto-éditer_un_wik‐
       ilivre/Annexer_(Version_internationalisée) et de consulter la page  de
       discussion de l'article concerné.

EXEMPLES
       Exécuter dans le répertoire Add_appendix/bin :

       "./pre-annex         https://fr.wikibooks.org/wiki/Wikilivres:Compila‐
       tions/Faire_sa_fleur_de_sel"

       "./annex Faire_sa_fleur_de_sel -pb"

       Consulter le fichier "Faire_sa_fleur_de_sel.appendix"

VOIR AUSSI
       https://fr.wikibooks.org/wiki/Goélette_Cardabela/Référencement_manuel

                               14 Décembre 2021                      annex(1)

manuel texte[modifier | modifier le wikicode]

manuel html[modifier | modifier le wikicode]

 



Reconstruction et tests du script addappendix[modifier | modifier le wikicode]

Ébauche vβ 220113 Éditer





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.

  • Cette page concerne le logiciel addappendix mis en paquet

script addapendix.sh[modifier | modifier le wikicode]

#!/bin/bash
#H Header doc
#H -------------------------------
#H File : tests/addappendix/addapendix.sh
#H Syntax : addapendix [ ?  | -v ]
#H Created : 220113 by GC
#H Updated : 220113 by ... for
#O Organizational chart
#O -------------------------------
#P Programmers notes
#P -------------------------------

VERSION=220117
TEXTDOMAIN=addappendix
TEXTDOMAINDIR="/usr/share/locale"
export TEXTDOMAINDIR

#P . gettext for translation
. gettext.sh

#O Script begin here
#O If parameters is empty
    if test -z $1
#O Then print the short syntax ant exit -1
    then 
	  echo -n -e "\033[31m"
      echo -n $"No parameter. addappendix [ <full url of book> | ? | -v ]"
	  echo -e "\033[0m"
	  exit -1
	fi

#O If firt parameter is '?'
	if [ "$1" = "?" ]
#O Then print syntax whih examples and exit 0
    then 
	  echo -n -e "\033[32m"
	  echo $"Syntax: addappendix [ <full url of book> | -v ]"
	  echo $"  Example 1 : addappendix https://en.wikibooks.org/wiki/Wikibooks:Collections/Guide_to_Unix"
	  echo $"  Example 2 : addappendix https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel"	  
	  echo -e "\033[0m"
      exit 0
	fi
#O IF first parameter is "-v"
    if [ "$1" = "-v" ]
#O Then print addapendix version
	then
	  echo -n -e "\033[32m"
	  echo -n $"addapendix version : $VERSION"
	  echo -e "\033[0m"
	  exit 0
	fi
	
#O *** First parameter analysis ***
#T    echo "$1"
#O Test if the first parameter points to wikibooks.org/wiki
    if echo $1 | grep wikibooks.org/wiki 
	then 
	  echo -n -e "\033[32m"	
	  echo -n $"  is a wiki-books"
	  echo -e "\033[0m"
    else
	  echo -n -e "\033[31m"	
	  echo -n $"$1 is not a wiki-book on wikibooks.org"
	  echo -e "\033[0m"
      exit -1
    fi
#O Check if $1 file exist
    if wget --spider $1 2>/dev/null; then
	  echo -n -e "\033[32m"		
      echo -n $"File $1 is found"
	  echo -e "\033[0m"	  
    else
	  echo -n -e "\033[31m"		
      echo -n $"File $1 is not found"
	  echo -e "\033[0m"
      exit -1
    fi

#O Find the bookname
    echo $1 | awk -F"/" ' { print $NF }' > bookname.txt
	read Bookname<bookname.txt
	echo; echo -n -e "\033[1;32m"		
	echo -n $"Book name : $Bookname"
	echo -e "\033[0m"
    echo $1 | awk -F"/" ' { print $5 }' > Compilations.txt
	read Compilations<Compilations.txt
	echo -n -e "\033[1;32m"		
	echo -n $"Compilations name: $Compilations"
	echo -e "\033[0m"
	if [ "$Compilations" = "Wikilivres:Compilations" ]; then Suffix=compiled; fi
	if [ "$Compilations" = "Wikibokoks:Collections" ]; then Suffix=collection; fi
    if test -z $Suffix; then Suffix=compiled; fi
    echo -n -e "\033[1;32m"		
	echo "Suffix = $Suffix"
	echo -e "\033[0m"

#O Create Bookname directory
    install -d ~/Add_appendix/books/$Bookname
	Projectdir=~/Add_appendix/books/$Bookname
#O Create temp directory in Wordir
	Workdir=~/Add_appendix
	mkdir -p $Workdir/temp
##O Create the file bookname.suffix
#T ***********************
#O Create $Projectdir/resources/TMP to download
    mkdir -p $Projectdir/resources/TMP
#O Download $1
    cd $Projectdir/resources/TMP
    rm -Rf $Projectdir/resources/TMP/* 2> /dev/null
    wget -N $1 -o $Workdir/temp/wget-log-télécharger.txt
    ls -1 > ../filename.txt
    read Filename<../filename.txt
    if [ "$Filename" = "filename.txt" ]; then echo $"line 113: \$Filename = filename.txt error, exit -1"; exit -1; fi
    rm ../filename.txt
#O go up in the directory resources and rename 'TMP' '$Filename'
    cd ..
    if test -e $Filename; then rm -R $Filename; fi
    if test -d $Filename 2>/dev/null
	then rm -R $Filename 2>/dev/null
    fi 
    mv TMP $Filename
    cd $Filename
#T  ls -al 
    cat $Filename|grep "<li><a href=">extract-li
    cat extract-li | sed "s/title=\"/\n[[/g" | grep -v "<li><a href=" |sed "s/\">/]]\n/g"|grep -v "</a>\|Cat\|<div" >extract-li1
    cat $Filename|grep "<dd><a href=">extract-dd
    cat extract-dd | sed "s/title=\"/\n[[/g" | grep -v "<dd><a href=" |sed "s/\">/]]\n/g"|grep -v "</a>" >extract-dd1
    cat extract-dd1 > $Bookname.$Suffix
    cat extract-li1 >> $Bookname.$Suffix
#T    echo "$Bookname.$Suffix = "
    cp $Bookname.$Suffix $Projectdir/$Bookname.$Suffix
#T ***********************
    if test -e $Projectdir/$Bookname.$Suffix
    then
	  echo -n -e "\033[1;32m"		
      echo -n "$Bookname.$Suffix : "
	  echo -e "\033[0m"
      cat $Projectdir/$Bookname.$Suffix
    fi
	
#O Download the book in html form
#O Télécharger le site récursivement avec une profondeur infinie ( -linf ), \
#O convertit les liens pour une consultation en local ( -k ), \
#O rapatrie tous les fichiers nécessaires à l'affichage convenable d'une page HTML ( -p ) \
#O et renomme toutes les pages HTML avec l'extension .html ( -E ) 
    echo; echo "Dowload $1"
    wget -r -linf -k -p -E "$1" -o $Workdir/temp/wget-log-télécharger.txt


    exit 0
#O Script end

script tests_addappendix.bash[modifier | modifier le wikicode]

#!/bin/bash
#H Header doc
#H -------------------------------
#H File : tests/addappendix/tests_addapendix.bash
#H Syntax : ./tests_addapendix.bash
#H Created : 220113 by GC
#H Updated : 220113 by ... for
#O Organizational chart
#O -------------------------------
#P Programmers notes
#P -------------------------------
VERSION=220116

echo -e "\033[1;033mtest addappendix.sh with first param empty\033[0m"
./addappendix.sh
sleep 3
echo "----"

echo -e "\033[1;033mtest addappendix.sh with first param = '?'\033[0m"
./addappendix.sh ?
sleep 3
echo "----"

echo -e "\033[1;033mtest addappendix.sh with first param = '-v'\033[0m"
./addappendix.sh -v
sleep 3
echo "----"

echo -e "\033[1;033mtest addappendix.sh with param = https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel\033[0m"
./addappendix.sh https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel

Résultat des tests[modifier | modifier le wikicode]

Au Terminal
cardabela@jpl-W230SS:~/addappendix-211219/tests/addapendix$ ./tests_addapendix.bash 
test addappendix.sh with first param empty
No parameter. addappendix [ <full url of book> | ? | -v ]
----
test addappendix.sh with first param = '?'
Syntax: addappendix [ <full url of book> | -v ]
  Example 1 : addappendix https://en.wikibooks.org/wiki/Wikibooks:Collections/Guide_to_Unix
  Example 2 : addappendix https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel

----
test addappendix.sh with first param = '-v'
addapendix version : 220117
----
test addappendix.sh with param = https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel
https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel
  is a wiki-books
File https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel is found

Book name : Faire_sa_fleur_de_sel
Compilations name: Wikilivres:Compilations
Suffix = compiled

Faire_sa_fleur_de_sel.compiled : 
[[Faire fleurir le sel/Couverture]]
[[Faire fleurir le sel/Introduction]]
[[Faire fleurir le sel/Préparation]]
[[Faire fleurir le sel/Filtrer et aseptiser]]
[[Faire fleurir le sel/Récolter]]

Dowload https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel

List of files created
cardabela@jpl-W230SS:~$ find Add_appendix/
Add_appendix/
Add_appendix/temp
Add_appendix/temp/wget-log-télécharger.txt
Add_appendix/books
Add_appendix/books/Faire_sa_fleur_de_sel
Add_appendix/books/Faire_sa_fleur_de_sel/Faire_sa_fleur_de_sel.compiled
Add_appendix/books/Faire_sa_fleur_de_sel/resources
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/fr.wikibooks.org
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/fr.wikibooks.org/robots.txt
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/fr.wikibooks.org/wiki
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/fr.wikibooks.org/wiki/Wikilivres:Compilations
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel.html
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/Faire_sa_fleur_de_sel
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/extract-dd1
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/Faire_sa_fleur_de_sel.compiled
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/extract-li1
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/extract-dd
Add_appendix/books/Faire_sa_fleur_de_sel/resources/Faire_sa_fleur_de_sel/extract-li





Construction du paquet ubuntu[modifier | modifier le wikicode]

  • Création d'un paquet dit origine

À moitié réalisé vβ 211220 Éditer






Créer l'archive origine[modifier | modifier le wikicode]

  • Le répertoire d’origine doit être en caractères minuscules
  • Il doit être de la forme <package>-<version>
  • Notre répertoire origine aura pour nom addappendix-211219
Créer l'original
Entrer dans le répertoire addappendix-211219'
dh_make --createorig

Nous obtenons à l'exécution avec l'option 'i' (indep):

Type of package: (single, indep, library, python)
[s/i/l/p]?
Maintainer Name     : Cardabela
Email-Address       : cardabela@unknown
Date                : Sun, 19 Dec 2021 14:57:49 +0100
Package Name        : addappendix
Version             : 211219
License             : blank
Package Type        : indep
Are the details correct? [Y/n/q]
Please respond with "yes", "no" or "quit" (or "y", "n" or "q")
Done. Please edit the files in the debian/ subdirectory now.
  • Cette commande va créer
  1. l'archive /home/cardabela/addappendix_211219.orig.tar.xz
  2. le répertoire /home/cardabela/addappendix_211219/debian qui contiendra les fichiers standard d'empaquetage:
addappendix.cron.d.ex    manpage.sgml.ex  README.source
addappendix.doc-base.EX  manpage.xml.ex   rules
addappendix-docs.docs    postinst.ex      salsa-ci.yml.ex
changelog                postrm.ex        source
control                  preinst.ex       watch.ex
copyright                prerm.ex
manpage.1.ex             README.Debian

On peut supprimer addappendix.doc-base.EX

Mise à jour des fichiers d'empaquetage[modifier | modifier le wikicode]

Note: https://www.debian.org/doc/manuals/maint-guide/dother.en.html#docs

changelog[modifier | modifier le wikicode]

changelog initial

addappendix (211219-1) unstable; urgency=medium

  * Initial release (Closes: #nnnn)  <nnnn is the bug number of your ITP>

 -- Cardabela <cardabela@unknown>  Sun, 19 Dec 2021 14:57:49 +0100
  • changelog peut être unstable, experimental, unreleased, version de linux ubuntu.
  • utiliser unreleased pour éviter l'enregistrement par erreur sur le ppa
addappendix (211219-1) unstable; urgency=medium

  * Initial Release.

 -- https://fr.wikibooks.org/wiki/Discussion_utilisateur:Goelette_Cardabela/addappendix  Sun, 19 Dec 2021 14:57:49 +0100

control[modifier | modifier le wikicode]

addappendix (211219-1) unstable; urgency=medium

  * Initial release 

 -- https://fr.wikibooks.org/wiki/Discussion_utilisateur:Goelette_Cardabela/addappendix  Sun, 19 Dec 2021 14:57:49 +0100
 

addappendix-docs.docs[modifier | modifier le wikicode]

  • Ces fichiers se trouvent dans le répertoire origine
  • Attention README dans le répertoire origine concerner les versions de Add_appendix indépendantes du paquet
README.Debian
README.source
SURVEY
TRANSLATIONS

copyright[modifier | modifier le wikicode]

Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: addappendix
Upstream-Contact: <preferred name and address to reach the upstream project>
Source: https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/addappendix

Files: *
Copyright: 2021 Goelette Cardabela french wikibooks user
           <years> <likewise for another author>
License: <special license>
 <Put the license of the package here indented by 1 space>
 <This follows the format of Description: lines in control file>
 .
 <Including paragraphs>

# If you want to use GPL v2 or later for the /debian/* files use
# the following clauses, or change it to suit. Delete these two lines
Files: debian/*
Copyright: 2021 Cardabela <goelette.cardabela@orange.fr>
License: GPL-2+
 This package is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.
 .
 This package is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 .
 You should have received a copy of the GNU General Public License
 along with this program. If not, see <https://www.gnu.org/licenses/>
 .
 On Debian systems, the complete text of the GNU General
 Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".

# Please also look if there are files or directories which have a
# different copyright/license attached and list them here.
# Please avoid picking licenses with terms that are more restrictive than the
# packaged work, as it may make Debian's contributions unacceptable upstream.
#
# If you need, there are some extra license texts available in two places:
#   /usr/share/debhelper/dh_make/licenses/
#   /usr/share/common-licenses/

preinst[modifier | modifier le wikicode]

postinst[modifier | modifier le wikicode]

prerm[modifier | modifier le wikicode]

postrm[modifier | modifier le wikicode]

Créer le Makefile original[modifier | modifier le wikicode]

  • Ce 'Makefile' est destiné aux tests afin de l'intégrer dans la production d'un 'paquet' ubuntu.
  • Il doit être placé dans le répertoire dit 'origine' addappendix_211219 qui contient les sources.
  • On entend par sources, toutes les sources, du programme, de la maintenance, des images, etc.
On se contentera d'adapter le Makefis d'installation

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

Empaqueter[modifier | modifier le wikicode]