Discussion :

[thecaptain]

Salut à tous

Je cherche un (bon) éditeur de spécifications. Je m'explique : l'idée est d'écrire une spec (XML) et de pouvoir la sortir (facilement) au format HTML et PDF principalement et que ce soit "propre".

Pour l'instant j'ai trouvé les outils suivants :
OpenOffice Writer (HTML assez moyen, peu de paramétrisation)
DocBook (qualité moyenne, gouffre à temps)
Doxygen ?

L'idée serait d'avoir un truc à la java tutorial (glossaire, page différentes, ...).

Est-ce que vous connaissez des outils assez souples pour ce genre de chose (et si possible OpenSource) ?

Merci d'avance

[gorgonite]

tiens, un pseudo que je connais bien


que souhaites-tu exactement ?
parce qu'a priori, xml -> xslt -> xhtml et le tour est joué, mais faut tout coder toi-même

quelle genre de spec ? ça aidera peut-être à trouver une appli adaptée

[thecaptain]

Hey tcho gorgonite

Ce serait une spec d'entrée pour un XML (du genre tel node doit contenir telle propriété de telle valeur, ... => check via un XSL).

Finalement on pensait prendre XMLMind et puis passer par un outil type DocBook pour générer le html y a bon ?

@++

[gorgonite]

Finalement on pensait prendre XMLMind et puis passer par un outil type DocBook pour générer le html y a bon ?

ça me semble une solution envisageable, mais c'est sans doute la plus complexe (sans avoir à réinventer la roue )

[thecaptain]

Si tu as d'autres solutions je suis également preneur Par contre je ne souhaite pas réinventer la roue

Dans OpenOffice, tu peux faire des liens depuis le glossaire vers les différentes partie du doc, mais c'est trop peu paramétrable (ou du moins j'ai rien trouvé de probant)...

@++

[Garulfo]

Une spécification est un ensemble précis et détaillé des besoins.
N'importe quel éditeur de texte fait donc l'affaire.
Ce qui compte c'est les conventions de format et de contenu plutôt.

Ce que tu chercherais serait-il un outil de gestion des besoins ?
Comme GenSpec ?
ftp://ftp.hydro.qc.ca/expedition/Expertise/

Je suis pas sûr de comprendre ce que tu veux.

[thecaptain]

Salut,

En fait, on aimerait un outil qui puisses être utilisé facilement et qui génère du PDF et du HTML. Nous aimerions pouvoir paramétriser le HTML pour avoir la coloration synthaxique (XML, Java, ...) ainsi que la possibilité de pouvoir générer par exemple une page par chapitre (avec TOC au début) L'idée est d'avoir une documentation online et offline, le tout facilement maintenable.

Je vais voir ce que propose GenSpec merci

@++

[Garulfo]

Qui peut générer des documents pas de problème. Sauf que malheureusement c'est du Word je pense -_-

La coloration syntaxique... je ne comprends pas. Si tu parles de spécifications, tu n'es probablement pas rendu là. À moins que tu ne fasses des outils qui travaillent sur des outils informatiques... À ce moment la description de ton XML entre en compte dans la description du domaine.

Si tu as du Word tu peux toujours en faire un (horriblement écrit) document HTML ^_^

[Agamemnon2000]

Une spécification est un ensemble précis et détaillé des besoins.
N'importe quel éditeur de texte fait donc l'affaire.
Ce qui compte c'est les conventions de format et de contenu plutôt.

Ce que tu chercherais serait-il un outil de gestion des besoins ?
Comme GenSpec ?
ftp://ftp.hydro.qc.ca/expedition/Expertise/

Je suis pas sûr de comprendre ce que tu veux.

Pour GenSpec, voir plutôt "fr.slideshare.net/PierrePi/ingnierie-des-exigences-prsentation-de-genspec-presentation"