Как структурировать вики файлы GitHub?

Я клонировал одну из моих вики-проектов проекта GitHub локально, и я хочу реструктурировать файловую систему. По умолчанию разные страницы, добавленные в wiki, создаются в родительском каталоге:

/wiki
     home.md
     wiki_page_1.md
     ...

Я хочу иметь структуру каталогов, подобную этой:

/wiki
  /setup
    setup_procedures.md
    index.md
  /development
    index.md
    tools.md
  /images
    front_page.png

Я попытался структурировать свои файлы wiki аналогично, но он не работает для файлов .md. Однако он работает для папки с изображениями. Есть ли способ сделать эту работу?

Ответы

Ответ 1

Если GitHub все еще использует github/gollum, то, как объясняется в разделе вы используете подкаталоги в проверке вики GitHub? ", вложенные папки не поддерживаются (или были ошибочными во время fork).

Более поздние версии gollum/gollum поддерживает эту организацию, хотя последние PR (Pull Requests) по-прежнему устраняют проблемы вокруг него (например, PR 787).

OP tsega добавляет в комментарии:

попытался заглянуть в вики Gollum, и оказалось, что вы можете упорядочить свои файлы в каталогах, но это не так, как вы к ним обращаетесь.

Доступ к каждой странице осуществляется из корня wiki, например. github.com/user/repo/wiki/file-name не github.com/user/repo/wiki/directory/file-name.

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

Ответ 2

Я только что ударил по той же проблеме, и я решил ее (kinda) с помощью настраиваемой строки меню и с помощью обычного Markdown, т.е. заголовков и ссылок для создания структуры папок.