Zero Procese Server • Pipeline 100% în Browser • Pachet Autonom 4 MB

100% Static, Fișier Unic Motor de Wiki & Documentație

Plasați un singur fișier autonom index.html lângă documentele voastre Markdown. Fără procese de compilare Node.js, fără baze de date și fără comenzi de reconstrucție. Compilare instantanee pe client cu Marked v15, DOMPurify, KaTeX, Prism, Mermaid și comutare dinamică a temelor pe GPU.

Începeți în 5 Minute Arhitectura Sistemului

$ curl -fsSL https://github.com/Octadira/vertiwiki/releases/latest/download/vertiwiki.html -o index.html

Centrul de Documentație

Acces Direct la Ghidurile Tehnice

Explorați tutoriale practice, diagrame arhitecturale, runbook-uri operaționale și cataloage API detaliate.

🚀

Primii Pași

Ghid practic de 5 minute cu exemple de cod executabile, configurări rapide și structuri minime.

🏛️

Arhitectura Sistemului

Explorați fluxul de execuție pe client, mașinile de stare și topologia de containere C4.

⚙️

Ghid de Configurare

Descoperiți toți parametrii din schemă, modurile de afișare, limbile suportate și setările de brand.

🛠️

Operațiuni & Runbooks

Proceduri de găzduire pe Cloudflare Pages, AWS CloudFront, Vercel și depanare în producție.

📖

Catalog API TypeScript

Semnături TypeScript exacte, tabele detaliate de parametri, hook-uri de plugin și interfețe.

🔄

Fluxuri de Execuție

Fluxul complet cerere-răspuns, rutare reactivă, dezinfectare DOM și diagrame secvențiale.

Arhitectură Tehnică

Construit pentru Durabilitate & Viteză

Șase atribute arhitecturale fundamentale care elimină complexitatea de backend și garantează fiabilitatea pe termen lung.

01 / RUNTIME PE CLIENT

Zero Backend & Zero Pași de Build

Fără procese Node.js pe server și fără comenzi de reconstrucție la editarea Markdown-ului. Plasați index.html în orice folder și publicați static.

DOMPurify • Marked v15 • Router SPA

02 / BUNDLE FIȘIER UNIC

Distribuție Autonomă într-un Singur Fișier

Compilat prin Vite 6 cu vite-plugin-singlefile. Marked v15, DOMPurify, KaTeX, Prism și Mermaid sunt integrate într-un pachet compact de 4 MB.

Zero Module Node • Portabil Offline

03 / SECURITATE STRICTĂ

Graniță de Încredere în Profunzime

Izolarea automată a iframe-urilor impune allow-presentation și blochează tentativele de spargere a frame-ului. Schemele periculoase sunt eliminate din toate legăturile.

DOMPurify Strict • Invariant Zero-XSS

04 / AEO & DESCOPERIRE AGENȚI

Arbore Semantic de Crawl & AEO

Arborele de crawl integrat permite descoperirea instantanee de către Googlebot fără SSR, combinat cu microdate dinamice Schema.org TechArticle și llms.txt.

AgentDocsSpec • llms.txt • JSON-LD

05 / MOTOR DE TEME PE GPU

Teme Decuplate & 11 Preseturi

Comută variabilele CSS pe document.documentElement în sub 1ms, fără reîncărcarea paginii. Suportă teme JSON externe prin folderul themes/.

11 Preseturi • Obsidian • Editorial • Nord

06 / CĂUTARE ÎN MEMORIE

Căutare Instantanee pe Client (ƒK)

Căutare ultrarapidă în memoria clientului prin MiniSearch. Include căutare fuzzy, tokenizare automată, scurtături de tastatură (ƒK sau /) și filtrare pe limbi.

MiniSearch • Sub-milisecundă • Zero Latență

Arhitectura Ciclului de Viață

Fluxul Determinist de Randare în 10 Etape

Cum transformă VertiWiki conținutul Markdown brut într-o interfață de documentație complet interactivă și dezinfectată în milisecunde.

Parsare Hash Rută & Parametri Query

Rezolvă #/cale.md sau parametrul ?page= pentru rescrieri de conținut negociat pe server.

Descărcare Asincronă a Resurselor

Descarcă fișierul Markdown prin fetch() cu rezoluție deterministă în subdirectoare și rezervă 404.

Parsare Frontmatter YAML

Extrage metadatele din antet, autorul documentului, etichetele personalizate și configurările de temă/layout.

Hook-uri de Ciclu de Viață beforeParse

Procesează macro-uri personalizate, inclusiv tab-uri de cod (::: tabs), detalii expandabile și insigne.

Compilare Marked v15 & Dezinfectare DOMPurify

Compilează CommonMark + GFM și impune dezinfectarea strictă Zero-XSS cu sandboxing pentru elementele iframe.

Hook-uri de Ciclu de Viață afterParse

Permite extensiilor de plugin să inspecteze sau să modifice codul HTML sigur înainte de montarea în DOM.

Montare în DOM & Rezolvare de Legături

Montează HTML-ul în #verti-app și transformă legăturile relative (../ghid.md → #/ghiduri/ghid.md).

Plugin-uri afterRender

Inițializează evidențierea de sintaxă Prism, formulele matematice KaTeX, diagramele Mermaid și zoom-ul pe imagini.

Cuprins (TOC) & Scrollspy

Construiește arborele de titluri și activează IntersectionObserver pentru urmărirea secțiunii curente.

Indexare Căutare & Microdate AEO

Indexează termenii în MiniSearch și actualizează microdatele Schema.org TechArticle JSON-LD.

Comparație Tehnică

De ce Aleg Dezvoltatorii VertiWiki

Vedeți cum se compară VertiWiki cu generatoarele clasice de site-uri statice și wiki-urile vechi.

Caracteristică Arhitecturală	Standardul VertiWiki	SSG Tradiționale (Docusaurus, VitePress)	Wiki-uri Clasice (DokuWiki, MediaWiki)
Model de Găzduire	100% Static (Server HTTP, CDN, S3, Git Pages)	Artefact de build static (Necesită CI/CD)	Server PHP / Node / Bază de date
Actualizare Conținut	0s (Reîncărcare imediată la editarea .md)	30s - 3min (Recompilare CI/CD & deploy)	Scriere directă în bază sau lock pe fișier
Motor de Căutare	MiniSearch pe client (Latență zero)	Algolia DocSearch sau JSON greoi	Căutare SQL pe server
Diagrame & Formule	Mermaid & KaTeX native pe client	Plugin-uri și transformări la build	Extensii de server (Mathoid, Graphviz)
Suprafață de Atac	Izolare strictă DOMPurify, zero vectori backend	Risc pe lanțul de pachete npm la build	Injecții SQL, vulnerabilități PHP
Optimizare AI Autonomă	Nativ llms.txt + Schema.org JSON-LD	Necesită integrare manuală	Inexistentă

Primii Pași

Pregătit în 3 Pași Simpli

Fără procese complicate de compilare Node.js și fără baze de date.

PASUL 01

Scrieți Conținutul în Markdown

Creați fișierul index.md, subdirectoarele (ex. concepts/) și meniul în navigation.md.

mkdir -p my-wiki && touch index.md navigation.md

PASUL 02

Descărcați Motorul

Descărcați bundle-ul autonom precompilat direct din GitHub Releases în rădăcina proiectului.

curl -fsSL https://github.com/Octadira/vertiwiki/releases/latest/download/vertiwiki.html -o index.html

PASUL 03

Publicați & Găzduiți Oriunde

Publicați pe GitHub Pages, Cloudflare Pages, S3 sau rulați local cu orice server HTTP static.

npx serve . # sau python3 -m http.server

Întrebări Frecvente

Clarificări Tehnice

Răspunsuri la principalele întrebări tehnice despre arhitectură, rutare, securitate și performanță.

Cum funcționează VertiWiki fără compilare pe server? +

VertiWiki rulează 100% în browserul clientului. Când o rută este accesată, fișierul Markdown brut este descărcat prin fetch(), i se extrage frontmatter-ul YAML, se execută hook-urile din pipeline, se compilează prin Marked v15, se sanitizează prin DOMPurify și se montează în DOM în mai puțin de 2 milisecunde.

Cum funcționează rezoluția linkurilor relative în subfoldere? +

VertiWiki include un modul automat de transformare (router.transformLinks()) care calculează căile relative de navigare în raport cu folderul documentului curent, garantând că linkurile Markdown și imaginile se deschid corect indiferent de adâncimea structurii.

Cum ajută optimizarea AEO agenții și motoarele AI? +

La fiecare schimbare de pagină, VertiWiki generează automat microdate Schema.org TechArticle și BreadcrumbList în format JSON-LD, pune la dispoziție indexul structurat llms.txt conform AgentDocsSpec și oferă un buton dedicat de copiere cu metadate pentru asistenții AI.

Poate rula VertiWiki complet offline sau pe rețele izolate? +

Da. Toate stilurile, fonturile WOFF2, formulele KaTeX și librăriile Mermaid sunt incluse direct în fișierul index.html. Cu un server static local (ex. python3 -m http.server), funcționează 100% offline fără conexiune la internet.

Cum pot crea și încărca teme personalizate? +

Creați fișiere JSON în directorul themes/ definind variabilele CSS pentru modurile deschis și închis. Înregistrați-le în config.json sub "customThemes" și devin selectabile instantaneu fără compilare de cod.

Cum indexează motoarele de căutare paginile fără randare pe server (SSR)? +

VertiWiki integrează un Arbore Semantic de Crawl direct în shell-ul HTML inițial. Roboții de căutare precum Googlebot descoperă legături clasice ancoră către fiecare document încă de la prima cerere HTTP.

Pregătit să Experimentați Documentația Zero-Backend?

Explorați portalul de documentație VertiWiki direct în browser sau inspectați codul sursă pe GitHub.

Deschideți Documentația Repository GitHub