2015-07-01 4 views
0

Вики-статья Bitbucket использует синтаксис Markdown.Как я могу локально просмотреть Wiki Markdown?

Существует множество способов предварительного просмотра одного файла .md, но есть ли способ просмотреть весь сайт уценки под OS X? То есть то, что будет обрабатывать несколько файлов одновременно, с внутренними ссылками, работающими.

Поиск по нему дает только десятки решений для отдельных файлов, но ни один , по-видимому, должен работать для этой настройки.

ответ

1

Возможно, вам нужен «генератор статического узла» (см. fewlistshere). Их основная функция - ходить в каталог и преобразовывать все файлы в HTML. Вы можете «создать» сайт, а затем просмотреть файлы в своей файловой системе, или многие инструменты также предлагают команду «служить», которая будет обслуживать файлы на локальном хосте для предварительного просмотра. Например, Github использует Jekyll для некоторых частей своего сервиса (GitHub Pages).

Тем не менее, я не знаю, какие инструменты использует Bitbucket, поэтому я не могу указать на что-то более конкретное, что даст вам почти то же поведение, что и в Вики-версии Bitbucket. Я считаю, что они являются магазином Python (GitHub - Ruby - таким образом, инструмент Ruby), но есть несколько реализаций Python парсеров Markdown, так что вы не дойдете до конца.

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

У меня был личный опыт работы с Pelican (движок блога) и MkDocs (генератор документации), но не знаю, будет ли он хорошо соответствовать вашим потребностям (они оба появляются в списках, связанных с выше). Кроме того, этот ответ становится опасно близким к рекомендации мнений/программ, поэтому я остановлюсь здесь.

Смежные вопросы