0

Sandcastle Help File Builder を使用してオープン ソース プロジェクトのドキュメントを作成していますが、次の 2 つの問題に直面しています。

  • ドキュメントの内容はフランス語です。SHFB プロジェクトで言語をフランス語に設定しましたが、生成されたテキストのほとんどはまだ英語です (「プロパティ」、「継承階層」、「参照」...)。SharedContent フォルダーにローカライズされたファイルがいくつかあることを確認しましたが (実際には完全にローカライズされていません)、翻訳できるのはごく一部、主に詳細 (フィードバック、免責事項、プライバシーに関する声明など) のみです。残りのテキストをローカライズするにはどうすればよいですか? Visual Studio 2008 の英語版があることに注意してください。それは問題になるでしょうか？

  • ドキュメントは HTML として生成され、Linux/Apache サーバーでホストされます。残念ながら、Sandcastle によって生成される多くのファイル名は大文字と小文字が一致していないため、Linux サーバーでは機能しません。たとえば、「Index.html」は Apache によってデフォルトのドキュメントとは見なされず (「index.html」である必要があります)、大文字と小文字が間違っているために CSS ファイルが見つかりません...手動で大文字と小文字を修正することもできますが、ドキュメントを再構築するたびに、もう一度やり直す必要があります。その問題に対する既知の解決策はありますか? Linux サーバーで Sandcastle によって生成されたドキュメントをホストするのは私が初めてではないと思いますが、それに関する有用な情報は見つかりませんでした...

ご協力いただきありがとうございます

4

2 に答える 2

1

私は言語の問題の解決策を見つけたと思います：

Sandcastleによって作成されたドキュメントの言語を更新します

今、私はすべての参照テキストを翻訳する必要があります;）

2番目の問題に関しては、実際には名前を変更する必要があるファイルは2つだけです（Index.htmlとstyles / Presentation.cssの名前を小文字に変更する必要があります）ので、それほど悪くはありません...

于 2009-12-19T02:16:02.657 に答える
1

最初の質問についてはわかりません。

2号で、似たようなことに直面しました。.chm ファイルを構成ファイルに解凍し、それらをいじったり、予告編を追加したりするツールを作成しました。編集するのではなく、名前を変更することもできます。

解凍するには、この記事のコードを使用しました。

しかしその後、SHFB は .html ファイルを直接生成できることがわかったので、この解凍手順は不要だった可能性があります。（わかりません。SHFBに戻ってhtmlファイルを生成するように構成したことはありません）

HTML ファイルをアンパックするか、SHFB から直接生成したら、powershell や javascript/cscript.exe などのスクリプトで名前をバッチで変更することもできます。

于 2009-12-19T00:57:54.873 に答える