Войти
Рецепты
Markdown
Открыть в ИИ

Многоязычный сайт

Результат: у сайта с русским языком появляется английский — /en/…, со своей главной, меню, переведёнными страницами, hreflang и переключателем языков в шапке.

1. Добавить язык

curl -s -X POST "$API/site/$SITE/languages" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"locale": "en_US"}' | jq -c '{changed, language: .language | {slug, name, url, front_page}}'
{"changed":true,"language":{"slug":"en","name":"English","url":"https://example.onpress.pro/en/","front_page":null}}

front_page: null — главной у языка пока нет. Проверьте, как языки попадают в адрес:

curl -s -H "Authorization: Bearer $OP_TOKEN" "$API/site/$SITE/languages" | jq -c .settings

Для схемы «основной язык без префикса, остальные под /{язык}/» нужны force_lang: 1 и hide_default: true; redirect_lang: true открывает по /en/ главную языка. Если что-то не так — PATCH $API/site/$SITE/languages с этими полями (языки сайта).

2. Перевести главную

Выгрузите главную в заготовку перевода:

curl -s -H "Authorization: Bearer $OP_TOKEN" \
  "$API/site/$SITE/pages/home/markdown?as=translation_source" | jq -r .markdown > home.en.md

Во frontmatter будет translation_of с id оригинала вместо id. Поменяйте lang на en, переведите name, excerpt, SEO-поля и текст. Слаг и url можно оставить прежними — в другом языке они не конфликтуют:

---
translation_of: 6454
name: "Acme"
slug: "home"
url: "/home/"
lang: "en"
frame: "article"
excerpt: "We build sites you run through an API."
seo_title: "Acme — sites through an API"
seo_description: "Acme builds sites on OnPress: pages from markdown, frames for the look, all through the API."
---

## What we do

Sites where pages are published with a request.
curl -s -X POST "$API/site/$SITE/pages/markdown" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d "$(jq -n --rawfile md home.en.md '{markdown: $md}')" \
  | jq -c '{id, lang, link, translations, group: .translation_group.changed}'
{"id":6470,"lang":"en","link":"https://example.onpress.pro/en/home/","translations":{"en":6470,"ru":6454},"group":true}

Главная сайта хранит страницу основного языка, а её перевод автоматически становится главной своего языка: /en/ теперь открывает эту страницу.

curl -s -H "Authorization: Bearer $OP_TOKEN" "$API/site/$SITE/languages/en" | jq -c .language.front_page

Список языков кэшируется: если здесь ещё null, а /en/ уже открывает страницу, сбросьте кэш языков — POST $API/site/$SITE/cache/flush с {"polylang": true}.

3. Перевести остальные страницы

Тот же цикл для каждой страницы: выгрузить с ?as=translation_source, перевести, поменять lang, опубликовать. Для пачки:

for p in o-kompanii kontakty 404; do
  curl -s -H "Authorization: Bearer $OP_TOKEN" \
    "$API/site/$SITE/pages/$p/markdown?as=translation_source" | jq -r .markdown > "$p.en.md"
done
# … перевести файлы, заменить lang: "ru" на lang: "en" …
for p in o-kompanii kontakty 404; do
  curl -s -X POST "$API/site/$SITE/pages/markdown" \
    -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
    -d "$(jq -n --rawfile md "$p.en.md" '{markdown: $md}')" | jq -c '{id, link, translations}'
done

Слаги переводов можно давать английские (slug: "about", url: "/about/") — связь идёт по translation_of, а не по слагу. Не забудьте перевод страницы 404: ответ «не найдено» на /en/… собирается страницей 404 английского языка.

Никогда не оставляйте id оригинала во frontmatter перевода — запрос отклонится 409 lang_mismatch. Для того и нужен ?as=translation_source.

4. Меню на каждом языке

Меню стоят в области отдельно на каждый язык:

curl -s -X POST "$API/site/$SITE/menus" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"name": "Header EN", "location": "header", "lang": "en", "items": [
        {"page": "/en/about/"},
        {"page": "/en/contacts/"}
      ]}' | jq -c '{menu, invalid}'

Пункты — страницы нужного языка: путь с префиксом языка находит именно их. Подвал — так же, с location: "footer_1" и footer_2. Русские меню остаются на месте.

5. Переключатель языков

Вставка в шапку, если её ещё нет:

<!-- onpress/lang-switcher {"display":"dropdown","show":"slug"} /-->

Переключатель показывает только языки, на которых текущая страница опубликована, и ведёт на её перевод; у страницы без перевода он не выводится. Нужны все языки сайта всегда — {"scope":"site"}.

6. Данные на каждом языке

Набор с текстом, который видит посетитель, получает английский вариант рядом с общим:

curl -s -X PUT "$API/site/$SITE/data/faq" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"lang": "en", "items": [{"page": "home", "q": "How much is it?", "a": "Free to start."}]}' \
  | jq -c '.dataset | {name, lang}'

Английские страницы получат вариант en, русские — общий набор.

7. Проверка

curl -s -o /dev/null -w '%{http_code} /en/\n' "https://ВАШ_ДОМЕН/en/"
curl -s "https://ВАШ_ДОМЕН/" | grep -o '<link rel="alternate" hreflang="[^"]*" href="[^"]*"'
curl -s -H "Authorization: Bearer $OP_TOKEN" "$API/site/$SITE/pages?lang=en" | jq -c '[.items[] | {url, frame: .frame.slug}]'
curl -s -H "Authorization: Bearer $OP_TOKEN" "$API/site/$SITE/pages/home/translations" | jq -c .translations

hreflang на обеих языковых версиях, у каждой английской страницы есть фрейм, группы переводов полные. SEO-обход по языку — GET $API/site/$SITE/seo/pages?lang=en.

Частые ошибки

  • Английская страница отвечает 404 — у неё нет фрейма (выгрузка переносит frame, но проверьте) или родитель по url не переведён: /en/docs/intro/ требует английскую /en/docs/.
  • 422 parent_not_found при публикации перевода — переведите сначала родителя.
  • Переключатель не показывает язык — у страницы нет опубликованного перевода на этот язык (GET /pages/{ref}/translations → missing_languages).
  • Главную языка не удалить (409 front_page_delete) — она член группы главной сайта. Сначала выведите её из группы (DELETE /pages/{ref}/translations), потом удаляйте.
  • 409 translation_group_conflict — страница с таким слагом в этом языке уже есть и состоит в другой группе; выведите её из группы (DELETE /pages/{ref}/translations) или дайте переводу другой слаг.