Ajuda da autoria de arquivos [fechado

Question

Eu apreciaria algumas sugestões sobre a ajuda de ajuda (Win32).

Eu sei como usar um arquivo de ajuda existente, .chm ou .hlp de C# ou Delphi ou qualquer outra coisa. O problema é que sempre há outra pessoa que foi legal o suficiente para me fornecer esses arquivos :)

Agora, por onde começo?

Eu tenho experimentado ajuda, ele funciona, mas acho isso um pouco falta e posso estar usando o Tex para renderizar meus arquivos de ajuda. O Workshop da Microsoft HTML é um pouco grosseiro. A busca de outras ferramentas retorna muitos resultados.

Como vocês fazem? Edição manual de HTML usando Vim / Dreamweaver. Alguma prática recomendada?

Answer 1

Usei a Adobe Robohelp em um projeto há dois meses. Eu acho que fornece bons resultados.

Eu recomendo para você.

Answer 2

Eu uso Robohelp há anos.

Está bem, mas o caminho de suporte e atualização estão confusos. A tecnologia principal também é muito datada.

Estamos nos mudando para Madcap Flare http://www.madcapsoftware.com/products/flare/robohelp.aspx

Answer 3

Nós usamos DocBook como nosso formato de ajuda subjacente. É essencialmente um subconjunto de XML projetado para criar documentação. Usamos o Syntext Serna como nosso editor XML, pois ele tem suporte para Wysiwyg e edição embutida de XML #includes.

A grande vantagem de usar o DocBook é que ele pode ser transformado em outros formatos usando os modelos XSL fornecidos pelo projeto DocBook. Podemos ir do DocBook para HTML, HTMLHELP e PDF (via XML-FO). Transformar nos formatos MS Word baseado em XML também é teoricamente possível.

Fazer do formato DocBook para um arquivo CHM é tão simples quanto:

1. Execute os modelos XSL HTML-HELP na fonte XML usando por exemplo, xstproc
2. Compile os arquivos HTML de saída usando o HTML Help Compiler da Microsoft (HHC).