Mengkonversi Dokumen, Manual ke format Drupal Book

Saya baru saja mencoba mengkonversi Drupal Manual yang terdiri dari beberapa modul tambahan seperti:

1. Logintoboggan, modul agar pengguna dapat login secara otomatis atau menginput password langsung saat registrasi.
2. Chatbox, modul untuk chatting dengan pengguna lain.
3. Forward, modul untuk membuat link agar halaman/node dapat direferensikan ke orang lain, biasanya fitur ini disebut “tell a friend“
4. Image Gallery, modul untuk membuat galeri gambar
5. TinyMCE, modul untuk membuat rich text editor menggunakan TinyMCE
6. IMCE, modul buat TinyMCE agar bisa langsung menyisipkan gambar ke halaman

Dengan semangat untuk saling berbagi, saya mau mengkonversi manual ini dalam format Microsoft Word ke HTML, kalau perlu tanpa input satu per satu halamannya. Nah, di Drupal ada modul bernama book. Modul ini memungkinkan kita untuk membuat satu buku secara kolaborasi dengan pengguna lain. Modul ini prinsip kerjanya sama dengan wiki, dimana semua pengguna yang diberi hak akses untuk mengedit buku, dapat mengedit/menambah isi dari satu atau lebih halaman buku tersebut.

Namun, saya tidak mau dong, kalau mesti input satu per satu. Drupal ternyata memiliki modul html2book. Coba download dan instal. Lebih baik untuk dapat menghapus dan membuat kode HTML lebih rapi, gunakan modul Html Corrector dan HTML Tidy. Saya pribadi menggunakan program kecil tidy di Linux untuk “membersihkan” kode-kode yang dihasilkan wordprocessor. Jika kamu menggunakan linux, coba lakukan hal berikut:

1. Buka dokumen dengan openoffice.org. Untuk pengguna Windows, pastinya menggunakan Microsoft Word (yang asli ya.. jangan yang bajakan :D).
2. Simpan dengan format HTML, misalnya dengan nama manual-raw.html
3. Nah jalankan program tidy, jika belum ada, install terlebih dahulu. Buat pengguna Debian/Ubuntu, cukup dengan:
   sudo apt-get install tidy
4. Lakukan perintah berikut:
   tidy -c -ashtml -utf8 manual-raw.html > output.html
5. Secara otomatis dokumen akan dirapikan dan hasilnya menjadi file output.html
6. dari file output ini, salin isinya (di dalam tag body) trus buat buku baru di Drupal. Paste isi manual ini ke dalam area teks.
7. Pada bagian bawah teks area, ada pilihan “Input split”, pilih “Create a new book page at each HTML heading”
8. Drupal akan otomatis membuat halaman berdasarkan heading yang dijumpainya, setelah itu selesai!

Perlu diingat bahwa manual yang kamu buat mesti menggunakan heading untuk judul, misalnya heading 1, heading 2, dst. Jika dikonversi menjadi HTML, maka heading tersebut akan berupa tag <h1>, <h2>, <h3> dst. Nah jika Drupal menjumpai tag ini, maka secara otomatis akan dibuatkan halaman baru dan dibuatkan link secara otomatis.

Kebiasaan buruk web developer atau siapapun itu menurut pengalaman saya adalah membuat judul untuk masing-masing section tidak menggunakan heading, tetapi menggunakan paragraf biasa dengan memperbesar ukuran font (font size) saja. Biasakan dengan membuat manual, dokumen atau apalah namanya dengan menggunakan heading untuk judul.

Contoh di weblog saya yang sudah jadi ada di drupal manual. Enjoy!