Mengubah Dokumen Dari Penurunan Harga Menjadi Format Microsoft Word

Di antara aktivitas lainnya, menulis dan mengedit dokumen teks termasuk dalam tindakan paling umum yang kami gunakan untuk komputer (desktop). Cara persisnya dilakukan mengikuti jalur yang berbeda — mulai dari menggunakan editor teks kosong seperti Vim hingga aplikasi grafis seperti Open/Libre Office atau service berbasis cloud yang dapat diakses melalui browser web seperti Google Docs. Kerugian kami, setiap alat dilengkapi dengan format dokumen aslinya sendiri serta pilihan format dokumen lain yang didukung. Kualitas konversi antara format ini sangat bervariasi, dan dapat menyebabkan banyak frustrasi saat melintasi batas format.

Dalam artikel ini kita telah melihat konversi antara Markdown [1] dan DOCX — format dokumen asli Microsoft Word yang digunakan sejak 2007. Anda mungkin bertanya-tanya mengapa penggemar Markdown dan Asciidoc (seperti saya) menangani kasus ini. Nah, berkolaborasi dengan sekelompok penulis lain dapat menyebabkan situasi dimana satu atau lebih peserta meminta DOCX sebagai format output. Jangan mengecewakan siapa pun, dan cari tahu batasan mana yang ada, sebagai gantinya, dan bagaimana kita bisa mencoba membuat semua anggota kelompok bahagia.

Apa itu Markdown?

Seperti yang telah ditunjukkan dalam “Pengantar Penurunan Harga” [2], maksud penurunan harga adalah konversi teks ke HTML sederhana. Ide di baliknya adalah membuat penulisan halaman web, dokumentasi dan terutama entri blog semudah menulis email. Sampai hari ini itu adalah sinonim de facto untuk kelas bahasa deskripsi markup yang ringan, dan tujuannya dapat dilihat telah tercapai.

Penurunan harga menggunakan sintaks pemformatan teks biasa. Dengan pendekatan serupa seperti HTML, sejumlah penanda menunjukkan judul, daftar, gambar, dan referensi dalam teks Anda. Beberapa baris di bawah ini menggambarkan dokumen dasar yang berisi dua judul (tingkat 1 dan 2) serta dua paragraf, dan lingkungan daftar.

# Recommended Places To Visit In Europe
 ## France
 This is a selection of places:
 * Paris (_Ile de France_)
 * Strasbourg (_Alsace_)
 For a proper visit plan about a week.

Konversi ke DOCX

Untuk mengonversi dokumen Markdown Anda ke DOCX, gunakan alat pandoc [3]. Pandoc adalah perpustakaan Haskell, dan menggambarkan dirinya sebagai “konverter dokumen universal”, atau “pisau tentara Swiss untuk konversi dokumen”. Ini tersedia untuk berbagai platform seperti Linux, Microsoft Windows, Mac OS X, dan BSD. Pandoc biasanya disertakan sebagai paket untuk distribusi Linux seperti Debian GNU/Linux, Ubuntu, dan CentOS.

Panggilan sederhana untuk konversi adalah sebagai berikut:

$ pandoc -o test.docx test.md

Parameter pertama `-o` merujuk ke file output, diikuti dengan nama file (`test.docx`). Ekstensi file membantu pandoc untuk mengidentifikasi format output yang diinginkan. Parameter kedua menamai file input — dalam kasus kami ini hanyalah `test.md`.

Versi panjang dari perintah yang ditampilkan di atas berisi dua parameter `-f markdown` dan `-t docx`. Yang pertama menyingkat istilah `flavour`, dan menjelaskan format file input. Yang kedua melakukan hal yang sama untuk file output, dan menyingkat `-to`.

Perintah lengkapnya adalah sebagai berikut:

$ pandoc -o test.docx -f markdown -t docx test.md

Membuka file yang dikonversi menggunakan Microsoft Word menghasilkan output berikut:

Untuk elemen teks yang berbeda, Pandoc menggunakan stylesheet. Ini memungkinkan Anda untuk menyesuaikan elemen-elemen ini nanti sesuai dengan kebutuhan Anda di seluruh dokumen. Versi Pandoc yang lebih baru juga menawarkan sebaliknya — Anda dapat mengonversi file DOCX menjadi penurunan harga sebagai berikut:

$ pandoc -o test.md test.docx

Kemudian, file yang dihasilkan memiliki konten berikut:

Recommended Places To Visit In Europe
 =====================================
 France
 ------
 This is a selection of places:
 -   Paris (*Ile de France*)
 -   Strasbourg (*Alsace*)
 For a proper visit plan about a week.

Opsi Baris Perintah yang Berguna

Daftar opsi Pandoc agak panjang. Yang berikut ini membantu Anda menghasilkan hasil yang lebih baik, dan membuat hidup Anda lebih mudah:

* `-P` (versi panjang `–preserve-tabs`): Pertahankan tab alih-alih mengonversinya menjadi spasi. Ini berguna untuk blok kode dengan garis indentasi yang merupakan bagian dari teks Anda.

* `-S` (versi panjang `–smart`): Menghasilkan output yang benar secara tipografis.

Opsi ini mengoreksi tanda kutip, tanda hubung/tanda hubung, serta elips (“…”). Ta
mbahan, spasi non-breaking ditambahkan setelah singkatan tertentu seperti “Mr.”.

* `–track-changes=value`: Menentukan apa yang harus dilakukan dengan penyisipan, penghapusan, dan komentar yang dihasilkan dengan bantuan fitur “Lacak Perubahan” Microsoft Word. Nilai dapat berupa menerima, menolak, atau semua untuk menyertakan atau menghapus perubahan yang dibuat dalam dokumen. Hasilnya adalah file datar.

Untuk opsi lebih lanjut, lihat dokumentasi, dan halaman manual Pandoc.