Комментарии 17
Йееее, очень приятно почитать такую офигенную статью, спасибо! Единственное, что мне показалось лишним -- зачем вам явный ToC, если он автоматически соберётся из структуры файлов? Можно было бы не пытаться познакомить Настю с YAML. Автоматический ToC ещё и от бардака в файлах спасёт, так как всё лишнее сразу всплывёт.
Без явного ToC, статьи будут в алфавитном порядке. Ей хотелось свой порядок установить. А лишние файлы (те что в ToC не добавлены) всплывают в виде ворнингов при сборке.
Действительно, выглядит как ограничение... Я подумал, что можно было бы добавить индекс к именам файлов, но потерпел неудачу.
Похоже, что в MkDocs ещё есть что доработать, хотелось бы чтобы для сортировки использовались имена файлов, а текст для ToC брался из h1 файла index.md
Что-то мне напоминают эти твои индексы с шагом 10... :-)
эхэхэ, фончик ностальгический, спасибо, заценил )))
Я в таких местах всегда стараюсь индексы делать с отверстиями, в которые можно что-нибудь поместить позже и чтобы ничего вокруг не пришлось переименовывать.
Меня этому косплей-фесты научили, потому что там номера участников менять очень больно, а участники постоянно хотят куда-то перемещаться как до феста, так и во время феста (могут не успеть на свой номер и быть перенесёнными в соседний блок).
Ещё, отдельное спасибо за Containerfile вместо Dockerfile (даже несмотря на то, что так докер его не видит по-умолчанию, и приходится указывать явно). Зато podman и rancher видят!
Более простой вариант сделал markdkown -> html.
И очень простой индекс https://gitlab.com/bazilxp/blog/-/blob/master/README.ru.md
https://blog.xpbit.com/ так выглядит статический вариант
Годнота-то какая, красота...
Я даже перепроверил сайт — тот ли самый гитхаб ))
Посмотрите Hugo, у него есть крутейшие готовые шаблоны и кастомизации. Раскатывать можно как с локального ПК, так и через gh actions. Без контейнеризации
Docker — контейнеризатор приложений (для упрощения запуска MkDocs).
Извините за, вероятно, глупый вопрос. Вы используете docker чтобы сделать mkdocs build и mkdocs serve?
Docs as Code для художественной литературы. Делаем творческий сайт ребенка с помощью MkDocs