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

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

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

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

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


person Thomas Levesque    schedule 19.12.2009    source источник


Ответы (2)


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

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

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

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

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

person Cheeso    schedule 19.12.2009
comment
Да, я думал о скрипте для переименования... но я все еще надеюсь найти лучшее решение ;) - person Thomas Levesque; 19.12.2009

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

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

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

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

person Thomas Levesque    schedule 19.12.2009