Вики-справочники GitHub
Имеется ли вики, которая устанавливается с помощью каталогов поддержки репозитория GitHub? Наша вики загромождена страницами, и мы ищем способ их лучше организовать.
Мы попытались вытащить репо, создать локальные каталоги и перемещать вещи, но когда они вернулись обратно, вики не подхватили изменения.
Ответы
Ответ 1
У меня была одна и та же проблема, и я попробовал варианты того, что вы пробовали. Ничего не застряло. Спросил GitHub об этом и получил ответ, который по сути сказал "Нет, но мы дадим разработчикам понять, что люди заинтересованы в этой функции".
Итак, короткий ответ - "Нет", а длинный ответ "Нет, но, возможно, в будущем".
Ответ 2
На самом деле, похоже, что github недавно добавила поддержку каталогов.
Я смог сделать следующее:
- Переместите существующий файл разметки в новый каталог.
- Создайте новый файл разметки в существующем каталоге (созданном на предыдущем шаге).
- Создайте новый файл разметки в новом каталоге.
Во всех случаях существующие страницы все еще были там, и новые страницы были добавлены.
Единственное ограничение, которое остается, состоит в том, что ваши имена файлов должны быть уникальными. Если у вас более одного файла с тем же именем, только один из них появится в вики (я не уверен, какой..).
Ответ 3
github wiki (aka Gollum) использует каталоги, но не так, как вы можете ожидать.
Документация на Gollum wiki может использовать некоторую работу, но это то, что я выяснил в основном посредством тестирования.
- Все файлы появляются в корневой папке wiki независимо от того, где они размещаются в репо.
-
_Header
, _Footer
и _Sidebar
файлы находятся в папке, но унаследованы, если есть
в дочерней папке нет.
- Ссылки на файлы могут относиться к исходному файлу (сохраняйте свои файлы с вашим контентом).
Итак, если вам нужны каталоги для пространства имен, вам не повезло. Рассмотрите возможность использования схемы NS-Page
для пространства имен.
Ответ 4
Это не идеальное решение, но обходным путем было бы создание настраиваемой боковой панели, где вы создаете оглавление со ссылками на ваши страницы. Я считаю, что это лучше, чем папки, так как это позволяет вам иметь ссылку на одну страницу в нескольких иерархиях.
Ответ 5
На самом деле все еще существует ограничение. Да, вы можете добавить 1 уровень (так, 1 подпапка). Но это! Я реорганизовал всю документацию, создав несколько уровней подпапок для организации, но это было нехорошо.
вздыхать
Я должен сказать: я потрясен этой Голллом. Я удивлен, что Гитуб даже поднял его.