Tahap 6: Formatting dan Export
Sesi 8.7 · ~5 menit baca
Formatting Itu Use Case Terbaik Automasi
Kamu punya konten yang sudah di-approve. Lolos review. Lolos editing. Sekarang konten itu harus ada di setiap format yang dibutuhkan channel distribusi kamu. HTML untuk website. PDF untuk download. EPUB untuk e-reader. WordPress XML untuk import. Markdown untuk arsip.
Ini pekerjaan mekanis. Ga butuh kreativitas, ga butuh penilaian, ga butuh taste. Butuh konversi yang tepat dan bisa diulang dari satu format ke format lain. Itu menjadikannya pekerjaan sempurna untuk automasi.
Prinsip Single-Source
Aturan utama formatting: satu file sumber menghasilkan semua format output. Kamu ga memelihara versi terpisah untuk web, print, dan email. Kamu memelihara satu versi kanonik (biasanya Markdown atau HTML bersih) dan mengkonversinya secara otomatis.
(Markdown)"] --> B["HTML"] A --> C["PDF"] A --> D["EPUB"] A --> E["WordPress XML"] A --> F["Email HTML"] A --> G["Plain Text"] style A fill:#222221,stroke:#c8a882,color:#ede9e3 style B fill:#222221,stroke:#6b8f71,color:#ede9e3 style C fill:#222221,stroke:#8a8478,color:#ede9e3 style D fill:#222221,stroke:#c47a5a,color:#ede9e3 style E fill:#222221,stroke:#c8a882,color:#ede9e3 style F fill:#222221,stroke:#6b8f71,color:#ede9e3 style G fill:#222221,stroke:#8a8478,color:#ede9e3
Kalau kamu edit versi PDF terpisah dari versi HTML, keduanya akan berbeda. Dalam tiga kali edit, kamu punya dua konten berbeda yang seharusnya identik. Begitulah error berkembang biak. Satu sumber, banyak output. Selalu.
Pandoc: Konverter Universal
Pandoc itu konverter dokumen gratis dan open-source yang menangani lebih dari 40 format. Dia mengkonversi Markdown ke HTML, HTML ke PDF (via LaTeX), Markdown ke EPUB, Markdown ke DOCX, dan hampir setiap kombinasi lainnya. Dia jalan dari command line, yang artinya bisa di-script dan diotomasi.
| Konversi | Command | Catatan |
|---|---|---|
| Markdown ke HTML | pandoc input.md -o output.html |
Tambah --standalone untuk HTML lengkap dengan head/body |
| Markdown ke PDF | pandoc input.md -o output.pdf |
Butuh LaTeX (install TeX Live atau MiKTeX) |
| Markdown ke EPUB | pandoc input.md -o output.epub |
Tambah metadata dengan --metadata title="Judul" |
| Markdown ke DOCX | pandoc input.md -o output.docx |
Pakai --reference-doc untuk template bermerek |
| HTML ke Markdown | pandoc input.html -o output.md |
Berguna untuk mengimpor konten lama ke pipeline kamu |
AI coding assistant kamu bisa menulis batch conversion script dalam hitungan menit. Script-nya membaca setiap file di folder "approved" kamu, mengkonversi masing-masing ke semua format yang dibutuhkan, dan menyimpan output di subfolder per format. Jalankan sekali setelah setiap editing pass.
Injeksi Metadata
Formatting bukan cuma soal body konten. Setiap format output butuh metadata: judul, deskripsi, nama penulis, tanggal publikasi, kata kunci, dan Open Graph tag untuk social sharing.
Simpan metadata di file terstruktur (YAML front matter di sumber Markdown kamu, atau file JSON terpisah per konten). Script konversi kamu membaca metadata dan menyuntikkannya ke lokasi yang benar untuk setiap format:
- HTML: tag
<title>,<meta>, properti Open Graph - PDF: properti dokumen (judul, penulis, subjek)
- EPUB: metadata OPF (dc:title, dc:creator, dc:description)
- WordPress: judul post, excerpt, kategori, tag
Input metadata manual itu sumber error yang umum. Otomasi. Metadata-nya ada di satu tempat dan disebarkan ke semua format secara otomatis.
Konsistensi Visual Lintas Format
Setiap format output punya rendering engine sendiri. HTML dirender di browser. PDF dirender via LaTeX atau PDF engine. EPUB dirender di software e-reader. Konten yang sama bisa tampil beda di setiap format, dan "beda" kadang berarti "rusak."
Buat format test checklist:
| Cek | HTML | EPUB | |
|---|---|---|---|
| Heading tampil benar | Verifikasi di browser | Verifikasi di PDF reader | Verifikasi di Calibre atau e-reader |
| Tabel terbaca | Cek responsive behavior | Cek lebar kolom | Tabel mungkin ga dirender; pakai alternatif |
| Gambar tampil | Cek path | Cek embedding | Cek penyertaan file |
| Link berfungsi | Klik setiap link | Verifikasi bisa diklik | Verifikasi bisa diklik |
| Code block terformat | Cek syntax highlighting | Cek font monospace | Cek line wrapping |
Jalankan checklist ini di batch pertama kamu. Begitu conversion pipeline kamu stabil, spot-check aja, ga perlu full-check. Tapi pertama kali, verifikasi semuanya.
Quality gate untuk Stage 6: semua target format dihasilkan tanpa error, metadata benar di setiap format, dan visual spot-check lolos. Ini tahap otomatis terakhir sebelum publishing.
Bacaan Lanjutan
- Pandoc User's Guide, John MacFarlane
- Pandoc on GitHub
- Using Pandoc to Format a Dissertation, Terence Eden
- Docker Pandoc: Automate Documentation Pipeline, Boundev
Tugas
Ambil konten jadi kamu dari Sesi 8.6 dan konversi ke minimal 3 format berbeda:
- Install Pandoc kalau belum (
pandoc.org/installing.html). - Simpan konten yang sudah di-approve sebagai file Markdown dengan YAML front matter untuk metadata.
- Konversi ke HTML, PDF, dan satu format tambahan pilihan kamu.
- Jalankan format test checklist di setiap output.
Kalau kamu nyaman scripting: minta AI coding assistant kamu untuk membuat batch conversion script yang menerima file Markdown sebagai input dan menghasilkan ketiga format. Satu command, tiga output.