Чи підтримує wiki, що встановлюється за допомогою репозиторію GitHub, каталоги? Наша вікі захаращена сторінками, і ми шукаємо спосіб їх краще організувати.
Ми спробували витягнути репо, створити локальні каталоги та перемістити речі, але коли коміт повернувся назад, вікі не взяв змін.
Відповіді:
У мене була точно така ж проблема, і я пробував варіанти того, що ви пробували. Нічого не застрягло. Запитавши підтримку GitHub щодо цього, ми отримали відповідь, яка, по суті, сказала: "Ні, але ми повідомимо розробників, що люди зацікавлені в цій функції".
Тож коротка відповідь - «Ні», а довга - «Ні, але можливо в майбутньому».
Насправді, схоже, нещодавно github додав підтримку каталогів.
Я зміг зробити наступне:
У всіх випадках наявні сторінки все ще існували, а нові сторінки додавались.
Єдине обмеження, яке залишається, полягає в тому, що імена ваших файлів повинні бути унікальними. Якщо у вас є більше одного файлу з однаковим ім’ям, у вікі з’явиться лише один із них (я не впевнений, який ..).
Вікі GitHub (він же Gollum ) використовує каталоги, але не так, як ви можете очікувати.
Документація у вікі Gollum може зайняти певну роботу, але це те, що я з'ясував переважно за допомогою тестування.
_Header, _Footerа _Sidebarфайли належать до кожного каталогу, але успадковуються, якщо в дочірній папці їх немає.Отже, якщо вам потрібні каталоги для простору імен, вам не пощастило. Подумайте про використання {namespace}-{page}схеми для простору імен.
Це не ідеальне рішення, але обхідним шляхом було б створити власну бічну панель, де ви створюєте зміст із посиланнями на ваші сторінки. Я вважаю, що це все одно краще папок, оскільки це дозволяє мати посилання на одну сторінку в декількох ієрархіях.
Насправді, обмеження все ще існують. Так, ви можете додати 1 рівень (отже, 1 підпапку). Але це все! Я переробив весь макет документації, створивши кілька рівнів підпапок для організації, але це було заборонено.
зітхати
Треба сказати: я вражений цією справою Голлума. Я здивований, що Github навіть взяв його.