Skip to content

docs(ru): fix the anchors that the site cannot resolve - #675

Merged
Ibochkarev merged 1 commit into
modxorg:3.xfrom
Ibochkarev:docs/ru-anchors
Oct 20, 2026
Merged

Ibochkarev merged 1 commit into
modxorg:3.xfrom
Ibochkarev:docs/ru-anchors

Conversation

@Ibochkarev

Copy link
Copy Markdown
Collaborator

Summary

The anchors of the headings are built by TOCUniqueSlugify, which transliterates the Cyrillic letters. A link with a Cyrillic anchor therefore leads nowhere — the browser looks for #публикация-в-менеджере-и-несколько-групп, while the heading carries the id #publikaciya-v-menedzhere-i-neskolko-grupp.

The Russian locale carried fifteen such links. They are replaced with the transliterated ones:

Before After
#публикация-в-менеджере-и-несколько-групп #publikaciya-v-menedzhere-i-neskolko-grupp
#кэширование #keshirovanie
#объединение-полей #obedinenie-poley
#пользовательские-заголовки #polzovatelskie-zagolovki
#удаленные-объекты #udalennye-obekty
#правило-callable #pravilo-callable
#типы-системных-настроек #tipy-sistemnyh-nastroek
#процессоры-в-modx-3 #processory-v-modx-3
#использование, #плейсхолдеры, #см-также #ispolzovanie, #pleysholdery, #sm-takzhe

The pages that are touched:

  • ru/building-sites/client-proofing/security/policies/index.md
  • ru/building-sites/client-proofing/security/policies/permissions/administrator-policy.md
  • ru/building-sites/client-proofing/security/policies/permissions/resource-policy.md
  • ru/building-sites/client-proofing/security/security-tutorials/giving-a-user-manager-access.md
  • ru/extending-modx/modx-class/reference/modx.haspermission.md
  • ru/extending-modx/xpdo/custom-models/defining-a-schema/validators.md
  • ru/building-sites/resources/custom-resources.md
  • ru/building-sites/resources/static-resource.md
  • ru/building-sites/resources/symlink/index.md
  • ru/building-sites/settings/index.md
  • ru/building-sites/tag-syntax/nested-tags.md
  • ru/extras/eventscalendar2/eventscalendar2.tplhead2.md
  • ru/getting-started/upgrading-to-3.0/actions.md

Checks

  • Every anchor of the Russian locale that points to a heading is resolved against that heading with the same slugifier the site uses (cocur/slugify 4.7.1 with TOCUniqueSlugify)
  • No link with a Cyrillic anchor is left in the Russian locale
  • markdownlint-cli@0.18 (the version used by CI): 0 issues

Note

There are about 130 links left in the Russian locale that point to an anchor that no heading carries — mostly the glossary, whose terms are not headings, and the pages of the extras, which keep the anchors of MODX 2. They are older than the recent passes and are left for a separate look.

The anchors of the headings are built by `TOC\UniqueSlugify`, which
transliterates the Cyrillic letters. A link with a Cyrillic anchor
therefore leads nowhere, and the pages of the Russian locale carried
fifteen such links.

The anchors are replaced with the transliterated ones:

- `#публикация-в-менеджере-и-несколько-групп` →
  `#publikaciya-v-menedzhere-i-neskolko-grupp`;
- `#кэширование` → `#keshirovanie`;
- `#объединение-полей` → `#obedinenie-poley`;
- `#пользовательские-заголовки` → `#polzovatelskie-zagolovki`;
- `#удаленные-объекты` → `#udalennye-obekty`;
- `#правило-callable` → `#pravilo-callable`;
- `#типы-системных-настроек` → `#tipy-sistemnyh-nastroek`;
- `#процессоры-в-modx-3` → `#processory-v-modx-3`;
- `#использование`, `#плейсхолдеры`, `#см-также` → `#ispolzovanie`,
  `#pleysholdery`, `#sm-takzhe`.

The anchors are checked against the headings of the pages they point
to, with the same slugifier the site uses.
@Ibochkarev
Ibochkarev merged commit b7ea230 into modxorg:3.x Oct 20, 2026
2 checks passed
@Ibochkarev
Ibochkarev deleted the docs/ru-anchors branch October 20, 2026 14:05
Ibochkarev added a commit to Ibochkarev/Docs-MODX that referenced this pull request Oct 20, 2026
The Russian page of the administrator policy is rewritten in this branch:
it lists the 183 permissions of the Administrator policy of MODX 3, one
per row, while the page on `3.x` still lists 101 of them and adds four
that the core does not have (`Content_Types`, `import_static`, `logs` and
one row in Russian). The rewritten table is kept, together with the
transliterated anchor from modxorg#675.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant