Journal DocBook ou l'art d'écrire de la documentation

7
1
fév.
2017

Salut,
J'ai découvert récemment le pas très connue DocBook un langage utilisant le XML comme base et permettant de rédiger de la documentation sans se souciée de la présentation et en se concentrant uniquement sur le contenue.

J'aimerai connaitre votre avis sur ce langage ?

Pour ma part, je le test encore mais c'est vraiment plaisant de pouvoir convertir un seul fichier vers le format PDF, HTML, EPUB ou encore Open Document. Sans devoir tout réécrire pour chaque format. :)

Mons, le 15 janvier 2015 – DocBook: rédigez comme un pro !

Posté par (page perso) . Édité par Benoît Sibaud, ZeroHeure et palm123. Modéré par ZeroHeure. Licence CC by-sa
10
8
jan.
2015
Communauté

Ce jeudi 15 janvier 2015 à 19h se déroulera la 35ème séance montoise des Jeudis du Libre de Belgique.
Public : Tout public
L’animateur conférencier : Philippe Wambeke (LoLiGrUB)
Logo Docbook

Description : Tout le monde a déjà dû écrire un document au moins une fois dans sa vie: travail de fin d’études, mémoires, recueil de cuisine, biographie, documentation technique ou fonctionnelle, … La rédaction de documentation est souvent synonyme de tâche répétitive, ingrate et chronophage, où on se perd très rapidement dans des détails qui n’ont rien à voir avec le contenu du document, comme la mise en forme par exemple. Dès lors, on se prend à rêver d’une solution libre qui permettrait de rédiger facilement sans se préoccuper de la mise en forme. Qui permettrait de changer de support en 1 clic, le tout en garantissant la pérennité du document. Et bien grâce à DocBook, ce rêve est devenu réalité !

Réduire les coûts et améliorer la qualité de la documentation avec DITA XML

Posté par (page perso) . Édité par Benoît Sibaud et baud123. Modéré par Pierre Jarillon. Licence CC by-sa
20
20
mar.
2012
Doc

Darwin Information Typing Architecture (DITA), est une architecture XML destinée à la création de documents structurés et modulaires. Elle diminue les coûts de production et de traduction, réduit les délais de mise sur le marché et améliore la qualité.

Les impatients trouveront sur le site de ressources pour le rédacteur technique comment mettre en place une chaîne de création et de publication DITA XML libre. Cette chaîne repose sur Emacs et le mode nXML (avec des schémas Relax NG modifiés) et DITA Open Toolkit. La suite de la dépêche détaille l'architecture DITA.

Nouveautés de la Formation Debian GNU/Linux

Posté par (page perso) . Modéré par baud123. Licence CC by-sa
37
1
mai
2011
Doc

À l'occasion de la publication de Debian Squeeze, nous avons mis à jour la Formation Debian GNU/Linux. Cette mise à jour n'avait pas fait l'objet d'une dépêche, mais je profite d'autres modifications majeures pour présenter toutes ces nouveautés en groupe.

La Formation Debian GNU/Linux est un document destiné aux débutants, essentiellement des utilisateurs avancés de Windows, qui souhaitent apprendre l'utilisation avancée et l'administration de Debian. Nous proposons pour cela une démarche d'installation de Debian pas à pas, en détaillant les notions au fur et à mesure qu'elles interviennent : le logiciel libre, Debian, les périphériques et systèmes de fichiers, l'arborescence, la ligne de commande, le système graphique, les services réseau…

Cette mise à jour a nécessité quelques adaptations mineures pour tenir compte des changements de l'installateur Debian et des logiciels, mais elle a surtout été l'occasion de moderniser notre système de publication et de préparer une nouvelle version au format EPUB.

Un éditeur XML Wysiwyg passe au libre

Posté par (page perso) . Modéré par Mouns.
24
4
juil.
2009
Bureautique
Séparer le fond de la forme, tel est le Graal de la rédaction technique, voire de la rédaction tout court. Si les formats XML tels que DocBook ou Dita répondent parfaitement à ce besoin, ils étaient encore réservés à ceux qui sont prêts à mettre les mains dans le cambouis et à manipuler des balises XML sous des éditeurs tels que vim ou Emacs.

Des solutions WYSIWYG plus simples de prime abord existaient, mais elles étaient - pour le moment - toutes propriétaires.

La libération par Syntex de son produit phare sous licence libre GPL v3 pourrait bouleverser le paysage de la création de documents dans les prochaines années et, peut-on rêver, pousser à l'abandon de cette hérésie qu'est le traitement de texte.

Si la version libre du produit souffre encore de quelques bugs, il est déjà tout à fait utilisable pour créer du contenu XML. Pour la génération au format HTML, PDF ou autre, en revanche, il faut toujours faire appel à des solutions telles que DITA Open Toolkit.

LyX 1.5.0 est sorti

Posté par (page perso) . Modéré par Florent Zara.
0
29
juil.
2007
Bureautique
LyX est un éditeur de document WYSIWYM qui se fonde largement sur LaTeX pour le rendu final des documents, et qui permet d'importer et d'exporter raisonnablement des documents LaTeX (y compris des présentations Beamer). A noter que LyX permet aussi de créer des documents Docbook

Au menu de cette version 1.5.0 qui vient de sortir, une grosse refonte avec principalement
  • L'abandon du front-end XForms (moche mais rapide au travers d'une session distante sous ssh via ADSL) ;
  • Le passage de Qt2 à Qt4 ce qui permet des ports MS-Windows et Mac OS X officiels ;
  • La mise en sommeil du front-end GTK faute de mainteneur ;
  • Le passage de Make à CMake et de sh à Python pour la compilation et les scripts.
Mais la plus grande réforme visible à l'utilisateur est le passage à unicode et, en conséquence, la fusion avec la branche CKJ .

NdM : Merci à celebrimbor pour son journal sur le sujet