Suivez-nous sur X
|
|
|
0,
A,
B,
C,
D,
E,
F,
G,
H,
I,
J,
K,
L,
M,
N,
O,
P,
Q,
R,
S,
T,
U,
V,
W,
X,
Y,
Z,
ALL
|
|
0,
A,
B,
C,
D,
E,
F,
G,
H,
I,
J,
K,
L,
M,
N,
O,
P,
Q,
R,
S,
T,
U,
V,
W,
X,
Y,
Z
|
|
0,
A,
B,
C,
D,
E,
F,
G,
H,
I,
J,
K,
L,
M,
N,
O,
P,
Q,
R,
S,
T,
U,
V,
W,
X,
Y,
Z
|
|
A propos d'Obligement
|
|
David Brunet
|
|
|
|
Test de MakeInfo 1.49b
(Article écrit par Cédric Beust et extrait d'Amiga News - mars 1993)
|
|
MakeInfo est un portage très intéressant d'un logiciel existant sous Unix.
Ce dernier permet de générer à partir d'un fichier unique rédigé avec un
certain formalisme plusieurs fichiers sous différentes formes :
- Format hypertexte.
- Format texte classique.
- Format PostScript pour impression laser.
L'intérêt de ce portage est que l'auteur a ajouté à MakeInfo
la possibilité de générer des fichiers au format AmigaGuide.
AmigaGuide est le tout nouveau format d'aide que Commodore fournit en standard
depuis le Kickstart 3.0 (version 39). Il est destiné à fournir à l'utilisateur
une aide soit asynchrone (en dehors du programme, pour consultation), soit en
cas de détresse pendant l'exécution de l'application ("à quoi sert ce bouton déjà ?").
Cette dernière fonction est encore très peu exploitée, mais en revanche, le
format AmigaGuide n'a pas attendu la totale propagation du Kickstart 3.0
pour s'imposer. Plusieurs programmes (qu'ils soient DP ou commerciaux)
sont d'ores et déjà fournis avec ces fameux fichiers ".guide" (citons ToolManager,
Cybercron, SAS 6.0, MFR, AD2HT, etc.).
AmigaGuide est un format de texte dit "hypertexte" :
le texte vous est présenté parsemé de mots-clés. Il vous suffit
de cliquer sur un de ces mots-clés pour faire apparaître automatiquement l'aide correspondante
(il est inestimable par exemple de consulter les Autodocs via AmigaGuide : un simple clic
sur une structure et le fichier include le définissant est automatiquement chargé).
L'outil standard de visualisation s'appelle AmigaGuide mais il en existe d'autres dans
le domaine public (moins performants).
Mais revenons à MakeInfo et plaçons-nous dans la situation d'un programmeur
qui vient de développer une application et désire écrire sa documentation.
L'idée d'AmigaGuide est immédiate mais il lui vient aussi à l'idée qu'une documentation
entièrement textuelle est indispensable afin que des utilisateurs, ne disposant
pas de visualisateur AmigaGuide, puissent lire la documentation avec un éditeur de
texte classique.
Comment faire ? Entretenir deux documentations séparées et les garder à jour conjointement ?
Délicat. C'est ici qu'intervient MakeInfo.
Pourvu que vous écriviez votre documentation dans son format, il se charge de
produire pour vous des fichiers de texte sous les formats que j'ai énumérés plus haut.
Il vous propose en fait beaucoup plus : création d'index, table des matières,
références croisées, styles spéciaux (gras, souligné, etc.).
Mais trêve d'explications, voici un petit fichier d'exemple :
@setfilename test.guide
@titlepage
@setitle Test
@title
@subtitle Un exemple de fichier pour MakeInfo
@author C'edric BEUST
@end titlepage
@setchapternewpage odd
@c %**end of header
@node TOP... (dir)
@top
@chapter Test de MakeInfo pour Amiga News
@menu
* Menu 1:: Thèse
* Menu 2:: Antithèse
* Menu 3:: Synthèse
@end menu
@node MENU 1...Top
@chapter Menu 1
Voici la thèse
@node MENU 2...Top
@chapter Menu 1
L'antithèse maintenant
@node MENU 3...Top
@chapter Menu 1
Et enfin la synthèse
@bye
|
Ensuite, on fait passer ce fichier par MakeInfo :
1> makeinfo --amiga test.texinfo
Making AmigaGuide® file 'test.guide' from test.texinfo'.
1> run amigaguide test.guide
|
Cet exemple présente un menu avec trois entrées (image 1).
Chaque entrée apparaît comme un bouton et le simple fait de
cliquer sur l'entrée correspondante fait apparaître le menu
(image 2).
Ne soyez pas effrayé par la syntaxe du langage : celle d'AmigaGuide est à peine
plus simple mais n'est pas aussi souple ! Une fois que votre documentation
sera convenablement écrite, il ne vous restera plus qu'à produire un fichier
PostScript pour avoir un superbe manuel de qualité égale à ce que produit
LaTeX.
Nom : MakeInfo 1.49b.
Développeur : Reinhard Spisser et Sebastiano Vigna.
Genre : générateur de document hypertexte.
Date : 1992.
Configuration minimale : Amiga OCS, 68000, 512 ko de mémoire.
Licence : GPL 2.
Téléchargement : Fish 787.
|
|