Platformă de blog care arată ca un carnet cu copertă tare; generează un site static din PHP.
  • PHP 60.9%
  • CSS 19.7%
  • JavaScript 19.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
ThinkRoot 106333ea72 Initial import of fila
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 fila 2026-11-06 16:46:52 +02:00
carnet Initial import of fila 2026-11-06 16:46:52 +02:00
.gitignore Initial import of fila 2026-11-06 16:46:52 +02:00
LICENSE Initial import of fila 2026-11-06 16:46:52 +02:00
README.md Initial import of fila 2026-11-06 16:46:52 +02:00

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_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/).

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) și carnet/cache/;
  • data/mentiuni/ (mențiunile primite) și, în data/imagini/, dosarele social/ și webp/;
  • 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

  1. În carnet/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 carnet/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 carnet/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 carnet/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 carnet/server/.htaccess blocul 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+S salvează; 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.js aliniază 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, / sau Ctrl+K caută, r o filă la întâmplare, m sau Ctrl+, setările, t zi/noapte, c sau yy copiază 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.js pă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/).