Публикация статьи блога

Как взять узел блога из вашего проекта и выложить его в сеть: и как страницу, которой можно поделиться, и как встраиваемый блок на вашем сайте.

Публикация из узла блога

Откройте узел блога в редакторе. В его шапке находятся элементы управления публикацией:

• Опубликовать записывает вашу статью на публичную страницу, и с этого момента страница отражает то, что вы опубликовали в последний раз. Ваш рабочий черновик остаётся частным, пока вы не опубликуете снова.
• Публикация явная и доступна только владельцу: нужно быть в системе и в сети.

После публикации статья живёт по адресу:

https://papera.dev/blog/<your-slug>

Нажмите Посмотреть в шапке, чтобы открыть эту страницу в новой вкладке.

Выберите адрес (slug)

Slug это последняя часть адреса. Он предлагается по заголовку, и его можно изменить в настройках SEO статьи. Slug уникален во всей Papera: если выбранный уже занят, публикация сообщит об этом и предложит свободный вариант (например my-article-2), который принимается одним нажатием.

Изменение slug у опубликованной статьи публикует её заново по новому адресу и освобождает старый. Перенаправления не создаётся, поэтому обновите ссылки, которыми вы поделились.

Встройте её на свой сайт

Чтобы разместить статью внутри другой страницы, сначала включите встраивание для статьи, затем нажмите Скопировать код встраивания в шапке. Вы получите самодостаточный фрагмент:

<iframe src="https://papera.dev/embed/blog/my-article"
        title="My article" loading="lazy"
        style="width:100%;border:0;height:600px"></iframe>
<script>
  addEventListener("message", (e) => {
    if (e.data?.type !== "papera:embed:height") return;
    const f = document.querySelector('iframe[src*="/embed/blog/my-article"]');
    if (f) f.style.height = e.data.height + "px";
  });
</script>

Вставьте его на свой сайт. Встраивание идёт без интерфейса вокруг: только статья и её оформление. Оно само подбирает высоту: небольшой скрипт растягивает iframe под содержимое. Если убрать скрипт, iframe просто сохранит фиксированную высоту. Ссылки внутри встроенной статьи открываются в новой вкладке, поэтому читателя никогда не уводит с вашей страницы.

Ограничьте встраивание списком сайтов

По умолчанию встраиваемую статью может показать у себя любой сайт. Чтобы ограничить это, перечислите разрешённые сайты (источники) в настройках встраивания статьи. Только они смогут показать её у себя, а iframe любого другого сайта останется пустым. Публичная страница при этом продолжает работать.

Снятие с публикации

Снять с публикации убирает публичную страницу: и /blog/<slug>, и её встраивание отвечают обычной ошибкой 404, неотличимой от статьи, которой никогда не было. Ваш локальный черновик не затрагивается, поэтому вы можете продолжать править и опубликовать снова позже.