Kebanyakan kerja kini lebih kepada membuat coaching (peserta bina aplikasi dengan saya menasihati apabila perlu) dan memberi latihan (saya mengajar, orang lain dengar). Adalah kebiasaan mengikut kehendak peserta untuk diberikan nota untuk dijadikan rujukan dikemudian hari.
Menyediakan nota untuk latihan kod bagi saya sangat mudah menggunakan markdown. Markdown juga adalah hasil pemikiran pengaturcara bukan? Tetapi jika mereka tidak menggunapakai sublimetext 3 ataupun apa-apa editor/site yang memberikan paparan markdown yang elok, format agak hambar.
Of course, mereka juga minta dalam bentuk ms-word document jadi...
Berbekal hasil carian google, saya diperkenalkan dengan pandoc. Ianya tool mudah untuk convert satu-satu format ke format yang lain. Termasuk Markdown ke MsWord!
Hasilnya (mohon abaikan salah silap pada nota contoh dibawah. Mengantuk dan nak cepat) ...
Sebelum:
Selepas:
Siap heading text ada kaler-kaler.
Jadi saya dapat fokus kepada mengcopy-paste menaip kod dan menceritakan apa ada pada kod-kod itu.
Sukar ke menggunakan pandoc? Selepas install, saya cuma run command dibawah:
pandoc -o codeigniterTraining.docx -f markdown -t docx Note.md
Setelah lebih kurang 13 saat kemudian, nota codeigniter siap dan boleh terus dihantar ke client dengan husnuzon semua okay saja.
Oldest comments (1)
ya, perlu husnuzon. hahah. anyway, thanks for the tip. senang kerja lepas ni nk buat documentation terus ke word.