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

Question

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

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

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

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

Answer 1

Я думаю, что нашел решение языковой проблемы:

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

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

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

Answer 2

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

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

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

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

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