Salut Youshe
Le monde la documentation est vaste, car il touche de nombreux métiers,
nombreux besoins. Il existe par conséquent de nobreux outil permettant
de « faire de la doc », et dans ce domaine les logiciels libres ne sont
pas en reste. De nombreux besoins diversifiés, donc de nombreux outils
permettant de réaliser des taches précises, plus ou moins techniques,
artistiques, permettant de créer, rédiger, coopérer, partager, annoter,
publier, diffuser....
L'éditeur de logiciels proposant le plus de solutions pour la conception
documentaire est Adobe, qui propose des suites logicielles
professionnelles pour la documentation. Perso, je ne suis pas convaincu
que le logiciel en boite soit une bonne façon de procéder pour concevoir
un système de production et de gestion documentaire. En effet chaque
projet documentaire a ses spécificités propres, lié au domaine et au
métier de la société ou de l'entité qui met ces projets en place, les
meilleurs solutions passent donc à mon avis par la juxtaposition
d'outils différents réalisant le mieux possible une étape de la chaîne
de publication sans chercher à tout gérer de A à Z.
Cela permet de créer des systèmes documentaires adaptés aux besoins,
évolutifs et extensibles.
Pour mettre en oeuvre ce type d'approche, il convient en premier lieu de
déterminer les formats à mettre en oeuvre pour véhiculer l'information.
Les outils ayant à produire du contenu sans savoir qui l'exploitera par
la suite, il est essentiel que les formats produits soient standards,
ouverts et de préférence normalisés.
XML est en effet un excellent langage pour l'ingénierie du document, ce
secteur est d'ailleurs son berceau. Car il facilité l'interopérabilité,
et permet de clairement séparer d'une part le contenu et la structure
logique de l'information; et d'autre part les aspects présentation...
<mode id="pub" set="on">
Sinon y'a l'excellent kolekti ;)
http://www.guilde.asso.fr/rencontres/20081014/
Il a pas encore les fonctionnalités de sortie que tu envisage
d'alimenter, mais c'est une direction que j'ai envie de donner à
l'outil, la conversion de documents de kOLEKti vers les formats de
publication finaux sont implémentés sous forme de plugins, il est
également possible d'appeler un script shell après la publication. Cela
permet de faciliment publier sur site/wiki/blog/... à l'ai d'une
commande curl par exemple.
Actuellement les formats de sortie sont xhtml, (avec plusieurs lib
css/js en standard : présentations S5, aide en ligne...). et depuis hier
en odt ! (et surement bientôt en odp)...
Pour la modification hors ligne et le versionning, je pense que le mieux
est d'installer ta base de docs sur un rcs git, svn... C'est pour ça que
kolekti travaille sur des fichiers texte à la source.
L'avantage c'est aussi que si tu structure bien ta base documentaire, tu
pourra extraire ta thèse et des articles en utilisant le même contenu !
</mode>
Stéphane.
Le vendredi 05 juin 2009 à 13:06 +0200, youshe a écrit :
> Bonjour la guilde,
>
> Depuis quelques temps je me pose la question de savoir quel formateur
> de texte je vais choisir pour rédiger toutes (ou presque) mes
> documentations/site/articles/... et dans cette idée, je me suis dit
> qu'il pourrait être sympa de revenir sur les différentes façons de
> faire...
>
> A terme, j'aimerais en fait me faire une espère de gestion centralisée
> (ou distribuée) de contenu, de sources et de plein de choses avec copie
> et travail local éventuel. Comme fonctionnalités visées :
> - blog
> - wiki
> - publication de docs : cours/docs techniques/how-to/... (sous forme
> d'espèce de livres ou d'articles)
> - site à part entière
> - repository pour héberger les sources
> - gestion de versions de tout ça
> - modification locale hors ligne et commit éventuel sans avoir à
> forcément installer le serveur (ex : espère ce repository distant qui
> peut être "checkouté" avec gestion de droits/permission/...)
> - lecture sur téléphone portable qui sait aussi :)
>
> L'idée est de tenter de débroussailler le terrain de la documentation
> que je ne connais que très peu.
> C'est pas bien formel et surtout pour faire appel aux expériences de
> chacun.
> Perso, j'utilisais jusqu'à maintenant latex pour tout rédiger et
> faisait appel à latex-suite sous vim pour accélérer le développement.
> Cette solution va bien pour mes cours et ce genre de chose, mais
> devient assez lourde pour avoir quelque chose d'unifié pour faire un
> site internet par exemple avec tout un tas de docs, ...
> D'autres solutions existent comme rédiger en "syntaxe wiki", dialecte
> xml (docbook je crois par exemple), ...
> En ce qui concerne xml, je pense m'y pencher un peu plus précisément
> dessus mais plusieurs choses à l'heure actuelle me gênent comme le fait
> que je n'ai pas (encore) de mapping pour vim qui me simplifie beaucoup
> le travail (oui, je suis un flemmard :))
> J'imaginais peut être passer par le xml pour centraliser le tout et
> écrire des espèces de traducteurs latex->xml, wiki->xml, ... et
> affichage du contenu par l'intermédiaire d'un script cgi (en python
> sûrement :D, ou à défaut en java+tomcat :/)
>
> J'espère que l'aspect assez brouillon de ce mail arrivera quand même à
> faire ressortir mes interrogations, à savoir : avec quel(s) formateurs
> de texte travailler et comment travailler :)
>
> Fred
>
--
Stéphane Bonhomme -- Exselt Services
Formations, Conseil et Réalisations en Ingénierie Documentaire,
Technologies Web et Logiciels Libres
stephane@??? - http://www.exselt.com
04 57 39 30 78 / 06 88 57 27 08
