代码之家  ›  专栏  ›  技术社区  ›  Thomas Levesque

sandcastle的问题:本地化和文件名大小写

  •  0
  • Thomas Levesque  · 技术社区  · 15 年前

    我正在使用Sandcastle帮助文件生成器为一个开源项目构建文档,我面临两个问题:

    • 文件内容为法语。我在shfb项目中将语言设置为法语,但生成的大多数文本仍然使用英语(“属性”、“继承层次结构”、“另请参见”…)。我看到sharedcontent文件夹中有一些本地化的文件(实际上并没有完全本地化),但它们只允许翻译一些内容,主要是细节(反馈、免责声明、隐私声明等)。 如何本地化其余文本? 请注意,我有一个英文版的Visual Studio 2008;这可能是一个问题吗?

    • 文档以HTML形式生成,并将托管在Linux/Apache服务器上。不幸的是,sandcastle生成的许多文件名的大小写不一致,因此它不能在Linux服务器上工作。例如,“index.html”不是Apache默认的文档(应该是“index.html”),CSS文件因为大小写错误而找不到…我可以手动修复外壳,但每次重新构建文档时都必须再次修复。 这个问题有已知的解决方案吗? 我想我不是第一个在Linux服务器上托管Sandcastle生成的文档的人,但是我找不到任何有用的信息…

    谢谢你的帮助

    2 回复  |  直到 15 年前
        1
  •  1
  •   Cheeso    15 年前

    我不知道第一个问题。

    在第二个问题上,我遇到了类似的问题。我构建了一个工具,将.chm文件解包成组成文件,然后旋转它们,添加拖车等。您可以做类似的事情,而不是编辑它们,重命名它们。

    为了解包,我使用了 this article .

    但后来我发现shfb可以直接生成.html文件,所以这个解包步骤可能是不必要的。(我不知道,我从未回去配置SHFB生成HTML文件)

    一旦您解包了HTML文件,或者直接从SHFB生成了它们,您甚至可以在一个脚本(如PowerShell或javascript/cscript.exe)中对其进行批重命名。

        2
  •  1
  •   Thomas Levesque    15 年前

    我想我找到了解决语言问题的办法:

    Update the language of documentation created by Sandcastle

    现在我只需要翻译所有参考文献;)

    关于第二个问题,实际上只有2个文件需要重命名(index.html和styles/presentation.css需要重命名为小写),所以这并不是很糟糕…