Pergunta

Eu quero os documentos DocBook em meu repositório SVN para olhar bom se alguém olha para eles em um navegador web. Eu comecei a escrever uma folha de estilo CSS, mas eu acho que ele vai ter limitações significativas -. Particularmente os relativos hiperlinks

Há um grande corpo de DocBook estilo XSL no DocBook local , mas eles não parecem ser apropriados para processamento do navegador. Eu não quero para gerar documentos estáticos e colocá-los em SVN. Eu quero que eles sejam basicamente legível para outros desenvolvedores sem muito incômodo.

Eu poderia escrever minha própria folha de estilo XSL navegador apropriada para converter DocBook para HTML, mas parece que alguém já deve ter feito isso. Eu só não sei onde encontrá-lo.

Foi útil?

Solução

Em uma vida passada eu usei wysiwygdocbook: http: / /www.cs.hs-rm.de/~werntges/proj/wysiwyg-dbk01.html

Outras dicas

Você está certo, as folhas de estilo DocBook XSL são muito pesados, e não são realmente adequados para execução em um navegador. O wiki listas DocBook algumas folhas de estilo CSS , talvez um daqueles pode funcionar para você?

A única que eu tenho experiência é a que XMLmind editor XML aparentemente usa para presente documentos DocBook.

Já fiz alguns XSLT + CSS muito básico e implementação incompleta para browserside DocBook styling. Você pode verificá-la aqui http://github.com/arsi/db2xhtml

Mas eu gostaria de ver projecto mais avançado se disponível em algum lugar!

[Editado porque eu descaracterizou a pergunta]

Você certamente não deseja executar as folhas de estilo através de um navegador eo PI, mas então você não iria querer fazer isso por qualquer conteúdo razoavelmente complexo. Fazê-lo do lado do servidor se você estiver executando mais de um servidor web ou como uma tarefa batch. Existe alguma maneira que você pode interpor um processo do lado do servidor no SVN?

DocBook é uma 'linguagem' complexos e capturando mesmo a maioria dos sutilezas de DocBook é muito difícil. Usando o DocBook XSL não é complexa em tudo e eu realmente recomendo que você vá nessa direção, se puder. As folhas de estilo são projetados para ser personalizado e são extremamente bem documentado por Bob Stayton em DocBook XSL: The Complete Guide .

Depois de um pouco de pesquisa, eu acredito que a resposta é "não é uma boa folha de estilo XSL para client-side DocBook rendering", além do bespoke queridos como a que eu implementado.

Normalmente, você iria produzir uma 'entrega' para leitura / display. A interpretação pode ser PDF, uma página HTML simples ou conjunto de páginas HTML. É raro que você entregar docbook diretamente a web.

  • Posso perguntar o que você está tentando realizar e por quê?
  • É este para entrega interno ou externo?

Eu odeio ficar a pergunta que pede "pode ??sua tecnologia de fazer X?" Ele assume um monte de conhecimento sobre o produto (plus, normalmente a resposta é "sim", mas isso não responder à pergunta real). É sempre melhor quando eu pergunto - "o que você está tentando realizar" - para que eu possa dizer-lhe ou não qualquer peça de tecnologia é um bom ajuste (ou eu posso apontar-lhe alguma outra parte que é um ajuste muito melhor, ou uma maneira melhor de fazê-lo).

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top