Obligement - L'Amiga au maximum

Jeudi 19 octobre 2017 - 20:03  

Translate

En De Nl Nl
Es Pt It Nl


Rubriques

 · Accueil
 · A Propos
 · Articles
 · Galeries
 · Glossaire
 · Hit Parade
 · Liens
 · Liste jeux Amiga
 · Quizz
 · Téléchargements
 · Trucs et astuces


Articles

 · Actualité (récente)
 · Actualité (archive)
 · Comparatifs
 · Dossiers
 · Entrevues
 · Matériel (tests)
 · Matériel (bidouilles)
 · Points de vue
 · En pratique
 · Programmation
 · Reportages
 · Tests de jeux
 · Tests de logiciels
 · Tests de compilations
 · Articles divers

 · Articles in english
 · Articles in other languages


Twitter

Suivez-nous sur Twitter




Liens

 · Sites de téléchargements
 · Associations
 · Pages Personnelles
 · Moteurs de recherche
 · Pages de liens
 · Constructeurs matériels
 · Matériel
 · Autres sites de matériel
 · Réparateurs
 · Revendeurs
 · Presse et médias
 · Programmation
 · Développeurs logiciels
 · Logiciels
 · Développeurs de jeux
 · Jeux
 · Autres sites de jeux
 · Scène démo
 · Divers
 · Informatique générale


Jeux Amiga

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


Trucs et astuces

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


Glossaire

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


Partenaires

Annuaire Amiga

Amedia Computer

Relec

Hit Parade


Contact

David Brunet

Courriel

 


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).

MakeInfo

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 : 68000, OCS, 512 ko de mémoire.
Licence : GPL 2.
Téléchargement : Fish 787.


[Retour en haut] / [Retour aux articles]