Jak publikujemy wpisy na EmDashu: od pliku JSON do produkcji

Każda strona i każdy wpis mają dwa osobne pola na zawartość. To nie jest jeden edytor, tylko dwa pojemniki renderowane jeden pod drugim:

• Treść (content): zwykły edytor tekstu. Akapity, śródtytuły, listy, linki, kod.
• Sekcje (sections): lista gotowych bloków (hero, metryki, karty, FAQ, tabela, proces, formularz) ułożonych w dowolnej kolejności.

Treść zawsze idzie pierwsza, sekcje pod nią. Taka kolejność to ustawienie szablonu, a nie ograniczenie EmDasha. Jeśli na Twojej stronie tekst ma stać pod komponentami, zamieniamy to w szablonie, raz dla całej strony albo z przełącznikiem dla każdego wpisu. Na stronie głównej pole Treść w ogóle się nie wyświetla, bo strona główna składa się wyłącznie z sekcji.

Komponentu nie wstawisz w środek pola Treść. Całą narrację z komponentami budujesz więc w Sekcjach, a fragmenty tekstu to bloki Tekst (rich_text). Ten wpis tak właśnie wygląda: blok Tekst, tabela, blok Tekst, proces, i tak dalej.

W JSON-ie to po prostu kolejne elementy tablicy:

"sections": [
  { "_type": "rich_text", "heading": "Wstęp", "content": "Akapit z [linkiem](/)." },
  { "_type": "metrics", "items": [{ "label": "Bloki", "value": "9" }] },
  { "_type": "rich_text", "content": "Wracamy do tekstu.", "background": "żółte" }
]

Gwiazdki w nagłówku (*tak*) dają kolor akcentu. Pole label daje etykietę „§03 — Nazwa”, a anchor zamienia sekcję w cel dla linku /#kotwica.

1. Wpis w JSON-ie. Wszystkie pola tekstowe, także te w środku bloków, piszesz jako markdown. Każdy blok dostaje _type i czytelny _key. Wersje i wartości domyślne EmDash uzupełni sam:

{
  "title": "Mój wpis",
  "excerpt": "Jedno zdanie na listę wpisów.",
  "content": "Wstęp z **pogrubieniem** i [linkiem](/).",
  "sections": [
    { "_type": "rich_text", "_key": "wstep", "heading": "Część *pierwsza*",
      "content": "## Śródtytuł\n\n- punkt\n- punkt" }
  ]
}

2. Szkic. Bez flagi --draft CLI od razu publikuje:

npx emdash content create posts --file wpis.json --slug moj-wpis --draft \
  --url https://emdash-pl.mpress.workers.dev

3. Poprawki. Edytujesz ten sam plik i wysyłasz go ponownie. EmDash dopasowuje bloki po _key: ten sam klucz to aktualizacja bloku, nowy klucz to nowy blok, brakujący klucz usuwa blok. Do tego token _rev z ostatniego odczytu, który chroni przed nadpisaniem cudzych zmian:

REV=$(npx emdash content get posts <id> --json | jq -r ._rev)
npx emdash content update posts <id> --rev "$REV" --file wpis.json --draft

4. Publikacja, dopiero po przeglądzie:

npx emdash content publish posts <id>

Na produkcji najpierw jednorazowe npx emdash login --url …. Lokalnie logowanie nie jest potrzebne, bo serwer dev wpuszcza CLI bez tokenu.