Как я могу использовать Mkdocs на локальном компьютере без сервера?

Я установил Mkdocs (Python 3.6.5) и редактировал и создавал файлы Markdown.

Я попытался открыть основной файл index.html в браузере, но не могу напрямую открывать страницы HTML, связанные с другими файлами HTML.

Используя командную строку и набрав «mkdocs serve», я могу открывать связанные страницы. Я знаю, что это нормальная функция Mkdocs без сервера.

Могу ли я использовать Mkdocs только на своем локальном компьютере?


person masaovl    schedule 13.08.2018    source источник


Ответы (2)


Согласно документу, вы можете добавить use_directory_urls: false в mkdocs.yml и перестроить его.

Стиль по умолчанию use_directory_urls: true создает более удобные для пользователя URL-адреса, и обычно это то, что вы захотите использовать. Альтернативный стиль (редактировать: use_directory_urls: false) иногда может быть полезен, если вы хотите, чтобы ваша документация оставалась правильно связанной при открытии страниц непосредственно из файловой системы, потому что он создает ссылки, которые указывают непосредственно на целевой файл, а не на целевой каталог.

person Yohanes Gultom    schedule 13.08.2018
comment
Большой. Не забудьте принять ответ, чтобы помочь другим с похожей проблемой - person Yohanes Gultom; 13.08.2018

Согласно официальной документации, вы можете генерировать html-файлы с помощью mkdocs build. Они будут храниться в папке с именем site. Вы можете открывать встроенные файлы, не запуская mkdocs serve.

person SloCompTech    schedule 03.09.2018