ນີ້ແມ່ນຄໍາສັ່ງ pod2text ທີ່ສາມາດດໍາເນີນການໄດ້ໃນ OnWorks ຜູ້ໃຫ້ບໍລິການໂຮດຕິ້ງຟຣີໂດຍໃຊ້ຫນຶ່ງໃນຫຼາຍໆບ່ອນເຮັດວຽກອອນໄລນ໌ຂອງພວກເຮົາເຊັ່ນ Ubuntu Online, Fedora Online, Windows online emulator ຫຼື MAC OS online emulator
ໂຄງການ:
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