2010-07-06 3 views
2

Je travaille sur beaucoup de projets basés sur la langue, et les plus grands nécessitent des documents de spécifications semi-formels. Dans le passé, j'ai utilisé OpenOffice.org ou simplement du HTML pour ces documents, et les ai convertis manuellement en d'autres formats. Pour mon projet actuel, cependant, je dois générer des sorties dans plusieurs formats (HTML, PDF, man page et texte, au minimum) et je cherche un langage de balisage de document ou de description de page qui peut gérer plusieurs formats de sortie et le exigences habituelles de formatage liées à la documentation de programmation:Existe-t-il un langage de balisage de document pouvant "tout faire"?

  • section DELIMITERS
  • interne et des liens externes
  • caractères nommés et les styles de paragraphes
  • section numérotation automatique
  • automatique table des matières génération
  • support Unicode

je besoin d'un haut degré de contrôle sur la sortie générée, par souci de cohérence visuelle. Cela semble être un ensemble d'exigences assez raisonnables, mais je ne connais pas d'outil unifié qui convienne vraiment au travail. J'envisageais de le faire, et si cela devient nécessaire, alors cette question sert un double objectif pour mesurer l'intérêt.

Répondre

4

On dirait que DOCBOOK pourrait vous intéresser. Le Wikipedia article vous donne un aperçu des capacités. Le meilleur est qu'il existe une implémentation open source. Vous pouvez donc l'étendre ou le modifier pour prendre en charge encore plus de formats de sortie. Cela nécessite une bonne connaissance de la pensée XSLT. Quoi qu'il en soit, mieux vaut réinventer la roue.

+0

Bien que j'aie espéré quelque chose de non-basé sur XML, cela semble supérieur (pour mes buts actuels) à LaTeX, et j'aime la possibilité d'utiliser XSLT pour les transformations de documents. –

+0

J'aime aussi LaTeX, mais il mélange encore un peu de formatage avec les données d'information et la courbe d'apprentissage est assez abrupte. Il existe des convertisseurs de docbook à LaTeX qui vous donnent la puissance de composition LaTeX: http://wiki.docbook.org/topic/DocBookPublishingTools – jdehaan

+0

Merci pour les conseils. J'ai eu l'intention de vérifier LaTeX plus en détail pendant un certain temps, mais je n'ai pas vraiment compris. –

3

LaTeX est le meilleur pari auquel je peux penser. Il ne fera pas de page de man et de texte brut (bien que ce dernier devrait être relativement simple à bidouiller ensemble).

3

LaTeX fait tout.

+0

C'est le cas? Les pages man et les sorties en texte brut aussi? – jalf

Questions connexes