Boo
./1
Jonas - Posté le 04/08/2008 à 18:05 Membre depuis le 14/09/2006, 1093 messages
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 grin

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é).
avatar "If you see strict DRM and copy protection that threatens the preservation of history, fight it: copy the work, keep it safe, and eventually share it so it never disappears. [...] no one living 500 years from now will judge your infringing deeds harshly when they can load up an ancient program and see it for themselves."

Benj Edwards - Why History Needs Software Piracy
./2
squalyl - Posté le 04/08/2008 à 18:08 Membre depuis le 16/06/2001, 59722 messages
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.
./3
Kevin Kofler - Posté le 04/08/2008 à 18:16 Membre depuis le 10/06/2001, 34841 messages
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#
avatar Mes 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é
./4
squalyl - Posté le 04/08/2008 à 18:17 Membre depuis le 16/06/2001, 59722 messages
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?
./5
flanker - Posté le 04/08/2008 à 18:24 Membre depuis le 11/07/2003, 49126 messages
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
./6
squalyl - Posté le 04/08/2008 à 18:40 Membre depuis le 16/06/2001, 59722 messages
oui, pour la doc d'entreprise c'est le mieux je pense. (tu m'ignores flanker? grin)
./7
flanker - Posté le 04/08/2008 à 18:42 Membre depuis le 11/07/2003, 49126 messages
J'ai demandé pourquoi il n'a pas utilisé Word, toi tu as proposé Word wink
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
./8
squalyl - Posté le 04/08/2008 à 18:52 Membre depuis le 16/06/2001, 59722 messages
mouahahaha ok grin
./9
Godzil - Posté le 04/08/2008 à 19:03 Membre depuis le 30/06/2001, 57118 messages
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!<-
Jonas - Posté le 04/08/2008 à 20:08 - Edité par Jonas le 04/08/2008 à 22:53 Membre depuis le 14/09/2006, 1093 messages
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 grin)

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 smile
avatar "If you see strict DRM and copy protection that threatens the preservation of history, fight it: copy the work, keep it safe, and eventually share it so it never disappears. [...] no one living 500 years from now will judge your infringing deeds harshly when they can load up an ancient program and see it for themselves."

Benj Edwards - Why History Needs Software Piracy
PpHd - Posté le 04/08/2008 à 20:10 Membre depuis le 11/06/2001, 19223 messages
Mais si le PDF c'est réexploitable : http://extensions.services.openoffice.org/project/pdfimport
Jonas - Posté le 04/08/2008 à 21:46 Membre depuis le 14/09/2006, 1093 messages
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!
avatar "If you see strict DRM and copy protection that threatens the preservation of history, fight it: copy the work, keep it safe, and eventually share it so it never disappears. [...] no one living 500 years from now will judge your infringing deeds harshly when they can load up an ancient program and see it for themselves."

Benj Edwards - Why History Needs Software Piracy
Kevin Kofler - Posté le 04/08/2008 à 22:25 Membre depuis le 10/06/2001, 34841 messages
squalyl (./4) :
tu réfléchis Kevin des fois?

#confus#
avatar Mes 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é
squalyl - Posté le 05/08/2008 à 09:35 Membre depuis le 16/06/2001, 59722 messages
personne ne connait latex dans les entreprises. C'est quasiment réservé au monde universitaire qui doit écrire des équations dans les textes.
Kevin Kofler - Posté le 05/08/2008 à 09:41 Membre depuis le 10/06/2001, 34841 messages
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.
avatar Mes 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é
squalyl - Posté le 05/08/2008 à 09:53 Membre depuis le 16/06/2001, 59722 messages
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.
Kevin Kofler - Posté le 05/08/2008 à 09:54 Membre depuis le 10/06/2001, 34841 messages
squalyl (./16) :
Si, il a raison, PDF est inmodifiable pour des gens NORMAUX

Mais il ne faut pas modifier le PDF, mais la source LATEX!!!
avatar Mes 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é
squalyl - Posté le 05/08/2008 à 09:55 Membre depuis le 16/06/2001, 59722 messages
oui, ok ^^

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

bon j'ai pas envie de troller latex/word de bon matin #zzz#
natto - Posté le 05/08/2008 à 16:51 Membre depuis le 15/06/2001, 16446 messages
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!
damnvoid - Posté le 05/08/2008 à 18:22 Membre depuis le 10/06/2001, 33930 messages
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.
avatar I'm on a boat motherfucker, don't you ever forget
squalyl - Posté le 05/08/2008 à 18:30 Membre depuis le 16/06/2001, 59722 messages
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^^).
damnvoid - Posté le 05/08/2008 à 18:42 Membre depuis le 10/06/2001, 33930 messages
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).
avatar I'm on a boat motherfucker, don't you ever forget
squalyl - Posté le 05/08/2008 à 18:50 Membre depuis le 16/06/2001, 59722 messages
certes.

nb d'entreprises qui utilisent latex pour leur doc interne = 1;
damnvoid - Posté le 05/08/2008 à 18:59 Membre depuis le 10/06/2001, 33930 messages
= 100% des entreprises dans lesquelles j'ai travaillé cheeky

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.
avatar I'm on a boat motherfucker, don't you ever forget
Jonas - Posté le 05/08/2008 à 22:16 Membre depuis le 14/09/2006, 1093 messages
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. smile
avatar "If you see strict DRM and copy protection that threatens the preservation of history, fight it: copy the work, keep it safe, and eventually share it so it never disappears. [...] no one living 500 years from now will judge your infringing deeds harshly when they can load up an ancient program and see it for themselves."

Benj Edwards - Why History Needs Software Piracy
kim - Posté le 05/08/2008 à 22:44 Membre depuis le 21/10/2001, 6619 messages
./10 pour le format frime, tu fais un format de manpage ou perldoc smile
avatar Il n'a pas de mots
Décrire son mépris
Perdre les rênes
Il a perdu la foi
Jonas - Posté le 06/08/2008 à 18:32 Membre depuis le 14/09/2006, 1093 messages
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)
avatar "If you see strict DRM and copy protection that threatens the preservation of history, fight it: copy the work, keep it safe, and eventually share it so it never disappears. [...] no one living 500 years from now will judge your infringing deeds harshly when they can load up an ancient program and see it for themselves."

Benj Edwards - Why History Needs Software Piracy
damnvoid - Posté le 09/01/2009 à 01:12 Membre depuis le 10/06/2001, 33930 messages
damnvoid (./24) :
= 100% des entreprises dans lesquelles j'ai travaillé cheeky

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.

./23 > nb d'entreprises qui utilisent latex pour leur doc interne = 2/2;
avatar I'm on a boat motherfucker, don't you ever forget
Kevin Kofler - Posté le 09/01/2009 à 02:00 Membre depuis le 10/06/2001, 34841 messages
Révise tes fractions, 2/2 est ce qu'il a dit. #gni#
avatar Mes 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é
Jonas - Posté le 11/05/2009 à 13:20 Membre depuis le 14/09/2006, 1093 messages
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!).
avatar "If you see strict DRM and copy protection that threatens the preservation of history, fight it: copy the work, keep it safe, and eventually share it so it never disappears. [...] no one living 500 years from now will judge your infringing deeds harshly when they can load up an ancient program and see it for themselves."

Benj Edwards - Why History Needs Software Piracy