Использование ярда для работы с файлами уценки
Я написал некоторые, используя документацию для рубинового камня. Я использую ярд для создания справочной документации по гемам ruby из источника ruby, и я хочу, чтобы ярд работал с этой другой документацией по уценке.
Я написал документацию в gitlab wiki, которая использует ту же уценку, что и github, и все ссылки на якоря работают.
Когда я использую ярд для создания HTML из разметки, две вещи идут не так, как надо. Во-первых, ссылки не работали, потому что в уценке ссылки на другие файлы не включали расширение, например [Getting Started] (Введение # начало работы), которое работало в вики, но во дворе требуется [Getting Started] (Введение.html# получения стартер). Я смог обойти это, написав правило перезаписи в файле.htaccess.
Второй вопрос сложнее. Сгенерированные вики привязки к заголовкам такие же, как и выше, тогда как привязки дворов: Введение.html#Getting_Started
Я попытался разобраться в проблеме, добавив [NC] в файл.htaccess, но это не помогло. Кроме того, существует проблема изменения символа "-" на "_".
Соответствующие биты из моего файла.yardopts в связи с моим вопросом:
--markup markdown
--markup-provider redcarpet
Мой вопрос:
Является ли структура созданных якорей следствием выбора разметки или поставщика разметки? Я смущен этими условиями, и я не смог найти полезную документацию о них.
У меня установлен гем github-markup gem, и я попытался заменить markdown на github-markup, но это не сработало, затем я попытался заменить redcarpet на github-markup, но это также не работает.
Я продолжаю искать документацию, чтобы попытаться понять, что я делаю здесь, не получая никакой ясности, таким образом цепляясь за соломинку.