- PHP 57.7%
- JavaScript 24%
- CSS 18.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Public copy of the project, without personal or sensitive data. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
| admin | ||
| sertar | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
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);imagickcu 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_rewritesau 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) șisertar/cache/;data/mentiuni/(mențiunile primite) și, îndata/imagini/, dosarelesocial/,flux/șiwebp/;- 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
- În
sertar/continut/setari.json, schimbăadresaîn adresa site-ului, de exempluhttps://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. - 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 nicisertar/date/dintr-o altă instalare (de exemplu, de pe calculatorul pe care ai testat): acolo sunt contul și sesiunile ei. - Serverul trebuie să poată scrie în dosarul site-ului (permisiuni 755; unde nu merge, 775), ca să refacă paginile.
- Deschide
https://exemplu.ro/admin/. Panoul cere cheia de instalare, scrisă de el în fișierulsertar/date/cheie-instalare.txtde 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. - 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ă. - În Setări, completează numele site-ului, autorul, e-mailul și restul (vezi mai jos).
- După ce certificatul SSL e activ, decomentează în
sertar/server/.htaccessblocul 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+Ssalvează;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.phpprimeș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ă îndata/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, listeleh-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șirobots.txtfolosesc adresa site-ului.
Ca aplicațiile GNOME
- Căutarea (
/,s,Ctrl+Fsau 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 desertar/.htaccess. .htaccessblochează ș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).