Problemas com Sandcastle: Localização e caixa de nome do arquivo

Question

Estou usando o Sandcastle Help File Builder para criar a documentação para um projeto de código aberto e estou enfrentando dois problemas:

• O conteúdo da documentação está em francês. Defino o idioma para o francês no projeto SHFB, mas a maior parte do texto gerado ainda está em inglês ("Propriedades", "Hierarquia de Herança", "Veja também" ...). Vi que existem alguns arquivos localizados nas pastas SharedContent (que na verdade não estão totalmente localizadas), mas elas permitem traduzir apenas algumas coisas, principalmente detalhes (feedback, aviso de isenção, declaração de privacidade e tal). Como posso localizar o resto do texto? Observe que tenho uma versão em inglês do Visual Studio 2008; Isso poderia ser um problema ?

• A documentação é gerada como HTML e será hospedada em um servidor Linux/Apache. Infelizmente, muitos nomes de arquivos gerados pelo Sandcastle têm invólucro inconsistente, para que não funcione em um servidor Linux. Por exemplo, "index.html" não é considerado o documento padrão do Apache (ele deve ser "index.html"), e os arquivos CSS não são encontrados por causa do invólucro errado ... eu poderia consertar o revestimento manualmente, mas eu Teria que fazer isso novamente toda vez que reconstruí a documentação. Existe uma solução conhecida para esse problema? Acho que não sou o primeiro a hospedar documentação gerada pelo Sandcastle em um servidor Linux, mas não consegui encontrar nenhuma informação útil sobre isso ...

Obrigado pela ajuda

Answer 1

Eu acho que encontrei uma solução para a questão do idioma:

Atualize o idioma da documentação criada por Sandcastle

Agora eu só tenho que traduzir todos os textos de referência;)

Em relação à segunda questão, na verdade, existem apenas 2 arquivos que precisam ser renomeados (index.html e estilos/apresentação.css precisam ser renomeados para minúsculas), então não é tão ruim ...

Answer 2

Não sei sobre a primeira pergunta.

Na 2ª edição, enfrentei algo semelhante. Eu criei uma ferramenta para descompactar o arquivo .chm em arquivos constituintes e, em seguida, girar -os, adicionando reboques, etc. Você pode fazer algo semelhante e, em vez de editá -los, renomeá -los.

Para descompactar eu usei o código de Este artigo.

Mas então eu descobri que o SHFB poderia produzir arquivos .html diretamente, portanto, essa etapa de descompacção pode ter sido desnecessária. (Eu não sei, nunca voltei e configurei o SHFB para produzir arquivos HTML)

Depois de descompactar os arquivos HTML ou produzi -los diretamente do SHFB, você pode até renomeá -lo em um script - como PowerShell ou JavaScript/CScript.exe.