Каталоги GitHub wiki

на самом деле, похоже, что GitHub недавно добавил поддержку каталогов.

Я смог сделать следующее:

• переместить существующий файл уценки в новый каталог.
• создайте новый файл markdown в существующем каталоге (созданном на предыдущем шаге).
• создайте новый файл markdown в новом каталоге.

во всех случаях, на существующие страницы все еще были там и были добавлены новые страницы.

в одно из оставшихся ограничений заключается в том, что имена файлов должны быть уникальными. Если у вас есть несколько файлов с одинаковым именем, только один из них будет отображаться в Вики (я не уверен, какой именно.. ).

GitHub wiki (ака Голлум) использует каталоги, но не так, как вы можете ожидать.

документация на Голлум Вики может использовать некоторые работы, но это то, что я понял в основном с помощью тестирования.

• все файлы отображаются в корне Вики независимо от того, где они размещены в репо.
• _Header,_Footer и _Sidebar файлы для каждого каталога, но наследуются, если есть нет у ребенка папка.
• ссылки на файлы могут быть связаны с исходным файлом (храните файлы с вашим контентом).

Итак, если вы хотите каталогах для пространства имен, вам не повезло. Рассмотрите возможность использования NS-Page схемы для пространства имен.

Это не идеальное решение, но решение будет создавать пользовательские панели, где можно создать оглавление со ссылками на ваши страницы. Я считаю, что это лучше, чем папки в любом случае, потому что это позволяет вам иметь ссылку на одну страницу в нескольких иерархиях.

на самом деле, есть еще ограничения. Да, вы можете добавить 1 уровень (так, 1 подпапка). Но это все! Я переработал весь макет документации, создав несколько уровней подпапок для организации, но это было не так.

вздох

Я должен сказать: Я потрясен этой штукой Голлума. Я удивлен, что Github даже взял его.