BitBucket Wiki: создать иерархическую структуру?

Question

Я хочу создать иерархию в моей вики следующим образом:

General
FooPages
    Foo1
    Foo2
    Foo3
       ODP
Bar
   Baz

Я хотел бы создать эти страницы и использовать макросы оглавления <<toc>> для их организации.

Как мне это сделать?Нужно ли клонировать и редактировать вики на моем собственном компьютере, или я могу сделать это исключительно через веб-интерфейс?

Answer 1

Вы можете (частично) сделать это, используя <<toc / >>. Это создаст оглавление для всех заголовков в файлах в корневом каталоге. Однако он не будет перечислять заголовки в файле в подкаталогах. Вы можете сделать то же самое для <<toc FooPages/ >> и т. Д.

Вы можете сделать это как через веб-интерфейс, так и локально на вашем компьютере.

Я разместил несколько примеров оглавления на этой вики-странице Bitbucket: http://bitbucket.org/marijnvanderzee/build-wiki/wiki/TocTests. Вы можете просмотреть разметку там.

Убедитесь, что вы уравновешиваете знаки равенства на ваших заголовках; например используйте == H2 == вместо == H2. Оба действительны, но в настоящее время последний не распознается макросом <<toc>>.

Answer 2

Относительно иерархии этого вопроса, стоит уточнить:

Вы можете создать иерархическую структуру, используя поле Заголовок при создании или редактировании вики-страницы.

Например: если вы хотите создать новый файл Bar.md в новом каталоге Foo, просто создайте новую страницу и в поле Название напишите «Foo / Bar.md».Он создаст каталог и файл одновременно.

Я не уверен, есть ли способ просто создать каталог, не добавляя в него файл сразу.

ОтносительноВ половине этого вопроса я обнаружил, что могу использовать синтаксис # HeaderTitle на страницах Markdown, и макрос Creole TOC его распознает.