arquivos de ajuda do Windows - quais são as opções?

votos
34

De volta aos velhos dias, Ajuda não era trivial, mas possível: gerar algum arquivo .rtf funky com etiquetas especiais, executá-lo através de um compilador, e você tem um arquivo WinHelp (.hlp) que realmente funciona muito bem.

Em seguida, a Microsoft decidiu que WinHelp não era moderna e antenada mais e mudou para CHM, até o ponto que eles realmente sacado WinHelp a partir de Vista.

Agora, CHM talvez agradável, mas todo mundo que tentou abrir um arquivo .chm na Rede vai saber o agradável Navegação para a página da Web foi cancelada tela que é causado por restrições de segurança.

Embora existam maneiras de fazer CHM trabalhar fora da rede, este não é uma boa escolha, porque quando um usuário pressiona o botão Ajuda que quer ajudar e não ter que fazer alguns ajustes funk.

Bottom Line: Acho CHM absolutamente inutilizável. Mas com não WinHelp sendo mais uma opção tanto, gostaria de saber quais são as alternativas, especialmente quando se trata de integrar-se com a minha aplicação (ou seja, para WinHelp e CHM há funções que lhe permitem saltar directamente para um tópico)?

PDF tem a desvantagem de requerer o Adobe Reader (ou um dos outros mais leves que muitas pessoas não usam). Eu poderia viver com isso vendo como isso é uma espécie de padrão hoje em dia, mas você pode dizer isso de forma confiável para saltar para uma determinada página / âncora?

arquivos HTML parece ser a melhor escolha, então você só tem que lidar com diferentes navegadores (CSS e outras coisas).

Edit: Eu estou olhando para criar meus próprios arquivos de ajuda. Como eu sou um fã do No programa de configuração, basta extrair and Run Filosofia, eu tive esse problema muitas vezes no passado, porque muitos dos meus usuários vão executá-lo fora da rede, o que faz exatamente este problema.

Então eu estou procurando uma maneira mais robusta e à prova de futuro para fornecer ajuda para meus usuários sem ter que codificar um sistema de ajuda diferente para cada aplicativo eu faço.

CHM é um formato muito bom, mas que material de segurança torna inutilizável, como um sistema de ajuda é suposto fornecer ajuda para o usuário, para não gerar ainda mais problemas.

Publicado 04/08/2008 em 11:43
fonte usuário
Em outras línguas...                            


10 respostas

votos
15

HTML seria a próxima melhor opção, só se você iria servi-los a partir de um servidor web público. Se você tentou empacotá-lo com a sua aplicação, todos os arquivos (e imagens (e folhas de estilo (e ...))) faria CHM olhar como um presente dos deuses.

Dito isto, quando, na verdade, empacotado no pacote de instalação, (em vez de ser servido através da rede), eu encontrei os arquivos CHM para trabalhar bem.

OTOH, outra armadilha sobre arquivos CHM: Mesmo se você tentar abrir um arquivo CHM em um local de disco, você pode topar com o bloco de segurança, se você baixou inicialmente de algum lugar, porque o arquivo poderia ser marcado como "veio de uma fonte externa" quando ele foi obtido.

Respondeu 04/08/2008 em 11:51
fonte usuário

votos
5

Eu não gosto a opção html, e realmente mudou-se de HTML simples para CHM através da compressão e indexá-las. Mesmo usá-los em um punhado de clientes não-Windows mesmo. Ele simplesmente resolvido o pequeno quebra constante de pessoas colocando-o na rede (nidificação profundidade limitada, efeitos de bloqueio estranhos), antivírus que morreu em diretórios com 30000 arquivos html, e 20 minutos de tempo de descompressão durante a instalação em um sistema mais antigo, zonas de segurança do navegador e recursos, erros de cálculo de espaço necessário no instalador etc.

E então eu nem sequer incluem as pessoas que começam a "corrigir" deles, produto 3rd party com defeito tentativas de "integração" etc, queixas sobre slowliness (navegador start-up)

Todos nós tinha esperado anos para os problemas que ir embora como sistemas operacionais e hardware melhoradas, mas os problemas eram recorrentes em um número bedazzling de variedades e já era o suficiente. Encontramos chmlib, e decidiu que poderíamos sempre usar algo baseado em isso como fuga com um leitor externo simples, se o sistema operacional fornecido queridos parou de funcionar e ligado.

Enquanto isso, nós também têm um próprio compilador, por isso estamos MS gratuitos à prova de futuro. Isso não significa que nunca vai mudar (soluções com servidores web locais parecem favorito hoje em dia), mas pelo menos nós temos uma escolha.

Respondeu 06/09/2009 em 01:03
fonte usuário

votos
3

Depende de como importar a documentação on-line é o seu produto, uma boa infra-estrutura de documentação pode ser complexa para estabelecer, mas uma vez feito isso compensa. Aqui está como o fazemos -

  • Fonte de ajuda DITA XML compilant, armazenada em SCC (ClearCase).
  • Ajuda a edição XMetaL
  • Compilação ajuda, personalizado Abrir DITA Toolkit , com o costume Perl / Java pré-processamento
  • Ajuda referências fonte cruzadas aplicações de recursos em tempo de compilação, ficheiros.RC etc.
  • Entregáveis ajuda de fonte única, PDF, CHM, Eclipse Help , HTML.
  • repositório de fonte única produz ajudar para vários produtos 10+ com milhares de temas compartilhados.

Do que você descreve que eu iria olhar para Eclipse Help, não é simples de integrar em aplicações .NET ou MFC, você basicamente tem que fazer o mapeamento ajuda para resolver a solicitação para um URL, em seguida, disparar o URL para Eclipse invólucro de Ajuda ou um navegador.

Respondeu 21/09/2008 em 01:11
fonte usuário

votos
3

Se você não quiser usar um instalador e você não quer que o usuário executar nenhuma etapa extra para permitir que arquivos CHM através da rede, por que não cair de volta para WinHelp? Vista não incluem WinHlp32.exe fora da caixa, mas é livremente disponível como um download para ambos Vista e Server 2008.

Respondeu 04/08/2008 em 14:48
fonte usuário

votos
3

Nosso software é ambos distribuídos localmente para os clientes e servido a partir de um compartilhamento de rede. Optamos por gerar tanto um arquivo CHM e um conjunto de arquivos HTML para servir a partir da rede. Usuários começando o programa usar localmente o arquivo CHM, e os usuários recebendo seu programa servido a partir de um compartilhamento de rede tem que usar os arquivos HTML.

Usamos Ajuda e manual e pode, portanto, facilmente produzir os dois tipos de saída a partir do mesmo projeto de código. Os arquivos HTML também contêm recursos de pesquisa e não requer um servidor web, de modo que ele não é uma solução ideal, funciona bem.

Até agora, todos os tipos de arquivo único para o Windows parece quebrado, de uma forma ou de outra:

  • WinHelp - obsoleto
  • HtmlHelp (CHM) - se obsoleto no Vista, não trabalhar a partir de compartilhamento de rede, além de que trabalha realmente agradável
  • Microsoft Ajuda 2 (HXS) - este parece funcionar direito até o ponto em que ele não, índices corrompidos ou semelhante, isto é usado pelo Visual Studio 2005 e acima, como um exemplo
Respondeu 04/08/2008 em 12:02
fonte usuário

votos
3

É a questão de como gerar seus próprios arquivos de ajuda, ou o que é o melhor formato de arquivo de ajuda?

Pessoalmente, acho CHM para ser excelente. Uma das primeiras coisas que eu faço quando a criação de uma máquina é baixar o Manual PHP em formato CHM ( http://www.php.net/download-docs.php ) e adicionar um atalho para ele em Crimson Editor . Então, quando eu pressione F1 ele carrega o CHM e realiza uma pesquisa para a palavra meu cursor está no (ótimo para referência de função rápida).

Respondeu 04/08/2008 em 11:52
fonte usuário

votos
2

Acho que a solução que vamos acabar indo com para a nossa aplicação está hospedando a ajuda arquivos nós mesmos. Isto dá-nos acesso imediato aos arquivos e a capacidade de mantê-los atualizados.

O que eu pretendo é ter o conteúdo carregado em um enorme série de arquivos XML, cada um contendo ajuda para um item específico. Este XML que contêm links para outros arquivos XML. Gostaríamos de usar XSLT para exibir o conteúdo conforme necessário.

Dependendo do licenciamento, podemos construir um arquivo XSLT específico do cliente, a fim de adaptar o olhar e sentir o que eles precisam. Podemos precisar de ser capaz de mostrar apenas ajuda para versões particulares de nosso produto bem e que pode ser feito através da filtragem de material no XSLT.

Respondeu 27/11/2008 em 21:39
fonte usuário

votos
2

PDF tem a desvantagem de requerer o Adobe Reader

Eu uso Foxit Reader no Windows em casa e no trabalho. Um muito menor e muito rápido para abrir. Muito útil quando você está se perguntando o que exatamente a80000326.pdf é e por que está obstruindo sua pasta de documentos.

Respondeu 05/08/2008 em 19:55
fonte usuário

votos
2

Se você está fazendo "apenas extrair e executar", você está indo para executar em questões de segurança. Isto é especialmente verdadeiro se você estiver usuários estão executando Vista (ou posterior). há uma razão por que você queria evitar embalar suas aplicações dentro de um instalador? Usando um instalador iria aliviar o problema "externamente". Você seria capaz de usar arquivos .chm sem quaisquer problemas.

Usamos InstallAware para criar nossos pacotes de instalação. Não é barato, mas é muito bom. Se o custo é sua preocupação, WIX é open source e bastante robusto. WIX tem uma curva de aprendizado, mas é fácil de trabalhar.

Respondeu 04/08/2008 em 13:11
fonte usuário

votos
1

Eu uso um pacote comercial chamado AuthorIT que pode gerar uma série de formatos diferentes, como chm, HTML, PDF, Word, Windows ajuda, xml, xhtml, e alguns outros que nunca ouviram falar de (toca dita um sino?). É um sistema de gerenciamento de conteúdo orientado para as necessidades de escritores de documentação técnica. A vantagem é que você pode usar e re-utilizar o mesmo conteúdo para construir um conjunto de guias, e em seguida, gerar-los em diferentes formatos.

Assim a linha inferior em relação à questão da escolha chm ou html ou o que é que se você estiver usando isso, você não é fechado em um determinado formato, mas você pode fornecer vários entre os quais o usuário pode escolher, e você ainda pode adicionar mais formatos como você ir junto, sem nenhum custo extra.

Se você tiver apenas um guia para criar não vai valer a pena, mas se você tem um conjunto de documentação para gerenciar, então é o melhor para o meu conhecimento. Seu apoio é muito útil também.

Respondeu 18/09/2008 em 15:47
fonte usuário

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more