Cahiers
enberg
GUT GUT GUT
m LE CTAN NAVIGATOR
P Christian Rossi
Cahiers GUTenberg, n 35-36 (2000), p. 215-221.
<http://cahiers.gutenberg.eu.org/fitem?id=CG_2000___35-36_215_0>
© Association GUTenberg, 2000, tous droits réservés.
L’accès aux articles des Cahiers GUTenberg (http://cahiers.gutenberg.eu.org/),
implique l’accord avec les conditions générales
d’utilisation (http://cahiers.gutenberg.eu.org/legal.html).
Toute utilisation commerciale ou impression systématique
est constitutive d’une infraction pénale. Toute copie ou impression
de ce fichier doit contenir la présente mention de copyright.
Le CTAN Navigator
ChristianRossi
LORIA/INRIALorraine
Campus Scientique
BP239
54602Vand÷uvre-lès-NancyCedex
Christian.Rossi@loria.fr
Résumé. LeCTAN Navigator (http://ctan.loria.fr) est un serveur WEB qui
fournit un ensembled'outils pourfaciliter larecherche,le transfert etl'installation
deschiersquisetrouvesurCTAN(ComprehensiveTeXArchiveNetwork).
1. Présentation de l'existant
CTAN (Comprehensive TeX Archive Network) est un ensemble de sites FTP qui
archivent pourainsidire toutce quisefait sur(L A
)T
E
X.LeLORIA hébergeun de
cesmiroirsetfournit unensembled'outils pourfaciliter larecherche,letransfertet
l'installation deschiersqui s'ytrouvent. C'estleCTANNavigator (http://ctan.
loria.fr).
Lebutdel'article estdeprésenter lesservices oertspar leCTANNavigatoretla
manièredeles utiliser.
1.1. Les miroirs CTAN
Ilexistedanslemondeplusd'unecinquantainedesitesFTPquihébergentunmiroir
CTANdont quatreen France (ftp.jussieu.fr,ftp.oleane.net,ftp. loria .fr et
ftp.uvsq.fr). Ils sont mis à jour àpartir demiroirs maîtres(ftp.dante.de,ftp.
tex.ac.ukouctan.tug.org).LalistecomplètedesmiroirsCTANestdisponibledans
lechierCTAN.sites(ftp://ftp.loria.fr/pub/ctan/CTAN .sit es parexemple)Ce
sontdessitesFTPdetrèsgrandetaille(3Go,65000chiers)ettrouverlebonchier
n'estpastoujoursfacile!
1.2. Outilsde recherche
Heureusement uncertain nombre d'interfaces WEBdestinésà faciliter larecherche
d'information existe comme par exemple celui de Jim Heeron (http://joshua.
que la rechercheest fructueusele transfert desdonnées peut sefaire sous laforme
d'unchierzipoud'unchiertargzipé.
1.3. Le T
E
X Catalogue Online
Le TeX Catalogue Online de Graham Williams est disponible sur chaque CTAN
(CTAN:/help/Catalogue/index.htm l). Il contient une description de plus de 1100
outilsetcontributionsliésà(L A
)T
E
XetdesliensversCTAN.
1.4. La liste CTAN-ANN
Cettelistepermetd'êtreinformédesnouveautésinstallées surCTAN.Ilestpossible
de s'abonner à la liste : envoyez un mail à listserv@urz.uni-heidelberg.de avec le
messagesuivant:SUBSCRIBECTAN-ANNPrénomNom
1.5. Le Latex Navigator
Bien sûr l'indispensable Latex Navigator (http://www.loria.fr/tex) qui est une
véritable encyclopédiesur(L A
)T
E
X.Maisilest plusdestinéà larecherchededocu-
mentationssur(L A
)T
E
Xqu'àdesrecherchessurCTAN.
2. La philosophie du CTAN Navigator
Danstout les casrechercherun chier n'est pastrès simple,laméthodeFTP n'est
pas très conviviale etl'installation du ou des chiers récupérés est de toute façon
manuelle.LeCTANNavigator aétécréépoursimplierlarecherche,letransfertet
l'installationdechiers,enclairessayerdegagnerdutemps.
La philosophieduCTANNavigatorestlasuivante:
Rechercher ! Transférer ! Installer
surCTAN avecODA avecOFI
2.1. Rechercher
Lebutestdetrouverleplusrapidementpossible leschiersquivousintéressentet
d'accéderdirectementauCTAN.Pourceladiérentsoutilssontdisponibles:
Recherched'informationparmotclésurleschiersdumiroirCTAN
Le script exécute une recherche sur le nom complet des chiers c'est-à-dire le
aché.De manièreàfaciliter larecherchevisuelletoutes les occurrences dumot
clésontécrites engras.Ilestpossibledetrierles chierssoit surlenom complet
soitsurladate.Toutlesnomsdechierssontachésavecdeslienshypertextes:
ilspermettentsoitderécupérerleschiersunparun,soitd'accéderauxdiérents
répertoires.Une rechercheaveclemêmemotclésurleTeXCatalogueOnlineest
égalementdisponibleàpartirdecettepage.
Recherched'informationparmotclésurleTeXCatalogueOnline
Ilestpossibledefaireunerechercheenutilisantdesnomsd'outils,decontributions
oumêmed'auteurs.Làaussidanslalistedesentréestrouvéeslemotrecherchéest
encaractèregrasdemanièreàfaciliterlavisualisation.Unlienhypertextepermet
alors d'accéderdirectement auxinformationsdétaillées duCatalogue etun autre
aux répertoires du CTAN oùils se trouvent. À partirde cette page il est aussi
possibledecontinuerlarecherchesurle(La)TeXNavigatoraveclemêmemotclé.
Archivedesmessagesdelaliste CTAN-ANNavecmoteurderechercheetliens
Les trois derniers mois de la liste CTAN-ANNonnce sont archivés et indexés.
Par rapport à un simple archivage HTML un prétraitement est eectué. Il
consiste à rajouterdes liens hypertextes surles noms des répertoires du CTAN.
Ilestainsipossibled'accéderauxnouveautésannoncéesparunsimpleclicdesouris.
LesnouveautésdujoursurCTAN(accessibleparWEBetparmail)
Tous les jours les chiers du CTAN sont mis à jour à partir du site maître.
Cela conduit à un chier de log qui est mis au format HTML. Là aussi il est
possible par un simpleclique de récupérer un nouveau chier ou d'accéder aux
répertoires modiés.Ilestaussipossiblederecevoirchaquejour cesinformations
parmail.Eneetunemailinglistexiste,c'estctan-news1@loria.fr.Pours'abonner
il faut envoyezun mail à sympa@loria.fravec le message suivant :SUBSCRIBE
ctan-news1PrénomNom.
LesnouveautésdelasemainesurCTAN
Le même principe est appliqué avec le chier CTAN :/FILES.last07days qui
contient les nouveaux chiers copiés sur le CTAN depuis une semaine (sans la
mailinglistbiensur).
StructuredesarchivesCTAN
UnchierHTMLestcrééàpartirduchierCTAN:/README.structureetprécise
lecontenudechaquesrépertoiresduCTAN.
2.2. Transférer
Demanièreàfaciliterletransfertetfourniruneinterfaceplusconvivialequelemode
FTPuncertain nombred'outilsetdepagesHTMLontétémisenplace:
ListeHTMLdesmiroirsCTANdisponibles
ÀpartirduchierCTAN:/CTAN.site laliste desmiroirs estmiseàjourchaque
nuit:seuls lesmiroirsrépondantàunpingsontprisencompteetdisposentd'un
lienpermettantunaccèsdirectauxserveursFTP.
MémorisationdumiroirCTANpréféréparl'utilisateur
Avant depouvoir transférer des chiers le serveur demandede choisir un miroir
CTAN.L'utilisateurlesélectionnedansunelisteoùlesmiroirsayantlemêmenom
dedomaine quesa machine sont classés en premier. Lechoixest ensuite mémo-
riségrâceàunecookie.Ilestbiensurpossibleàtoutmomentdechangerdemiroir.
InterfaceWEBauxserveursFTP
À partirdu menuWEB-ODA dela paged'accueil ilest alors possible d'accéder
aux données du CTAN. Le serveur intercepte les données brutes de manière à
améliorer la présentation : fond blanc, déplacement rapide dans l'arborescence
en utilisant les liens hypertextes de la ligne "Index of", recherche avec le nom
duchieroudu répertoiresurleCatalogue en cliquantsurles icônes degauche,
description plus détaillée des extensions de chiers dans la colonne de droite,
transfertimmédiatdu contenudu répertoiresous laforme d'unchier targzipé,
d'unchierzipoubienavecODA.
ODA(O-maticDirectoryAccess)pourautomatiser letransfert
ODAapourbut,sousUnixetLinux,grâceàunsimplescriptshdefaciliterletrans-
fertdechiersprésentssurCTAN.ODAfonctionnegrâceàctan.oda.sh,unscript
quiestappelélorsquel'utilisateur cliquesurlebouton"Get DIRwithODA" de
l'accèsWEB-ODAauCTAN.Cescriptouvreunxterm,lanceunftpsurl'ensemble
durépertoiresouslaformed'unchiertar.gz(ousousformerécursiveavecncftp),
illecopieaubonendroitdansunrépertoiredetest.Sileoulesrépertoiresn'exis-
taientpasilssontcréés,siunrépertoireexistaitdéjàilestrenomméenfonctionde
ladatedutransfert.Ilmetensuiteàjourlechierdelogetlancelatexs'ildétecte
des chiers ayant pour extension .ins ou.dtx. Par exemple au LORIA le réper-
toiredetestest/local/tex/archive.Supposonsquel'onveuillerécupérerlepackage
ccaption qui se trouve sur CTAN :/macros/latex/contrib/supported/ccaption/.
Une fois positioné dans le bon répertoire avec WEB-ODA il sut de cliquer
sur"Get ccaptionwith ODA". Le script va copier les chiers en local sous /lo-
cal/tex/archive/macros/latex/contrib/supported/ccaption/.Pournirlechierde
2000/03/0517:50 rossisalm.loria.frMAJmacros/latex/contrib/supported/ccaption
ccaption2000/02/29v2.6bExtendedcaptioningand newfloats
PourqueODAfonctionneilnefautpasoublierde:
1. récupérezlechierctan.oda.shdisponiblesurleCTANNavigator;
2. modier la variable LOCALDIR qui dénitle répertoire ou vous copiez les
chiers(L A
)T
E
Xrécupérésdu CTAN(cen'est paslerépertoired'installation
dénitive);
3. congurezvotrenavigateur:
PourNetscaperajouterdanslemenudesapplications(Edit!Preferences!
Navigator!Applications):
MIMEType: application/oda
Suffixes: oda
Application: xterm -sb -sl 200 -e ctan.oda.sh %s
Lescriptctan.oda.shdoitêtredansunrépertoirerecherchéparvotreshell.
Ilneresteplusqu'àtesterlanouvelleversionetl'installersitoutmarchebien,c'est
l'objetdeOFI:O-maticFilesInstall.
2.3. Installer
OFI(O-maticFilesInstall) estlasuitelogique deODA etapourbutdepermettre
d'automatiser l'installation des données disponibles sur CTAN que l'on a récupéré
avecODA.OFI(commeODA)supposequelatexestdéjàinstallé,sonbutestd'ins-
tallerdenouvellescontributionsetréaliserdesmisesàjour.
OFIutiliseun scriptsh(ctan.o.sh) estàbesoind'unchierd'installationquidoit
êtreprésent danschaquerépertoireoùsetrouvedesdonnéesinstalables:packages,
fontes...Voiciparexemplelechier.ctan.opourccaption(CTAN:/macros/latex/-
contrib/supported/ccaption):
#OFI_BEGIN
OFI_VERSION=1.0
FILES_VERSION=2.6b
DIR_CTAN=macros/latex/contrib/s uppor ted/c capt ion
TestMkdir $TEXMFMAIN/tex/latex/ccaption
TouchVersion $TEXMFMAIN/tex/latex/ccaption
cp -f ccaption.sty $TEXMFMAIN/tex/latex/ccaption
#OFI_END
Lescript ctan.o.sh va exécuter chacune des instructionsde ce chier (ilutilise la
commandesh:source).
Voiciunedescriptiondesdiérenteslignesdecechier:
OFI_VERSION:versiondeOFI;
FILES_VERSION:versiondesnapshot;
TestMkdir:fonctiondénitdanslescriptctan.o.shquicréelerépertoireindiqué
enarguments'iln'existepas;
TouchVersion:créeunchier.version.oàpartirdelavariableavec$OFI_VER-
SION;
$TEXMFMAIN:variablequiestlerépertoiretexmfdetex(parexempleauLO-
RIA:/usr/local/tex/texmf);
cp:commandeshàexécuter,snapshot.styestcopiédanssous$TEXMFMAIN;
#OFI_BEGINet#OFI_END:marqueledébutetlanduchier.
Ici OFIutilise lafonctionTestMkdirmaisd'autresfonctions peuvent êtrerajoutées
enfonctiondesbesoinsdansctan.o.sh.S'ils'agitd'unemiseàjourOFIrenommeles
ancienschiersetrépertoires en.old.Ilvérieaussisi laversion àinstallerestplus
récenteque laversionactuelle.OFImetensuite àjourun chierdelog ctan.o.log
sous$TEXMFMAIN.
2000/03/05 17:52rossisalm.loria.frMAJ2.6b macros/latex/contrib/supported/ccaption
...
Danslecasd'unemiseàjoursilechier.ctan.on'existepasOFIpeutlecréer:il
cherchesi les chiers récupérésexistent sous $TEXMFMAINgrâce àlacommande
kpsewhich.
3. Réalisation du CTAN Navigator
Les outilsutilisés pour réaliserleCTANNavigator sontdepréférences des logiciels
libres.TouslesscriptsWEBsontenperl.LesscriptsCGIderecherchesurCTANet
leCataloguedemêmequeceuxdegestiondescookiessont baséssurceuxécritspar
JimHeeron.LesmessagesdeCTAN-ANNsontconvertisavecMHonArc.Leschiers
enXMLducataloguesontconvertisavecXT.L'indexationduLatexNavigatoretde
CTAN-ANNonceutiliseleprogrammeht://Dig.LemiroirCTANsourceestmiroré
avecmirror.LeserveurWEBesthébergéparleLORIA(http://www.loria.fr)qui
utilisebiensurApache.
4. Les évolutions possibles
LeCTANNavigator apourbutdefourniruneplate-formedetestpourlesinstalla-
tionsautomatiques.Leformatpourleschiers.ctan.on'estpasgédemêmequele
langageutilisépourlesprogrammes.Lerajoutdeprocédurededésinstallationsestà
Danstouslescassivousavezdesremarquesoudesproblèmesd'utilisationn'hésitez
pasàenvoyerunmailàctan@loria.fr.
CTAN Navigator
