pod2text - Online di Cloud

PROGRAM:

NAMA

pod2text - Konversikan data POD ke teks ASCII yang diformat

RINGKASAN

pod2teks [-aklostu] [--kode] [--kesalahan=gaya] [-i indentasi]
[-q tanda kutip] [--nourl] [--stderr] [-w lebar]
[memasukkan [keluaran ...]]

pod2teks -h

DESKRIPSI

pod2teks adalah front-end untuk Pod::Text dan subclass-nya. Itu menggunakan mereka untuk menghasilkan
teks ASCII yang diformat dari sumber POD. Secara opsional dapat menggunakan urutan termcap atau
Urutan lolos warna ANSI untuk memformat teks.

memasukkan adalah file yang akan dibaca untuk sumber POD (POD dapat disematkan dalam kode). Jika memasukkan
tidak diberikan, defaultnya adalah "STDIN". keluaran, jika diberikan, adalah file untuk menulis
keluaran yang diformat. Jika keluaran tidak diberikan, output yang diformat ditulis ke "STDOUT".
Beberapa file POD dapat diproses di tempat yang sama pod2teks doa (menghemat beban modul dan
waktu kompilasi) dengan menyediakan beberapa pasang memasukkan dan keluaran file pada baris perintah.

PILIHAN

-a, --alt
Gunakan format output alternatif yang, antara lain, menggunakan heading yang berbeda
style dan tandai entri "=item" dengan titik dua di margin kiri.

--kode
Sertakan teks non-POD dari file input di output juga. Berguna untuk
melihat kode yang didokumentasikan dengan blok POD dengan POD diberikan dan kode dibiarkan
utuh.

-c, --warna
Format output dengan urutan lolos warna ANSI. Menggunakan opsi ini mengharuskan
Term::ANSIColor diinstal pada sistem Anda.

-i indentasi, --indentasi=indentasi
Atur jumlah spasi untuk membuat indentasi teks biasa, dan indentasi default untuk
blok "= lebih". Default ke 4 spasi jika opsi ini tidak diberikan.

-kesalahan=gaya
Atur gaya penanganan kesalahan. "die" mengatakan untuk memberikan pengecualian pada pemformatan POD apa pun
kesalahan. "stderr" mengatakan untuk melaporkan kesalahan pada kesalahan standar, tetapi tidak membuangnya
pengecualian. "pod" mengatakan untuk menyertakan bagian POD ERRORS dalam dokumentasi yang dihasilkan
meringkas kesalahan. "none" mengabaikan kesalahan POD sepenuhnya, sebanyak mungkin.

Standarnya adalah "mati".

-h, --membantu
Cetak informasi penggunaan dan keluar.

-l, --longgar
Cetak baris kosong setelah heading "=head1". Biasanya, tidak ada baris kosong yang dicetak setelahnya
"=head1", meskipun satu masih dicetak setelah "=head2", karena ini yang diharapkan
pemformatan untuk halaman manual; jika Anda memformat dokumen teks arbitrer, gunakan ini
pilihan dianjurkan.

-m lebar, --margin kiri=lebar, --batas=lebar
Lebar margin kiri dalam spasi. Default ke 0. Ini adalah margin untuk semua
teks, termasuk heading, bukan jumlah indentasi teks biasa; Untuk
terakhir, lihat -i .

--nourl
Biasanya, kode pemformatan L<> dengan URL tetapi teks jangkar diformat untuk menampilkan keduanya
teks jangkar dan URL. Dengan kata lain:

Lhttp://example.com/>

diformat sebagai:

foohttp://example.com/>

Bendera ini, jika diberikan, menekan URL saat teks jangkar diberikan, jadi contoh ini
akan diformat hanya sebagai "foo". Ini dapat menghasilkan output yang lebih sedikit berantakan
di mana URL tidak terlalu penting.

-o, --menyerang berlebihan
Format output dengan pencetakan overstrike. Teks tebal ditampilkan sebagai karakter,
spasi, karakter. Miring dan nama file ditampilkan sebagai garis bawah, spasi mundur,
karakter. Banyak pager, seperti kurang, tahu cara mengonversi ini menjadi tebal atau bergaris bawah
teks.

-q tanda kutip, --kutipan=tanda kutip
Setel tanda kutip yang digunakan untuk mengelilingi teks C<> ke tanda kutip. Jika tanda kutip adalah satu
karakter, digunakan sebagai kutipan kiri dan kanan; jika tanda kutip adalah dua karakter,
karakter pertama digunakan sebagai kutipan kiri dan karakter kedua sebagai kutipan kanan; dan
if tanda kutip adalah empat karakter, dua yang pertama digunakan sebagai kutipan kiri dan yang kedua
dua sebagai kutipan yang tepat.

tanda kutip juga dapat diatur ke nilai khusus "tidak ada", dalam hal ini tidak ada tanda kutip
ditambahkan di sekitar teks C<>.

-s, --kalimat
Asumsikan setiap kalimat diakhiri dengan dua spasi dan coba pertahankan spasi itu. Tanpa
opsi ini, semua spasi putih berurutan dalam paragraf non-verbatim dikompres menjadi
satu ruang.

--stderr
Secara default, pod2teks mati jika ada kesalahan yang terdeteksi dalam input POD. Jika --stderr is
diberikan dan tidak --kesalahan bendera hadir, kesalahan dikirim ke kesalahan standar, tetapi pod2teks
tidak menggugurkan. Ini setara dengan "--errors=stderr" dan didukung untuk mundur
kompatibilitas.

-t, --termcap
Cobalah untuk menentukan lebar layar dan urutan tebal dan garis bawah untuk
terminal dari termcap, dan gunakan informasi itu dalam memformat output. Keluaran akan
dibungkus pada dua kolom kurang dari lebar perangkat terminal Anda. Menggunakan ini
opsi mengharuskan sistem Anda memiliki file termcap di suatu tempat di mana Term::Cap dapat
menemukannya dan mengharuskan sistem Anda mendukung termios. Dengan opsi ini, output
of pod2teks akan berisi urutan kontrol terminal untuk jenis terminal Anda saat ini.

-u, --utf8
Secara default, pod2teks mencoba menggunakan penyandian keluaran yang sama dengan penyandian masukannya (untuk
kompatibel dengan versi yang lebih lama). Opsi ini mengatakan untuk memaksa
pengkodean keluaran ke UTF-8.

Ketahuilah bahwa, saat menggunakan opsi ini, pengkodean input sumber POD Anda harus
dinyatakan dengan benar kecuali US-ASCII atau Latin-1. Masukan POD tanpa "= penyandian"
perintah akan diasumsikan dalam bahasa Latin-1, dan jika itu benar-benar dalam UTF-8, outputnya
akan dikodekan ganda. Lihat perlpod(1) untuk informasi lebih lanjut tentang "= encoding"
perintah.

-w, --lebar=lebar, -lebar
Kolom untuk membungkus teks di sisi kanan. Default ke 76, kecuali -t is
diberikan, dalam hal ini dua kolom kurang dari lebar perangkat terminal Anda.

EXIT STATUS

Selama semua dokumen yang diproses menghasilkan beberapa keluaran, bahkan jika keluaran itu termasuk
errata (bagian "POD ERRORS" yang dibuat dengan "--errors=pod"), pod2teks akan keluar dengan
status 0. Jika ada dokumen yang sedang diproses tidak menghasilkan dokumen keluaran,
pod2teks akan keluar dengan status 1. Jika ada kesalahan sintaks dalam dokumen POD sedang
diproses dan gaya penanganan kesalahan diatur ke default "mati", pod2teks akan menggugurkan
segera dengan status keluar 255.

DIAGNOSTIK

If pod2teks gagal dengan kesalahan, lihat Pod::Text dan Pod::Simple untuk informasi tentang apa
kesalahan itu mungkin berarti. Secara internal, itu juga dapat menghasilkan diagnostik berikut:

-c (--color) membutuhkan Term::ANSIColor diinstal
(F) -c or --warna diberikan, tetapi Term::ANSIColor tidak dapat dimuat.

Opsi tidak diketahui: %s
(F) Opsi baris perintah yang tidak diketahui diberikan.

Selain itu, Getopt::Pesan kesalahan panjang lainnya mungkin disebabkan oleh baris perintah yang tidak valid
Pilihan.

LINGKUNGAN

KOLOM
If -t diberikan, pod2teks akan mengambil lebar layar Anda saat ini dari ini
variabel lingkungan, jika tersedia. Ini menimpa informasi lebar terminal di
TERMCAP.

TERMCAP
If -t diberikan, pod2teks akan menggunakan konten variabel lingkungan ini jika
tersedia untuk menentukan urutan pemformatan yang benar untuk terminal Anda saat ini
perangkat.

Gunakan pod2text online menggunakan layanan onworks.net