Проблемы с Sandcastle:локализация и регистр имен файлов

Question

Я использую Sandcastle Help File Builder для создания документации для проекта с открытым исходным кодом и столкнулся с двумя проблемами:

• Содержание документации на французском языке.В проекте SHFB я установил французский язык, но большая часть сгенерированного текста по-прежнему на английском («Свойства», «Иерархия наследования», «См. также»…).Я видел, что в папках SharedContent есть несколько локализованных файлов (которые на самом деле не полностью локализованы), но они позволяют переводить лишь некоторые вещи, в основном детали (отзывы, отказ от ответственности, заявление о конфиденциальности и тому подобное). Как локализовать остальной текст? Обратите внимание, что у меня английская версия Visual Studio 2008;может ли это быть проблемой?

• Документация создается в формате HTML и размещается на сервере Linux/Apache.К сожалению, многие имена файлов, сгенерированные Sandcastle, имеют несовместимый регистр, поэтому они не работают на сервере Linux.Например, Apache не считает «Index.html» документом по умолчанию (это должен быть «index.html»), а файлы CSS не найдены из-за неправильного регистра...Я мог бы исправить корпус вручную, но мне пришлось бы делать это заново каждый раз, когда я пересобираю документацию. Есть ли известное решение этой проблемы? Думаю, я не первый, кто размещает документацию, созданную Sandcastle, на сервере Linux, но я не смог найти никакой полезной информации об этом...

Спасибо за вашу помощь

Answer 1

Кажется, я нашел решение языковой проблемы:

Обновить язык документации, созданной Sandcastle.

Теперь мне осталось перевести все справочные тексты ;)

Что касается второй проблемы, то на самом деле нужно переименовать только два файла (Index.html и Styles/Presentation.css необходимо переименовать в нижний регистр), так что это не так уж и плохо...

Answer 2

Не знаю насчет первого вопроса.

По 2-му вопросу столкнулся с чем-то подобным.Я создал инструмент для распаковки файла .chm на составляющие файлы, а затем их изменения, добавления трейлеров и т. д.Вы могли бы сделать что-то подобное и вместо того, чтобы редактировать их, переименовать их.

Для распаковки я использовал код из Эта статья.

Но затем я узнал, что SHFB может создавать файлы .html напрямую, поэтому этот шаг распаковки, возможно, был ненужным.(Я не знаю, я никогда не возвращался и не настраивал SHFB для создания html-файлов)

После того, как вы распаковали HTML-файлы или создали их непосредственно из SHFB, вы даже можете выполнить пакетное переименование их в сценарии, например powershell или javascript/cscript.exe.