Najważniejsza zmiana w 1.1.0: notACMS wysyła teraz dwa motywy w pakiecie, a ty wybierasz jeden już przy pierwszym buildzie:

./notACMS deploy --demo    # domyślny — projekt amber-phosphor, który widzisz tutaj
./notACMS deploy --bare    # minimalny wireframe: fonty systemowe, jasny tryb, ~200 linii CSS

ddev build obsługuje te same flagi. Cokolwiek wybierzesz, działa każda funkcja: treści wielojęzyczne, blog, RSS, sitemap, wyszukiwarka, formularz kontaktowy, obrazy z wariantami responsywnymi, czas czytania, wskaźnik postępu czytania. Różnica leży jedynie w wyglądzie — i, co najważniejsze, w tym, ile dziedziczysz, zanim zaczniesz dopasowywać.

Minimalny rdzeń#

Rdzeń w templates/, assets/, translations/ jest teraz wireframem. Został świadomie zminimalizowany, żeby nadpisanie pojedynczego bloku nie ciągnęło za sobą języka wizualnego, z którym musiałbyś walczyć. Jeśli budujesz projekt szyty na miarę, startuj z bare i od pierwszego dnia kontrolujesz cały wygląd.

Motyw demo#

Demo żyje w docs/demo/ i kopiowane jest do local/, kiedy wybierzesz --demo. To pełny projekt amber-phosphor, który właśnie czytasz — ciemny tryb, overlay wyszukiwania, sidebar dokumentacji, przełącznik motywu, wszystko razem. Startuj stąd, jeśli chcesz dopracowany projekt już dziś i planujesz dopracowywać, a nie przebudowywać.

System nadpisań local/#

Oba motywy korzystają z tego samego mechanizmu: każdy plik w local/ ma pierwszeństwo przed odpowiadającą mu ścieżką w rdzeniu.

Rdzeń nie jest nigdy edytowany. git pull pozostaje czysty. Personalizacje żyją w repozytorium twojej strony, nie w forku tego repo.

Aktualizacja z 1.0.0#

Jeśli używałeś 1.0.0 i chcesz, żeby twoja strona wyglądała dokładnie jak wcześniej, pakiet kompatybilności to jedna linijka:

cp -r docs/customization/old-template/. local/
ddev build

To wrzuca kompletny motyw sprzed 1.1.0 — szablony, SCSS, fonty, obrazy, tłumaczenia — do local/. Twoja strona renderuje się dokładnie jak przedtem. Później możesz selektywnie usuwać pliki z local/, w miarę jak adaptujesz nowe elementy projektu.

Faktyczne breaking changes, które cię dotkną, jeśli dostosowywałeś stary rdzeń:

• Zmiana nazwy entrypointa SCSS: local/assets/styles/local.scss → local/assets/styles/app_local.scss. Zmień nazwę pliku i zaktualizuj import w local/assets/app.js.
• Zmienne SCSS kolorów w rdzeniu zastąpione CSS custom properties: $color-body → var(--text), $color-link → var(--accent) itd. Pełna mapa w UPGRADE-1.1.md.
• Klucze tłumaczeń usunięte z rdzenia (nadal obecne w motywie demo): header.tagline, nav.projects, nav.search, blog.published_on, blog.comments_disabled. Jeśli twoje szablony wołają '...'|trans na tych kluczach, zaktualizuj je.
• Katalog docs/examples/ usunięty: przydatne części trafiły do docs/customization/old-template/; przykłady nadpisań ad hoc zostały wyparte przez model bare/demo.

Zobacz UPGRADE-1.1.md po pełną listę ze snippetami przed/po.

Co jeszcze nowego w 1.1.0#

• Czas czytania i wskaźnik postępu czytania na wpisach, dokumentacji i releasach.
• Przełącznik języka jako rozszerzenie Twiga (lang_switch_urls) z poprawnymi łańcuchami fallbacków dla archiwów, list z paginacją i stron głównych.
• Zajawki wpisów usuwają kotwice nagłówków — żadnych zbłąkanych # na kartach list.
• Szkielet suite testów w tests/Unit/, tests/Integration/, tests/Fixtures/ z początkowym pokryciem i komendą test uruchamianą z hosta.
• Skille agenta AI w .claude/skills/ do pracy nad repo: dodawanie locali, sprawdzanie alignmentu dokumentacji, site-sweepy, tłumaczenia i generowanie przewodników aktualizacji.

Pełny changelog#

Każda zmiana ze swoją kategorią: CHANGELOG.md.

Po kilku miesiącach wewnętrznego użytkowania w projektach osobistych, oznaczam pierwsze stabilne wydanie. Podstawowy zestaw funkcji jest wystarczająco solidny, aby budować prawdziwe strony.

Pipeline treści#

Pipeline treści to serce notACMS. Odczytuje katalog local/content/, parsuje frontmatter i jedną komendą generuje kompletną stronę statyczną.

• Treść Markdown z frontmatter YAML
• Renderowanie CommonMark z permalinkami nagłówków
• Generowanie excerptów z treści prozatorskich
• Obliczanie czasu czytania

Wielojęzyczny routing#

Lokale są definiowane w _site.yaml. Każdy lokal otrzymuje własną przestrzeń URL, z opcjonalnymi nadpisaniami ścieżek w _routes.yaml. Tagi hreflang są generowane automatycznie.

locales:
  en:
    label: "English"
    date_format: "M d, Y"
  pl:
    label: "Polski"
    date_format: "d.m.Y"

Wyszukiwarka Pagefind#

Pełnotekstowe wyszukiwanie jest wbudowane w wynik statyczny przez Pagefind. Komenda budowania automatycznie generuje indeks wyszukiwania. Brak zewnętrznego API, brak wyszukiwania po stronie serwera — tylko statyczny indeks działający offline.

Przetwarzanie obrazów#

Obrazy przechowywane obok treści są przetwarzane podczas budowania. notACMS generuje warianty WebP w wielu szerokościach, automatycznie aktualizuje atrybuty src o responsywne srcset i obsługuje mapowanie ścieżek między katalogami treści i wynikowym.

Środowisko lokalne DDEV#

Środowisko deweloperskie jest w pełni skonteneryzowane z DDEV. ddev start daje PHP 8.5, Nginx i wszystkie narzędzia budowania. ddev build produkuje wynik statyczny. ddev code-check uruchamia PHPStan i PHP CS Fixer.

Przełomowe zmiany#

To pierwsze stabilne wydanie. Jeśli używałeś wersji sprzed 1.0, sprawdź schemat _site.yaml — klucz social zmienił się z listy na mapę.

Aktualizacja#

git pull
ddev composer install
ddev build

Co dalej#

v1.1.0 skupi się na systemie designu i dokumentacji. Ta strona — zbudowana z notACMS — stanie się oficjalną dokumentacją i referencją designu.

Dłuższa historia w tle na moim osobistym blogu: I left WordPress.

Problem, na który wciąż trafiałem#

Każdy projekt PHP, nad którym pracowałem, w końcu potrzebował strony internetowej. Dokumentacja, landing page, blog — to co zwykle. I za każdym razem, gdy sięgałem po narzędzie, lądowałem w tym samym miejscu: narzędzie, które chciało, żebym myślał jak ono, a nie jak programista PHP.

Hugo jest szybki, ale jego język szablonów jest obcy. Jekyll wymaga Ruby. WordPress ma zły kształt dla treści statycznych. Next.js jest potężny, ale zamienia problem z publikowaniem Markdown w problem z bundlerem JavaScript.

Wciąż myślałem: znam już Symfony. Znam już Twig. Mam już Composer. Dlaczego muszę uczyć się nowego ekosystemu tylko po to, żeby opublikować tekst?

Decyzja o braku bazy danych#

Pierwsza rzecz, którą postanowiłem: żadnej bazy danych. Nie „baza danych opcjonalnie" — żadnej bazy danych w ogóle. Treść żyje w plikach. Proces budowania odczytuje pliki. Wynik to pliki.

To wymusza pewną dyscyplinę. Struktura treści musi być jawna i przewidywalna. Nie ma zapytania do bazy, po które można sięgnąć, gdy chce się znaleźć powiązane wpisy lub wygenerować mapę strony. Wszystko musi być wyprowadzalne z drzewa plików.

To ograniczenie okazało się właściwym wyborem. Sprawia, że system jest łatwy do rozumienia, łatwy do backupowania i trywialnie łatwy dla narzędzi AI.

AI-friendly z założenia#

Zacząłem poważnie o tym myśleć, gdy zacząłem używać LLM w codziennej pracy. Proszenie AI o pomoc przy generowaniu treści, tłumaczeniu stron czy walidacji schematów YAML jest proste, gdy format to zwykły tekst.

W przypadku CMS-a opartego na bazie danych trzeba by wyjaśniać schemat, pisać SQL, zarządzać migracjami. Z notACMS przekazujesz AI katalog plików Markdown i może ona bezpośrednio odczytywać, generować i edytować treści — bo format to po prostu tekst.

To nie jest funkcja dodana po fakcie. To powód, dla którego system jest zaprojektowany w taki sposób.

Fundament Symfony#

Zbudowałem notACMS na Symfony 7 z tego samego powodu, dla którego używam Symfony do wszystkiego innego: jest jawny, typowany i dobrze udokumentowany. Kontener DI, komendy konsolowe, Twig — to wszystko standardowy Symfony. W infrastrukturze nie ma nic nowatorskiego.

Model treści to interesująca część. System routingu odczytuje _routes.yaml i generuje trasy Symfony z drzewa treści. Komenda budowania renderuje każdą trasę i zapisuje statyczny HTML. Warstwa serwisów jest cienka i wymienialna.

Co dalej#

To pierwsze wydanie to działający fundament. Rzeczy, które chcę zbudować:

• Integracja wyszukiwarki Pagefind (w v1.0.0)
• Lepszy pipeline obrazów z generowaniem WebP
• Pełniejsze wsparcie wielojęzyczne
• Właściwa strona Design Reference (tym staje się ta strona)

Repozytorium jest publiczne. Jeśli chcesz śledzić postępy lub wnieść wkład, link jest w stopce.