Struktur Proyek

Peta berkas tema GitDocs dan tanggung jawab tiap bagian.

Di halaman ini

Tema disusun agar lapisan data (tipe konten, REST, renderer) terpisah rapi dari lapisan tampilan, sehingga mudah dirawat maupun dipindahkan ke plugin bila kelak diperlukan.

Teks

aithordev-wiki/
├── style.css                 Header tema
├── functions.php             Bootstrap: konstanta, autoloader, boot
├── inc/
│   ├── class-theme.php       Orkestrator (memuat semua modul)
│   ├── class-post-types.php  CPT doc_page, taksonomi doc_space, meta
│   ├── class-router.php      Aturan URL /docs/{space}/{path}/
│   ├── class-tree.php        Pohon navigasi + cache
│   ├── class-content.php     Pipeline render & ekstraksi TOC
│   ├── class-pages.php       Layanan simpan/terbitkan/pindah/hapus
│   ├── class-search-index.php  Pembuat indeks JSON
│   ├── class-rest-api.php    Endpoint gitdocs/v1
│   ├── class-assets.php      Enqueue CSS/JS + konfigurasi front-end
│   ├── class-cleanup.php     Mematikan fitur blog WordPress
│   ├── class-admin.php       Menu, kolom, alat, dasbor
│   ├── class-editor-app.php  Bootstrap editor React
│   ├── class-preview.php     Mode pratinjau langsung
│   ├── class-seeder.php      Konten contoh
│   ├── markdown/             Parser Markdown + komponen
│   └── vendor/parsedown/     Parsedown (MIT)
├── template-parts/           Bagian tampilan (sidebar, TOC, kartu, …)
├── assets/
│   ├── css/  tokens · app · content · editor · admin · login
│   ├── js/   app · search · preview · editor/*
│   ├── fonts/  Google Sans Flex & Code (OFL)
│   ├── icons/  subset Lucide (ISC)
│   └── vendor/ Prism, Fuse.js, htm
├── seed/                     Konten contoh (berkas .md ini)
└── languages/                gitdocs.pot

Alur sebuah halaman

Menulis

Anda mengetik Markdown di editor. Setiap ketikan memicu pratinjau yang dirender oleh server, bukan oleh JavaScript, sehingga hasilnya identik dengan halaman terbit.
Menyimpan

Markdown disimpan pada meta gitdocs_markdown (ikut tercatat di revisi WordPress). Hasil render HTML disimpan di post_content dan disanitasi oleh kses seperti konten WordPress lainnya.
Menyajikan

Pengunjung menerima HTML yang sudah jadi — tidak ada proses Markdown saat halaman dibuka. Daftar isi dan potongan pencarian sudah tersimpan sebagai meta.

Diagram alur konten GitDocs — Markdown ditulis sekali, dirender di server, lalu disajikan secepat HTML statis

Tempat penyimpanan data

Data	Lokasi
Sumber Markdown	Meta `gitdocs_markdown` (berevisi)
HTML tampil	`post_content`
Daftar isi	Meta `_gitdocs_toc`
Potongan pencarian	Meta `_gitdocs_search`
Perubahan belum terbit	Meta `_gitdocs_draft`
Ikon, sampul, opsi halaman	Meta `gitdocs_*`
Space	Taksonomi `doc_space`
Indeks pencarian	`uploads/gitdocs/search-index.json`

Karena post_content berisi HTML biasa, konten Anda tetap terbaca bila suatu saat berpindah tema — tidak ada lock-in pada format khusus.

Alur sebuah halaman

Menulis

Menyimpan

Menyajikan

Tempat penyimpanan data