Boo
@_ö
(11:09)  Bienvenue ! - Inscrivez vous pour poster ! -
@Boo + 6 inconnu(s)

Login :  Mot de passe :      Se souvenir de moi.  Mot de passe perdu ?
/!\:: Cliquez ici pour vous inscrire et poster, créer des sujets ou des forums ! ::/!\
 « - 1/1 - » :: Pages
 Index » Forum informatique & développement » Autres langages de programmation (29r) » Documentation Quel langage utiliser?
./Post de départ - Documentation Quel langage utiliser?
14.09.2006 - 876
18:05  Jonas - Posté : 04-08-2008  M
Pour mon taff cet été je dois écrire de la documentation (des mini howto sur 1-2 fonctions de logiciels) sous formes de petites fiches (maxi 2 pages) à destination des employés.

Donc moi ni une ni deux je me met en mode geek et je commence à me faire un petit template sympatoche en LaTeX. Sauf que là mon supérieur (qui ne connaissait pas LaTeX) déplore que le format de sortie (PDF) ne soit pas réexploitable.
Donc en fait il va falloir que je rédige la doc de façon à ce que ça soit réutilisable. La boite ayant 99,99% de ces postes sous Win Word (ou OpenOffice) semble donc le coix désigné, mais j'aimerai éviter si possible d'utiliser un traitement de texte WYSWYG.

Ma question est donc vers quel langage puis-je me tourner pour écrire de la doc "propre" tout en sachant qu'il faudra que ça soit réexploitable (rééditable) par derrière?

J'ai entendu parler ça et là de DocBook. C'est bien? Y-at'il des IDE pour ça (pour latex j'utilise un plugin de gedit qui me donne des boutons pur compiler et afficher en un clic c'est nikel)? Avez-vous deja testé?

Donc voila j'attends vos conseils et avis de geek avisés now :D

PS: J'ai vraiment hésité à poster ici, donc si ce topic est vraiment HS ne vous gênez pas pour le déplacer (pardon alors pour lé darngement occasionné).
./Publicité AdSense
./1
16.06.2001 - 59988
18:08  squalyl - Posté : 04-08-2008  M
html?

ben oui c'est con mais c'est ultra simple au moins.

sinon openoffice (ou word)

et je pense que tu te mélanges sur "wysiwyg". ou alors c'est moi.
./2
10.06.2001 - 33210
18:16  Kevin Kofler - Posté : 04-08-2008  M
Mais il a fumé quoi, ton supérieur? #roll# Évidemment que le format de sortie n'est pas exploitable, c'est le format d'entrée qu'il faut éditer! #roll#
avatarMes news pour calculatrices TI: Ti-Gen (fr/en), MobiFiles (de)
Mes projets PC pour calculatrices TI: TIGCC, CalcForge (CalcForgeLP, Emu-TIGCC)
Mes chans IRC: #tigcc et #inspired sur irc.freequest.net (UTF-8)

Liberté, Égalité, Fraternité
./3
16.06.2001 - 59988
18:17  squalyl - Posté : 04-08-2008  M
Rah, il est vraiment con de pas payer une formation LaTeX d'une semaine à tous les gens de la boite suceptibles de toucher ton doc!

tu réfléchis Kevin des fois?
./4
11.07.2003 - 51997
18:24  flanker - Posté : 04-08-2008  M
Question bête : pourquoi ne pas utiliser Word ? (y a des équivalents des templates)
avatar<<< Kernel Extremist©®™ >>>
Aviations Militaires
<Vertyos> un poil plus mais elle suce bien quand même la mienne ^^
<Sabrina`> tinkiete flan c juste qu'ils sont jaloux que je te trouve aussi appetissant
./5
16.06.2001 - 59988
18:40  squalyl - Posté : 04-08-2008  M
oui, pour la doc d'entreprise c'est le mieux je pense. (tu m'ignores flanker? :D)
./6
11.07.2003 - 51997
18:42  flanker - Posté : 04-08-2008  M
J'ai demandé pourquoi il n'a pas utilisé Word, toi tu as proposé Word ;)
avatar<<< Kernel Extremist©®™ >>>
Aviations Militaires
<Vertyos> un poil plus mais elle suce bien quand même la mienne ^^
<Sabrina`> tinkiete flan c juste qu'ils sont jaloux que je te trouve aussi appetissant
./7
16.06.2001 - 59988
18:52  squalyl - Posté : 04-08-2008  M
mouahahaha ok :D
./8
30.06.2001 - 54022
19:03  Godzil - Posté : 04-08-2008  M
Un framework de doc qui est apriori sympa, et qu'on utilisait au boulot, c'est http://dita.xml.org/

Je peut tenter de sortir ce qu'on avait fait (et il avait été utilisé pour passer de FrameMaker vers ça, donc c'est quand meme assez puissant ^^)
avatar
Proud to be CAKE©®™
The cake is a lie! - Love your weighted companion cube

->986-Studio's Wonder Project!<-
./9
14.09.2006 - 876
20:08  Jonas - Posté : 04-08-2008  M
En effet j'ai fait une erreur en parlant de wyswyg au lieu de wysiwyg.

Sinon je suis dans le département info (et oui mon supérieur ne connais pas LaTeX ^^) et donc ya un coté frime a ne pas négliger (si mes journées de 7h étaient remplies je me casserait pas la tête mais là jai largement le temps de frimer (et puis d'apprendre aussi ^^)).

Donc voila un petit truc à base d'XML ça me botte bien. Pour l'HTML ça me plait moyen car c'est pas hyper frime et puis surtout j'apprendrai rien (quoique je suis un gros boulet sur la syntaxe des fois :D)

Je connaissais pas le DITA, c'est marrant c'est supporté par OASIS comme le DocBook, je vais regarder dans cette voie aussi.

Sinon je viens de voir qu'il existe un plugin eclipse pour DocBook donc je vais l'installer? Quelqu'un l'a essayé? Vous avez des retours d'expérience?

Merci en tout cas de vos réponses :)
Edité par JoNas le 04-08-2008 à 22:53:10.
./10
11.06.2001 - 19072
20:10  PpHd - Posté : 04-08-2008  M
./11
14.09.2006 - 876
21:46  Jonas - Posté : 04-08-2008  M
PpHd: Comme le dit l'article ça reste très limité au niveau des changements qu'on peut apporter par derrière... Mais merci quand même!
./12
10.06.2001 - 33210
22:25  Kevin Kofler - Posté : 04-08-2008  M
squalyl (./3) :
tu réfléchis Kevin des fois?

#confus#
avatarMes news pour calculatrices TI: Ti-Gen (fr/en), MobiFiles (de)
Mes projets PC pour calculatrices TI: TIGCC, CalcForge (CalcForgeLP, Emu-TIGCC)
Mes chans IRC: #tigcc et #inspired sur irc.freequest.net (UTF-8)

Liberté, Égalité, Fraternité
./13
16.06.2001 - 59988
09:35  squalyl - Posté : 05-08-2008  M
personne ne connait latex dans les entreprises. C'est quasiment réservé au monde universitaire qui doit écrire des équations dans les textes.
./14
10.06.2001 - 33210
09:41  Kevin Kofler - Posté : 05-08-2008  M
Le problème, c'est qu'il (le supérieur de JoNas) n'a pas l'air de comprendre ce qu'est un format d'entrée et ce qu'est un format de sortie, ce qui est quand-même grave... Même si on ne connaît pas LATEX en particulier, le fait que le format de sortie n'est pas le format idéal pour éditer devrait rester évident et ne devrait pas constituer un problème.
avatarMes news pour calculatrices TI: Ti-Gen (fr/en), MobiFiles (de)
Mes projets PC pour calculatrices TI: TIGCC, CalcForge (CalcForgeLP, Emu-TIGCC)
Mes chans IRC: #tigcc et #inspired sur irc.freequest.net (UTF-8)

Liberté, Égalité, Fraternité
./15
16.06.2001 - 59988
09:53  squalyl - Posté : 05-08-2008  M
Si, il a raison, PDF est inmodifiable pour des gens NORMAUX

donc il vaut mieux WORD / OO qui est A LA FOIS un format d'entrée et de sortie, parce que c'est plus RAPIDE

je te souhaite honnêtement et en toute amitié de ne jamais travailler dans une entreprise.
./16
10.06.2001 - 33210
09:54  Kevin Kofler - Posté : 05-08-2008  M
squalyl (./15) :
Si, il a raison, PDF est inmodifiable pour des gens NORMAUX

Mais il ne faut pas modifier le PDF, mais la source LATEX!!!
avatarMes news pour calculatrices TI: Ti-Gen (fr/en), MobiFiles (de)
Mes projets PC pour calculatrices TI: TIGCC, CalcForge (CalcForgeLP, Emu-TIGCC)
Mes chans IRC: #tigcc et #inspired sur irc.freequest.net (UTF-8)

Liberté, Égalité, Fraternité
./17
16.06.2001 - 59988
09:55  squalyl - Posté : 05-08-2008  M
oui, ok ^^

juste le document word/oo.o, tu vois tout de suite le résultat :D

bon j'ai pas envie de troller latex/word de bon matin #zzz#
./18
15.06.2001 - 16848
16:51  natto - Posté : 05-08-2008  F
mais kevin a tout a fait raison, on ne devrait pas avoir les droits de modifications sur un document released, du moins sur son format de sortie. Par contre utiliser latex en entreprise, c'Est a se rouler par terre #triso#
avatar 納豆パワー!
I becamed a natto!!!1!one!
./19
10.06.2001 - 35353
18:22  damnvoid - Posté : 05-08-2008  M
Bah moi j'ai bossé dans une entreprise de finance (1,5 milliards sous gestion, 10 millions de chiffres d'affaire), et on faisait du latex. Alors vous pouvez revoir vos préjugés, merci.

Pour le problème du topic, je dirais que c'est assez difficile. Ça dépend de ce que ton supérieur considère comme utilisable : si tu arrives à les convaincre qu'éditer un fichier Latex ou XML c'est pas si difficile que ça, t'as la solution. Sinon il y a LyX, qui a un GUI multi plateformes, mais qui est rapidement limité si on veut faire des trucs un peu funky. Enfin tu peux essayer de faire un source XML et une feuille de style XSLT pour passer ça en format OpenDocument (donc lisible par OpenOffice), mais ça a l'air assez complexe.
avatarI'm on a boat motherfucker, don't you ever forget
./20
16.06.2001 - 59988
18:30  squalyl - Posté : 05-08-2008  M
je garde mes préjugés tant que je connaitrai pas le % global d'entreprises qui utilisent latex pour leurs documents de travail (pas publications de recherche^^).
./21
10.06.2001 - 35353
18:42  damnvoid - Posté : 05-08-2008  M
On utilisait latex (et parfois LyX) pour notre documentation interne, pas pour des publications de recherche. Et c'était même pas pour écrire plein de symboles mathématiques compliqués, juste pour documenter nos programmes (ça ne remplaçait pas les commentaires doxygen, bien sûr).
avatarI'm on a boat motherfucker, don't you ever forget
./22
16.06.2001 - 59988
18:50  squalyl - Posté : 05-08-2008  M
certes.

nb d'entreprises qui utilisent latex pour leur doc interne = 1;
./23
10.06.2001 - 35353
18:59  damnvoid - Posté : 05-08-2008  M
= 100% des entreprises dans lesquelles j'ai travaillé %)

Bref ça veut rien dire d'essayer de faire un recensement. Par contre c'est débile de dire que latex est inutilisable en entreprise. Comme tout le reste, ça dépend du contexte, de l'existant, et il faut savoir s'adapter et ne pas adopter d'attitude sectaire.
avatarI'm on a boat motherfucker, don't you ever forget
./24
14.09.2006 - 876
22:16  Jonas - Posté : 05-08-2008  M
Bon après avoir jetté un coup d'oeil à apache forrest qui ne m'a pas tant plu que ça j'ai jetté mon dévolu sur DocBook. C'est bon j'ai compris le prinicpe c'est vraiment puissant et ça demande pas une si grosse masse d'outils par rapport au LaTeX qui necessiterai en plus une formation des gens de la boite.

Je veux dire par là que le service info possèdant deja sur chaque poste un editeur XML (friendly on va dire) et un JRE (+JDK même si pas utile dans notre cas) il ne me reste plus qu'à leur filer un ToolChain du style DocMan pour qu'ils puissent faire mumuse avec. Demain j'essairai avec Vex le plugin DocBook pour Eclipse (existe en standalone aussi) afin de voir si ça marche bien aussi (car avec DocMan ça marche nikel même si c'est un peu long).

Voilà, tout ça pour générer des PDFs voir de l'(X)HTML. Je dois dire que je suis content de découvrir et d'apprendre ça, c'est vraiment très puissant. :)
./25
21.10.2001 - 6983
22:44  kim - Posté : 05-08-2008  M
./9 pour le format frime, tu fais un format de manpage ou perldoc :)
avatarIl n'a pas de mots
Décrire son mépris
Perdre les rênes
Il a perdu la foi
./26
14.09.2006 - 876
18:32  Jonas - Posté : 06-08-2008  M
Docbook exporte en manpage, par contre je sais pas s'il exporte vers perldoc (mais oui à mon avis si c'est juste un feuille XSL a créer)
./27
10.06.2001 - 35353
01:12  damnvoid - Posté : 09-01-2009  M
damnvoid (./23) :
= 100% des entreprises dans lesquelles j'ai travaillé %)

Bref ça veut rien dire d'essayer de faire un recensement. Par contre c'est débile de dire que latex est inutilisable en entreprise. Comme tout le reste, ça dépend du contexte, de l'existant, et il faut savoir s'adapter et ne pas adopter d'attitude sectaire.

Dans ma nouvelle boite (une grosse banque US), tous les modèles sont documentés en Latex.

./22 > nb d'entreprises qui utilisent latex pour leur doc interne = 2/2;
avatarI'm on a boat motherfucker, don't you ever forget
./28
10.06.2001 - 33210
02:00  Kevin Kofler - Posté : 09-01-2009  M
Révise tes fractions, 2/2 est ce qu'il a dit. #gni#
avatarMes news pour calculatrices TI: Ti-Gen (fr/en), MobiFiles (de)
Mes projets PC pour calculatrices TI: TIGCC, CalcForge (CalcForgeLP, Emu-TIGCC)
Mes chans IRC: #tigcc et #inspired sur irc.freequest.net (UTF-8)

Liberté, Égalité, Fraternité
./29
14.09.2006 - 876
13:20  Jonas - Posté : 11-05-2009  M
Bon je déterre un peu mais c'est au cas ou quelqu'un tomberait par hasard sur le topic.

Je suis tombé sur un starter-kit super simple pour Docbook qui mérite le détour! Il est trouvable ici.

Pour ceux qui sont sous GNU/Linux pour écrire le XML il existe le très agréable XML Conglomerate qui comporte des templates Docbook (que demande le peuple!).
./Publicité AdSense
 « - 1/1 - » :: Pages
 Index » Forum informatique & développement » Autres langages de programmation (29r) » Documentation Quel langage utiliser?

./Poster un nouveau message. - Ouvrir dans une nouvelle fenêtre
Login : Mot de passe :

url - image - media  
spoiler - pre - fixed
quote - box - hr
poll - code





Smileys
Smileys perso
Pièce jointe
     Flood control (?) :    
Les messages postés sont la propriété de leurs auteurs. Nous ne sommes pas responsables de leurs contenus.

» yN ©1624 - Aide / Charte / Crédits
71ms | Statistiques