Platformă de blog care arată ca o aplicație GNOME/libadwaita; generează un site static din PHP.
  • PHP 57.7%
  • JavaScript 24%
  • CSS 18.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
ThinkRoot fd800fa864 Initial import of caiet
Public copy of the project, without personal or sensitive data.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 16:46:52 +02:00
admin Initial import of caiet 2026-11-06 16:46:52 +02:00
sertar Initial import of caiet 2026-11-06 16:46:52 +02:00
.gitignore Initial import of caiet 2026-11-06 16:46:52 +02:00
LICENSE Initial import of caiet 2026-11-06 16:46:52 +02:00
README.md Initial import of caiet 2026-11-06 16:46:52 +02:00

Caiet, un blog în stilul GNOME

O platformă de blog care arată ca o aplicație GNOME/libadwaita: bara de titlu cu comutator de secțiuni, liste și carduri Adwaita, meniu cu stil și culoare de accent, căutare, dialoguri, notificări și bara de jos pe telefon.

Cititorii primesc un site static: pagini HTML gata făcute, rapide, fără bază de date. Le face un motor mic în PHP, care rulează pe același hosting shared (Apache sau LiteSpeed): de fiecare dată când salvezi ceva în panoul de administrare (/admin/), motorul reface paginile. Panoul arată și el ca o aplicație GNOME.

Ce îți trebuie

  • PHP 8.1 sau mai nou, cu permisiunea de a scrie în dosarul site-ului.

  • Extensiile PHP:

    • mbstring, obligatorie;
    • gd, pentru imaginile WebP și cele pentru rețele (fără ea, site-ul merge, dar fără ele);
    • imagick cu suport SVG, opțională: ilustrațiile SVG ale articolelor devin chiar ele imaginea pentru rețele;
    • curl, pentru mențiunile trimise și anunțul WebSub;
    • dom, pentru mențiunile primite;
    • fileinfo, pentru verificarea imaginilor urcate (fără ea, verificarea se face mai simplu);
    • zip, pentru copia de siguranță din panou;
    • intl, opțională: caută mai bine cuvintele cu diacritice.

    Pe aproape orice hosting sunt deja active; altfel se activează din panoul hostingului, la extensiile PHP.

  • Apache cu mod_rewrite sau LiteSpeed, ca să meargă adresele scurte din .htaccess.

Ce e în dosar

Conținutul dosarului se urcă în rădăcina site-ului (de obicei public_html/).

caiet/
├── admin/                   panoul de administrare: intrarea (index.php), stilul și scripturile lui
├── sertar/                  dosarul privat, blocat din web (și prin sertar/.htaccess)
│   ├── cli.php              comenzile din terminal: construieste, cont, ceas
│   ├── motor/               motorul care face site-ul
│   │   ├── construieste.php ordinea pașilor și fișierele generate
│   │   ├── site.php         căile, setările, adresele și funcțiile mici
│   │   ├── continut.php     citirea articolelor și a paginilor (ciorne, articole programate)
│   │   ├── sabloane.php     șabloanele paginilor
│   │   ├── markdown.php     convertorul Markdown
│   │   ├── fluxuri.php      RSS, Atom, JSON Feed, harta site-ului, indexul căutării
│   │   ├── imagini.php      WebP și imaginile pentru rețele (cu GD; cu Imagick, și din SVG), imaginile urcate
│   │   ├── minify.php       micșorarea CSS, JS, HTML, SVG și XML
│   │   ├── anunta.php       mențiunile trimise și anunțul WebSub, la publicare
│   │   └── cont.php         contul de administrator, sesiunea, codurile CSRF
│   ├── panou/               paginile și acțiunile panoului
│   ├── stil/                sursele lui assets/: css/adwaita.css, js/ (app, vedere, setari, copiere, tur, arhiva,
│   │                        icons), logo/caiet.svg și app/ (logo-ul și iconița ca PNG, pentru imagini și fluxuri)
│   ├── fonturi/             Adwaita Sans în TTF, pentru imaginile pentru rețele
│   ├── server/              .htaccess, webmention.php, ceas.php și router.php (doar pentru testare)
│   └── continut/            ce scrii: articole/, pagini/, setari.json, aplicatii.json, redirectionari.json
├── data/imagini/            ilustrațiile și fotografiile urcate
├── LICENSE                  licența MIT
└── README.md

După instalare mai apar, făcute de platformă:

  • sertar/date/ (contul, sesiunile, coșul, mențiunile trimise) și sertar/cache/;
  • data/mentiuni/ (mențiunile primite) și, în data/imagini/, dosarele social/, flux/ și webp/;
  • site-ul generat: index.html, .htaccess, assets/, data/articole/, feed.xml și celelalte.

În browser, adresele sunt scurte: exemplu.ro/primul-articol (articol), /contact (pagină), /arhiva, /despre, /eticheta/linux, /pagina/2. Regulile din .htaccess le leagă de fișierele din data/; cine deschide direct un fișier (/data/articole/primul-articol.html) sau adaugă / la final ajunge la adresa scurtă.

Instalarea pe hosting

  1. În sertar/continut/setari.json, schimbă adresa în adresa site-ului, de exemplu https://exemplu.ro. Se poate schimba și din panou, mai târziu. Merge și într-un subdosar (https://exemplu.ro/blog): toate adresele se iau de aici.
  2. Urcă conținutul dosarului în public_html/ (sau în subdosar), cu FTP (de exemplu FileZilla) ori din managerul de fișiere al hostingului, inclusiv fișierele ascunse .htaccess. Nu urca dosarul .git și nici sertar/date/ dintr-o altă instalare (de exemplu, de pe calculatorul pe care ai testat): acolo sunt contul și sesiunile ei.
  3. Serverul trebuie să poată scrie în dosarul site-ului (permisiuni 755; unde nu merge, 775), ca să refacă paginile.
  4. Deschide https://exemplu.ro/admin/. Panoul cere cheia de instalare, scrisă de el în fișierul sertar/date/cheie-instalare.txt de pe server: deschide fișierul din managerul de fișiere, copiază cheia și fă-ți contul (parola are cel puțin 12 caractere). Așa, nimeni altcineva nu-și poate face cont între urcare și prima ta intrare. După ce contul e făcut, fișierul se șterge singur. Cu acces SSH, contul se poate face și din terminal: php sertar/cli.php cont nume.
  5. Apasă „Reconstruiește site-ul” în panou. Până la prima construire, site-ul nu are încă pagini (nici index.html, nici .htaccess-ul principal), deci vizitatorii nu văd nimic. După aceea, fiecare salvare din panou reface site-ul singură.
  6. În Setări, completează numele site-ului, autorul, e-mailul și restul (vezi mai jos).
  7. După ce certificatul SSL e activ, decomentează în sertar/server/.htaccess blocul care trece pe HTTPS și apasă iar „Reconstruiește site-ul”.

Actualizarea platformei

Urcă doar admin/, sertar/motor/, sertar/panou/, sertar/stil/, sertar/server/, sertar/fonturi/ și sertar/cli.php, apoi apasă „Reconstruiește site-ul”. Nu suprascrie sertar/continut/, sertar/date/ și data/: acolo sunt textele, contul și imaginile tale.

Setările

Din panou, la Setări (sau de mână, în sertar/continut/setari.json):

Setarea Ce face
titlu, motto numele site-ului și fraza de sub el
adresa adresa publică a site-ului, fără / la final
autor, porecla numele tău și porecla; apar pe prima pagină, pe /despre, în dialogul „Despre” și în fluxuri
email adresa pentru „Răspunde pe e-mail” și pentru contactul de pe /despre
mastodon, conturi contul tău din fediverse și celelalte conturi (cu iconițe și rel="me"), pe /despre
linkuri alte site-uri ale tale, pe /despre
despre câteva rânduri despre tine, pe /despre (dacă nu există pagina despre, vezi mai jos)
subsol textul subsolului, în Markdown
pe_pagina câte articole sunt pe o pagină
fus_orar pentru datele articolelor și pentru articolele programate
hub serverul WebSub anunțat la publicare (gol: niciunul)

În textul subsolului merg: {an} (anul de acum), {blog} (numele site-ului), {autor} (numele tău) și {zile:2026-01-01} (câte zile au trecut de la o dată, ținut la zi în browser). Semnul 🄯 (sau ©) apare ca semnul copyleft. Sub text apar mereu linkurile spre fluxuri. De exemplu:

🄯 {an} {blog}

[Despre](/despre) [Contact](/contact)

Linkurile din subsol trebuie să ducă spre pagini care există; o platformă nouă n-are nicio pagină, deci subsolul de început e doar 🄯 {an} {blog}.

Pagina Despre și meniul

/despre e făcută de platformă: numele tău, contactele, fluxurile, alte site-uri, paginile și câteva cifre despre blog. Textul de sus e setarea despre. Dacă vrei un text mai lung, cu titluri, imagini și linkuri, fă o pagină cu adresa despre: textul ei apare pe /despre în locul setării, deasupra contactelor.

Paginile bifate „în meniu” apar în meniul din bara de titlu și în lista de pe pagina Despre, în ordinea aleasă la fiecare pagină.

Panoul de administrare

La /admin/, ca o aplicație GNOME: bara de titlu cu secțiunile (jos, pe telefon), liste Adwaita, rânduri de introducere ca în Setări, notificări. Stilul (ca sistemul, luminos, întunecat) și culoarea de accent sunt cele alese pe site, din meniu și din Setări; butonul din bara de titlu schimbă stilul în amândouă.

  • Panou: o notă rapidă (titlu opțional, text, etichete; publică sau păstrează ca ciornă), cifrele blogului, ciornele, articolele programate și cele publicate de curând.
  • Articole și Pagini: liste cu căutare și filtre (publicate, ciorne, programate, coș). Ștergerea mută articolul în coș, de unde se poate pune înapoi.
  • Editorul: titlul, textul (Markdown; fișierele scrise în HTML rămân HTML), cu bară de formatare (titluri, liste, casete, cod, imagini, galerie, secțiuni pliabile, note de subsol, tabele) și previzualizare exact ca pe site, refăcută cât scrii. Imaginile se pot trage sau lipi direct în text. La Detalii: adresa, introducerea, data și ora (o dată din viitor programează articolul), etichetele, imaginea, descrierea ei, ilustrația abstractă și postarea din fediverse; la pagini, ordinea și dacă apar în meniu. Ctrl+S salvează; Ctrl+B, Ctrl+I, Ctrl+K: îngroșat, cursiv, link. Ce scrii se păstrează și în browser, iar dacă schimbi adresa unui articol publicat, adresa veche duce la cea nouă (sertar/continut/redirectionari.json).
  • Imagini: urcare (și prin tragere), cu verificarea tipului după conținut, nume curate, micșorare la 2400 px și ștergerea datelor ascunse (locația, aparatul). Fiecare imagine arată de câte ori e folosită.
  • Aplicații: un catalog ca GNOME Software: aplicația recomandată, categoriile (nume, culoare, iconiță) și aplicațiile din ele (nume, ID de pe Flathub, rezumat, culoare, articolul despre ea). Catalogul apare pe o pagină cu adresa aplicatii, dacă o creezi; fără ea, nu apare nicăieri.
  • Setări: tot ce e în tabelul de mai sus, parola, o copie de siguranță și reconstruirea site-ului; de aici se ajunge și la mențiunile primite, care se pot șterge.

Siguranța: un singur cont, cu parola păstrată doar ca amprentă; după 5 încercări greșite intrarea se blochează 15 minute; sesiunea merge doar prin cookie HttpOnly și SameSite=Strict (și Secure pe https) și expiră după 8 ore fără activitate; fiecare formular are cod CSRF; panoul nu se poate încadra în alt site și nu e indexat. Dacă o salvare strică construirea (de exemplu, două articole cu aceeași adresă), schimbarea se anulează și site-ul rămâne cum era.

Copia de siguranță

Butonul din Setări descarcă o arhivă ZIP cu sertar/continut/ (articolele, paginile, setările, catalogul de aplicații, redirecționările), data/imagini/ (imaginile urcate, fără variantele generate) și data/mentiuni/. Contul și parola nu sunt în ea.

Panoul nu poate pune arhiva înapoi. Ca să refaci site-ul din ea, dezarhiveaz-o peste dosarul site-ului (se potrivește cu sertar/continut/ și data/), din managerul de fișiere al hostingului sau cu FTP, apoi apasă „Reconstruiește site-ul”. Pe o instalare nouă, fă întâi contul (pașii 4 și 5 de la instalare).

Articolele programate

Site-ul e static, deci nimic nu rulează singur pe server. Când există un articol programat, paginile cer din când în când ceas.php (cel mult o dată la jumătate de oră de la fiecare cititor), iar el publică articolul dacă i-a sosit ora. Dacă nu te bazezi pe vizite, pune un cron. În cPanel, la Cron Jobs, la fiecare 10 minute (*/10 * * * *):

php /home/UTILIZATOR/public_html/sertar/cli.php ceas

(cu calea dosarului tău; managerul de fișiere o arată sus).

Mențiunile și fluxurile

Când un articol devine public din panou (sau din ceas), motorul trimite singur mențiuni (webmention) site-urilor spre care are linkuri și anunță hubul WebSub, după ce răspunsul a plecat spre browser. Pleacă doar pentru articolele datate în ultimele 3 zile, deci articolele vechi, aduse de pe alt blog, nu trimit nimic. Construirea din terminal (php sertar/cli.php construieste) și serverul de test de pe calculator nu anunță nimic. Ce s-a trimis se ține minte în sertar/date/mentiuni-trimise.json, ca o mențiune să plece o singură dată.

Fluxurile RSS, Atom și JSON Feed (feed.xml, atom.xml, feed.json) au cele mai noi 30 de articole, complete și pregătite pentru cititoare: casetele devin citate, secțiunile pliabile se deschid, videoclipurile devin linkuri, imaginile sunt WebP.

Articolele, de mână

Antetul unui articol (sertar/continut/articole/titlul-meu.md), dacă îl scrii direct, nu din panou:

---
title: Titlul meu
date: 2026-10-25 09:30
tags: GNOME, Ghid
lead: O frază de introducere.
alt: Descrierea imaginii, pentru cititoarele de ecran.
art: teal
mastodon: https://mastodon.social/@nume/1234567890
draft: true
---
Textul articolului, cu **îngroșat**, *cursiv* și [linkuri](https://www.gnome.org/).

Numele fișierului e adresa articolului. Doar date e obligatoriu.

title se poate lăsa deoparte: articolul devine o notă. Pe pagina ei nu are titlu deasupra (nici ilustrația abstractă, dacă n-are imagine), iar în liste, în fila browserului și în fluxuri apare începutul textului. Din panou, adresa unei note se face din text.

O pagină (sertar/continut/pagini/contact.md) are nevoie de title; în loc de dată are order (locul în meniu) și, dacă nu vrei s-o treci în meniu, menu: false. Merg și fișiere .html, cu antetul ca un comentariu JSON (<!-- {"title": "…", "date": "…"} -->).

Imaginea articolului se ia automat din data/imagini/titlul-meu.svg (sau .webp, .jpg, .png). Fără ea, art: alege o ilustrație abstractă: gol (albastru-violet), teal, sunset, slate, green, pink, gold. Casetele, tabelele, galeriile, notele de subsol și celelalte elemente se scriu din bara de formatare a editorului. Orice element cu data-copy="text" copiază textul acela la clic.

Comentarii: fediverse, mențiuni și e-mail

  • Fediverse. Adresa postării de pe Mastodon (sau Pleroma, Akkoma, GoToSocial), din editor sau din antetul articolului (mastodon:). Sub articol apar răspunsurile (încărcate doar când vizitatorul apasă „Încarcă”), aprecierile și distribuirile, plus linkul „și în fediverse” sub titlu.
  • Mențiuni (webmention). webmention.php primește mențiunile, verifică pagina care trimite (să aibă link spre articol, urmând redirecționările și refuzând adresele din rețeaua locală) și le păstrează în data/mentiuni/. Bridgy (https://brid.gy) poate trimite automat aprecierile și răspunsurile de pe Mastodon ca mențiuni.
  • E-mail. „Răspunde pe e-mail” deschide un mesaj spre adresa din Setări, cu titlul articolului.

IndieWeb și motoare de căutare

  • Microformate: articolele sunt h-entry, listele h-feed, prima pagină are h-card-ul autorului, iar pagina Despre h-card-ul complet. rel="me" leagă site-ul de e-mail și de conturile din Setări.
  • Fiecare pagină are adresă canonică și etichete Open Graph; sitemap.xml și robots.txt folosesc adresa site-ului.

Ca aplicațiile GNOME

  • Căutarea (/, s, Ctrl+F sau lupa) se deschide peste pagină, ca vederea de ansamblu din GNOME Shell: articole recente și etichete, apoi rezultate grupate pe articole, pagini și etichete, fără să conteze diacriticele.
  • Grila de aplicații (a): secțiunile blogului, paginile, fluxurile, Setările și turul, ca iconițe.
  • Arhiva e ca în Fișiere: bara de cale, dosare pe ani și luni, grilă sau listă, sortare; plus vederea Calendar (/arhiva#calendar) și etichetele ca inel, ca în Disk Usage Analyzer.
  • Setări (Ctrl+,): stilul, culoarea de accent, mărimea textului, lățimea coloanei și animațiile.
  • Blocurile de cod au buton Copiază.
  • Tipărește sau salvează PDF (din meniu sau Ctrl+P): doar articolul, fără bare și butoane, cu adresele linkurilor.
  • Turul apare o singură dată, la prima vizită, și se redeschide din meniu sau din grila de aplicații.
  • Dialogul Despre (din meniu) arată numele site-ului și autorul din Setări.

Tastatură

Tasta ? arată toate scurtăturile. Pe scurt, în stilul vim: j/k derulează (pe liste aleg articolul, iar o sau Enter îl deschide), d/u jumătate de pagină, gg/G început și final, h/l (sau [/], p/n) articolul anterior și următor, H/L înapoi și înainte în istoric, / sau s caută, a grila de aplicații, Ctrl+, Setările, g h/g a/g d duc la Articole, Arhivă și Despre, t schimbă stilul, c sau yy copiază linkul, m deschide meniul.

Securitate

  • Dosarul privat sertar/ (motorul, textele, contul) e blocat din web de .htaccess și de sertar/.htaccess.
  • .htaccess blochează și mențiunile primite, fișierele ascunse și orice fișier sensibil ajuns din greșeală pe server (.py, .md, .json în afară de fluxuri și căutare, jurnale, copii de siguranță, arhive).
  • Fiecare pagină are o politică de securitate a conținutului (CSP): rulează doar scripturile site-ului, iar textul venit din fediverse e curățat înainte de afișare. webmention.php și panoul nu afișează erorile PHP.

Pe calculator, pentru testare

php sertar/cli.php construieste
php -d opcache.revalidate_freq=0 -S localhost:8765 sertar/server/router.php

Apoi deschide http://localhost:8765/ și http://localhost:8765/admin/. Contul se face ca pe hosting, cu cheia din sertar/date/cheie-instalare.txt, sau din terminal: php sertar/cli.php cont nume.

Dacă extensia GD nu e activă în php.ini, adaugă -d extension=gd la ambele comenzi. opcache.revalidate_freq=0 face ca serverul de test să vadă imediat fișierele PHP schimbate. Serverul PHP de test nu citește .htaccess, așa că sertar/server/router.php face aceleași legături și blochează dosarul privat. De pe el nu pleacă mențiuni.

Licența

Codul platformei e sub licența MIT (vezi LICENSE), © 2026 ThinkRoot. Fontul Adwaita Sans își păstrează licența lui, SIL Open Font License 1.1 (sertar/fonturi/OFL-adwaita-sans.txt).