Annonces Google
Serveur IRC
Serveur : irc.portlane.se
Canal : #AmigaNG
Activité du Site

Pages vues depuis 25/07/2007 : 24 885 323

  • Nb. de membres 186
  • Nb. d'articles 1 269
  • Nb. de forums 19
  • Nb. de sujets 20
  • Nb. de critiques 24

Top 10  Statistiques

Index du forum »»  Création-Développement »» Outil pour la documentation

Outil pour la documentation#2323

7Contributeur(s)
OlrickK-LartblinkElwoodsinisrusbigdanLio
3 Modérateur(s)
K-LElwoodcorto
Olrick Olrickicon_post
Salut,
je me pose la question d'un outil pour rédiger une doc qui sera ensuite publiée en HTML.

Voici le contexte:
Je dois faire évoluer une library et j'avais précédemment fait une doc de référence au format texte.
Aujourd'hui je la fais évoluer et je trouve qu'un fichier texte est certes le minimum syndical mais totalement inefficace au niveau utilisation, il y manque au moins un sommaire avec des hyperliens.
Je pense que le HTML est ma solution car tout système possède un lecteur utilisable, c'est un standard multi plateformes et c'est accessoirement publiable sur le Net.
 
Je n'ai pas pratiqué l'Amigaguide mais je pense que ça ne tient pas la route face au HTML.

Ma contrainte: je veux enrichir ma doc tout en développant, sur mon NG.

Donc, l'un de vous a-t-il pratiqué/connaissance d'un moyen/outil pour obtenir mon objectif ?

NB: s'il y en a un qui me dit notepad/ed/dme/... , il peut d'ores et déjà profiter de mon mépris le plus profond et se considérer estampillé Gringo-Like.

Merci d'avance.
#NUL!
K-L K-Licon_post
NotePad/Ed/dme... non ?

:-D

Je ne sais pas comment tu comptes t'y prendre alors je te propose plusieurs liens (en PPC ou 68k) :

http://os4depot.net/index.php?function=showfile&file=utility/text/convert/rtf-riddle.lha
http://aminet.net/package/dev/misc/adcvt
http://aminet.net/package/text/hyper/ag2html
http://aminet.net/package/comm/www/awdntsc

Voire simplement : http://aminet.net/search?query=html+editor

Côté OS4, pas d'éditeur HTML et c'est bien dommage. Si d'autres ont des idées :-)
--
AmigaONE X1000/1,8 Ghz (A-Eon), Radeon RX560, 2 Go de Ram et OS4.1 FE
artblink artblinkicon_post
Ah bas tiens, vu qu'elwood m'a donnée une idée, mais comme j'ai regardé et que ça va être hard, voici une nouvelle idée qui émerge dans ma teuté lol

Bon, bin j'ai 2 semaine ;-)
Olrick Olrickicon_post
Merci K-L
Tu m'as fait penser que je pourrais éventuellement utiliser Doxygen, mais il me faudra autre chose qu'un NG...

Et merci pour ta franche bonne humeur qui me rappelle pourquoi je suis accroc aux Alchimies.
#NUL!
Elwood Elwoodicon_post
Olrick, les dépendances pour "builder" Doxygen sont ridicules. Alors arrête de chercher et au boulot !
Comme le dit Artblink, tu as 2 semaines :-)
--
Philippe Ferrucci
Avec une Sam460 et AmigaOS 4.1, je suis eco-responsable. Cool !
Olrick Olrickicon_post
Elwood, c'est gentil de penser à moi mais là j'en suis à mon 4e niveau de tiroir alors ça ne sera pas pour tout de suite. Et puis la recompilation d'un outil Linux ce n'est pas mon truc, je manque de savoir faire, ça bouffe du temps et au final je n'ai pas vraiment produit quelque chose, d'où une absence totale de motivation.
Désolé.
#NUL!
sinisrus sinisrusicon_post
Tu cherche un éditeur HTML si je comprend bien?
Alors honnêtement le HTML est vraiment très facile peut être que la solution la plus basic et dont tu ne veux pas entendre parler serais pourtant la plus logique... Surtout pour faire une petite doc
--
Coin coin... amitheme.amiga-ng.org
Sam460 1,15Ghz - OS4.1FE - Radeon Saphir HD7750 R7 250E - 2Go de ram
bigdan bigdanicon_post

Olrick : version moderne, une moulinette et des balises à la javadoc ou doxygen !

Après tu sors du texte du html, du xml, du latex, du pdf, etc...

J'utilisais un système similaire en Rebol (toutes les docs étaient générées et mises à jour avec un ou deux scripts) il y a quelques années.

Version ancienne "comme il y a 20-25 ans" : autodocs et conversion en amigaguide
sinisrus sinisrusicon_post
Sinon abiword doit bien pouvoir le faire en plus tu même gênerer un pdf
--
Coin coin... amitheme.amiga-ng.org
Sam460 1,15Ghz - OS4.1FE - Radeon Saphir HD7750 R7 250E - 2Go de ram
Lio Lioicon_post
j'aurais suggéré guideml mais comme ta doc n'est pas amigaguide d'origine je ne sais pas.
sinon un petit tour ici : http://os4depot.net/index.php?function=browse&cat=utility/text/convert

A1G4/Radeon9000PRO/1Go RAM; X5000/RadeonR7-250x/2Go RAM; AOS4.1FE
Petites Annonces

0 annonce(s) publiée(s)

Consulter

AmigaOS 4.1

Laissez-vous tenter par
AmigaOS 4.1
AmiTheme

AmiTheme