Рецепты

Каждый рецепт — законченная задача от пустого места до проверенного результата. Запросы идут в том порядке, в каком их надо выполнять; переменные OP_TOKEN, API и SITE заданы, как в быстром старте. Слаги и адреса в рецептах — примерные, подставляйте свои.

• Сайт с нуля — шапка, подвал, оболочка статьи, меню, первые страницы, главная, стили.
• Раздел документации — оболочка с деревом, оглавлением и пейджером, страницы разделом, порядок и короткие подписи.
• Лендинг из конструктора — готовый HTML как фрейм-документ, страница-адрес, статическая копия, главная.
• FAQ на странице — фрейм faq со слотом, блок onpress/faq в тексте и вариант с общим набором.
• Свой фрейм из готового — копия фрейма со своей разметкой при тех же данных и схеме.
• Многоязычный сайт — новый язык, переводы страниц, меню и главная на каждом языке, переключатель.
• Поменять меню — пункты шапки и подвала на каждом языке.
• Перенести страницу — в другую ветку без потери адреса и без дублей.
• Картинки в статье — загрузка, подписи, изображение записи.
• Список из данных — карточки из набора с фильтром и разбивкой по страницам.
• Сменить оформление — CSS-переменные, свой CSS и проверка.

Общие правила, которые экономят время

1. Сначала фрейм, потом страница. Страница без фрейма на сайте v2 отвечает 404. Публикуйте страницы сразу с frame.
2. slug и url согласованно. Последний сегмент url — это страница, но слаг берётся из slug. Разошлись — адрес будет не тот.
3. Перенос — с id. Публикация без id ищет страницу под новым родителем и, не найдя, создаёт вторую.
4. Проверяйте без кук. curl -s -o /dev/null -w '%{http_code}' <адрес> — так страницу видит посетитель и поисковик.
5. Читайте warnings и printed. Проигнорированное поле, сменившийся слаг, неопубликованный родитель, отсутствие фрейма — всё это приходит в ответе, а не ошибкой.
6. Пробуйте на черновике. У публикации нет dry_run, зато есть status: draft и preview_url. У фреймов, наборов, стилей и дерева документации dry_run есть.