Eu tenho usado uma ferramenta chamadadoxigêniopara documentar o código. Isso criou uma pasta de .htmlarquivos, .jsarquivos javascript e .pngarquivos de imagem, e cria uma documentação muito boa baseada em navegador executando index.htmlna pasta.
No entanto, não é muito fácil de usar - pois o usuário precisa encontrá-lo index.htmlem um arquivo com centenas de outros. Tentei mesclar tudo isso em um único .htmlcom uma variedade de ferramentas on-line, como HTMLDOC, nenhuma das quais funcionou.
Eu queria saber a) se havia uma maneira de mesclar essa coleção de arquivos html, .jsand .pngem um único arquivo ou b) se não, existe uma maneira de criar uma espécie de "pacote" que oculta os arquivos subjacentes e executa o índice página quando clicado? Em última análise, quero fazer com que o usuário possa clicar em um único arquivo/pacote chamado "documentação" em vez de consultar uma lista enorme!
Muito obrigado,
Davi
Responder1
Infelizmente, existem vários formatos concorrentes de “arquivo da web” e não conheço nenhum que seja compatível com todos os navegadores.