En ce moment, je suis en train de faire une documentation dans le cadre de mon travail, via Word. 150 pages de documentation, avec des captures d'écran, du texte. Il y a un index, un sommaire, des styles pour les parties. C'est loin d'être aussi propre que ce que j'aurai pu faire avec Latex. Ce n'est pas du texte, c'est un format fermé, c'est lourd à gérer (un document de 150 pages, je ne peux pas faire d'include et travailler sur une section à la fois), je rêve à l'utilisation de vrais outils.
Et comme en ce moment, je lis pas mal de documentation Debian... Je trouve que le format, la mise en page sont vraiment bien. J'avais appris les bases de LaTEX (de quoi faire un beau rapport de stage avec des formules, du code source) et depuis, je ne peux plus revenir à OpenOffice... LaTEX, c'est bien, génial et correspond vraiment à mes besoin, mais je suis peu à peu tenté par le Docbook et la possibilité de faire du pdf, de l'html...
Alors, que me conseillez vous? De devenir un gourou du LaTEX ou de me pencher vers le DocBook.
Enfin, bien qu'utilisant Ubuntu, je lis pas mal de doc Debian. Car une installation qui marche bien, qui est facile, out of the box, ça ne me satisfait pas. Je ne sais pas comment ça marche, ce qui est fait.
Pour finir, si vous voyez du troll dans le message, c'est parce que l'on est vendredi. Mais j'aimerai aussi des réponses sérieuses.
# Et pourquoi pas LyX
Posté par pada . Évalué à 2.
[^] # Re: Et pourquoi pas vim-latex
Posté par Colin Pitrat (site web personnel) . Évalué à 2.
Enfin, pour peu que l'on connaisse un peu vim bien sûr. Et finalement, on se rend compte qu'il n'y a pas tant de choses à connaître pour faire un document avec LaTeX.
http://vim-latex.sourceforge.net/
Et une petite introduction :
http://epitrat.free.fr/article.php3?id_article=8
[^] # Kile / Texmaker
Posté par Marc Poiroud (site web personnel) . Évalué à 6.
* kile : http://kile.sourceforge.net/
Mais rassure toi, une solution existe grâce à :
* Texmaker : http://www.xm1math.net/texmaker/index_fr.html
Fait avec du bon Qt libre et en plus tu peux l'utiliser sous Linux, Windows et MacOS, donc n'hésites pas :)
Attention, l'essayer c'est l'adopter ...
[^] # Re: Kile / Texmaker
Posté par Colin Pitrat (site web personnel) . Évalué à 4.
"Malheureusement tu n'utilises pas un environnement conçu pour travailler ! "
J'ai pourtant relu plusieurs fois ton commentaire, le journal, les commentaires précédent, rien n'y fait. Qu'est-ce que tu as bien pu vouloir dire par là ?
[^] # Re: Kile / Texmaker
Posté par gentildemon . Évalué à 5.
L'auteur du journal utilise Word dans le cadre de son travail, il est donc assez vraissemblabe qu'il tourne sous Windows, qui n'est pas un environnement conçu pour travailler...
# txt2tags
Posté par nanard . Évalué à 3.
C'est un outils que j'aime bien.
Allez tous vous faire spéculer.
[^] # Re: txt2tags
Posté par Nicolas . Évalué à 1.
Je suis en train de me pencher justement sur ces deux outils... et j'arrive pas à me décider.
La syntaxe de txt2tags à l'air un peu plus "propre", mais par contre ça me semble un peu moins puissant...
[^] # Re: txt2tags
Posté par nanard . Évalué à 3.
Par contre txt2tags prends facilement de l'ampleur avec les *macro* %!postproc et %!preproc, des fois ca fais un peut magouille, mais ca reste quand même simple et efficace.
Allez tous vous faire spéculer.
[^] # Re: txt2tags
Posté par Nicolas Dumoulin (site web personnel) . Évalué à 4.
Oui, RST a plus de fonctionnalité d'extension de macro de fou, mais peut devenir plus compliqué. Et puis la compilation n'est pas super simple non plus.
Txt2tags, c'est un programme python, ton fichier source avec quelques options en en-tête et c'est tout. Les balises sont peu intrusives et structure le texte source.
Perso, je l'ai adopté pour écrire mes documents. Tu peux générer des pages XHTML avec les attributs kivonbien pour ta feuille CSS, et donc personnaliser le rendu.
Et il y a effectivement les macros de pré et post-processing qui permettent de bidouiller si tu veux.
Au passage, un billet à ce sujet ;-)
http://bobuse.free.fr/blog/index.php/2006/11/15/txt2tags-ecr(...)
[^] # Re: txt2tags
Posté par Nicolas Dumoulin (site web personnel) . Évalué à 2.
[^] # asciidoc
Posté par lolop (site web personnel) . Évalué à 2.
http://www.methods.co.nz/asciidoc/
Votez les 30 juin et 7 juillet, en connaissance de cause. http://www.pointal.net/VotesDeputesRN
# LaTeX et LFS...
Posté par Gyro Gearllose . Évalué à 1.
Moi aussi, j'ai vainement essayé de travailler avec les outils (jeux ?) fournis par la société de Redmond.
Je passe plus de temps à chercher comment faire qu'à vraiment me concentrer sur l'essentiel : travailler.
Depuis que j'utilise LaTeX, je perds moins de temps (en fait, je n'en perds pas du tout), et j'ai directement un résultat impeccable. Par contre, je ne vois pas l'intérêt de passer à docbook pour faire du PDF ou du HTML. On peut directement faire ça depuis LaTeX (texi2pdf et latex2html).
Ceci dit, je ne me suis jamais penché sur docbook....
Pour le reste, rien ne vaut un LFS si tu veux vraiment savoir comment ton système fonctionne.
Voilà.
[^] # Re: LaTeX et LFS...
Posté par Pol . Évalué à 1.
Moi j'ai appris Linux avec une Slackware puis après 2 ans je suis passé sous Gentoo...Franchement tu en apprend tous les jours avec les 2 distro...
seulement avec LFS tu vas peut etre passer 1 mois pour le configurer comme tu veux, cela dit, ca devrait être très instructif...
[^] # Re: LaTeX et LFS...
Posté par Gyro Gearllose . Évalué à 2.
Une demi-journée pour avoir un système bootable, c'est laaaargement suffisant. Ensuite, je t'accorde volontiers qu'il faut au moins deux jours de plus pour avoir un système complet (1/2 heure pour compiler Xorg, 8 heures pour KDE....).
Enfin bref, c'est en effet très instructif, et je n'installe plus que ça....
Par contre, c'est marrant, parce que comme toi, j'ai commencé par la slack (version 130 disquettes sur mon DX2-66, que de souvenirs), puis, je suis très vite passé à la MNIS que j'aimais bien, car elle était très complète. Après quelques errements entre redHat et SuSE, je suis resté quelques années sous SuSE, avant de finalement basculer définitivement sur LFS.
Voilà, j'ai un peu raconté ma vie, et franchement marché dedans....
# Latex plus clair
Posté par Julien Duponchelle (site web personnel) . Évalué à 4.
[^] # Re: Latex plus clair
Posté par Anonyme . Évalué à 1.
# LateX est plus souple
Posté par Djoumé SALVETTI . Évalué à 6.
- Taper des fichier XML c'est lourd...
- Inclure du code source avec coloration syntaxique c'est pas simple avec DocBook, pour LateX il y a listings
- Avec LaTex on peut gerer les liens (hyperref), convertir en html (Hevea), ou en pdf (pdflatex)
- Les références bibliographiques
Que demande le peuple?
[^] # Re: LateX est plus souple
Posté par Gniarf . Évalué à -1.
[^] # Re: LateX est plus souple
Posté par left . Évalué à 4.
c'est indéniable
- Inclure du code source avec coloration syntaxique c'est pas simple avec DocBook, pour LateX il y a listings
tu peux convertir les fichiers au formats docbook avec des outils comme dblatex (cf http://linuxfr.org/2006/11/22/21666.html)
- Avec LaTex on peut gerer les liens (hyperref), convertir en html (Hevea), ou en pdf (pdflatex)
avec docbook aussi:
http://www.oasis-open.org/docbook/documentation/reference/ht(...)
les outils comme xmlto permettent de convertir vers les formats: dvi, html, htmlhelp, man, ps, xhtml, fo, html-nochunks, javahelp, pdf, txt et xhtml-nochunks
- Les références bibliographiques
http://www.oasis-open.org/docbook/documentation/reference/ht(...)
J'ajouterai que la doc générée, en html par exemple, utilise les styles dont nous avons l'habitude (comme la doc debian par exemple).
En fait, l'argument le plus important contre docbook, c'est que écrire du xml à la main c'est chiant. Je plussoie donc ton premier argument, je moinsse les autres .
# DocBook et éditeur
Posté par rangzen (site web personnel) . Évalué à 6.
Le meilleur, et de très loin, ... est un freeware ( http://www.xmlmind.com/xmleditor/what_is_xxe.html ) :/
Tous les projets libres actuels sont soit buggé, soit pas très avancé.
Quand tu as une très grosse doc à faire rapidement, pas le temps de jouer avec les bugs :/
[^] # Re: DocBook et éditeur
Posté par Bonnefille Guilhem (site web personnel) . Évalué à 5.
Quand à la question LaTeX / DocBook, perso je suis passé à DocBook car je voulais vraiment abandonner toute notion de présentation pour me concentrer sur le fond.
De plus, en DocBook, on a accès aux XInclude, qui offrent un mécanisme d'inclusion beaucoup plus évolué que les include de LaTeX. Avec les XInclude, je peux faire une collection de doc de type "article", puis, je peux compacter mes articles dans un seul "book". L'intérêt, c'est que chaque morceau de mon document est un document bien formé (au sens XML) et peut être exploité à part.
Coté moyens de compilation, j'utilise les XSL DocBook standard (Norman Walsh je crois), avec xsltproc et Fop (mon couple gagnant, mais y'a peut-être mieux. Avec ça, je produit sans difficulté des HTML et des PDF.
Les feuilles XSL sont bien pensées et permettent pas mal de personalisation en positionnant juste des paramètres. On peut aussi aller plus loin dans la personnalisation, par exemple pour sortir des mises en page "société". Par contre, il faut commencer à se pencher dans le langage XSL.
Bref, DocBook c'est vraiment bien, un poil plus lourd que LaTeX, mais bien.
[^] # Re: DocBook et éditeur
Posté par a_jr . Évalué à 2.
Par contre, s'il faut faire a la fois texte et mise en page, je pense (sans avoir vraiment essaye) que latex est mieux. C'est tout a fait faisable avec docbook, mais faut, en plus des connaissances docbook, avoir une bonne maitrise de xslt, voire de xls:fo. Decourageant. D'ailleurs, dans mon cas, c'est pas moi qui m'occupe de la mise en page. Mais je crois en avoir deja parle au precedent paragraphe :)
Le bonjour chez vous,
Yves
[^] # Re: DocBook et éditeur
Posté par golum . Évalué à 2.
http://www.labo-sun.com/resource-FR-astuces-693-0-eclipse-xm(...)
[^] # Re: DocBook et éditeur
Posté par Bonnefille Guilhem (site web personnel) . Évalué à 2.
[^] # Re: DocBook et éditeur
Posté par Blackknight (site web personnel, Mastodon) . Évalué à 2.
# conseil
Posté par alice . Évalué à 0.
Il n'y a que les newbies qui annoncent qu'ils vont troller.
[^] # Re: conseil
Posté par Oook . Évalué à 9.
# hum
Posté par Etre-ange . Évalué à 5.
[^] # Re: hum
Posté par Bonnefille Guilhem (site web personnel) . Évalué à 2.
# Dblatex
Posté par SaintGermain . Évalué à 2.
Je m'étais posé la même question que toi et j'ai fini par adopter Docbook via dblatex.
En gros on a le meilleur des 2 mondes : la clarté et l'universalité de Docbook et la puissance/souplesse de LaTeX.
Un gros plus est la prise en compte des équations au choix à la mote XML avec MathML ou à la mode LaTeX.
J'ai écris une dépêche à ce sujet :
http://linuxfr.org/2006/11/22/21666.html
Je n'ai vraiment pas eu à regretter mon choix...
# Word n'est pas si nul que ça
Posté par Dring . Évalué à 6.
Bon, j'ai pas de Word sous la min, mais il me semble bien que c'est possible de le faire, ça. Après, je ne sais pas si ça marche bien, mais ça existait déjà sous Word pour MS/DOS.
D'ailleurs, on peut aussi le faire sous OpenWriter (Menu Insertion - Section - Cocher "Lier" puis choisir un fichier).
[^] # Re: Word n'est pas si nul que ça
Posté par Jeanuel (site web personnel) . Évalué à 4.
Word est un outil tout à fait utilisable s'il est correctement utilisé. Le problème, c'est que tout est fait dans l'interface pour t'inciter à mal l'utiliser.
Mais gérer un gros document se fait très bien à conditions de n'utiliser aucune mise en forme en dehors des tyles, ce qui demande uniquement un peu de rigeur et de faire attention au mode d'inclusion des images.
Le rendu ne sera pas aussi beau qu'en Latex, par contre, la personnalisation de la première page sera bien plus facile !
# Sans vouloir défendre word ....
Posté par dwd . Évalué à 1.
Et bien justement si !!!!! Tu peux faire un document maître qui contient des sous-documents et travailler sur un seul d'entre eux à la fois !!!!
Attention, je ne défend pas Word, et je pense que LaTeX et largement supérieur seulement restons exact !!!!
[^] # Re: Sans vouloir défendre word ....
Posté par alexissoft . Évalué à 2.
A ce compte là, restons exacts sur l'orthographe.
[^] # Re: Sans vouloir défendre word ....
Posté par 태 (site web personnel) . Évalué à 3.
Note : ceci n'est pas du premier degré.
[^] # Re: Sans vouloir défendre word ....
Posté par Anonyme . Évalué à 2.
Enfin si, on peut, mais ...
[^] # Re: Sans vouloir défendre word ....
Posté par Colin Pitrat (site web personnel) . Évalué à 1.
Par contre, je t'accorde que c'est plus galère à utiliser que diff / patch à mon goût.
[^] # Re: Sans vouloir défendre word ....
Posté par dinomasque . Évalué à 2.
Word intègre une très bonne gestion du suivi des modifications.
BeOS le faisait il y a 20 ans !
# AsciiDoc
Posté par Anonyme . Évalué à 2.
http://www.methods.co.nz/asciidoc/
# docbook ou
Posté par Mildred (site web personnel) . Évalué à 2.
http://tbookdtd.sourceforge.net/
Suivre le flux des commentaires
Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.