Wednesday, September 07, 2016

Static web generator dengan Mkdocs

Untuk membuat static web generator (web statis, yang isinya biasanya hanya informasi saja) cukup mudah menggunakan mkdocs. Dengan Ubuntu langkah-langkahnya adalah sebagai berikut:
    1. sudo apt-get install mkdocs
    2. mkdocs new website
    3. cd website
    4. mkdocs serve (buka http://127.0.0.1:8000 untuk melihat, ctrl-c di terminal untuk mematikannya)
    5. mkdocs build
Hanya dengan empat langkah di atas kita sudah bisa membuat static web dengan mkdocs. Buka sub folder "site" dalam folder "website" (sebagai contoh pada langkah kedua diatas) dan buka file index.html didalamnya. Jika anda sudah mempunyai hosting, anda cukup mengcopy seluruh file dalam folder site ke hosting anda, biasanya dalam folder "www".

Mengganti tema/theme

Konsep dari mkdocs adalah membuat static website dari makrdown alih-alih menggunakan pure html, wordpress, joomla atau bootstrap. Mkdocs akan membuat file html untuk anda berdasarkan markdown dan file konfigurasi mkdocs.yml. Untuk mengganti tema website dari default mkdocs, kita perlu mengedit file mkdocs.yml sebagai berikut
site_name: website
pages:
- Home: index.md
- About: about.md
theme: alabaster
Sebelum mem-build ulang, buat file about.md dalam folder docs. Tutorial singkat markdown bisa dibaca disini. Setelah membuat file about.md anda bisa membersihkan hasil build sebelumnya dan mem-build ulang,
mkdocs build --clean
mkdocs build
Nah, dengan perintah tersebut anda sudah bisa mengedit dan mengganti tema web anda. Setiap kali anda mengedit konfigurasi dan isi web anda, jangan lupa untuk meng-clean anda mem-build ulang dengan dua perintah di atas. Berikut contoh tampilan static web yang dibangun dengan Mkdocs.

Halaman web yg dibangun dengan mkdocs (http://vibrastic.ep.its.ac.id/simpanfile/)
Related Posts Plugin for WordPress, Blogger...