Cara Membuka & Mengubah POD ke PDF untuk Membaca Dokumentasi Perl

Iklan

Padahal itu dulunya bahasa integral untuk pemrograman web Bahasa Pemrograman Yang Dipelajari - Pemrograman WebHari ini kita akan melihat berbagai bahasa pemrograman web yang mendukung Internet. Ini adalah bagian keempat dari seri pemrograman pemula. Pada bagian 1, kami mempelajari dasar ... Baca lebih banyak , Perl kini telah jatuh di pinggir jalan dalam mendukung bahasa yang lebih modern seperti Python, Ruby, dan JavaScript. Sangat sedikit orang yang berpikir bahwa ada baiknya upaya mempelajari Perl belakangan ini.

Tetapi itu tidak berarti bahasanya tidak berguna atau usang. Faktanya, banyak situs web dan alat web modern masih mengandalkan Perl untuk operasi sehari-hari - termasuk Craigslist, IMDb, dan DuckDuckGo - jadi jika Anda tertarik mempelajarinya, jangan biarkan siapa pun menghentikan Anda atau menghalangi Anda 7 Trik yang Berguna untuk Menguasai Bahasa Pemrograman BaruTidak apa-apa untuk kewalahan ketika Anda belajar kode. Anda mungkin akan melupakan hal-hal secepat Anda mempelajarinya. Kiat-kiat ini dapat membantu Anda mempertahankan semua informasi baru dengan lebih baik.

Baca lebih banyak .

Jika Anda akan belajar Perl, maka Anda juga ingin berkenalan dengan POD. Inilah yang itu, mengapa itu penting, dan apa yang harus dilakukan ketika Anda mengalami file seperti itu.

Apa itu File POD?

POD adalah singkatan dari Plain Old Documentation, yang merupakan bahasa markup dasar yang digunakan untuk memformat teks tanpa banyak usaha. Mirip dengan bahasa markup markdown Apa itu Penurunan Harga? 4 Alasan Mengapa Anda Harus Belajar SekarangBosan dengan editor HTML dan WYSIWYG? Maka penurunan harga adalah jawaban untuk Anda tidak peduli siapa Anda. Baca lebih banyak , tetapi secara khusus dirancang untuk mendokumentasikan kode sumber dan modul Perl.

POD dapat digunakan dalam dua cara: itu dapat ada langsung dalam kode sumber file Perl ATAU itu bisa ada sebagai file POD terpisah. Ketika kode itu ada di dalam kode, Anda dapat menganggapnya seperti komentar dalam bahasa pemrograman lain apa pun, kecuali lebih bagus dan lebih fleksibel.

#! / usr / bin / perl

gunakan yang ketat;

gunakan peringatan;

= pod

= head1 Header Example

Script ini melakukan beberapa hal keren, seperti ini dan itu. Parameter berikut harus ada agar berfungsi dengan benar. Jangan coba melakukan ini pada mesin yang bermasalah.

= potong

print “Hanya kode ini yang dieksekusi. \ n ";

Dokumentasi yang disematkan bekerja dengan baik untuk skrip mandiri atau ketika Anda ingin memastikan bahwa siapa pun yang menemukan file juga memiliki jaminan akses ke dokumentasi, tetapi bisa jadi merepotkan ketika Anda ingin mendokumentasikan seluruh basis kode dengan lebih tinggi tingkat.

Untungnya, POD juga dapat digunakan untuk membuat halaman tipe manual yang lebih cocok untuk dokumen berorientasi pengguna (karena pengguna mungkin tidak ingin mempelajari kode sumber skrip itu sendiri). Saat itulah file POD berguna.

Cara Membaca File POD

Agar lebih jelas, dokumentasi POD tertanam ditemukan dalam file skrip Perl aktual di antara baris kode, dan file skrip ini datang dalam salah satu dari dua format ekstensi: .PL atau .PM. Ketika Anda melihat ekstensi .POD, itu menunjukkan bahwa file tersebut adalah dokumentasi murni dan tidak menyertakan kode sumber.

Meskipun dimungkinkan untuk membuka file POD dalam editor teks apa pun termasuk Notepad, Anda mungkin hanya ingin melakukannya jika Anda benar-benar mengedit dokumentasi mentah itu sendiri. Anggap saja seperti membuka file HTML di editor: dengan semua markup, konten teks yang sebenarnya sulit dibaca.

Sebagai gantinya, Anda harus menggunakan beberapa jenis alat pembaca yang mengambil dokumentasi POD mentah dan menyajikannya dengan cara yang mudah dibaca.

Cara termudah adalah dengan menggunakan perldoc alat baris perintah yang secara otomatis disertakan ketika Perl diinstal ke sistem Anda. Sebagian besar sistem OS X dan Linux datang dengan Perl yang sudah diinstal, tetapi pengguna Windows harus menginstalnya secara manual. (Untungnya, tidak lebih sulit daripada menjalankan file pemasang.)

Sekarang luncurkan baris perintah, arahkan ke tempat file POD berada, dan ketik perldoc [.POD file] untuk melihatnya sebagai diformat dengan benar. Misalnya, jika file itu bernama library.pod maka Anda mengetik perldoc library.pod dan hanya itu.

Cara Mengonversi POD ke Format Lain

Meskipun demikian perldoc alat ini tidak terlalu sulit untuk digunakan, itu tidak nyaman ketika Anda ingin berbagi dokumentasi dengan orang lain atau ketika Anda ingin membacanya dari komputer Anda. Saat itulah Anda mungkin ingin mempertimbangkan konversi ke format lain.

Konversi ke HTML: Instal dan gunakan pod2html alat yang menyediakan cara mudah untuk menerjemahkan file POD menjadi file HTML yang dapat dibaca. Sayangnya, itu hanya dapat melakukan konversi satu-ke-satu (sehingga Anda tidak dapat menggabungkan beberapa file POD menjadi satu file HTML).

Konversi ke PDF: Instal dan gunakan pod2pdf alat, yang mirip dan hanya mudah digunakan sebagai alat pod2html di atas, kecuali itu dikonversi ke PDF daripada HTML.

Pilihan lain adalah mengonversi POD ke HTML menggunakan metode yang ditunjukkan di atas, buka file HTML di browser seperti Chrome atau Firefox, lalu cetak halaman sebagai PDF.

Konversi ke Penurunan Harga: Instal dan gunakan pod2markdown alat untuk menerjemahkan antara POD dan Markdown. Penurunan harga adalah bahasa markup tujuan umum, yang berarti pengguna lebih mungkin mengenalnya dan ada lebih banyak alat di luar sana yang dapat menerima dan menampilkan penurunan harga.

Konversi ke LaTeX: Instal dan gunakan pod2latex alat. LaTeX adalah bahasa markup lain, yang kurang umum daripada Markdown, tetapi masih lebih populer daripada POD. LaTeX terutama digunakan dalam dokumen akademis dan ilmiah, tetapi jika Anda membutuhkannya, konverter ini ada.

Konversi ke Teks Biasa: Instal dan gunakan pod2text alat, yang menghasilkan file hanya teks dengan pemformatan berbasis ASCII. Anda mungkin tidak perlu menggunakan ini, tetapi jika Anda pernah melakukannya, ketahuilah bahwa opsi itu ada.

Apakah Posting Ini Bermanfaat?

Setelah Anda terbiasa, file POD sangat sederhana dan nyaman digunakan. Ada sedikit kurva pembelajaran, tetapi sangat kecil - terutama jika Anda telah menggunakan bahasa markup sebelumnya. Semoga Anda sekarang merasa nyaman berurusan dengan file POD.

Jika Anda merasa kewalahan, tanyakan pada diri sendiri ini pertanyaan penting untuk coders pemula 4 Pertanyaan untuk Ditanyakan pada Diri Sendiri Sebelum Mempelajari KodeMempelajari bahasa pemrograman itu populer. Tetapi apakah ini untuk semua orang? Sebelum Anda berkomitmen untuk itu, tanyakan pada diri sendiri pertanyaan-pertanyaan berikut dan jujurlah. Baca lebih banyak . Kesulitan tidak harus berarti demikian Anda tidak seharusnya menjadi seorang programmer 6 Tanda Bahwa Anda Tidak Ingin Menjadi ProgrammerTidak semua orang cocok menjadi programmer. Jika Anda tidak sepenuhnya yakin bahwa Anda ditakdirkan untuk menjadi seorang programmer, berikut adalah beberapa tanda yang dapat mengarahkan Anda ke arah yang benar. Baca lebih banyak , tetapi penting untuk jujur ​​dengan diri sendiri dan mengelola harapan Anda.

Yang sedang berkata, perhatikan tips ini untuk belajar bagaimana kode tanpa stres Cara Belajar Pemrograman Tanpa Semua StresMungkin Anda sudah memutuskan untuk mengejar pemrograman, baik untuk karier atau hanya sebagai hobi. Bagus! Tapi mungkin Anda mulai merasa kewalahan. Tidak begitu bagus. Ini bantuan untuk memudahkan perjalanan Anda. Baca lebih banyak dan mengetahui cara mengetahui tutorial pengkodean yang baik dari yang buruk Apa yang Membuat Tutorial Pemrograman yang Baik?Tidak semua tutorial pemrograman dibuat setara. Beberapa manfaat Anda dan orang lain akhirnya membuang-buang waktu Anda. Inilah yang harus dicari dalam tutorial pemrograman berkualitas. Baca lebih banyak .

Untuk apa Anda menggunakan Perl? Punya tips lain untuk dibagikan atau pertanyaan untuk diajukan? Beri tahu kami di komentar di bawah!