-
Notifications
You must be signed in to change notification settings - Fork 379
Description
Motivation
I noticed that in the docs many places when links don't match "correct" headers, for example:
https://xtls.github.io/ru/config/api.html#api -> См. раздел Связанные настройки в этом документе -> doesn't match header Связанные настройки.
Reason
VuePress replace some characters on build stage, for example й to и in the case above. This behavior described in the issue.
Proposal
Fix the links to use the correct generated link in the header, for example: #связанные-настройки should be #связанные-настроики.
But this change has problems: some links become non-working in the IDE/GitHub because #связанные-настроики don't point to the header Связанные настройки until docs doesn't build.
So there is also a variant to specify header's links before compilation for IDE/GitHub: ## Связанные настройки -> ## <a id="связанные-настроики"></a>Связанные настроики, but it's not a very intuitive option for developers.
Alternatives
A way to off such behavior of the library