Sistema de modelo de documentação Wiki/DocBook/LATEX
-
22-09-2019 - |
Pergunta
Estou procurando um sistema de modelo de documentação, ou melhor, estará criando um. Ele deve suportar os seguintes recursos:
- Crie saída em pdf e html
- Suporte para fórmulas grandes e complicadas (látex)
- Referências entre documentos
- Bibliografias
- Os modelos serão preenchidos por um script python
Eu tentei látex com vários conversores Tex-to-HTML, mas não estou satisfeito com os resultados. Eu uso o DocBook há um tempo, mas acho que a edição do DocBook não é fácil de escrever e o suporte para fórmulas ainda não é suficiente.
O principal problema é que haverá usuários deste sistema que não conhecem a sintaxe ou documento do documento de látex. Pensei em uma alternativa para esses usuários que fornecem uma possibilidade de edição com a sintaxe do wiki (convertido pelo Python em látex).
Vamos resumir: eu quero a saída HTML e PDF de pelo menos a entrada de látex e wiki. O DocBook pode ser usado como formato intermediário.
Alguém já teve um problema semelhante ou pode me dar um conselho sobre quais ferramentas e quais formatos de arquivo eu deveria usar?
Solução
Usamos a Esfinge: http://sphinx.pocoo.org
Faz quase tudo isso.
Seu script python ou seus usuários ou quem quer que eu não possa seguir a pergunta) pode criar conteúdo usando Primeira marcação (que talvez seja o mais fácil dos idiomas de marcação). Você o executa através da Esfinge e obtém HTML e LATEX.
Outras dicas
Criei um pré-processador de látex e módulo Python que permite incorporar Python ou SQL dentro de um arquivo de látex. O Python e/ou SQL são executados e a saída é dobrada.
Com o LATEX2HTML ou LATEX2RTF, você pode usar o código LATEX para produzir HTM e RTF.
Eu publiquei para você em http://simson.net/pylatex/
ArborText suporta látex nativamente. Você pode enviar o mecanismo de publicação ou o LATEX do compositor e ele passará diretamente.
Ele também suporta muitos outros idiomas de composição também e até oferece a oportunidade de fazer manipulação de manifestação de página como você veria no InDesign (sem a dor de cabeça e a sobrecarga do ID).
eu penso isso Asciidoc é melhor direcionado para o que você está tentando obter. É uma linguagem de marcação simples, permite fórmulas de látex nela e gera documentos do DocBook a partir dos quais você pode gerar ainda mais a representação legível de HTML ou LATEX