pod2text - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

pod2text - ປ່ຽນຂໍ້ມູນ POD ໃຫ້ເປັນຂໍ້ຄວາມ ASCII ທີ່ມີຮູບແບບ

ສະຫຼຸບສັງລວມ

pod2text [-aclostu] [--ລະຫັດ] [-- ຄວາມ​ຜິດ​ພາດ​=ແບບ] [-i ຫຍໍ້ ໜ້າ]
[-q quote:] [--nourls] [--stderr] [-w width]
[ການປ້ອນຂໍ້ມູນ [output ...]]

pod2text -h

ລາຍລະອຽດ

pod2text ແມ່ນທາງໜ້າສຳລັບ Pod::Text ແລະໝວດໝູ່ຍ່ອຍຂອງມັນ. ມັນໃຊ້ພວກມັນເພື່ອສ້າງ
ຮູບແບບຂໍ້ຄວາມ ASCII ຈາກແຫຼ່ງ POD. ມັນສາມາດທາງເລືອກທີ່ຈະໃຊ້ລໍາດັບ termcap ຫຼື
ANSI ລໍາດັບ escape ສີເພື່ອຈັດຮູບແບບຂໍ້ຄວາມ.

ການປ້ອນຂໍ້ມູນ ແມ່ນໄຟລ໌ທີ່ຈະອ່ານສໍາລັບແຫຼ່ງ POD (POD ສາມາດຖືກຝັງຢູ່ໃນລະຫັດ). ຖ້າ ການປ້ອນຂໍ້ມູນ
ບໍ່ໄດ້ຖືກມອບໃຫ້, ມັນຕັ້ງຄ່າເລີ່ມຕົ້ນເປັນ "STDIN". output, ຖ້າໃຫ້, ແມ່ນໄຟລ໌ທີ່ຈະຂຽນ
ຮູບແບບຜົນຜະລິດ. ຖ້າ output ບໍ່ໄດ້ມອບໃຫ້, ຜົນໄດ້ຮັບທີ່ມີຮູບແບບຖືກຂຽນເປັນ "STDOUT".
ໄຟລ໌ POD ຫຼາຍສາມາດປະມວນຜົນໄດ້ໃນອັນດຽວກັນ pod2text invocation (ປະຫຍັດການໂຫຼດໂມດູນແລະ
ລວບລວມເວລາ) ໂດຍການສະຫນອງຫຼາຍຄູ່ຂອງ ການປ້ອນຂໍ້ມູນ ແລະ output ໄຟລ໌ຢູ່ໃນເສັ້ນຄໍາສັ່ງ.

OPTIONS

-a, --alt
ໃຊ້ຮູບແບບຜົນຜະລິດສະຫຼັບທີ່, ໃນບັນດາສິ່ງອື່ນໆ, ໃຊ້ຫົວຂໍ້ທີ່ແຕກຕ່າງກັນ
ຮູບແບບ ແລະໝາຍ "=item" ລາຍການທີ່ມີຈໍ້າສອງເມັດຢູ່ໃນຂອບຊ້າຍ.

--ລະຫັດ
ລວມເອົາຂໍ້ຄວາມທີ່ບໍ່ແມ່ນ POD ຈາກໄຟລ໌ປ້ອນຂໍ້ມູນໃນຜົນໄດ້ຮັບເຊັ່ນກັນ. ເປັນປະໂຫຍດສໍາລັບ
ການເບິ່ງລະຫັດທີ່ບັນທຶກໄວ້ດ້ວຍບລັອກ POD ທີ່ມີ POD rendered ແລະລະຫັດຊ້າຍ
ສະພາບເດີມ

-c, --ສີ
ຟໍແມັດຜົນຜະລິດດ້ວຍ ANSI ລໍາດັບການຫລົບຫນີສີ. ການນໍາໃຊ້ທາງເລືອກນີ້ຮຽກຮ້ອງໃຫ້ມີມັນ
ໄລຍະເວລາ::ANSIColor ຈະຖືກຕິດຕັ້ງຢູ່ໃນລະບົບຂອງທ່ານ.

-i ຫຍໍ້ ໜ້າ, --indent=ຫຍໍ້ ໜ້າ
ກໍານົດຈໍານວນຍະຫວ່າງເພື່ອຫຍໍ້ຫນ້າຂໍ້ຄວາມປົກກະຕິ, ແລະການຫຍໍ້ຫນ້າເລີ່ມຕົ້ນສໍາລັບ
"=over" ຕັນ. ຄ່າເລີ່ມຕົ້ນເປັນ 4 ຍະຫວ່າງຖ້າຕົວເລືອກນີ້ບໍ່ໄດ້ຖືກມອບໃຫ້.

- ຄວາມ​ຜິດ​ພາດ​=ແບບ
ກໍານົດຮູບແບບການຈັດການຄວາມຜິດພາດ. "ຕາຍ" ບອກວ່າຈະຖິ້ມຂໍ້ຍົກເວັ້ນໃນການຈັດຮູບແບບ POD
ຄວາມຜິດພາດ. "stderr" ເວົ້າວ່າການລາຍງານຂໍ້ຜິດພາດກ່ຽວກັບຄວາມຜິດພາດມາດຕະຖານ, ແຕ່ບໍ່ໃຫ້ຖິ້ມ
ຂໍ້​ຍົກ​ເວັ້ນ. "pod" ບອກວ່າຈະລວມເອົາພາກສ່ວນ POD ERRORS ໃນເອກະສານຜົນໄດ້ຮັບ
ສະຫຼຸບຄວາມຜິດພາດ. "ບໍ່ມີ" ບໍ່ສົນໃຈຄວາມຜິດພາດ POD ທັງຫມົດ, ເທົ່າທີ່ເປັນໄປໄດ້.

ຄ່າເລີ່ມຕົ້ນແມ່ນ "ຕາຍ".

-h, - ຊ່ວຍ
ພິມຂໍ້ມູນການນໍາໃຊ້ແລະອອກ.

-l, -- ວ່າງ
ພິມເສັ້ນເປົ່າຫຼັງຈາກຫົວຂໍ້ "=head1". ໂດຍປົກກະຕິ, ບໍ່ມີເສັ້ນເປົ່າຖືກພິມອອກຫຼັງຈາກ
"=head1", ເຖິງແມ່ນວ່າຫນຶ່ງຍັງຖືກພິມອອກຫຼັງຈາກ "=head2", ເພາະວ່ານີ້ແມ່ນຄາດວ່າ
ການຈັດຮູບແບບສໍາລັບຫນ້າຄູ່ມື; ຖ້າ​ຫາກ​ວ່າ​ທ່ານ​ກໍາ​ລັງ​ຈັດ​ຮູບ​ແບບ​ເອ​ກະ​ສານ​ຂໍ້​ຄວາມ​ໂດຍ​ຕົນ​ເອງ​, ການ​ນໍາ​ໃຊ້​ນີ້​
ທາງ​ເລືອກ​ແມ່ນ​ແນະ​ນໍາ​ໃຫ້​.

-m width, --ຂອບຊ້າຍ=width, --ຂອບ=width
ຄວາມກວ້າງຂອງຂອບຊ້າຍໃນຊ່ອງຫວ່າງ. ຄ່າເລີ່ມຕົ້ນເປັນ 0. ນີ້ແມ່ນຂອບຂອງທັງໝົດ
ຂໍ້ຄວາມ, ລວມທັງຫົວຂໍ້, ບໍ່ແມ່ນຈໍານວນທີ່ຂໍ້ຄວາມປົກກະຕິແມ່ນຫຍໍ້ຫນ້າ; ສໍາ​ລັບ
ສຸດທ້າຍ, ເບິ່ງ -i ທາງເລືອກ.

--nourls
ໂດຍປົກກະຕິ, L<> ການຈັດຮູບແບບລະຫັດທີ່ມີ URL ແຕ່ຂໍ້ຄວາມສະມໍຖືກຈັດຮູບແບບເພື່ອສະແດງທັງສອງ
ຂໍ້ຄວາມສະມໍແລະ URL. ໃນຄໍາສັບຕ່າງໆອື່ນໆ:

ລhttp://example.com/>

ຖືກຈັດຮູບແບບເປັນ:

ຟູhttp://example.com/>

ທຸງນີ້, ຖ້າໃຫ້, ສະກັດກັ້ນ URL ເມື່ອຂໍ້ຄວາມສະມໍຖືກມອບ, ດັ່ງນັ້ນຕົວຢ່າງນີ້
ຈະຖືກຈັດຮູບແບບເປັນພຽງແຕ່ "foo". ນີ້ສາມາດຜະລິດຜົນຜະລິດທີ່ສັບສົນຫນ້ອຍໃນກໍລະນີ
ບ່ອນທີ່ URLs ບໍ່ສໍາຄັນໂດຍສະເພາະ.

-o, -- ການໂຈມຕີເກີນຂອບເຂດ
ຈັດຮູບແບບຜົນຜະລິດດ້ວຍການພິມ overstrike. ຂໍ້ຄວາມຕົວໜາຖືກສະແດງເປັນຕົວອັກສອນ,
backspace, ລັກສະນະ. ໂຕອຽງ ແລະຊື່ໄຟລ໌ຖືກສະແດງເປັນຂີດກ້ອງ, backspace,
ລັກສະນະ. pagers ຫຼາຍ, ເຊັ່ນ: ຫນ້ອຍ, ຮູ້ວິທີປ່ຽນອັນນີ້ເປັນຕົວໜາ ຫຼືຂີດກ້ອງ
ຂໍ້​ຄວາມ.

-q quote:, --ວົງຢືມ=quote:
ກໍາ​ນົດ​ເຄື່ອງ​ຫມາຍ​ວົງ​ຢືມ​ທີ່​ໃຊ້​ເພື່ອ​ອ້ອມ​ຂ້າງ C<> ຂໍ້​ຄວາມ​ເປັນ quote:ທີ່ຢູ່ ຖ້າຫາກວ່າ quote: ແມ່ນດຽວ
ລັກສະນະ, ມັນຖືກນໍາໃຊ້ເປັນທັງ quote ຊ້າຍແລະຂວາ; ຖ້າ quote: ແມ່ນ​ສອງ​ຕົວ​ອັກ​ສອນ​,
ຕົວອັກສອນທໍາອິດຖືກໃຊ້ເປັນຄໍາເວົ້າຊ້າຍແລະທີສອງເປັນຄໍາເວົ້າທີ່ຖືກຕ້ອງ; ແລະ
if quote: ແມ່ນສີ່ຕົວອັກສອນ, ສອງຕົວທໍາອິດຖືກໃຊ້ເປັນຄໍາເວົ້າຊ້າຍແລະຕົວທີສອງ
ສອງເປັນຄໍາເວົ້າທີ່ຖືກຕ້ອງ.

quote: ອາດຈະຖືກຕັ້ງເປັນຄ່າພິເສດ "none", ໃນກໍລະນີທີ່ບໍ່ມີເຄື່ອງຫມາຍອ້າງອີງ
ເພີ່ມປະມານ C<> ຂໍ້ຄວາມ.

-s, -- ປະໂຫຍກ
ສົມມຸດວ່າແຕ່ລະປະໂຫຍກລົງທ້າຍດ້ວຍສອງຍະຫວ່າງ ແລະພະຍາຍາມຮັກສາໄລຍະຫ່າງນັ້ນໄວ້. ໂດຍບໍ່ມີການ
ຕົວເລືອກນີ້, ຊ່ອງຫວ່າງຕິດຕໍ່ກັນທັງໝົດໃນວັກທີ່ບໍ່ແມ່ນຄຳເວົ້າຖືກບີບອັດໃສ່
ຊ່ອງດຽວ.

--stderr
ໂດຍຕົວຢ່າງ, pod2text ຕາຍຖ້າມີຂໍ້ຜິດພາດໃນການປ້ອນຂໍ້ມູນ POD. ຖ້າ --stderr is
ໃຫ້ແລະບໍ່ມີ -- ຄວາມ​ຜິດ​ພາດ​ ທຸງແມ່ນປະຈຸບັນ, ຂໍ້ຜິດພາດຖືກສົ່ງໄປຫາຄວາມຜິດພາດມາດຕະຖານ, ແຕ່ pod2text
ບໍ່ໄດ້ເອົາລູກອອກ. ອັນນີ້ເທົ່າກັບ "--errors=stderr" ແລະຮອງຮັບການຖອຍຫຼັງ
ຄວາມເຂົ້າກັນໄດ້.

-t, --termcap
ພະຍາຍາມກໍານົດຄວາມກວ້າງຂອງຫນ້າຈໍແລະລໍາດັບທີ່ກ້າຫານແລະ underline ສໍາລັບ
terminal ຈາກ termcap, ແລະນໍາໃຊ້ຂໍ້ມູນນັ້ນໃນການຈັດຮູບແບບຜົນຜະລິດ. ຜົນຜະລິດຈະ
ຫໍ່ຢູ່ສອງຖັນຫນ້ອຍກວ່າຄວາມກວ້າງຂອງອຸປະກອນຢູ່ປາຍຍອດຂອງທ່ານ. ການນໍາໃຊ້ນີ້
ທາງ​ເລືອກ​ຮຽກ​ຮ້ອງ​ໃຫ້​ລະ​ບົບ​ຂອງ​ທ່ານ​ມີ​ໄຟລ​໌ termcap ບາງ​ບ່ອນ​ທີ່ Term::Cap ສາ​ມາດ​ເຮັດ​ໄດ້
ຊອກຫາມັນແລະຮຽກຮ້ອງໃຫ້ລະບົບຂອງທ່ານສະຫນັບສະຫນູນ termios. ດ້ວຍທາງເລືອກນີ້, ຜົນຜະລິດ
of pod2text ຈະມີລໍາດັບການຄວບຄຸມ terminal ສໍາລັບປະເພດ terminal ໃນປັດຈຸບັນຂອງທ່ານ.

-u, --utf8
ໂດຍຕົວຢ່າງ, pod2text ພະ​ຍາ​ຍາມ​ທີ່​ຈະ​ນໍາ​ໃຊ້​ການ​ເຂົ້າ​ລະ​ຫັດ​ຜົນ​ຜະ​ລິດ​ດຽວ​ກັນ​ກັບ​ການ​ເຂົ້າ​ລະ​ຫັດ​ຂອງ​ຕົນ (ເພື່ອ​
ຮອງຮັບກັບລຸ້ນເກົ່າ). ທາງ​ເລືອກ​ນີ້​ເວົ້າ​ວ່າ​ແທນ​ທີ່​ຈະ​ບັງ​ຄັບ
ການເຂົ້າລະຫັດອອກເປັນ UTF-8.

ຈົ່ງຮູ້ວ່າ, ເມື່ອໃຊ້ຕົວເລືອກນີ້, ການເຂົ້າລະຫັດຂອງແຫຼ່ງ POD ຂອງທ່ານຈະຕ້ອງເປັນ
ປະກາດຢ່າງຖືກຕ້ອງເວັ້ນເສຍແຕ່ວ່າມັນເປັນ US-ASCII ຫຼື Latin-1. ການປ້ອນຂໍ້ມູນ POD ໂດຍບໍ່ມີການ "= ການເຂົ້າລະຫັດ"
ຄໍາ​ສັ່ງ​ຈະ​ໄດ້​ຮັບ​ການ​ຄາດ​ວ່າ​ຈະ​ເປັນ​ໃນ Latin-1, ແລະ​ຖ້າ​ຫາກ​ວ່າ​ມັນ​ເປັນ​ຕົວ​ຈິງ​ໃນ UTF-8, ຜົນ​ຜະ​ລິດ
ຈະຖືກເຂົ້າລະຫັດສອງຄັ້ງ. ເບິ່ງ perlpod(1) ສໍາລັບຂໍ້ມູນເພີ່ມເຕີມກ່ຽວກັບ "=encoding"
ຄໍາສັ່ງ.

-w, --width=width, -width
ຖັນທີ່ຈະຫໍ່ຂໍ້ຄວາມຢູ່ເບື້ອງຂວາມື. ຄ່າເລີ່ມຕົ້ນເປັນ 76, ເວັ້ນເສຍແຕ່ -t is
ໃຫ້, ໃນກໍລະນີນີ້ມັນເປັນສອງຖັນຫນ້ອຍກວ່າຄວາມກວ້າງຂອງອຸປະກອນ terminal ຂອງທ່ານ.

ອອກ STATUS

ຕາບໃດທີ່ເອກະສານທັງໝົດທີ່ປະມວນຜົນໄດ້ສົ່ງຜົນໃຫ້ບາງຜົນຜະລິດ, ເຖິງແມ່ນວ່າຜົນໄດ້ຮັບນັ້ນລວມເຖິງ
errata (ສ່ວນ "POD ERRORS" ທີ່ສ້າງຂຶ້ນດ້ວຍ "--errors=pod"), pod2text ຈະ​ອອກ​ດ້ວຍ
ສະຖານະ 0. ຖ້າເອກະສານໃດນຶ່ງທີ່ກຳລັງປະມວນຜົນບໍ່ສົ່ງຜົນໃຫ້ເອກະສານຜົນໄດ້ຮັບ,
pod2text ຈະອອກດ້ວຍສະຖານະ 1. ຖ້າມີ syntax ຜິດພາດໃນເອກະສານ POD
ປະມວນຜົນແລະຮູບແບບການຈັດການຄວາມຜິດພາດຖືກຕັ້ງເປັນຄ່າເລີ່ມຕົ້ນຂອງ "ຕາຍ", pod2text ຈະເອົາລູກອອກ
ທັນ​ທີ​ທີ່​ມີ​ສະ​ຖາ​ນະ​ການ​ອອກ 255​.

ທິດສະດີວິທະຍາ

If pod2text ລົ້ມເຫລວກັບຄວາມຜິດພາດ, ເບິ່ງ Pod::Text and Pod::Simple for information about what
ຄວາມຜິດພາດເຫຼົ່ານັ້ນອາດຈະຫມາຍຄວາມວ່າ. ພາຍໃນ, ມັນຍັງສາມາດຜະລິດການວິນິດໄສດັ່ງຕໍ່ໄປນີ້:

-c (--color) ຮຽກ​ຮ້ອງ​ໃຫ້​ມີ Term::ANSIColor ໄດ້​ຮັບ​ການ​ຕິດ​ຕັ້ງ
(F) -c or --ສີ ໄດ້ຖືກມອບໃຫ້, ແຕ່ Term::ANSIColor ບໍ່ສາມາດໂຫຼດໄດ້.

ຕົວເລືອກທີ່ບໍ່ຮູ້ຈັກ: %s
(F) ທາງເລືອກເສັ້ນຄໍາສັ່ງທີ່ບໍ່ຮູ້ຈັກໄດ້ຖືກມອບໃຫ້.

ນອກຈາກນັ້ນ, Getopt ອື່ນ ໆ:: ຂໍ້ຄວາມຄວາມຜິດພາດທີ່ຍາວອາດຈະເປັນຜົນມາຈາກເສັ້ນຄໍາສັ່ງທີ່ບໍ່ຖືກຕ້ອງ
ຕົວເລືອກ

ENVIRONMENT

ສີ
If -t ແມ່ນ​ໃຫ້​, pod2text ຈະເອົາຄວາມກວ້າງປະຈຸບັນຂອງຫນ້າຈໍຂອງທ່ານຈາກນີ້
ສະພາບແວດລ້ອມປ່ຽນແປງໄດ້, ຖ້າມີ. ມັນ overrides terminal width ຂໍ້​ມູນ​ໃນ
TERMCAP.

TERMCAP
If -t ແມ່ນ​ໃຫ້​, pod2text ຈະໃຊ້ເນື້ອໃນຂອງສະພາບແວດລ້ອມນີ້ຕົວແປຖ້າຫາກວ່າ
ມີໃຫ້ເພື່ອກໍານົດລໍາດັບການຈັດຮູບແບບທີ່ຖືກຕ້ອງສໍາລັບເຄື່ອງປະຈຸບັນຂອງທ່ານ
ອຸປະກອນ.

ໃຊ້ pod2text ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net