- PHP 60.9%
- CSS 19.7%
- JavaScript 19.4%
| 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 | ||
| carnet | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
Filă, un blog ca un carnet
O platformă de blog care arată ca un carnet cu copertă tare: hârtie dictando cu marginea roșie, separatoare colorate pe margine (navigarea), o panglică de semn de carte care coboară pe măsură ce citești, file numerotate și datate ca într-un jurnal, poze lipite cu bandă adezivă, post-it-uri, ștampile în loc de etichete și un cuprins cu puncte de ghidaj. Pe prima pagină e eticheta „În caz de pierdere”, ca la carnetele Moleskine.
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. Pentru cititori nu rulează nimic în plus.
Ce îți trebuie
-
PHP 8.1 sau mai nou, cu permisiunea de a scrie în dosarul site-ului.
-
Extensiile PHP:
mbstring, obligatorie;gd, pentru pozele WebP și imaginile pentru rețele (fără ea, site-ul merge, dar fără ele);curl, pentru mențiunile trimise și anunțul WebSub;dom, pentru mențiunile primite;fileinfo, pentru verificarea pozelor 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/).
fila/
├── admin/ panoul de administrare: intrarea (index.php), stilul și scriptul lui
├── carnet/ dosarul privat, blocat din web (și prin carnet/.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 (datele ca în jurnal)
│ │ ├── continut.php citirea filelor și a paginilor (ciorne, file programate)
│ │ ├── sabloane.php șabloanele paginilor
│ │ ├── markdown.php convertorul Markdown
│ │ ├── cod.php culorile codului (bash, python, console, diff, ini)
│ │ ├── fluxuri.php RSS, Atom, JSON Feed, harta site-ului, indexul căutării
│ │ ├── imagini.php WebP și imaginile pentru rețele (cu extensia GD), pozele 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/, js/, fonts/, logo/, app/ (iconițele de telefon)
│ ├── fonturi/ Caveat și Literata în TTF, pentru imaginile pentru rețele
│ ├── server/ .htaccess, webmention.php, ceas.php, sw.js și router.php (doar pentru testare)
│ └── continut/ ce scrii: articole/, pagini/, setari.json, redirectionari.json
├── data/imagini/ pozele urcate
├── LICENSE licența MIT
└── README.md
După instalare mai apar, făcute de platformă:
carnet/date/(contul, sesiunile, coșul, mențiunile trimise) șicarnet/cache/;data/mentiuni/(mențiunile primite) și, îndata/imagini/, dosarelesocial/șiwebp/;- site-ul generat:
index.html,.htaccess,assets/,data/articole/,feed.xmlși celelalte.
În browser, adresele sunt scurte: exemplu.ro/prima-mea-fila (filă), /contact (pagină), /arhiva (cuprinsul),
/despre, /eticheta/linux, /pagina/2. Regulile din .htaccess le leagă de fișierele din data/.
Instalarea pe hosting
- În
carnet/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 urcacarnet/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șierulcarnet/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 carnet/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
carnet/server/.htaccessblocul care trece pe HTTPS și apasă iar „Reconstruiește site-ul”.
Actualizarea platformei
Urcă doar admin/, carnet/motor/, carnet/panou/, carnet/stil/, carnet/server/, carnet/fonturi/ și
carnet/cli.php, apoi apasă „Reconstruiește site-ul”. Nu suprascrie carnet/continut/, carnet/date/ și data/:
acolo sunt textele, contul și pozele tale.
Setările
Din panou, la Setări (sau de mână, în carnet/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 /despre, pe eticheta de pe prima pagină și în fluxuri |
email |
apare pe eticheta „În caz de pierdere” și pe /despre |
recompensa |
ce scrie la „Recompensă” pe etichetă (de exemplu „o cafea”) |
mastodon, conturi |
contul tău din fediverse și celelalte conturi, cu 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 file sunt pe o pagină a carnetului |
fus_orar |
pentru datele filelor și pentru filele 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
/despre e făcută de platformă: numele tău, contactele, fluxurile, alte site-uri, lista paginilor și câteva cifre
despre carnet. Textul de sus e setarea despre. Dacă vrei un text mai lung, cu titluri, poze și linkuri, fă o
pagină cu adresa despre: textul ei apare pe /despre în locul setării, deasupra contactelor.
Paginile bifate cu „Apare în lista de pe pagina Despre” sunt trecute acolo, în ordinea aleasă la fiecare pagină.
Panoul de administrare
La /admin/. Merge și pe telefon, cu butoane mari și separatoare care se derulează.
Butonul de lumină din bara de sus (◐ ca sistemul, ☀ zi, ☾ noapte) folosește aceeași alegere ca butonul de lumină de pe site: ce alegi într-o parte se vede și în cealaltă.
- Panou: o notă rapidă (titlu opțional, text, etichete; publică sau păstrează ca ciornă), câte file, ciorne, programate, pagini, poze și mențiuni sunt, plus ciornele, filele programate și cele publicate de curând.
- File și Pagini: liste cu căutare și filtre (publicate, ciorne, programate, coș). Ștergerea mută fila în coș, de unde se poate pune înapoi.
- Editorul: titlul, textul în Markdown, cu bară de formatare (îngroșat, marker, titluri, liste, post-it-uri, cod,
poze, galerie, notă pe margine, cerc, notă de subsol, tabel) și previzualizare pe hârtia filei, refăcută cât
scrii (alături, pe ecranele mari, sau pe rând, pe telefon). Pozele se pot trage sau lipi direct în text. La
Detalii: adresa, introducerea, data și ora (o dată din viitor programează fila), etichetele, poza filei,
descrierea ei și postarea din fediverse; la pagini, ordinea și dacă apar pe pagina Despre. Starea: publicată sau
ciornă.
Ctrl+Ssalvează;Ctrl+B,Ctrl+I,Ctrl+K: îngroșat, cursiv, link. Ce scrii se păstrează și în browser: dacă pagina se închide fără salvare, textul se poate pune înapoi. Dacă schimbi adresa unei file publicate, adresa veche duce la cea nouă (carnet/continut/redirectionari.json). - Poze: 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 poză arată de câte ori e folosită.
- Mențiuni: mențiunile primite de la alte site-uri; cele nepotrivite se șterg.
- Setări: tot ce e în tabelul de mai sus, parola și o copie de siguranță.
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ă file 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 carnet/continut/ (filele, paginile, setările, redirecționările),
data/imagini/ (pozele 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 carnet/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).
Filele programate
Site-ul e static, deci nimic nu rulează singur pe server. Când există o filă 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ă fila 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/carnet/cli.php ceas
(cu calea dosarului tău; managerul de fișiere o arată sus).
Mențiunile și fluxurile
Când o filă 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 filele datate
în ultimele 3 zile, deci filele vechi, aduse de pe alt blog, nu trimit nimic. Construirea din terminal
(php carnet/cli.php construieste) și serverul de test de pe calculator nu anunță nimic. Ce s-a trimis se ține minte
în carnet/date/mentiuni-trimise.json, ca o mențiune să plece o singură dată. webmention.php primește mențiunile
de la alții; apar în panou, la Mențiuni.
Fluxurile (feed.xml, atom.xml, feed.json) au cele mai noi 30 de file, cu textul complet.
Elementele dintr-o filă
Antetul unei file (carnet/continut/articole/titlul-meu.md), dacă o scrii de mână și nu din panou:
---
title: Titlul meu
date: 2026-10-27 09:30
tags: Linux, Jurnal
lead: O frază de introducere.
alt: Descrierea pozei filei, pentru cititoarele de ecran.
image: /data/imagini/poza.jpg
mastodon: https://mastodon.social/@nume/123
draft: true
---
Textul filei, cu **îngroșat**, *cursiv*, ==marcat== și [linkuri](https://exemplu.ro).
Numele fișierului e adresa filei. Doar date e obligatoriu.
title se poate lăsa deoparte: fila devine o notă. Pe pagina ei nu are titlu deasupra, pe prima pagină apare textul
ei, iar în liste, în fila browserului și în fluxuri apare începutul textului. Din panou, adresa unei note se face
din text.
O pagină (carnet/continut/pagini/contact.md) are nevoie de title; în loc de dată are order (locul în lista de
pe pagina Despre) și, dacă nu vrei s-o treci acolo, menu: false. Merg și fișiere .html, cu antetul ca un
comentariu JSON (<!-- {"title": "…", "date": "…"} -->).
Pe lângă Markdown-ul obișnuit: cod cu numele fișierului (```bash title="a.sh"), culori și eticheta limbajului,
sesiuni de terminal (```console), diferențe (```diff), galerii de poze, liste de definiții, cronologii,
citate cu autor, note pe margine, cuvinte încercuite, bare de progres hașurate, tabele cu titlu și total, butoane,
fișe de index și hărți sau videoclipuri care se încarcă doar la cerere. Butoanele din bara editorului le scriu
pe toate. Numărul filei („fila 6”) se dă singur, după dată: prima filă scrisă e fila 1.
Pentru cititori
- Efecte: fila se întoarce la trecerea de la o pagină la alta (Chrome și Edge), titlul se scrie, markerul se trage peste text și cercul se desenează când ajungi la ele, pozele și post-it-urile se îndreaptă sub mouse, panglica coboară cu cititul, iar pozele se măresc (săgeți sau glisare pentru următoarea, clic pentru mărire). Cu mișcarea redusă setată în sistem, totul apare direct.
- Rândurile hârtiei: toate înălțimile sunt multipli de un rând (
--randîn CSS), iar scrisul de mână e mutat ca linia lui de bază să cadă pe linia hârtiei;app.jsaliniază pozele, codul și post-it-urile la rândul următor. - Setări (creionul din colț): hârtia, scrisul, coperta, lumina și mărimea textului, păstrate în browser.
- Tastatura (tasta
?arată lista):j/k,d/u,gg/G,h/l(fila următoare și anterioară),H/L,g h/g c/g d,/sauCtrl+Kcaută,ro filă la întâmplare,msauCtrl+,setările,tzi/noapte,csauyycopiază linkul,Escînchide; în vizualizatorul de poze, săgețile,z,q. - Pe orice ecran, de la telefoanele de 320 px la monitoarele 4K, cu zonele sigure ale telefoanelor.
- Fără internet:
sw.jspăstrează filele citite;manifest.webmanifestși iconițele permit „Adaugă pe ecranul principal” pe telefon (doar pe https). - Fluxuri RSS, Atom și JSON; microformate (h-entry, h-card) pentru IndieWeb; răspunsurile din fediverse sub file, încărcate doar la cerere.
Pe calculator, pentru testare
php carnet/cli.php construieste
php -d opcache.revalidate_freq=0 -S localhost:8770 carnet/server/router.php
Apoi deschide http://localhost:8770/ și http://localhost:8770/admin/. Contul se face ca pe hosting, cu cheia din
carnet/date/cheie-instalare.txt, sau din terminal: php carnet/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ă
carnet/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. Fonturile Caveat, Literata și Courier Prime
își păstrează licența lor, SIL Open Font License 1.1 (fișierele OFL-*.txt din carnet/stil/fonts/ și
carnet/fonturi/).