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

Livre compilé : Utilisateur:Goelette_Cardabela/Compilations/Annexer (Version orignale)
Annexe obtenue avec : addappendix https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Compilations/Annexer_\(Version_orignale) Scripts de la version internationalisée
Contenu du livre : Auto-éditer un wikilivre/Annexer (Version orignale)/Contenu
Annexe obtenue avec : ./annexer Annexer -pb Scripts de la version originale
Auto-éditer un wikilivre
Annexer (Version orignale)
Éditeur : Goelette Cardabela

# Table des matières par chapitres
## Manuels

Annexer_(Version_orignale)
Installer les fichiers de l'application
Éditeur : Goelette Cardabela

# Installer les fichiers de l'application
## Préinstaller l'application sur le PC

    Note : BASH doit être installé sur le PC; il existe en standard sous linux.
    1. Copier le code suivant dans un terminal de votre PC, et exécuter la commande.
    2. La méthode d'installation manuelle est la plus simple. Copier et coller les codes de l'application, dans un éditeur de texte, les enregistrer dans le répertoire ~/Annexer que vous venez de créer.
    3. Contenu du répertoire Annexer après l'installation
    Les sources shell.sh sont copiées dans le répertoire Annexer/src, les manuels dans Annexer/man, LivreTest est créé pour l'exécution de Annexer LivreTest
Annexer_(Version_orignale)
Fichiers pour les tests
Éditeur : Goelette Cardabela

# Fichiers pour les tests avec LivreTest

LivreTest.contenu

## Article maître du livre

    Le lien suivant est nécessaire pour les livres qui n'ont pas leur page à la racine de wikibooks. On peut éviter cette ligne avec la commande : annexer Utilisateur:Goelette_Cardabela/Sandbox/LivreTest en remplacement de annexer LivreTest, au risque de saturer le buffer de la ligne de commandes et de provoquer un dysfonctionnement de l'application annexer.
Utilisateur:Goelette_Cardabela/Sandbox/LivreTest

## Contenus

ArticleUn ArticleDeux ArticleTrois
LivreTest.compilé

## LivreTest
### Tests de référencement
#### Article maître du livre

    LivreTest

#### Contenus

    Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleUn
    Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleDeux
    Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleTrois
Annexer_(Version_orignale)
Téléchargement de l'application
Éditeur : Goelette Cardabela

# Téléchargement de l'application

Il est possible de télécharger cette application expérimentale à but éducatif à l'adresse ci-dessous : Annexer-fr_200701.zip Copies des articles avec le lien ci-dessous. md5sum : c4825faa84eef1514d72edb0bd7b394e Annexer-fr_200701.zip. Les droits de copies et de partages sont ceux des articles de wikilivres téléchargés. Remarque concernant l'état du serveur de téléchargements
Annexer_(Version_orignale)
header.inc.sh
Éditeur : Goelette Cardabela

# header.inc.sh

Fichier d'entête, inclus dans tous les modules. Version 210505

## header.inc.sh

* Ce code est à transcrire dans le répertoire ~/Annexer/tests/header.inc.sh et ne doit pas être exécutable.
* Lorsque le code est éprouvé, le transcrire dans le répertoire ~/Annexer/src
* Le code header.inc validé peut être transcrit dans le répertoire ~/Annexer/bin et ne doit pas être exécutable, le code doit être inclus dans un programme appelant par la commande 'source ~/Annexer/bin/header.inc'
* Notez que ce code a été testé et peut être copié dans le répertoire des sources sans subir de tests préablables.

### ctrl-header.inc.bash

Ce code est à transcrire dans le répertoire ~/Annexer/tests/header.inc.sh et doit être rendu exécutable (chmod 755 ctrl-header.inc.bash)

#### ctrl-header.inc.bash contrôle des codes de header.inc.sh

    vérifie que les lignes de codes ne contiennent pas de commentaire et lance les tests de validation avec test-header.inc.bash ci-après.

### test-header.inc.bash

Ce code est à transcrire dans le répertoire ~/Annexer/tests/header.inc.sh et doit être rendu exécutable
Annexer_(Version_orignale)
lister.sh
Éditeur : Goelette Cardabela

# lister.sh

Crée les fichiers de listes pour les modules suivants. Version obsolète 200701
Annexer_(Version_orignale)
télécharger.sh
Éditeur : Goelette Cardabela

# télécharger.sh

Télécharge les pages de Wikilivres selon les listes générées.Version obsolète 200623
Annexer_(Version_orignale)
ajouter_sclt.sh
Éditeur : Goelette Cardabela

# ajouter_sclt.sh

Ajoute l'entête pour les textes et les articles de l'Annexe. Version obsolète 210125
Annexer_(Version_orignale)
ajouter_sclic.sh
Éditeur : Goelette Cardabela

# ajouter_sclic.sh

Ajoute l'entête globale pour les images et illustration, etc. Version obsolète 210125
Annexer_(Version_orignale)
ajouter_sclip.inc.sh
Éditeur : Goelette Cardabela

# ajouter_sclip.inc.sh

Ajoute les textes des conditions de copie des images. Version obsolète 210125
Annexer_(Version_orignale)
sclipwb.sh
Éditeur : Goelette Cardabela

# sclipwb.sh

Ajoute, par article, les liens vers les images selon Wikilivres. Version obsolète 210125
Annexer_(Version_orignale)
sclipco.sh
Éditeur : Goelette Cardabela

# sclipco.sh

Ajoute, par article, les liens vers les images selon Commons. Version obsolète 210125
    ↑ Ce module sclipco.sh utilise des données produites par le module sclipwb sclipco.sh l’exécutable est à réviser. Avis du 30 juillet 2020 et du 25/01/2021.#! /bin/bash # Fichier : sclipco.sh VERSION=210125 #P Nom du fichier de commandes : sclipco #P Syntaxe : "ajouter_sclipco <nom du livre>" #P Exemple : "./ajouter_sclpco LivreTest" à la console. #P Date de création : 16 mai 2020 #P Modifié le : 18 mai 2020 par GC #P Modifié le : 20 mai 2020 par GC lignes 25 à 37 'Retour' de ajouter_sclip. #P Modifié le : 30 mai 2020 par CG pour l'installation automatique du module. #P Modifié le : 4 juin 2020 par GC mise à jour des liens d'exécution. #P Version de la documentation sur WikiLivres le : 20 mai 2020 #P## Une version 'commons' est possible en co-édition avec la commande #P## 'ajouter_sclic'. #P## Les images, sources, licences, auteurs sont copiés dans les #P## sous-répertoires respectifs depuis le sous-répertoire du livre. #P## Les noms des images de 'commons' commencent par 'File:' alors qu'en #P## version wikibooks les noms des images commencent par 'Fichier:' #P## Dans l'exemple 'LivreTest' : #P## cd $Projet/ArticleUn; ls Fichier*.html Fichier*.html.* | sed s/Fichier:/File:/g > ArticleUn.commonshtmlpict #P## while read pict; do cp $Projet/$1/$pict .; done < ArticleUn.commonshtmlpict #P## Il suffit de construire la page LivreTest.sclip à partir des fichiers : #P## *.title, *.source, *.license, *.auteur #P if [ $0=sclipco ]; then echo "sclipco : Version "$VERSION; fi #O inclure dans bin : ajouter_sclip.inc ou, dans src/* ajouter_sclip.inc.sh source ajouter_sclip.inc Retour=$? #T echo "Code de retour de la commande ajouter_sclip : " $Retour #O si le code de retour est différent de '0' if [ $Retour -gt '0' ] && [ $Personal = "true" ]; #O alors afficher le nom du module de commande en erreur et quitter 'annexer' #O avec retour à 1 then echo "Erreur au module shell 'ajouter_sclip'" exit 1 #O fin si fi echo "fichier cible : "$PageScliP echo "------" #T exit #O tant que l'on peut lire les lignes du fichier $Projet/$1.pj while read pjline do #O si la ligne lue n'est pas $1 (nom du livre) #T echo "ligne lue : " $line if [ $pjline != $1 ] #O alors: then #T echo "ligne prise en compte : " $pjline #O entrer dans le répertore de l'article, cd $Projet/$pjline #O lister les 'Fichier*.html' et Fichier*.html.* dans le fichier #O $pjline.commonshtmlpict ls Fichier*.html Fichier*.html.* | sed s/Fichier:/File:/g > $pjline.commonshtmlpict #O copier les fichiers Fichier*.html Fichier*.html.* du répertoire #O $Projet/$1 while read pict; do cp $Projet/$1/$pict .; done < $pjline.commonshtmlpict #O copier le nom de l'article dans $1.sclip echo "'''Article : $pjline'''<br \>" >> $PageScliP echo "'''Article : $pjline'''" #P## Annexe version 'commons' ############################## #O sélectionner les images de chaque articles dans Article/htmlcommons.list #O exclure .title|.source|.license|.auteur|.str|.tmp cat $pjline.commonshtmlpict | grep -v -E ".title|.source|.license|.auteur|.str|.tmp" > htmlcommons.list #T cat htmlcommons.list #O tant qu'il y a des lignes d'images dans le fichier htmlcommons.list while read htmlcommonsline do #O images, cat $htmlcommonsline.title >> $PageScliP cat $htmlcommonsline.title #O source, cat $htmlcommonsline.source >> $PageScliP cat $htmlcommonsline.source #O license, cat $htmlcommonsline.license >> $PageScliP cat $htmlcommonsline.license #O auteur(s). cat $htmlcommonsline.auteur >> $PageScliP cat $htmlcommonsline.auteur #O terminer la page $P$PageScliP echo "" >> $PageScliP #O fin du tant qu'il y a des lignes d'images done < htmlcommons.list #O fin du 'si la ligne n'est pas le nom du livre'. fi #O fin du tq .pj done < $Projet/$1.pj #O terminer la page $PageScliP echo "</div>" >> $PageScliP echo "{{Nouvelle page imprimée}}" >> $PageScliP exit 0 # Fin de sclipco.sh
Annexer_(Version_orignale)
annexer.sh
Éditeur : Goelette Cardabela

# annexer.sh

Commande globale. Version obsolète 200626
Annexer_(Version_orignale)
cp-localsrc-2-localbin
Éditeur : Goelette Cardabela

# cp-localsrc-2-localbin

. Version 210504
    ↑ L'Installateur ci-dessous installe les fichiers de commandes dans le répertoire d'exécution ~/Annexer, il doit d'être installé en mode exécutable dans le répertoire des sources ~/Annexer/src.
Annexer_(Version_orignale)
Manuel linux annexer_fr.1
Éditeur : Goelette Cardabela

# Manuel linux annexer_fr.1
## Les fichiers suivants doivent être installés dans le répertoire ~Annexer/man puis installés avec makeman_annexer.sh

Fichier nroff avec un aperçu, pour l'installation du manuel français version 200626 Fichier : annexer_fr.1
    annexer_fr.1 ci-après est formaté nroff pour manuels au format Unicode UTF-8
    Le manuel est lisible au format UTF-8 par la commande man .\annexer_fr.1
    Il est lisible éventuellement au format ASCII par la commande : nroff -man annexer_fr.1
    Lors de l'installation il sera renommé annexer.1 et installé dans le répertoire des manuels français UTF-8.
Code d'extraction :
#Aperçu

## Aperçu

Annexer_(Version_orignale)
Manuel annexer_fr.html
Éditeur : Goelette Cardabela

# Manuel annexer_fr.html

Fichier html avec un aperçu, pour l'installation du manuel français version 200626

## Le manuel html s'installe dans le répertoire /usr/local/share/doc/annxer/annexer_fr.html

#Aperçu html (aspect du manuel au format html) Pas de très bonne qualité, ne reproduit pas correctement l'aspect du manuel.
#Aperçu annexer_fr.txt (manuel annexer_fr.txt.gz décompressé) De bonne qualité, reproduit correctement l'aspect du manuel.)

## Aperçu annexer_fr.txt
### Ce fichier est normalement compressé au format .gz

    annexer_fr.txt.gz
Annexer_(Version_orignale)
makeman_annexer.sh
Éditeur : Goelette Cardabela

# makeman_annexer.sh

Cet exécutable installe le manuel dans la sructure unix/linux en français.