Saya sebelumnya tidak pernah tertarik dengan split keyboard atau ergo keyboard. Menurut saya bentuknya cukup aneh seperti keyboard biasa yang dibelah jadi dua bagian. Saya tidak suka bentuknya. Ini murni preferensi pribadi saja. Tidak suka bukan berarti jelek.

Namun, semua berubah sejak saya menemukan Corne keyboard. Split keyboard, low profile, dengan jumlah key yang sedikit (hanya 42 atau 36 keys), case yang tipis, dimensi yang mini (seukurang telapak tangan), configurable, remapable (programmable), dan case yang customizeable.

Cerita dulu

Berhubung ini adalah artikel pertama saya yang membahas tentang typing, saya akan cerita dulu background history saya berkenalan dengan keyboard.

SD kelas 4 atau 5 saya pertama kali bertemu komputer dan keyboard, karena ikut les komputer yang diadakan dari sekolah SD tapi ruang komputernya ada di gedung SMA. Saat itu kami dikenalkan dengan game di komputer. Saya paling suka bermain Mario Teaches Typing (1993).

Gambar 1. Mario Teaches Typing (1993). Source https://www.uvlist.net/game-211662-Mario+Teaches+Typing

Saat SMP, orang tua saya membeli komputer untuk di rumah. Alhamdulillah menang dorprize sehingga dapat komputer hadiah, Pentium MMX yang diletakkan di kamar saya.

Saat kelas 2 SMA, untuk pertama kali ada guru (pak Taufik) yang notice kalau saya cukup cepat dalam mengetik. Sempat 1-2 kali diminta untuk mengetik di laptop beliau.

Kelas 2 SMA, saya mengikuti lomba web beregu tingkat nasional. Di tim ini saya kebagian mengetik konten yang akan dipajang di website yang akan dilombakan.

Singkat cerita, sampai kuliah yang kedua, salah satu teman yang juga seorang Finance, menilai ketikan saya cukup cepat tapi jarinya tidak sesuai. Tidak touch typing. Karena ia sempat belajar touch typing di kampus dan menjadi persyaratan lulus. Dari sini saya pertama kali mengetahui tentang touch typing (mengetik tanpa melihat tuts keyboard).

Sampai saat COVID-19 saya sudah bekerja sebagai software engineer, saya menyadari dalam proses mengetik, proses problem solving di pikiran saya juga bercampur dengan proses mengetik. Saya masih memikirkan beberapa lokasi key yang belum saya hafal, terutama key yang berkaitan dengan simbol-simbol code. Terkadang juga harus melihat posisi dari key yang ingin saya tekan jika saya kehilangan referensi posisinya. Pada tahap ini, saya mulai menyadari touch typing mungkin bisa membuat proses mengetik code tidak bercampur dengan proses berfikir.

Saya putuskan untuk mulai belajar touch typing. Ternyata saya harus mulai belajar dari awal lagi untuk membiasakan jari-jari agar mengetik sesuai dengan posisi dan porsinya masing-masing.

Dari informasi yang saya kumpulkan, belajar touch typing banyak yang merekomendasikan untuk memulai dari keybr.com. Karena keybr dapat mengidentifikasi jari mana yang lemah dan akan terus men-generate kata yang mengandung huruf yang menjadi kelemahan kita. Di sini saya mulai membangun fondasi touch typing yang benar. Kalau dilihat dari data log yang ada di keybr, saya mulai latihan dari November 2021 sampai Februari 2022.

Setelah mulai nyaman dan terbiasa dengan touch typing, saya mulai beralih ke monkeytype.com. Di sini saya pergunakan untuk melancarkan dan membangun muscle memory yang lebih solid. Hingga hari ini, saya masih menggunakan monkeytype untuk membangun kecepatan mengetik dalam satuan Words per Minute (WPM).

Keychron K6

Setelah sangat lancar dengan touch typing, WPM sudah rata-rata di 70-80. Kejenuhan mengetik mulai muncul. Saya mengatasi dengan mencoba menggunakan mechanical keyboard.

Saya pilih Keychron karena ini adalah mechanical keyboard pertama saya, dan saya igin mendapatkan pengalaman yang baik.

Singkat cerita saya juga sudah mulai jenuh/fatigue dengan high profile switch. Saya pun ingin mencoba low profile switch. Tapi, sekalian saja saya coba split keyboard.

Saya merasa saat menggunakan standard keyboard sering tertukar antara kiri dan kanan. Seperti terjadi semacam interfere signal karena tangan kanan dan kiri berdekatan. Mungkin kalau diilustrasikan akan seperti ini.

Gambar 2. Ilustrasi tentang interfere signal yang saya bayangkan

Dengan menggunakan split keyboard, akan memberikan jarak antara kedua tangan, sehingga tidak ada signal yang beririsan (ini bercanda ya).

Chocofi

Sebelum mengenal Chocofi, sebenarnya saya hanya mengincar Corne. Tapi setelah berkeliling marketplace, saya tidak menemukan pre-built model Corne yang saya suka. Saya cenderung menyukai Chocofi pre-built yang sudah sesuai dengan selera saya, yaitu:

1. Full black
2. Low profile
3. Wireless (bluetooth)
4. Menggunakan case (agar board tidak terekspose)

Pilihan pun jatuh kepada Chocofi.

Berikut ini profil dari Chocofi.

1. Keyboard shield dan casing 3D print dengan kontroler NRF528540 yang support ZMK Studio
2. Tiap sisi punya 3 baris, 5 kolom, dan 3 tombol buat ibu jari (thumb cluster)
3. Column Staggered dengan kolom pinky (kolom ke 5) dibuat lebih turun mengikuti bentuk anatomi jari kelingking. Menurut saya, layout ini cocok untuk tipikal jari orang asia yang memiliki jari jemari yang mungil
4. Terinspirasi dari keyboard Fifi, dan menggunakan firmware Seperti Corne dan Miryoku
5. Support ZMK Studio untuk kebutuhan custom mapping keys sesuai kebutuhan tanpa perlu flash tinggal copy & paste
6. Dilengkapi Switch On-Off dan menggunakan baterai 500 mAh di masing-masing sisi.

Berikut ini spesifikasi dari Chocofi.

1. 3x5 Column staggered + 3 buttons on thumb cluster
2. NRF52840 controller (type c, ble, bluetooth)
3. OLED 0.91 inchi 128x32 pixel SSD1306 I2C
4. Socket Kailh choc hot swap low profile 1350
5. Switch Kailh choc v1 red pro low profile (linear)
6. Keycap Kailh choc v1 PBT black blank
7. 3D Printed PLA+ Case
8. Programmable buttons
9. Support ZMK Studio (menggunakan ZMK Firmware)
10. Rubber Feets
11. Suport 5 Multiple Device through Bluetooth
12. Li-Po Battery 500 mAh
13. Type C Connector
14. 1 Meter braided USB Type C Cable

Karena keyboard ini tidak ada case dan karena bentuknya yang kecil dan terlihat ringkih, saya khawatir jika dimasukkan tas akan baku hantam dengan barang-barang lain di dalam tas, maka saya putuskan untuk membeli case. Setelah saya hitung-hitung dimensinya cocok dengan Fujifilm Instax Mini case.

Awal mula mencoba mengetik, saya hanya mendapatkan 5 WPM. Beberapa jam kemudian mulai naik ke 15 WPM. Setalah 24 jam mulai naik ke 40 WPM.

Ini adalah progres setelah seminggu.

Surprisingly, mengetik di keyboard ini ternyata menyenangkan. Tidak ada fatigue pada otot-otot digitorum (kelompok otot yang mengontrol gerakan jari tangan). Mengetiknya memang masih dragged karena masih harus membiasakan dengan konsep layer. Karena keyboard ini hanya memiliki 36 key, maka key yang tidak ada di base layer akan disimpan di layer berbeda.

Layering

36 key tentu tidak akan memenuhi semua kebutuhan mengetik. Maka dari itu keyboard-keyboard dengan key yang sedikit seperti ini biasanya menggunakan konsep layering. Dimana mapping key akan dibagi berdasarkan beberapa layer.

Berikut ini layer-layer yang saya pergunakan.

1. layer 0 (qwerty_layer), base layer atau front layer
2. layer 1 (numsym_layer), numeric & symbol layer
3. layer 2 (fun_layer), function buttons
4. layer 3 (sys_layer), system layer untuk pengaturan konektifitas bluetooth

Gambar 10. layer 0 (qwerty_layer), base layer atau front layer

Gambar 11. layer 1 (numsym_layer), numeric & symbol layer

Gambar 12. layer 2 (fun_layer), function buttons

Gambar 13. layer 3 (sys_layer), system layer untuk pengaturan konektifitas bluetooth

Pada layer-layer tersebut dapat dilihat pada layer 0 atau base layer atau qwerty_layer, terdapat tombol referensi untuk mengakse layer 1 dan 2 yang terdapat pada thumb cluster kiri dan kanan.

Untuk mengakses layer 1, saya menekan dan tahan tombol space. Dengan begini, saya sudah masuk ke layer 1, tinggal menekan button apa yang ingin ditekan pada layer 1. Begitu juga untuk mengakses layer 2.

Untuk mengakses layer 3, saya perlu berada di layer 2, lalu menekan button referensi untuk ke layer 3 yang juga terdapat di thumb cluster sebelah kanan.

Saya masih bereksperimen dengan layout layering seperti apa yang cocok. Jadi akan sangat besar dikemudian hari layout ini akan berubah.

Saya menghindari menggunakan layer yang terlalu banyak agar tidak terjadi “layering fatigue” yaitu kondisi “keblinger” atau kelelahan otak karena kebanyakan layer. Hahaha.

Selain pendekatan layer juga ada pendekatan combo button.

Combo

Sesuai namanya combo button berarti menekan 2 atau lebih button secara bersama-sama untuk memanggil fungsinya.

Saya tidak terlalu banyak menggunakan combo button. Hanya saya pergunakan untuk hal-hal yang berkaitan dengan pengaturan saja.

Kesan penulis

Beberapa manfaat yang saya rasakan setelah mencoba menggunakan Chocofi split keyboard.

1. Kita di-encourage untuk menggunakan touch typing. Karena (dengan split keyboard) jika tidak menggunakan touch typing artinya kita akan melihat ke dua sisi keyboard, bisa di sisi kanan atau kiri. Split keyboard membuat proses mengetik menjadi tidak efektif.
2. Karena “dipaksa” untuk menggunakan touch typing, membuat jari-jemari menjadi lebih disiplin dengan porsinya masing-masing. Ini sangat cocok dengan layout split keyboard yang terbelah jadi dua di sisi kanan dan kiri. Tidak ada jari di tangan kiri yang menyeberang ke sisi kanan, begitu pula sebaliknya.
3. Minim typo. Karena jarak tangan cukup berjarak dan tidak saling berdekatan. Ini menyebabkan tidak terjadi race condition saat pengiriman sinyal dari otak ke dua sisi tangan (note: ini pendapat saya, saya belum mencari literaturenya).
4. Proses adaptasi jika sudah bisa mengetik dengan touch typing tidak terlalu lama. Adaptasi dari staggered ke column-staggered juga tidak terlalu lama. Saya 1 pekan sudah bisa menyesuaikan dengan column-staggered dari staggered. Jujur lebih nyaman menggetik di column-staggered (bisa jadi ortholinear juga lebih nyaman, saya belum punya keyboard dengan ortholinear). Karena posisi jari dari homerow hanya perlu bergerak ke atas atau ke bawah, bukan serong atas atas atau serong bawah.
5. Sangat mudah diprogram ulang. Karena menggunakan ZMK Firmware, sehingga sangat mudah untuk diprogram ulang jika kita mau memodifikasi tombol dan layer sesuai dengan kebutuhan kita.
6. Berpotensi besar untuk dicustom sendiri sesuai keinginan dan kebutuhan. Misal ingin ganti keycaps, ganti switch, ingin ganti case shield nya, dan lain-lain.
7. Karena point 6, artinya juga mudah untuk diperbaiki sendiri.

Dari beberapa kesan tersebut, dapat terlihat jelas bahwa fondasi utama jika ingin menikmati mengetik dengan keyboard adalah touch typing.

Beberapa hal yang saya tidak begitu nyaman dengan Chocofi split keyboard.

1. Barangnya sulit didapat. Karena builder ada di luar negeri, yang tersedia di marketplace Indo tidak begitu beragam.
2. Learning cuve nya lumayan. Untuk dapat menggunakan split keyboard, kita harus menyediakan waktu untuk menggunakan. Berteman dengan ketidaknyamanan untuk beberapa saat.
3. Chocofi tidak sepopuler Corne. Sehingga tidak banyak yang membuat modifikasi, terutama dibagian case. Karena kelebihan dari keyboard seperti ini adalah sangat mudah untuk bergonta-ganti case.

Pesan penulis

Split keyboard bukanlah level tertinggi dari penggunaan keyboard. Split keyboard hanya opsi atau pilihan dari beberapa pilihan model keyboard yang beredar di pasaran saat ini. Tidak semua orang cocok menggunakan split keyboard. Pergunakan perkakas/tools (dalam hal ini keyboard) yang memang nyaman kamu gunakan.

Referensi

1. ZMK Firmware
   Diakses tanggal: 2026-07-11

2. Nickcoutsos Keymap Editor
   Diakses tanggal: 2026-07-11

Meja belajar merupakan hal yang sangat personal untuk saya. Sejak SD saya diberikan meja belajar di kamar oleh orang tua saya. Sejauh ingatan saya, di masa sekolah, sejak SD sampai SMA, saya pernah punya 3 model meja belajar. Mulai dari yang model seperti meja kantoran, kemudian model yang memiliki rak 2 tingkat di atas meja belajar, yang terakhir adalah model meja belajar yang terintegrasi untuk meletakkan komputer (layar monitor CRT beserta CPU di bagian bawahnya). Saat kuliah saya juga memilih untuk menggunakan meja belajar. Saya sudah benar-benar melekat erat dengan meja belajar. Sebagian besar waktu saya di rumah mungkin di depan meja belajar.

Oh yaa, berhubung sekarang meja belajar ini sudah berubah jadi meja kerja, maka penamaan meja belajar untuk selanjutnya akan saya sebut dengan meja kerja.

Penamaan meja kerja 5.1 ini artinya meja kerja yang saya gunakan saat ini adalah meja kelima dengan modifikasi versi 1.

INFO

Sebenarnya proses modifikasi meja ini sudah terjadi sejak 1 Desember 2024. Tapi baru sempat saya dokumentasikan sekarang. 🤣

Berikut ini adalah perjalanan modifikasi meja kerja 5.0 menjadi 5.1.

Gambar 1. Setup meja belajar 5.0 sebelum dimodifikasi (tampak depan)

Gambar 2. Setup meja belajar 5.0 sebelum dimodifikasi (tampak samping)

Alasan memodifikasi meja kerja

Alasan saya memodifikasi meja kerja adalah karena saya menambah perangkat baru yang ingin saya letakkan di meja belajar. Namun, karena tidak mungkin semua alat berada di atas meja utama, saya memutuskan untuk menambahkan rak untuk meletakkan peralatan tambahan tersebut.

Saya sebut sebagai “rak level 1” karena berada 1 level (tingkat) di atas meja belajar.

Setelah banyak mempertimbangkan mau seperti apa rak yang saya buat, akhirnya saya memutuskan untuk membuat rak semi-permanent dengan menggunakan besi siku.

Bahan-bahan yang dibutuhkan

Bahan-bahan yang saya beli untuk membuat rak level 1, sebagai berikut:

1. Besi siku panjang 3 meter, tebal 1 mm x 2 batang
2. Triplek 3 mm x 1 lembar
3. Mur baut untuk besi siku x 25 biji
4. Plat siku x 12 lembar
5. Kaki karet untuk besi siku x 2 buah

Gambar 3. Wah ternyata tripleknya kebesaran, padahal saya cuma akan menggunakan 120x20 cm

Gambar 4. Besi siku (tampak jauh)

Gambar 5. Besi siku (tampak dekat)

Gambar 6. Mur, Baut, dan kaki karet untuk besi siku

Gambar 7. Plat siku

Alat-alat yang diperlukan

Alat-alat yang dibutuhkan, sebagai berikut:

1. Gergaji besi
2. Kunci pas ukuran 12
3. Meteran
4. Penggaris
5. Pulpen
6. Paki dan Palu (untuk melubangi triplek)

Setelah alat dan bahan lengkap, selanjutnya buat desainnya.

Desain dan rancangan

Dari desain yang saya buat, saya membutuhkan ukuran:

INFO

Panjang dari meja saya 120 x 60 cm, karena itu saya membuat panjang rak level 1 ini 120 cm, dengan tinggi 120 cm juga.

Implementasi

Gambar 8. Besi siku yang sudah dipotong sesuai desain

Setelah dipotong, selanjutnya dirakit dengan mur dan baut dan setiap sudut sikunya dibantu dengan plat siku agar bentuknya tidak berubah.

Gambar 9. Setelah dirakit mulai kelihatan bentuknya

Selanjutnya tinggal diberikan papan. Tapi saya memilih menggunakan triplek agar tidak berat.

Gambar 10. Proses pembuatan lubang di triplek

Setelah keempat sudut triplek sudah dilubangi, selanjutnya tinggal dirakit ke rak.

Gambar 11. Meja kerja setelah ditambahkan rak level 1 dengan besi siku (tampak samping)

Gambar 12. Meja kerja setelah ditambahkan rak level 1 dengan besi siku (tampak depan)

Selesai!

Sekarang saya sudah punya rak level 1. Sekarang meja saya tidak terlalu penuh dengan peralatan lagi.

2026

Setelah 1 tahun menggunakan rak ini, saya merasa raknya kurang tinggi. Jadi saya tinggikan kakinya 10 cm. Penambahan tinggi 10 cm ini lumayan memberikan tambahan space untuk monitor eksternal agar bisa lebih tinggi selevel mata saya.

Gambar 13. Sebelum ditinggikan (kiri), setelah ditinggikan (kanan)

Pesan Penulis

Meja belajar atau meja kerja adalah tempat saya paling banyak menghabiskan waktu untuk belajar, membaca, dan bekerja. Meja kerja menjadi sesuatu yang sangat personal untuk saya. Maka dari itu saya tidak berusaha meniru setup meja orang lain. Yang menurut orang lain bagus, belum tentu menurut saya. Begitu juga sebaliknya, yang menurut orang lain jelek, belum tentu menurut saya jelek.

Meskipun saya menggunakan Linux, tapi fingerprint tetap dapat digunakan. Saya sudah pernah menulis artikel tentang ini, Mengatur Fungsi dari Fingerprint pada Arch Linux.

Kepraktisan tersebut tidak berlangsung lama, karena plafon kamar saya bocor, dan tetesannya mengenai palmrest (kejadian sekitar tahun 2017-2018). Untungnya fingerprint di ThinkPad X260 ini adalah modul board terpisah dari Motherboard, jika rusak, cukup mengganti fingerprint board module saja.

Gambar 1. Fingerprint Board (Tampak Atas)

Gambar 2. Fingerprint Board (Tampak Bawah)

Long story short, fingerprint board yang saya pakai ini (berdasarkan keterangan seller) adalah copotan dari fingerprint board ThinkPad X250. Berdasarkan bentuk ThinkPad X260 memang memiliki kesamaan dengan seri X240 dan X250. Ketiga lineup seri ini memang memiliki parts yang bisa digunakan bersama.

Untuk mengganti fingerprint, harus mengangkat: internal battery (jika ada), drive (SSD) case, speaker left & right, dan motherboard.

Gambar 3. Bongkar ThinkPad X260 sampai Motherboard

Kita melepas plat cover besi yang menutupi fingerprint board (Gambar 4).

Gambar 4. Fingerprint Board Baru (Kiri) dan Fingerpint Board Lama (Kanan, masih tercover plat)

Setelah plat cover besi terlepas, fingerprint board sudah bisa untuk diganti. Jangan lupa untuk melepaskan kabel flexiblenya.

Gambar 5. Fingerprint Board Baru (Kiri) dan Fingerpint Board Lama (Kanan, cover sudah terlepas, siap diganti)

Selesai.

Meskipun terlihat mengerikan, sebenarnya proses pembongkaran ini tidak terlalu sulit. Yang terpenting pelan-pelan dan hati-hati.

Saya tidak ingin mengunduh data geofabrik untuk region Indonesia yang berukuran besar (per-tulisan ini dibuat, 1.6 GB), karena saya hanya memerlukan data untuk tiga sub-region: pulau Sumatra (258 MB), Java (847 MB), dan Kalimantan (138 MB). Oleh karena itu, saya hanya akan mengunduh data untuk ketiga sub-region tersebut dan menggabungkannya menjadi satu file .osm.pbf.

Mengunduh Data Sub-Region Geofabrik

Unduh data untuk ketiga sub-region yang diperlukan dari situs Geofabrik:

1. https://download.geofabrik.de/asia/indonesia/sumatra-latest.osm.pbf
2. https://download.geofabrik.de/asia/indonesia/java-latest.osm.pbf
3. https://download.geofabrik.de/asia/indonesia/kalimantan-latest.osm.pbf

Letakkan ketiga file .osm.pbf yang telah diunduh ke dalam satu folder, misal: geofabrik/.

$ cd geofabrik/
$ wget -c https://download.geofabrik.de/asia/indonesia/sumatra-latest.osm.pbf
$ wget -c https://download.geofabrik.de/asia/indonesia/java-latest.osm.pbf
$ wget -c https://download.geofabrik.de/asia/indonesia/kalimantan-latest.osm.pbf

geofabrik/
│ java-latest.osm.pbf
│ kalimantan-latest.osm.pbf
└ sumatra-latest.osm.pbf

Menggabungkan Data Sub-Region dengan Osmium Tool

Setelah ketiga file .osm.pbf untuk sub-region yang diperlukan telah diunduh, langkah selanjutnya adalah menggabungkannya menjadi satu file .osm.pbf menggunakan Osmium Tool.

Instalasi Osmium Tool dapat dilakukan dengan mengikuti petunjuk di situs resminya: https://osmcode.org/osmium-tool/.

Setelah Osmium Tool terinstal, jalankan perintah berikut untuk menggabungkan ketiga file .osm.pbf menjadi satu file .osm.pbf baru, misal: indonesia-3pulau-latest.osm.pbf.

$ osmium merge sumatra-latest.osm.pbf java-latest.osm.pbf kalimantan-latest.osm.pbf -o indonesia-3pulau-latest.osm.pbf

Tunggu hingga proses penggabungan selesai.

Kesimpulan

Dalam catatan ini, saya telah mendemonstrasikan proses penggabungan data untuk pulau Sumatra, Java, dan Kalimantan menjadi satu file .osm.pbf baru yang berukuran lebih kecil dibandingkan dengan data untuk seluruh region Indonesia.

Referensi

1. https://download.geofabrik.de/asia/indonesia.html
   Diakses tanggal: 2026-02-22

2. https://osmcode.org/osmium-tool/
   Diakses tanggal: 2026-02-22

Apa itu Overpass API?

Overpass API memungkinkan kita untuk melakukan query terhadap data OpenStreetMap (OSM) yang dapat digunakan untuk mencari POI (Point of Interest) pada radius tertentu dari lokasi yang didefinisikan. Overpass API menggunakan bahasa query yang disebut Overpass QL. Dengan Overpass API, kita dapat melakukan query untuk mencari data OSM berdasarkan kriteria tertentu, seperti jenis POI, lokasi, dan lain-lain.

Overpass API dengan Docker

1. Buat Docker Compose untuk Overpass API

Buat file docker-compose.yml dengan isi seperti ini,

services:
  overpass:
    image: openzonedev/overpass-api:0.7.57.2
    container_name: osm-overpass
    restart: unless-stopped
    environment:
      OVERPASS_META: "yes"
      OVERPASS_MODE: "init"
      OVERPASS_PLANET_URL: file:///overpass/data/kalimantan-latest.osm.bz2
    volumes:
      - ./geofabrik/kalimantan-new.latest.bz2:/overpass/data/kalimantan-latest.osm.bz2:ro
      - overpass-data:/db
    expose:
      - "80"
    ports:
      - "8081:80"

volumes:
  overpass-data:

2. Persiapkan data OSM untuk Overpass API

Pada contoh di atas, saya menggunakan data OSM untuk wilayah Kalimantan yang saya unduh dari Geofabrik.

INFO

Overpass API membutuhkan file data OSM dalam format .osm.bz2 untuk proses import data.
Saya akan merubah file .osm.pbf yang kita unduh dari Geofabrik menjadi format .osm.bz2 menggunakan tool osmium-tool.

File .osm.pbf ini bisa didapatkan dari situs Geofabrik.

Setelah mengunduh file .osm.pbf, letakkan file tersebut di dalam direktori geofabrik/ yang berada di root project. Buat direktori geofabrik/ jika belum ada.

$ mkdir geofabrik
$ cd geofabrik
$ wget -c https://download.geofabrik.de/asia/indonesia/kalimantan-latest.osm.pbf

Tunggu proses download selesai, setelah itu pastikan file .osm.pbf sudah berada di dalam direktori geofabrik/.

Berikut adalah struktur direktori yang diharapkan setelah menambahkan file .osm.pbf:

geofabrik/
└── kalimantan-latest.osm.pbf
docker-compose.yml

2.1 Konversi file .osm.pbf ke format .osm.bz2

Untuk mengkonversi file .osm.pbf ke format .osm.bz2, bisa menggunakan tool osmium-tool. Pastikan osmium-tool sudah terinstall di sistem.

Jika belum, bisa menginstalnya dengan mengikuti petunjuk di situs resmi osmium-tool.

$ brew install osmium-tool

Setelah osmium-tool terinstall, jalankan perintah berikut untuk mengkonversi file .osm.pbf ke format .osm.bz2:

$ osmium cat geofabrik/kalimantan-latest.osm.pbf -o geofabrik/kalimantan-latest.osm.bz2

Tunggu proses konversi selesai, setelah itu pastikan file .osm.bz2 sudah berada di dalam direktori geofabrik/.

Sip, sekarang file .osm.bz2 sudah siap untuk digunakan dalam proses import data oleh Overpass API.

3. Jalankan Docker Compose

Setelah file docker-compose.yml sudah siap dan file data OSM dalam format .osm.bz2 sudah berada di dalam direktori geofabrik/, jalankan perintah berikut untuk memulai Docker Compose:

$ docker-compose up -d

PERHATIAN

Untuk pertama kali menjalankan docker compose, Overpass API service akan melakukan proses import data dari file .osm.bz2 ke dalam Overpass Data, proses ini membutuhkan waktu yang cukup lama, tergantung pada ukuran file .osm.bz2 yang digunakan. Untuk file kalimantan-latest.osm.bz2 yang berukuran 318 MB, proses import data bisa memakan waktu sekitar 30 menit hingga 1 jam.

Untuk melihat log dari container, bisa menggunakan perintah berikut:

$ docker compose logs overpass -f

Tunggu proses import data selesai. Biasanya akan muncul log seperti berikut ketika proses import data sudah selesai:

Overpass container initialization complete. Exiting.

Setelah proses import data selesai, Overpass API service sudah siap untuk digunakan. Overpass API bisa diakses melalui http://localhost:8081/.

4. Akses Overpass API

4.1 /api/status

Untuk memastikan bahwa Overpass API service sudah berjalan dengan baik, coba akses endpoint /api/status untuk melihat status dari Overpass API service.

$ curl http://localhost:8081/api/status

Outputnya akan seperti ini,

Connected as: 3232252161
Current time: 2026-02-16T10:25:16Z
Rate limit: 0

4.2 /api/interpreter

Setelah Overpass API service sudah siap, coba lakukan query untuk mencari data OSM berdasarkan kriteria tertentu.

Base URL nya seperti ini,

$ curl -X POST http://localhost:8081/api/interpreter

Outputnya akan seperti ini,

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <meta http-equiv="content-type" content="text/html; charset=utf-8" lang="en"/>
  <title>OSM3S Response</title>
</head>
<body>

<p>The data included in this document is from www.openstreetmap.org. The data is made available under ODbL.</p>
<p><strong style="color:#FF0000">Error</strong>: encoding error: Your input contains only whitespace. </p>

</body>
</html>

Nah, tinggal tambahkan query untuk mencari data OSM berdasarkan kriteria tertentu.

Gunakan juga header Content-Type: application/x-www-form-urlencoded untuk mengirim data query dalam format URL encoded.

Misalnya, untuk mencari semua POI dengan tag amenity=cafe pada radius 5000 meter dari titik user berada (-1.2286365, 116.8941987), kita bisa menggunakan query berikut:

$ curl -X POST http://localhost:8081/api/interpreter -H "Content-Type: application/x-www-form-urlencoded" --data "data=[out:json];node[amenity=cafe](around:5000, -1.2286365, 116.8941987);out center;"

Outputnya dalam bentuk JSON akan seperti ini,

{
  "version": 0.6,
  "generator": "Overpass API 0.7.57.2 48842a1b",
  "osm3s": {
    "timestamp_osm_base": "2026-01-18T20:51:44Z",
    "copyright": "The data included in this document is from www.openstreetmap.org. The data is made available under ODbL."
  },
  "elements": [
    {
      "type": "node",
      "id": 9898980886,
      "lat": -1.2420011,
      "lon": 116.8730133,
      "tags": {
        "amenity": "cafe",
        "name": "Excelso - Living Plaza"
      }
    },
    {
      "type": "node",
      "id": 9899039726,
      "lat": -1.2437437,
      "lon": 116.8607824,
      "tags": {
        "amenity": "cafe",
        "name": "Excelso Cafe Mall Fantasy"
      }
    },
    {
      "type": "node",
      "id": 9899398634,
      "lat": -1.2449160,
      "lon": 116.8603869,
      "tags": {
        "amenity": "cafe",
        "name": "CPM Coffee Shop Balikpapan Baru - Damai"
      }
    },
    {
      "type": "node",
      "id": 9899400587,
      "lat": -1.2452571,
      "lon": 116.8597143,
      "tags": {
        "amenity": "cafe",
        "name": "Balgas Cafe - Damai"
      }
    },
    {
      "type": "node",
      "id": 9899406395,
      "lat": -1.2452690,
      "lon": 116.8606450,
      "tags": {
        "amenity": "cafe",
        "name": "Kopi Lawe - Damai Baru"
      }
    },
    {
      "type": "node",
      "id": 9900996432,
      "lat": -1.2511856,
      "lon": 116.8696109,
      "tags": {
        "amenity": "cafe",
        "branch": "Ruko Jalan MT Haryono",
        "brand": "Kopi Kenangan",
        "brand:wikidata": "Q97221992",
        "cuisine": "coffee_shop",
        "diet:halal": "only",
        "name": "Kopi Kenangan",
        "takeaway": "yes"
      }
    },
    {
      "type": "node",
      "id": 10036595776,
      "lat": -1.2460153,
      "lon": 116.8594667,
      "tags": {
        "amenity": "cafe",
        "name": "Dialog Cafe - Balikpapan Baru"
      }
    }
  ]
}

Dari data di atas, kita bisa melihat bahwa terdapat beberapa POI dengan tag amenity=cafe pada radius 5000 meter dari latitude dan longitude yang saya definisikan yang berhasil ditemukan oleh Overpass API.

Silahkan sesuaikan query sesuai dengan kebutuhan untuk mencari data OSM berdasarkan kriteria tertentu. Berikut adalah contoh query dalam format Overpass QL yang digunakan di atas:

[out:json];
(
  node[amenity=cafe](around:5000, -1.2286365, 116.8941987);
);
out center;

5. Stop Docker Compose

Jika sudah selesai menggunakan Overpass API service, jangan lupa untuk menghentikan Docker Compose dengan perintah berikut:

$ docker-compose download

Kesimpulan

Saya telah mencatat langkah-langkah untuk menjalankan instance Overpass API menggunakan Docker. Dengan mengikuti langkah-langkah di atas, kita dapat dengan mudah menjalankan Overpass API service di lingkungan lokal kita dan melakukan query terhadap data OpenStreetMap untuk mencari POI berdasarkan kriteria tertentu.

Referensi

1. https://overpass-api.de/
   Diakses tanggal: 2026-02-15
2. https://osmcode.org/osmium-tool/
   Diakses tanggal: 2026-02-15

Pada catatan sebelumnya “OpenStreetMap Nominatim (Geocoding Machine) dengan Docker” saya telah membahas cara menjalankan instance Nominatim menggunakan Docker. Pada artikel ini, saya akan mencatat langkah-langkah untuk mengonfigurasi Geocoder gem di aplikasi Ruby on Rails agar menggunakan instance Nominatim self-hosted sebagai geocoding service lookup.

Konfigurasi Geocoder Gem

Jika sebelumnya sudah memiliki config file untuk Geocoder di config/initializers/geocoder.rb, buka file tersebut.

Dan tambahkan atau modifikasi konfigurasi seperti ini,

!filename: config/initializers/geocoder.rb
Geocoder.configure(
  # Geocoding options
  # timeout: 3,                 # geocoding service timeout (secs)
  # lookup: :nominatim,         # name of geocoding service (symbol)
  # ip_lookup: :ipinfo_io,      # name of IP address geocoding service (symbol)
  # language: :en,              # ISO-639 language code
  # use_https: false,           # use HTTPS for lookup requests? (if supported)
  # http_proxy: nil,            # HTTP proxy server (user:pass@host:port)
  # https_proxy: nil,           # HTTPS proxy server (user:pass@host:port)
  # api_key: nil,               # API key for geocoding service
  # cache: nil,                 # cache object (must respond to #[], #[]=, and #del)

  # Exceptions that should not be rescued by default
  # (if you want to implement custom error handling);
  # supports SocketError and Timeout::Error
  # always_raise: [],

  # Calculation options
  # units: :km,                 # :km for kilometers or :mi for miles
  # distances: :linear          # :spherical or :linear

  # Cache configuration
  # cache_options: {
  #   expiration: 2.days,
  #   prefix: 'geocoder:'
  # }

  use_https: false,
  lookup: :nominatim,
  nominatim: {
    host: localhost:8080
  },
)

Saya menggunakan localhost:8080 karena pada catatan sebelumnya saya menjalankan Nominatim di Docker dengan port mapping 8080:8080 dan karena di localhost sehingga tidak menggunakan https.

Bisa juga disesuaikan dengan host dan port tempat Nominatim dijalankan. Misal, saya sudah punya service yang saya jalankan di https://nominatim.bandithijo.dev, maka konfigurasi nominatim akan seperti ini,

!filename: config/initializers/geocoder.rb
Geocoder.configure(
  # ...
  # ...

  use_https: true,
  lookup: :nominatim,
  nominatim: {
    host: 'nominatim.bandithijo.dev',
  },
)

Dengan begini saya sudah berhasil mengonfigurasi Geocoder gem untuk menggunakan Nominatim self-hosted sebagai geocoding service lookup. Selanjutnya, saya bisa menggunakan Geocoder gem untuk melakukan geocoding dan reverse geocoding pada aplikasi Ruby on Rails saya dengan menggunakan instance Nominatim yang saya jalankan sendiri.

Pengujian

Untuk menguji apakah konfigurasi sudah benar, bisa dilakukan di Rails console.

$ rails console

Setup logger agar menampilkan request dan response dari Geocoder gem untuk mempermudah proses debugging,

irb(main):001> Geocoder.configure(logger: Logger.new(STDOUT))

Outputnya,

=>
{:timeout=>3,
 :lookup=>:nominatim,
 :ip_lookup=>:ipinfo_io,
 :language=>:en,
 :http_headers=>{},
 :use_https=>true,
 :http_proxy=>nil,
 :https_proxy=>nil,
 :api_key=>nil,
 :basic_auth=>{},
 :logger=>
  #<Logger:0x000000012837e6b8
   @default_formatter=#<Logger::Formatter:0x0000000124a709e8 @datetime_format=nil>,
   @formatter=nil,
   @level=0,
   @level_override={},
   @logdev=
    #<Logger::LogDevice:0x0000000128273980
     @binmode=false,
     @dev=#<IO:<STDOUT>>,
     @filename=nil,
     @mon_data=#<Monitor:0x0000000124a70970>,
     @mon_data_owner_object_id=71700,
     @reraise_write_errors=[],
     @shift_age=nil,
     @shift_period_suffix=nil,
     @shift_size=nil,
     @skip_header=false>,
   @progname=nil>,
 :kernel_logger_level=>2,
 :always_raise=>[],
 :units=>:km,
 :distances=>:linear,
 :cache=>nil,
 :cache_prefix=>nil,
 :cache_options=>{:prefix=>"geocoder:", :expiration=>nil},
 :nominatim=>{:host=>"osm.bintangdigitalasia.com/nominatim"}}

Dapat dilihat, bahwa konfigurasi nominatim untuk host sudah sesuai dengan yang diinginkan.

Lalu lakukan geocoding pada alamat tertentu,

Forward Search

irb(main):002> Geocoder.search("Jakarta")

Outputnya,

D, [2026-02-09T00:02:12.686252 #30316] DEBUG -- : Geocoder: HTTP request being made for http://localhost:8080/search?accept-language=en&addressdetails=1&format=json&q=Jakarta
=>
[#<Geocoder::Result::Nominatim:0x0000000127219df0
  @cache_hit=nil,
  @data=
   {"place_id"=>3204450,
    "licence"=>"Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
    "osm_type"=>"relation",
    "osm_id"=>6362934,
    "lat"=>"-6.1754049",
    "lon"=>"106.8271680",
    "class"=>"boundary",
    "type"=>"administrative",
    "place_rank"=>8,
    "importance"=>0.2933433333333333,
    "addresstype"=>"city",
    "name"=>"Special Capital Region of Jakarta",
    "display_name"=>"Special Capital Region of Jakarta, Java, Indonesia",
    "address"=>
     {"city"=>"Special Capital Region of Jakarta",
      "ISO3166-2-lvl4"=>"ID-JK",
      "region"=>"Java",
      "ISO3166-2-lvl3"=>"ID-JW",
      "country"=>"Indonesia",
      "country_code"=>"id"},
    "boundingbox"=>["-6.3744575", "-4.9993635", "106.3146732", "106.9739750"]}>]

Reverse Search

irb(main):003> Geocoder.search([-1.2379, 116.8529])

Outputnya,

D, [2026-02-09T00:04:49.941967 #30316] DEBUG -- : Geocoder: HTTP request being made for http://locahost:8080/reverse?accept-language=en&addressdetails=1&format=json&lat=-1.2379&lon=116.8529
=>
[#<Geocoder::Result::Nominatim:0x0000000125da17b0
  @cache_hit=nil,
  @data=
   {"place_id"=>119266,
    "licence"=>"Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
    "osm_type"=>"way",
    "osm_id"=>109864339,
    "lat"=>"-1.2378944",
    "lon"=>"116.8529396",
    "class"=>"highway",
    "type"=>"residential",
    "place_rank"=>26,
    "importance"=>0.0533433333333333,
    "addresstype"=>"road",
    "name"=>"Jalan Bubutan",
    "display_name"=>"Jalan Bubutan, Gunung Samarinda, Balikpapan Utara, Balikpapan, East Kalimantan, 76125, Indonesia",
    "address"=>
     {"road"=>"Jalan Bubutan",
      "village"=>"Gunung Samarinda",
      "city_district"=>"Balikpapan Utara",
      "city"=>"Balikpapan",
      "state"=>"East Kalimantan",
      "ISO3166-2-lvl4"=>"ID-KI",
      "postcode"=>"76125",
      "country"=>"Indonesia",
      "country_code"=>"id"},
    "boundingbox"=>["-1.2383814", "-1.2355025", "116.8482510", "116.8530576"]}>]
irb(main):003>

Kesimpulan

Dengan mengikuti langkah-langkah di atas, saya berhasil mengonfigurasi Geocoder gem untuk menggunakan Nominatim self-hosted sebagai geocoding service lookup. Saya juga berhasil melakukan geocoding dan reverse geocoding menggunakan instance Nominatim yang saya jalankan sendiri. Dengan menggunakan Nominatim self-hosted, saya memiliki kontrol penuh atas data geocoding dan dapat menghindari batasan penggunaan yang mungkin diterapkan oleh layanan geocoding pihak ketiga.

Referensi

1. https://github.com/alexreisner/geocoder
   Diakses tanggal: 2026-02-08

Pendahuluan

OpenStreetMap Nominatim adalah sebuah layanan geocoding yang memungkinkan pengguna untuk mencari lokasi berdasarkan nama tempat atau alamat (forward search) atau geographic coordinate (reverse search). Dalam artikel ini, saya akan mendokumentasikan cara menjalankan OpenStreetMap Nominatim menggunakan Docker agar proses setup Nominatim menjadi lebih mudah dan cepat, tanpa perlu repot mengatur lingkungan dan dependensi secara manual.

Apa itu OpenStreetMap Nominatim?

OpenStreetMap Nominatim adalah sebuah layanan geocoding yang memungkinkan pengguna untuk mencari lokasi berdasarkan nama tempat atau alamat (forward search) atau koordinat geografis (reverse search). Nominatim menggunakan data dari OpenStreetMap untuk menyediakan informasi lokasi yang akurat. Tanpa OpenStreetMap, Nominatim tidak memiliki data apapun untuk digunakan dalam proses geocoding.

Forward Geocodig adalah proses mengubah nama tempat atau alamat menjadi koordinat geografis (latitude dan longitude). Misalnya, jika mencari “Balikpapan”, Nominatim akan memberikan koordinat geografis dari Balikpapan.

Reverse Geocoding adalah proses mengubah koordinat geografis (latitude & longitude) menjadi nama tempat atau alamat. Misalnya, jika memiliki koordinat geografis dari Balikpapan (-1.2398711,116.8593379), Nominatim akan memberikan nama tempat atau alamat yang sesuai.

Nominatim API

Nominatim menyediakan API yang dapat digunakan untuk melakukan forward, reverse geocoding dan beberapa hal lainnya.

Berikut adalah contoh penggunaan Nominatim API:

1. /search
   Digunakan untuk melakukan forward geocoding. Untuk mencari lokasi berdasarkan nama tempat atau alamat.
2. /reverse
   Digunakan untuk melakukan reverse geocoding. Untuk mencari nama tempat atau alamat berdasarkan koordinat geografis (latitude & longitude).
3. /lookup
   Digunakan untuk mencari informasi lokasi berdasarkan OSM ID.
4. /details
   Digunakan untuk mencari informasi lokasi berdasarkan OSM ID, dengan informasi yang lebih detail dibandingkan dengan /lookup.
5. /status
   Digunakan untuk memeriksa status dari Nominatim service.
6. dll.

OpenStreetMap Nominatim dengan Docker

Untuk menjalankan OpenStreetMap Nominatim dengan Docker, bisa menggunakan image yang sudah tersedia di Docker Hub. Agar prosesnya lebih mudah, saya prefer untuk membuat docker compose saja. Berikut adalah langkah-langkahnya:

1. Buat Docker Compose untuk Nominatim Service

Buat file docker-compose.yml dengan isi sebagai berikut:

!filename: docker-compose.yml
services:
 nominatim:
   image: mediagis/nominatim:5.2
   container_name: osm-nominatim
   restart: unless-stopped
   environment:
     PBF_PATH: /nominatim/data/kalimantan-latest.osm.pbf
   volumes:
     - ./geofabrik/kalimantan-latest.osm.pbf:/nominatim/data/kalimantan-latest.osm.pbf
     - nominatim-data:/var/lib/postgresql
   expose:
     - "8080"
   ports:
     - "8080:8080"

volumes:
 nominatim-data:

Saya menggunakan docker image mediagis/nominatim:5.2 yang sudah tersedia di Docker Hub.

Pada PBF_PATH diisi dengan file .osm.pbf. PBF adalah format file yang digunakan untuk menyimpan data OpenStreetMap. File ini berisi informasi tentang jalan, bangunan, dan fitur geografis lainnya yang ada di wilayah tertentu. Dalam contoh ini, saya menggunakan file kalimantan-latest.osm.pbf yang berisi data OpenStreetMap untuk wilayah Kalimantan. Untuk mendapatkan file .osm.pbf untuk wilayah lain, bisa mengunduhnya dari situs Geofabrik.

Kisaran size file .osm.pbf untuk wilayah Indonesia dan beberapa wilayah lainnya adalah sebagai berikut:

Saya menggunakan 2 values untuk volumes,

1. .geofabrik/kalimantan-latest.osm.pbf:/nominatim/data/kalimantan-latest.osm.pbf
   Volume ini digunakan untuk menghubungkan file .osm.pbf yang ada di host dengan file .osm.pbf yang ada di dalam container. Dengan begitu, saya dapat menggunakannya di PBF_PATH untuk proses import data. Proses persiapan file .osm.pbf ini akan saya jelaskan di bagian selanjutnya.
2. nominatim-data:/var/lib/postgresql
   Volume ini digunakan untuk menyimpan data yang dihasilkan oleh Nominatim. Data ini akan disimpan di dalam container, sehingga jika container dihapus, data ini tidak akan hilang. nominatim-data ini adalah nama volume yang dibuat dibagian volumes di bawah nominatim-data:. Volume ini akan dihubungkan dengan direktori /var/lib/postgresql di dalam container, yang merupakan direktori tempat Nominatim menyimpan data yang dihasilkan.

Secara default nonimatin mengekspose port 8080 di dalam container, sehingga saya juga expose port 8080 di bagian expose. Agar bisa diakses dari luar container, saya juga memetakan port 8080 di host ke port 8080 di dalam container dengan menggunakan ports.

2. Persiapkan data OSM berupa file .osm.pbf

Sebelum menjalankan Docker Compose, pastikan sudah memiliki file .osm.pbf yang akan digunakan untuk proses import data. File .osm.pbf ini bisa didapatkan dari situs Geofabrik.

Setelah mengunduh file .osm.pbf, letakkan file tersebut di dalam direktori geofabrik/ yang berada di root project. Buat direktori geofabrik/ jika belum ada.

$ mkdir geofabrik
$ cd geofabrik
$ wget -c https://download.geofabrik.de/asia/indonesia/kalimantan-latest.osm.pbf

Tunggu proses download selesai, setelah itu pastikan file .osm.pbf sudah berada di dalam direktori geofabrik/.

Berikut adalah struktur direktori yang diharapkan setelah menambahkan file .osm.pbf:

geofabrik/
└── kalimantan-latest.osm.pbf
docker-compose.yml

Sip, sekarang file .osm.pbf sudah siap untuk digunakan dalam proses import data oleh Nominatim.

3. Jalankan Docker Compose

Setelah membuat file docker-compose.yml, jalankan perintah berikut untuk menjalankan Nominatim service:

$ docker-compose up -d

PERHATIAN

Untuk pertama kali menjalankan docker compose, Nominatim service akan melakukan proses import data dari file .osm.pbf ke dalam Nominatim, proses ini membutuhkan waktu yang cukup lama, tergantung pada ukuran file .osm.pbf yang digunakan. Untuk file kalimantan-latest.osm.pbf yang berukuran 138 MB, proses import data bisa memakan waktu sekitar 30 menit hingga 1 jam.

Untuk melihat log dari container, bisa menggunakan perintah berikut:

$ docker compose logs nominatim -f

Tunggu proses import data selesai. Biasanya akan muncul log seperti berikut ketika proses import data sudah selesai:

--> Nominatim is ready to accept requests

Setelah proses import data selesai, Nominatim service sudah siap untuk digunakan. Nominatim API bisa diakses melalui http://localhost:8080/.

4. Coba Nominatim API

Setelah Nominatim service sudah siap, coba akses Nominatim API untuk melakukan forward geocoding dan reverse geocoding.

/status

Pertama-tama coba cek statusnya dulu.

$ curl http://localhost:8080/status

Outputnya,

OK

Atau kalau mau outputnya dalam JSON,

$ curl http://localhost:8080/status?format=json

Outputnya,

{
  "status": 0,
  "message": "OK",
  "data_updated": "2026-01-21T12:30:08+00:00",
  "software_version": "5.2.0",
  "database_version": "5.2.0-0"
}

/search (Forward Geocoding)

Coba lakukan forward geocoding untuk mencari lokasi berdasarkan nama tempat atau alamat. Misalnya, mencari lokasi “jakarta”.

$ curl "http://localhost:8080/search?q=jakarta&format=json"

Outputnya,

[
  {
    "place_id": 144282,
    "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
    "osm_type": "way",
    "osm_id": 795600162,
    "lat": "-0.5354329",
    "lon": "117.0914415",
    "category": "highway",
    "type": "residential",
    "place_rank": 26,
    "importance": 0.0533433333333333,
    "addresstype": "road",
    "name": "Jakarta",
    "display_name": "Jakarta, Loa Bakung, Sungai Kunjang, Samarinda, Kalimantan Timur, 75391, Indonesia",
    "boundingbox": [
      "-0.5355636",
      "-0.5353021",
      "117.0914346",
      "117.0914483"
    ]
  }
]

Wah! Ternyata ada daerah beranama “Jakarta” di Kalimantan Timur.

/revers (Reverse Geocoding)

Coba lakukan reverse geocoding untuk mencari nama tempat atau alamat berdasarkan koordinat geografis (latitude & longitude). Misalnya, mencari lokasi berdasarkan koordinat -0.5354329,117.0914415 (koordinat Balikpapan).

$ curl "http://localhost:8080/reverse?lat=-1.2398711&lon=116.8593379&format=json"

Outputnya,

{
  "place_id": 144282,
  "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
  "osm_type": "way",
  "osm_id": 795600162,
  "lat": "-0.5354329",
  "lon": "117.0914415",
  "class": "highway",
  "type": "residential",
  "place_rank": 26,
  "importance": 0.0533433333333333,
  "addresstype": "road",
  "name": "Jakarta",
  "display_name": "Jakarta, Loa Bakung, Sungai Kunjang, Samarinda, Kalimantan Timur, 75391, Indonesia",
  "address": {
    "road": "Jakarta",
    "village": "Loa Bakung",
    "city_district": "Sungai Kunjang",
    "city": "Samarinda",
    "state": "Kalimantan Timur",
    "ISO3166-2-lvl4": "ID-KI",
    "postcode": "75391",
    "country": "Indonesia",
    "country_code": "id"
  },
  "boundingbox": [
    "-0.5355636",
    "-0.5353021",
    "117.0914346",
    "117.0914483"
  ]
}

/lookup

Coba lakukan lookup untuk mencari informasi lokasi berdasarkan OSM ID. Misalnya, mencari informasi lokasi berdasarkan OSM ID 795600162. Ini adalah OSM ID dari hasil pencarian sebelumnya untuk lokasi “jakarta” di Kalimantan Timur.

$ curl "http://localhost:8080/lookup?osm_ids=W795600162&format=json"

Outputnya,

[
  {
    "place_id": 144282,
    "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
    "osm_type": "way",
    "osm_id": 795600162,
    "lat": "-0.5354329",
    "lon": "117.0914415",
    "class": "highway",
    "type": "residential",
    "place_rank": 26,
    "importance": 0.0533433333333333,
    "addresstype": "road",
    "name": "Jakarta",
    "display_name": "Jakarta, Loa Bakung, Sungai Kunjang, Samarinda, Kalimantan Timur, 75391, Indonesia",
    "address": {
      "road": "Jakarta",
      "village": "Loa Bakung",
      "city_district": "Sungai Kunjang",
      "city": "Samarinda",
      "state": "Kalimantan Timur",
      "ISO3166-2-lvl4": "ID-KI",
      "postcode": "75391",
      "country": "Indonesia",
      "country_code": "id"
    },
    "boundingbox": [
      "-0.5355636",
      "-0.5353021",
      "117.0914346",
      "117.0914483"
    ]
  }
]

/details

Coba lakukan details untuk mencari informasi lokasi berdasarkan OSM ID, dengan informasi yang lebih detail dibandingkan dengan /lookup. Misalnya, mencari informasi lokasi berdasarkan OSM ID 795600162.

$ curl "http://localhost:8080/details?osmtype=W&osmid=795600162&format=json"

Outputnya,

{
  "place_id": 144282,
  "parent_place_id": 142133,
  "osm_type": "W",
  "osm_id": 795600162,
  "category": "highway",
  "type": "residential",
  "admin_level": 15,
  "localname": "Jakarta",
  "names": {
    "name": "Jakarta"
  },
  "addresstags": {},
  "calculated_postcode": "75391",
  "country_code": "id",
  "indexed_date": "2026-02-08T13:11:46.748639+00:00",
  "importance": 0.0533433333333333,
  "calculated_importance": 0.0533433333333333,
  "extratags": {},
  "rank_address": 26,
  "rank_search": 26,
  "isarea": false,
  "centroid": {
    "type": "Point",
    "coordinates": [
      117.0914415,
      -0.5354329
    ]
  },
  "geometry": {
    "type": "Point",
    "coordinates": [
      117.0914415,
      -0.5354329
    ]
  }
}

5. Stop Docker Compose

Jika sudah selesai menggunakan Nominatim service, bisa stop Docker Compose dengan perintah berikut:

$ docker-compose down

Kesimpulan

Dalam artikel ini, saya telah mendokumentasikan cara menjalankan OpenStreetMap Nominatim menggunakan Docker, mulai dari membuat Docker Compose, mempersiapkan file .osm.pbf, menjalankan Docker Compose, mencoba Nominatim API, hingga menghentikan Docker Compose. Dengan menggunakan Docker, proses setup Nominatim menjadi lebih mudah dan cepat, tanpa perlu repot mengatur lingkungan dan dependensi secara manual.

Pada artikel selanjutnya, saya akan mendokumentasikan cara menggunakan Nominatim self-hosted pada Geocoder gem untuk melakukan geocoding dan reverse geocoding di aplikasi Ruby on Rails, “Menggunakan Nominatim Self-Hosted pada Geocoder Gem”

Referensi

1. https://nominatim.openstreetmap.org/ui/about.html
   Diakses tanggal: 2026-02-07

2. https://nominatim.org/release-docs/develop/api/Overview/
   Diakses tanggal: 2026-02-07

QnA ini di-request oleh mas Rizky Ramadhan via email. Pertanyaan ini diajukan sekitar tahun 2023. Ia bertanya sebagian besar terkait dengan Ruby on Rails. Saya merasa pertanyaan dan jawaban ini akan memberikan lebih banyak manfaat jika dipublikasikan. Semoga bermanfaat yaa.

PERHATIAN

Saya kesulitan mencari alamat email dari mas Rizky Ramadhan, jika mas Rizky membaca ini dan tidak berkenan untuk mempublikasikan tulisan ini, boleh hubungi saya via email yaa.

Question: from Rizky Ramadhan

Halo, mas. Perkenalkan, saya Rizky, baru lulus tahun ini, sekarang sudah bekerja, sekitar 1 bulan lebih dikit. Kalau di kantor biasa pakai Yii, untuk hobi saya suka Laravel. Mau tanya soal Ruby on Rails.

Kemarin saya sudah menonton tutorial Ruby on Rails dari Padang Tekno di YouTube, lumayan sulit juga nyari tutorial yang up to date, kebanyakan 3 tahun / 5 tahun yang lalu.

Kalau dari yang saya pahami, konsep Rails dan Laravel lumayan mirip. Apa yang bisa dilakukan Rails, bisa juga dilakukan Laravel. Meskipun, kalau soal syntax, Ruby lebih elegan.

Jadi, pertanyaannya:

1. Apa yang bikin bertahan dengan Rails sampai hari ini mas?
2. Kelebihan apa yang dimiliki Rails sehingga memudahkan pada saat bekerja?
3. Fitur apa yang dimiliki Rails sehingga sulit untuk pindah ke framework lain?

Saya tertarik buat nyoba Rails, mas. Cuman, belum click di mana “magic” nya, selain syntax yang elegan tadi.

Udah liat-liat comparison nya di internet, tapi sepertinya kebih baik bertanya langsung kepada sepuh. Makasih mas 🙏

Answer: from BanditHijo

Halo halo Rizky.

Selamat atas kelulusan dan sudah keterima bekerja. Mudah-mudahan berkah ilmunya yaa.

Sebelumnya, terima kasih yaa sudah mengajukan pertanyaan terkait Rails. Sebenernya saya belum bisa disebut sepuh Rails, karena baru pakai Rails dari tahun 2019-2021 (FullStack), 2022-2023 (Backend). Wkwkwk.

Q: Apa yang bikin bertahan dengan Rails sampai hari ini?

Mungkin karena masih bekerja pakai Rails dan belum ketemu kesulitan dan jalan buntu ketika digunakan saat bekerja. Masih happy pakai Rails.

Q: Kelebihan apa yang dimiliki Rails sehingga memudahkan pada saat bekerja?

Kelebihan-kelebihan yang saya rasakan ketika pakai Rails saat bekerja:

1. Rails ini framework yang bersifat Opinionated. Artinya sudah ada aturan yang disepakati (secara umum) untuk melakukan suatu pekerjaan yang umum (biasa disebut Best Practice). Kalau bekerja dalam tim, sifat opinionated ini yang mempermudah dan mempercepat menyelesaikan suatu task. Karena kita tidak perlu lagi memperdebatkan mana cara penyelesaian masalah yang baik. Kecuali ada kondisi-kondisi tertentu yang disepakai oleh tim untuk tidak menggunakan “best practice” karena kebutuhan tertentu.

2. Proses menyelesaikan task menjadi lebih cepat karena beberapa flow bisnis, sudah ada dan sudah dibuatkan best practicenya, jadi tidak perlu lagi memperdebatkan flow bisnis yang sudah umum. Tinggal pakai saja kalau memang tidak ada kebutuhan khusus.

   Dengan begini, perdebatan terkait hal-hal teknis, yang umumnya terjadi di tempat kami:

   • Nama tabel di Rails, sudah dikonvensikan kalau nama tabel harus kata benda yang plural
   • Penggunaan HTTP method harus mengikuti aturan RESTful API. Dimana ketika membuat endpoint harus menggunakan HTTP method yang sesuai untuk fungsi yang sesuai (GET/POST/PATCH/PUT/DELETE).

3. Metaprogramming. Ruby memiliki kemampuan metaprogramming yang diadopsi oleh Rails untuk mempermudah proses pembuatan aplikasi.

   Terkait metraprogramming di Rails, ada banyak sekali, tapi yang baru-baru aja (inget) saya pakai yang seperti ini:

   • Active Model Dirty https://api.rubyonrails.org/classes/ActiveModel/Dirty.html
     Saya pakai untuk membuat callback, ketika suatu atribute (misal: name) berubah nilainya.

   • Active Record Nested Attributes https://api.rubyonrails.org/classes/ActiveRecord/NestedAttributes/ClassMethods.html
     Saya pakai untuk membuat data child yang berasosiasi dengan parent. Jadi ketika parentnya dibuat, child nya juga ikut terbut. Misal: membuat admin (parent) baru dengan beberapa admin_permission (child).

   2 method di atas, terdengar biasa aja. Tapi kalau dilihat kodenya, hal-hal tersebut dapat dilakukan hanya dengan kode yang simple tanpa perlu banyak effort.

   Hal lain seperti migrasi dan relasi tabel juga pakai metaprogramming, sehingga ada method-method yang secara ajaib sudah ada dan tinggal dipakai.

   Kebetulan kemarin sempet lihat topik terkait “Powerful Rails Feature You Might Not Know” dari Chris Oliver di Rails World 2023, bisa coba tonton di sini yaa https://www.youtube.com/watch?v=iPCqwZ9Ouc4

4. Dokumentasi yang dimiliki Rails juga terbilang rapi dan deskriptif. Mulai dari dokumentasi Rails yang ada di https://guides.rubyonrails.org/, sampai dokumentasi Rails API yang ada di https://api.rubyonrails.org/

5. Rails sebenarnya kumpulan dari beberapa module (library) yang modular yang didesain untuk memiliki intarface yang agnostic. Jadi bisa pakai engine (backend) apa saja. Misal, untuk Active Job kita bisa pakai Sidekiq, Resque, Sneakers, Delayed Job, Good Job, dll. https://edgeguides.rubyonrails.org/active_job_basics.html#starting-the-backend Tapi dengan interface yang sama. Jadi meskipun backend job nya bisa berbeda, tapi interface nya tetep sama (nama pemanggilan method nya sama). Terkait Rails dan modularitynya, bisa tonton dari salah satu Rails Core, Eileen Uchitelle di Keynote RailsConf 2023 https://www.youtube.com/watch?v=TKulocPqV38.

Q: Fitur apa yang dimiliki Rails sehingga sulit untuk pindah ke framework lain?

Jujurly saya belum pernah coba framework lain selama Rails, jadi belum bisa kasih jawaban.

Rails ini framework yang sudah lama, sudah mature dalam artian sudah banyak digunakan untuk menyelesaikan beberapa bisnis flow. Yang kemudian flow tersebut dibakukan dalam bentuk method, sehingga tinggal kita pakai dan panggil saja. Tentunya ketersediaan built-in class dan method ini dan hal-hal yang berkaitan dengan jawaban sebelumnya juga yang membuat proses penyelesaian suatu problem menjadi lebih cepat.

Kira-kira ini sedikit yang bisa saya sharing terkait Rails dari pengalaman selama menggunakan Rails untuk kerjaan.

Untuk sekarang, dikerjaan, saya lebih banyak pakai Rails sebagai Backend saja. Jadi tidak menjadikan Rails sebagai FullStack. Maka dari itu, jawaban dan ilustrasi yang kuberikan, terbatas di Rails sebagai Backend (sudut pandang fitur-fitur yang memudahkan pekerjaan di Backend). Tentunya tidak sebanding dengan orang yang menjadikan Rails sebagai Fullstack. Karena di bagian Frontend juga terdapat method-method helper yang banyak memudahkan untuk mempercepat proses pembuatan tampilan web.

Untuk kedepannya, saya juga masih sambil belajar JavaScript. Pengetahuan JavaScript sebagai Rails Developer tentu akan sangat membantu, dibandingkan dengan Rails Developer yang tidak memiliki pengetahuan tentang JavaScript sama sekali.

Mudah-mudahan jawaban saya sudah menjawab 3 pertanyaan yang diajukan yaa.

AsciiDoc adalah bahasa markup teks ringan yang digunakan untuk menulis dokumentasi, artikel, buku, dan konten lainnya. Mirip dengan Markdown, AsciiDoc memungkinkan penulis untuk membuat dokumen yang mudah dibaca dan ditulis dalam format teks biasa, yang kemudian dapat dikonversi ke berbagai format output seperti HTML, PDF, dan ePub.

INFO

“AsciiDoc is a plain text markup language for writing technical content. It’s packed with semantic elements and equipped with features to modularize and reuse content. AsciiDoc content can be composed using a text editor, managed in a version control system, and published to multiple output formats.” - AsciiDoc.org

Awal Mula Bertemu AsciiDoc

Awal mula saya bertemu dengan Markup Language ini adalah ketika saya membeli sebuah ebook berjudul “Pemrogram Rp 100 Juta: Panduan Bagi Pemrogram Untuk Menggapai Harga, Tahta, dan Kemasyhuran” oleh Arjuna Sky Kok pada tahun 2020.

Saat itu kami diberikan akses ke private repositori GitHub tempat buku tersebut disimpan, dan saya menemukan bahwa buku tersebut ditulis menggunakan AsciiDoc. Saat itu saya berfikir, “Wah! Keren sekali bisa membuat sebuah dokumen atau buku menggunakan bahasa markup seperti ini.” – Saat itu saya belum mengenal LaTeX. Karena yang saya tahu, untuk membuat dokumen atau buku perlu menggunakan aplikasi pengolah kata seperti Microsoft Word atau LibreOffice Writer atau dengan aplikasi desktop publishing seperti Adobe InDesign atau Scribus.

Dikemudian hari, ternyata saya cukup sering menemukan proyek-proyek open source yang menggunakan AsciiDoc untuk dokumentasi mereka, seperti proyek-proyek yang menggunakan Asciidoctor sebagai tool untuk mengkonversi dokumen AsciiDoc ke format lain. Beberapa diantaranya seperti:

1. GitHub: Book: Api on Rails 6 (AsciiDoc + Asciidoctor)
2. FedoraProject Docs: GitLab: Fedora Linux Documentation Home (AsciiDoc + Antora + Asciidoctor)

PERTANYAAN

Apa perbedaan AsciiDoc dan Asciidoctor?

AsciiDoc adalah markup language yang digunakan untuk menulis dokumen, sedangkan Asciidoctor adalah tool atau perangkat lunak yang digunakan untuk mengkonversi dokumen AsciiDoc ke berbagai format output seperti HTML, PDF, ePub, dan lainnya.

Apakah tidak cukup dengan Markdown?

Markdown memang sudah sangat populer dan banyak digunakan untuk menulis dokumentasi, artikel, dan konten lainnya. Namun, AsciiDoc menawarkan beberapa kelebihan dibandingkan Markdown, terutama untuk dokumentasi teknis yang kompleks. Beberapa kelebihan AsciiDoc dibandingkan Markdown antara lain:

1. Fitur yang Lebih Lengkap
   AsciiDoc memiliki fitur yang lebih lengkap dibandingkan Markdown, seperti dukungan untuk tabel, blok kode dengan penyorotan sintaks, catatan kaki, dan lainnya.
2. Mudah Dibaca dan Ditulis
   AsciiDoc dirancang agar mudah dibaca dalam format teks biasa, sehingga penulis dapat fokus pada konten tanpa terganggu oleh format yang rumit.
3. Fleksibilitas Format Output
   AsciiDoc dapat dikonversi ke berbagai format output seperti HTML, PDF, ePub, dan lainnya menggunakan tool seperti Asciidoctor.
4. Dukungan untuk Modularisasi Konten
   AsciiDoc mendukung modularisasi konten, sehingga penulis dapat mengelola dokumen yang besar dengan lebih efisien.
5. Integrasi dengan Development Tool
   AsciiDoc sering digunakan dalam proyek perangkat lunak untuk dokumentasi, dan dapat diintegrasikan dengan development tool seperti Git dan CI/CD.

Contoh Dokumen AsciiDoc

= Title of the document
Rizqi Nur Assyaufi <bandithijo@example.mail>
:source-highlighter: rouge
:icons: font
:toc: macro
:toc-title:

== Table of contents

toc::[]

Gambar 1. Table of Contents dan Judul Dokumen

== Section

Hi, my name is {author}. I'm a Backend Software Engineer at Small Startup footnote:[Startup is a new company, often technology-focused, designed for rapid growth by validating a scalable business model, seeking external funding (like venture capital), and aiming to disrupt existing markets with innovative products or services — Wikipedia] in Jakarta that are working remotely from Balikpapan. Feel free to ask me anything about Software Develop-thing or Linux-thing on {email}.

*This is bold text*

_This is cursive text_

`This is mono text`

Gambar 2. Paragraf dengan format teks

== List

Docker allows to package the full stack in a container:

* OS
** Windows
** Ubuntu
* JVM,
* App server
* Application with its configuration

Gambar 3. Nested list

== Block quotes

[quote, Ben Parker, Spiderman Movie]
____
With great power comes great responsibility.
____

Gambar 4. Block quote

== Defining cross references

You can assign meta data to a block. Here’s an example of a quote block that includes all types of metadata:

[source, ruby, linenums]
----
class Cat <1>
  def meow <2>
    puts "Meow!" <3>
  end
end

cat = Cat.new <4>
cat.meow <5>
----
<1> class definition
<2> method definition
<3> output statement
<4> creating an instance of the class
<5> calling the method

Gambar 5. Cross reference in code block

== Admonition paragraphs and blocks for warnings, notes and tips

An admonition paragraph draws the reader’s attention to certain information. It can be defined by a predefined label at the beginning of the paragraph or as a block.

Here are the other built-in admonition types:

NOTE: Some additional info...

TIP: Pro tip...

IMPORTANT: Don't forget...

WARNING: Watch out for...

CAUTION: Ensure that...

Gambar 6. Admonition blocks

Hi, my name is {author}. I'm a Backend Software Engineer at Small Startup footnote:[Startup is a new company, often technology-focused, designed for rapid growth by validating a scalable business model, seeking external funding (like venture capital), and aiming to disrupt existing markets with innovative products or services — Wikipedia] in Jakarta that are working remotely from Balikpapan. Feel free to ask me anything about Software Develop-thing or Linux-thing on {email}.

Gambar 7. Footnote example

Lalu dengan menggunakan tool Asciidoctor, dokumen tersebut dapat dieksport ke dalam format PDF.

$ asciidoctor-pdf sample_document.adoc

Maka akan menghasilkan file sample_document.pdf yang berisi dokumen yang sudah terformat dengan baik.

Gambar 8. Hasil eksport dokumen ke format PDF halaman 1

Gambar 9. Hasil eksport dokumen ke format PDF halaman 2

Dapat dilihat dari contoh-contoh di atas, dokumen yang dihasilkan memiliki format yang rapi dan terlihat profesional.

Sintaks AsciiDoc juga mendukung berbagai elemen seperti judul, paragraf, list, blok kode, quote, cross reference, footnote, table of contents, dan blok peringatan (admonition blocks) untuk menyoroti informasi penting.

Dokumen di atas hanyalah contoh sederhana dari apa yang dapat dilakukan dengan AsciiDoc. Untuk membuat menjadi layout buku juga tinggal menggunakan dokumen type book.

Komentar Penulis

Bukan saya alergi dengan WYSIWYG editor seperti Ms.Word atau LO Writer, tapi “menurut keyakinan saya”, menulis dokumen teknis lebih efisien dengan AsciiDoc. Kita tinggal mengisi konten saja dengan notasi-notasi (sintaks) yang sesuai, processor yang akan merender menjadi format yang sesuai. Tidak perlu formatting text manual.

Kalau membuat dokumen teknis itu 50% nya menulis konten dan 50% nya lagi formatting text. Maka dengan AsciiDoc, kita bisa 90% fokus menulis kontent dan 10% nya konfigurasi template awal.

Bahkan jika konfigurasi templatenya sudah jadi, “menurut keyakinan saya” malah bisa 100% tinggal menulis konten saja.

Penutup

Dengan fitur-fitur yang lengkap dan fleksibilitasnya, AsciiDoc menjadi pilihan yang menarik untuk menulis dokumentasi teknis.

Untuk informasi lebih lanjut tentang AsciiDoc, Anda dapat mengunjungi situs resminya atau dokumentasi Asciidoctor yang saya sertakan pada bagian referensi di bawah.

Referensi

1. https://asciidoc.org/
   Tanggal diakses: 2026-01-18

2. https://docs.asciidoctor.org/asciidoc/latest/
   Tanggal diakses: 2026-01-18

3. https://asciidoctor.org/
   Tanggal diakses: 2026-01-18

Di pertengahan tahun 2025, saya memutuskan untuk membuat perubahan besar pada cara saya menulis artikel di blog ini. Setelah beberapa tahun menggunakan berbagai notasi syntax, saya merasa perlu untuk menyederhanakan proses penulisan agar tetap mempertahankan mood dalam menulis. Oleh karena itu, pada BanditHijo Versi 3, saya berfokus pada penggunaan CommonMark specification sebagai standar penulisan artikel.

Format Penulisan dari Versi ke Versi

Sedikit kilas balik, pada versi pertama blog ini [1], saya menggunakan modifikasi tag/notasi markdown yang cukup kompleks untuk menulis artikel. Hal ini membuat proses penulisan menjadi lebih rumit dan terkadang mengganggu alur kreatif saya.

Versi Pertama (Markdown + Jekyll Custom Tags)

Gambar 1. BanditHijo’s Blog versi pertama

Sebagai gambaran, seperti ini Jekyll custom tag yang saya gunakan pada versi pertama:

1. Jika ingin menuliskan shell dengan user prompt:

   {% shell_user %}
   sudo pacman -Syu
   {% endshell_user %}
   

   $ sudo pacman -Syu
   

2. Jika ingin menuliskan shell dengan custom prompt:

   {% shell_term postgres> %}
   CONNECT my_database;
   {% endshell_term %}
   

   postgres> CONNECT my_database;
   

3. Jika ingin memasukkan gambar:

   {% image https://image.url/123/image_01.png | 1 %}
   

4. Jika ingin memasukkan gambar dengan caption:

   {% image https://image.url/123/image_01.png | 1 | Caption di sini %}
   

Dan masih banyak lagi notasi khusus yang saya pergunakan pada versi pertama. Artikel lengkapnya bisa di baca di sini: Membuat Jekyll Custom Tags dengan Liquid Tags.

Pada mulanya, saya merasa bahwa dengan menggunakan custom tag/notasi markdown tersebut, saya dapat menulis artikel dengan lebih ekspresif. Namun, seiring berjalannya waktu, saya menyadari bahwa kompleksitas tersebut justru menghambat proses penulisan saya.

Versi Kedua (AsciiDoc)

Saya juga sempat mencoba merubah format artikel di versi kedua [2], yang tadinya menggunakan Markdown pada versi pertama, saya ubah menjadi AsciiDoc. Pertimbangan saya menggunakan AsciiDoc, karena blog saya sebagian besar berisi hal-hal teknis. Sehingga cocok menggunakan notasi AsciiDoc yang luwes untuk dokumen teknis.

Gambar 2. BanditHijo’s Blog versi kedua

Namun, setelah mencoba beberapa waktu, dan memigrasikan beberapa artikel saya, proses build menjadi lebih lambat dan proses menulis menggunakan AsciiDoc ternyata tidak semudah yang saya bayangkan. Akhirnya, saya memutuskan untuk kembali lagi menggunakan versi pertama.

AsciiDoc memang memiliki kelebihan dalam hal penulisan dokumen teknis, namun untuk blog pribadi yang lebih banyak berisi artikel ringan dan tutorial, saya merasa bahwa Markdown lebih sesuai dengan kebutuhan saya. Tapi, saya masih tetap menggunakan AsciiDoc untuk membuat dokumentasi teknis yang saya berikan untuk pihak lain. Karena membuat dokumentasi teknis dengan AsciiDoc sangat efisien. Karena hanya cukup menyediakan template dokumen, kemudian tinggal menulis kontennya saya, lalu build menjadi dokumen.

Saya menggunakan AsciiDoctor sebagai tool untuk formatingnya, dan AsciiDoctor PDF untuk merubah menjadi format PDF. Keduanya adalah tool yang sangat powerful untuk membuat dokumentasi teknis.

AsciiDoc menurut saya levelnya berada di antara Markdown dan LaTeX. Jika Markdown terlalu sederhana, dan LaTeX terlalu kompleks, maka AsciiDoc adalah solusi di tengah-tengahnya.

Versi Ketiga (CommonMark Specification)

Seiring berjalannya waktu, saya menyadari bahwa semakin sederhana proses penulisan, semakin bersemangat saya untuk menulis. Karena custom tag/notasi markdown yang saya gunakan pada versi pertama justru membuat proses menulis menjadi lebih rumit dan mengganggu alur kreatif saya. Meskipun saya sudah menggunakan snippet code di Neovim untuk mempercepat penulisan, tetap saja prosesnya terasa kurang praktis buat saya.

Maka dari itu, di pertengahan tahun 2025, saya memutuskan untuk membuat perubahan besar pada cara saya menulis artikel di blog ini. Setelah beberapa tahun menggunakan berbagai notasi syntax, saya merasa perlu untuk menyederhanakan proses penulisan agar tetap mempertahankan mood dalam menulis. Oleh karena itu, pada BanditHijo Versi 3, saya berfokus pada penggunaan CommonMark specification sebagai standar penulisan artikel.

Ada beberapa keuntungan yang saya dapatkan dengan mengikuti CommonMark specification:

1. Sederhana dan Efisien: Proses penulisan menjadi lebih cepat dan efisien karena saya tidak perlu mengingat berbagai custom tag/notasi markdown yang rumit.
2. Konsistensi: Artikel-artikel di blog ini menjadi lebih konsisten dalam formatnya, sehingga pembaca dapat dengan mudah memahami konten tanpa terganggu oleh variasi notasi.
3. Fokus pada Konten: Saya dapat lebih fokus pada isi artikel tanpa harus terganggu oleh aspek teknis penulisan.
4. Kompatibilitas: Dengan mengikuti standar yang umum digunakan, artikel-artikel di blog ini lebih mudah diakses dan dibaca di berbagai platform dan perangkat. Misalnya, jika saya ingin memigrasikan blog ini ke platform lain di masa depan, prosesnya akan lebih mudah karena artikel-artikel sudah mengikuti standar yang umum. Selain itu juga jadi lebih kompatibel dengan berbagai tool yang mendukung Markdown seperti saat dibaca oleh RSS reader, atau saat diimport ke aplikasi note-taking seperti Obsidian, Notion, dsb.

Untuk menjaga konsistensi format penulisan, saya mendokumentasikan rules dalam menulis di sini “Writing Rules” yang berisi panduan menulis artikel di blog ini.

Saya berusaha semaksimal mungkin mengikuti CommonMark specification dan seminimal mungkin menggunakan modifikasi tag/notasi markdown dalam menulis artikel.

Thema Baru di Blog BanditHijo versi 3

Saya menggunakan thema baru yang lebih minimalis dan fokus pada konten artikel.

Kali ini saya tidak lagi menggunakan plain CSS yang dibuat sendiri seperti pada versi sebelumnya, melainkan menggunakan framework CSS bernama Tailwind CSS. Framework ini memungkinkan saya untuk membuat desain yang responsif dan modern dengan lebih mudah.

Gambar 3. BanditHijo’s Blog versi ketiga

Assets Management

Sebelumnya, pada versi pertama, saya menyimpan semua gambar di layanan pihak ketiga, seperti postimages.org. Pada mulanya, saya pikir gambar akan membuat repo blog ini menjadi gemuk dan sulit di-manage. Namun, setelah mempertimbangkan berbagai aspek, saya memutuskan untuk menyimpan semua gambar langsung di dalam repository blog ini. Ceritanya bisa dibaca di sini, Preferensi Saya dalam Menyimpan Assets Gambar di Jekyll.

Untuk manajemen assets seperti gambar, saya membuat struktur direktori yang lebih terorganisir di dalam repository blog ini. Setiap artikel memiliki direktori khusus untuk menyimpan gambar dan file terkait lainnya. Hal ini memudahkan saya dalam mengelola assets baik berupa gambar maupun file lainnya.

📂 _posts/
└ 📂 blog/
  └ 📂 2025/
    └ 📄 2025-12-29-ruby-programmers-best-friend.md 👈 artikel
📂 assets/
│ 📁 css/
│ 📂 images/
└ 📂 posts/
  └ 📂 blog/
    └ 📂 2025/
      └ 📂 2025-12-29-ruby-programmers-best-friend/ 👈 direktori assets
        │ 📄 file-01.pdf
        │ 📄 gambar-01.png
        └ 📄 gambar-02.png
⚙️ _config.yml
📄 index.markdown
📄 README.md

Kemudian pada front matter artikel, saya menambahkan variabel assets yang berisi path ke direktori assets artikel tersebut. Sehingga saat menulis artikel, saya hanya perlu merujuk ke variabel assets untuk menyisipkan gambar atau file lainnya.

---
layout: "post"
title: "Ruby, Programmer's Best Friend"
date: "2025-12-29 08:00"
permalink: "/blog/:title"
assets: "/assets/posts/blog/2025/2025-12-29-ruby-programmers-best-friend" # 👈 direktori assets
author: "BanditHijo"
category: "blog"
tags: ["ruby"]
description: "Ruby adalah bahasa pemrograman yang dirancang untuk kemudahan dan produktivitas."
---

Kemudian pada artikel, saya dapat mengakses variabel assets dengan {{ page.assets }}.

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

![Gambar 1]({{ page.assets }}/gambar-01.png)

![Gambar 2]({{ page.assets }}/gambar-02.png)

Lorem ipsum dolor sit amet, consectetur adipiscing elit, [Download File 1]({{ page.assets }}/file-01.pdf).

Dengan pendekatan ini, saya mendapatkan beberapa keuntungan, di antaranya:

1. Terstruktur dengan baik
   Setiap artikel memiliki direktori gambar sendiri yang terorganisir berdasarkan kategori dan tanggal postingan.
2. Mudah untuk dikelola
   Jika saya perlu mengubah nama file gambar atau menghapus gambar tertentu, saya hanya perlu mengakses direktori gambar yang sesuai dengan artikel tersebut tanpa harus mencari di seluruh project.
3. Fleksibel untuk berbagai jenis file
   Saya dapat menyimpan berbagai jenis file (gambar, PDF, dokumen, dll) di dalam direktori yang sama tanpa harus bergantung pada layanan pihak ketiga.

Penutup

Tak terasa sudah sejak 2018 saya menulis di blog ini dengan berbagai format penulisan. Dari mulai menggunakan custom tag/notasi markdown di versi pertama, mencoba AsciiDoc di versi kedua, hingga akhirnya kembali ke Markdown dengan mengikuti CommonMark specification di versi ketiga ini.

Dengan perubahan ini, saya berharap dapat lebih fokus pada konten artikel tanpa terganggu oleh aspek teknis penulisan.

Terima kasih saya ucapkan untuk teman-teman yang telah mengikuti perjalanan blog ini hingga versi ketiga. Terima kasih karena telah memberikan testimonial dan feedback dalam beberapa kesempatan ketika berinteraksi dengan saya, baik secara langsung maupun tidak langsung melalui media sosial dan juga email. Saya senang jika blog ini dapat memberikan manfaat dan inspirasi buat teman-teman yang membacanya.

Mumpung masih awal tahun, saya mengajak teman-teman, “Ayo nulis blog juga yaa!”

Referensi

1. https://github.com/bandithijo/bandithijo.github.io_v1
   Tanggal diakses: 2026-01-16

2. https://github.com/bandithijo/bandithijo.github.io_v2
   Tanggal diakses: 2026-01-16

3. https://github.com/bandithijo/bandithijo.github.io_v3
   Tanggal diakses: 2026-01-16