Локализация комментариев XML

Question

Я собираюсь использовать комментарии XML для документирования API расширяемости приложения, но я не нашел ссылок на использование нескольких языков или какого-либо способа локализации этих файлов. Я хотел бы использовать sandcastle или любой другой инструмент (ABD ...?), Но я не знаю, куда поместить переведенные комментарии XML, я не знаю, должен ли я использовать ту же схему XML и т. Д. ... .

Есть ли у вас опыт по этому поводу?

Answer 1

Звучит неплохо для вас, чтобы написать расширение для редактора с помощью Visual Studio 2010. Новый редактор делает это действительно практичным, и они публикуют множество примеров этого.

Однако, как уже говорилось в других ответах, сначала вам необходимо выяснить, чего вы должны достичь. Возможно, вам придется извлечь измененные комментарии в файл, а затем уведомить кого-то, чтобы начать процесс локализации изменений. Вероятно, вы не собираетесь выполнять автоматическую локализацию, но вы, вероятно, можете автоматизировать процесс, собрав измененные комментарии, отправив их для локализации, а затем включив переведенные документы в документацию после того, как они вернутся из перевода.

Answer 2

Создайте файл XML (используете ли вы схему?), Который содержит комментарии в виде элементов с атрибутами xml: lang, идентифицирующими каждый из них.

Затем вы можете использовать XSLT или XQuery для создания версий на определенных языках по запросу или, по крайней мере, разрешить читателю делать это.

Это труднее сделать, если вы используете, но если вы используете выше, ваш XSLT или XQuery может на самом деле сгенерировать другой файл с комментариями на целевом языке.

Надеюсь, это поможет.