Cara Menggunakan Pandoc File Converter Di FreeBSD

Pandoc adalah alat baris perintah untuk mengonversi berkas dari satu bahasa markah ke bahasa markah lainnya. Bahasa markah menggunakan tag untuk memberi anotasi pada bagian dokumen. Bahasa markah yang umum digunakan meliputi Markdown, ReStructuredText, HTML, LaTex, ePub, dan Microsoft Word DOCX.

Pandoc adalah utilitas baris perintah sumber terbuka yang berfungsi sebagai konverter format, mengonversi berkas antar bahasa markah. Alat ini dibuat pada tahun 2006 oleh John MacFarlane dan ditulis dalam Haskell. Alat ini kompatibel dengan Windows, CentOS, dan sebagian besar sistem mirip Unix. Bahasa markah adalah sistem anotasi yang digunakan untuk memformat teks dengan cara yang berbeda secara visual. Singkatnya, bahasa markah sangat penting untuk memperindah Internet.

Bahasa markah menggunakan tag untuk memberi anotasi pada bagian dokumen. Bahasa markah yang umum digunakan meliputi Markdown, ReStructuredText, HTML, LaTex, ePub, dan Microsoft Word DOCX. Dalam bahasa Inggris yang sederhana, Pandoc memungkinkan Anda mengonversi beberapa berkas dari satu bahasa markah ke bahasa markah lainnya. Contoh umum termasuk mengonversi file Markdown ke presentasi, LaTeX, PDF, atau bahkan ePub.

Berikut ini beberapa contoh bahasa markup:

• HTML
• XML
• Markdown (dianggap sebagai markup ringan)

A. Cara Nginstal Pandoc

Utilitas atau aplikasi yang digunakan saat menangani beberapa file dengan format yang berbeda adalah Pandoc. Tujuan Pandoc adalah untuk mengonversi markup dokumen apa pun tanpa mengubah konten sumbernya. Artikel ini akan memberikan gambaran umum tentang cara menginstal Pandoc di FreeBSD 13.2 Stable.

Di FreeBSD Anda dapat menginstal Pandoc dengan FreeBSD Pckage pkg atau dengan repositori port FreeBSD. Pada artikel ini kita akan mencoba menginstal Pandoc melalui pkg, selain mudah, pkg juga menawarkan kecepatan instalasi tanpa mengurangi repositori yang dibutuhkan oleh aplikasi tersebut.

Untuk menjalankan Pandoc di sistem FreeBSD Anda harus menginstal beberapa aplikasi yang dibutuhkan Pandoc untuk berjalan di sistem FreeBSD. Anda mengikuti skrip berikut untuk menginstal Pandoc di FreeBSD.

root@router2:~ # pkg update
root@router2:~ # pkg upgrade -y

root@router2:~ # pkg install ghc
root@router2:~ # pkg install hs-cabal-install

Ketergantungan Pandoc lain yang harus Anda instal adalah tex-xetex dan texlive-full. Ketergantungan ini digunakan untuk menjalankan latex dan pdf-engine xelatex.

root@router2:~ # pkg install texlive-full
root@router2:~ # pkg install print/tex-xetex

Jika aplikasi pendukung sudah terinstal, lanjutkan dengan menginstal Pandoc. Untuk menginstal Pandoc, ikuti skrip berikut.

root@router2:~ # pkg install hs-pandoc

Setelah Pandoc terinstal di sistem FreeBSD Anda. Kini Pandoc siap digunakan untuk mengonversi berkas.

B. Cara Menggunakan Pandoc File Converter

Di bawah ini kami akan memberikan beberapa contoh cara menggunakan aplikasi Pandoc sebagai program konverter berkas. Buat berkas biblio.bib di folder /root, kami akan mengonversi berkas ini menjadi berkas html dan kami akan menamainya example24a.html. Skrip di bawah ini adalah contoh berkas biblio.bib.

@Book{item1,
author="John Doe",
title="First Book",
year="2005",
address="Cambridge",
publisher="Cambridge University Press"
}

@Article{item2,
author="John Doe",
title="Article",
year="2006",
journal="Journal of Generic Studies",
volume="6",
pages="33-34"
}

@InCollection{item3,
author="John Doe and Jenny Roe",
title="Why Water Is Wet",
booktitle="Third Book",
editor="Sam Smith",
publisher="Oxford University Press",
address="Oxford",
year="2007"
}

Untuk mengubah file dengan ekstensi bib ke format html, gunakan skrip berikut.

root@router2:~ # pandoc biblio.bib --citeproc -s -o biblio.html

Di bawah ini Anda akan diberikan beberapa contoh skrip Pandoc untuk mengonversi beberapa jenis format file, Anda dapat mempraktikkan skrip ini secara langsung.

root@router2:~ # pandoc MANUAL.txt -o example1.html
root@router2:~ # pandoc -s MANUAL.txt -o example2.html
root@router2:~ # pandoc -s --toc -c pandoc.css -A footer.html MANUAL.txt -o example3.html
root@router2:~ # pandoc -s MANUAL.txt -o example4.tex
root@router2:~ # pandoc -s example4.tex -o example5.text
root@router2:~ # pandoc -s -t rst --toc MANUAL.txt -o example6.text
root@router2:~ # pandoc -s MANUAL.txt -o example7.rtf
root@router2:~ # pandoc -t beamer SLIDES -o example8.pdf
root@router2:~ # pandoc -s -t docbook MANUAL.txt -o example9.db
root@router2:~ # pandoc -s -t man pandoc.1.md -o example10.1
root@router2:~ # pandoc -s -t context MANUAL.txt -o example11.tex
root@router2:~ # pandoc -s -r html http://www.gnu.org/software/make/ -o example12.text
root@router2:~ # pandoc MANUAL.txt --pdf-engine=xelatex -o example13.pdf
root@router2:~ # pandoc example15.md -o example15.ipynb
root@router2:~ # pandoc math.text -s -o mathDefault.html
root@router2:~ # pandoc math.text -s -o mathDefault.html

Untuk memudahkan Anda mempelajari Pandoc, kami telah menyiapkan beberapa file yang disimpan di direktori "/usr/local/www/data". Gunakan perintah ls untuk melihat seluruh isi file.

root@router2:/usr/local/www/data # ls
MANUAL.txt      README.md       Result          index.html      run.txt         sample.odt      sample1.epub    samplepaper.tex

a. konvert file html ke docx

root@router2:/usr/local/www/data # pandoc -s -f html -t docx -o /usr/local/www/data/Result/unixBSDfile.docx http://www.baidu.com

b. Konvert file html ke markdown

root@router2:/usr/local/www/data # pandoc -f html -t markdown -o /usr/local/www/data/Result/unixBSDfile1.md https://www.unixwinbsd.site/2024/01/google-indexing-api-with-go-lang-for.html
root@router2:/usr/local/www/data # pandoc -f html -t markdown -o /usr/local/www/data/Result/unixBSDfile2.md index.html

c. Konvert file markdown ke mediawiki

root@router2:/usr/local/www/data # pandoc -f markdown -t mediawiki -o /usr/local/www/data/Result/unixBSDfile.wiki README.md

d. Konvert file txt/tex ke json

root@router2:/usr/local/www/data # pandoc run.txt -f latex+raw_tex -o /usr/local/www/data/Result/unixBSDfileTXT.json
root@router2:/usr/local/www/data # pandoc samplepaper.tex -f latex+raw_tex -o /usr/local/www/data/Result/unixBSDfileTEX.json

e. Konvert file epub ke pdf

root@router2:/usr/local/www/data # pandoc -f epub sample1.epub -t latex -s -o /usr/local/www/data/Result/unixBSDfile.pdf --pdf-engine=xelatex

f. Konvert file txt ke db

root@router2:/usr/local/www/data # pandoc -s -t docbook MANUAL.txt -o /usr/local/www/data/Result/unixBSDfile.db

g. Konvert odt ke markdown md

root@router2:/usr/local/www/data # pandoc -o /usr/local/www/data/Result/unixBSDfile.odt -t markdown README.md

Mari kita lihat isi direktori dari hasil konversi di atas.

root@ns7:/usr/local/www/data # cd Result
root@ns7:/usr/local/www/data/Result # ls
unixBSDfile.db          unixBSDfile.pdf         unixBSDfile1.md         unixBSDfileTEX.json
unixBSDfile.docx        unixBSDfile.wiki        unixBSDfile2.md         unixBSDfileTXT.json

Pandoc sering didefinisikan sebagai konverter dokumen universal, Pandoc adalah program perangkat lunak sumber terbuka untuk konversi file. Jika Anda perlu mengonversi file dari format apa pun yang dapat dibayangkan ke format lain, Pandoc adalah jawabannya. Pandoc paling cocok digunakan untuk mengonversi jenis file seperti Markdown, Microsoft Word (.docx), dan XML menjadi dokumen dan bahasa markup yang lebih mudah digunakan, termasuk PDF dan HTML.

Untuk informasi lebih lanjut tentang cara menggunakan Pandoc, Anda dapat membaca situs web resmi: https://pandoc.org/demos.html.