Я использую Sandcastle Help File Builder для создания документации для проекта с открытым исходным кодом, и я столкнулся с двумя проблемами:
Содержание документации на французском языке. Я установил французский язык в проекте SHFB, но большая часть сгенерированного текста по-прежнему на английском ("Свойства", "Иерархия наследования", "См. также"...). Я видел, что в папках SharedContent есть несколько локализованных файлов (которые на самом деле не полностью локализованы), но они позволяют переводить только некоторые вещи, в основном детали (отзывы, отказ от ответственности, заявление о конфиденциальности и тому подобное). Как мне локализовать остальную часть текста? Обратите внимание, что у меня есть английская версия Visual Studio 2008; это может быть проблемой?
Документация создается в формате HTML и размещается на сервере Linux/Apache. К сожалению, многие имена файлов, сгенерированные Sandcastle, имеют несовместимый регистр, поэтому он не работает на сервере Linux. Например, «Index.html» не считается документом по умолчанию Apache (он должен быть «index.html»), а файлы CSS не найдены из-за неправильного регистра... Я мог бы исправить регистр вручную, но я придется делать это снова каждый раз, когда я перестраиваю документацию. Есть ли известное решение этой проблемы? Думаю, я не первый, кто размещает документацию, созданную Sandcastle, на сервере Linux, но я не смог найти никакой полезной информации об этом...
Спасибо за вашу помощь