Блог

Вот проблема:

Mkdocs используют имя файла для создания ссылок. Однако пользователи, которые обновляют документ, часто меняют имена файлов, поскольку они используют упорядоченные заголовки (1 1 Introduction.md , 1 2 Основные Content.md ,…)

Конечно, они помещают ссылки на другие страницы в свой документ следующим образом: (Введение)[./1 1 Introduction/#Paragraph2]

Когда они меняют имя файла, ссылка прерывается. Есть ли какой-либо способ создать ссылку на другую страницу #anchor без ссылки на имя файла и избежать неработающей ссылки при изменении имени файла? (Плагин, опция в mkdocs, что-то я пропустил, …)

Заранее спасибо

Я нашел ответ, и это было действительно очевидно. Мы не используем свойство nav файла yml для автоматического построения дерева, и мы могли бы определить его, чтобы избежать зависимости от имени файла для упорядочения.

Таким образом, имя файла все равно не может быть изменено, но мы можем определить порядок в свойстве nav и легко переименовать заголовок страницы.

Очевидное решение, но мы его пропустили.