Outils logiciels
page précédente Script "FAIT"	[ table des matiéres ] [ Retour a la page d'accueil ] [ liste générale des documents ]	page suivante Exemples de fichiers de mise en page

5/ Manuel de "cart"

cart est un script en bash qui crée un page HTML listant la totalité des documents d'un répertoires.
Le principe est trés simple : un ls recursif est executé depuis la racine du répertoire, donnant la liste de tous les fichiers dans le répertoire et tous les sous répertoires. Ensuite la sortie de la commande ls est traitée en y rajoutant un formattage HTML pour créer une page lisible par un navigateur et contenant un lien sur cahque fichier de la page.
On obtient une présentation qui suit donc le format de sortie de ls par sous répertoire dans l'ordre alphabétique. Pour modifier la présentation de sortie il faudrait jouer sur les options de ls .
Ce fichier est fait pour etre placé à la racine du répertoire qui a été "cartographié".
Quelque finesses ont été rajoutés à ce système : dans la présentation des fichiers par sous repertoires les fichiers sont palcé par types c'est à dire en fait par extension.
Les extensions reconnues sont :

pour les fichiers ayant une extension pdf, gif, jpg, png, swf, le script recherche dans leurs sous repertoire respectif les fichiers HTML (.htm) qui les appéllent et rajoutent un commentaire au nom du fichier.
Aucune recherche n'est faite en dehors du sous repertoire du fichier : si un dessin est appelé depuis un autre répertoire que lsien ce ne sar pas pas vu par "cart". Les fichier .txt et .rtf sont supposés être les copies "sources" ayant servie à engendrer le répertoire où ils se trouvent. Les fichiers nommés "index.htm" sont supoosés être les index des répertoires explorés.
Les fichiers HTML (.htm) reçoivent comme commentaire le titre de niveau <H1> du fichier. Si le fichier comporte plusieurs titre de niveau <>H1>, le résultat sera bizarre.
Les fichiers sans extensions ou avec des extensions non connues sont repertoriés comme "type de fichier non reconnus par le listage automatique".

5.1/ options

Aucune options

5.2/ Entrées

Aucune entrées : cart doit être lancé dans le répertoire à explorer. Il n'y a pas d'autre moyens de lui indiquer ce qu'il doit faire.

5.3/ Sorties

Cart sort la page HTML sur sa sortie standard, cet à dire par défaut la console. Il faut faire une redirection de la sortie sur un fichier pour obtenir un fichier HTML lisible. exemple : cart > liste-des-doc.htm

5.4/ Licence

Licence GPL.
Ce script est distribué tel quel sans aucune garantie.

5.5/ Auteur

Sylvain Pujolle, CIP Glenan

CIP glenan
BP 525
29185 CONCARNEAU CEDEX

cip.glenans@free.fr

5.6/ Bogues

Cart ne cherche pas les fichiers liens sur les figures en dehors du répertoires ou se trouve la figure.
Cart donne l'appélation "figure" en fonctions des extensions ce qui est souvent inadaptés pour les fichiers PDF.
Aucun traitement des erreurs n'est réalisé.
Cart ne fonctionne que si les fichiers HTML ne contiennent qu'un titre <H1>.

page précédente
Script "FAIT"

[ table des matiéres ]
[ Retour a la page d'accueil ]
[ liste générale des documents ]

page suivante
Exemples de fichiers de mise en page

Les Glenan, l'école :
http://cip.glenans.free.fr