pod2text - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

pod2text - Chuyển đổi dữ liệu POD sang văn bản ASCII được định dạng

SYNOPSIS

pod2text [-aclostu] [--mã số] [--lỗi=phong cách] [-i lịnh sung công]
[-q dấu ngoặc kép] [--nourl] [--stderr] [-w chiều rộng]
[đầu vào [đầu ra ...]]

pod2text -h

MÔ TẢ

pod2text là giao diện người dùng cho Pod :: Text và các lớp con của nó. Nó sử dụng chúng để tạo
văn bản ASCII được định dạng từ nguồn POD. Nó có thể tùy chọn sử dụng trình tự thuật ngữ hoặc
Trình tự thoát màu ANSI để định dạng văn bản.

đầu vào là tệp để đọc cho nguồn POD (POD có thể được nhúng trong mã). Nếu như đầu vào
không được cung cấp, nó mặc định là "STDIN". đầu ra, nếu được cung cấp, là tệp để ghi
đầu ra được định dạng. Nếu như đầu ra không được cung cấp, đầu ra được định dạng được ghi thành "STDOUT".
Một số tệp POD có thể được xử lý trong cùng một pod2text lời kêu gọi (tiết kiệm tải mô-đun và
thời gian biên dịch) bằng cách cung cấp nhiều cặp đầu vào và đầu ra các tệp trên dòng lệnh.

LỰA CHỌN

-a, --alt
Sử dụng một định dạng đầu ra thay thế, trong số những thứ khác, sử dụng một tiêu đề khác
kiểu và đánh dấu các mục "= item" bằng dấu hai chấm ở lề trái.

--mã số
Bao gồm bất kỳ văn bản không phải POD nào từ tệp đầu vào trong đầu ra. Hữu ích cho
xem mã được ghi lại bằng các khối POD với POD được hiển thị và mã còn lại
nguyên vẹn.

-c, --màu sắc
Định dạng đầu ra với trình tự thoát màu ANSI. Sử dụng tùy chọn này yêu cầu
Thuật ngữ :: ANSIColor được cài đặt trên hệ thống của bạn.

-i lịnh sung công, --indent =lịnh sung công
Đặt số lượng khoảng trắng để thụt lề văn bản thông thường và thụt lề mặc định cho
"= over" khối. Mặc định là 4 dấu cách nếu tùy chọn này không được cung cấp.

-srors=phong cách
Đặt kiểu xử lý lỗi. "die" cho biết đặt một ngoại lệ trên bất kỳ định dạng POD nào
lỗi. "stderr" nói để báo cáo lỗi về lỗi tiêu chuẩn, nhưng không đưa ra
ngoại lệ. "pod" cho biết bao gồm phần LỖI POD trong tài liệu kết quả
tổng hợp các lỗi. "none" hoàn toàn bỏ qua các lỗi POD, càng nhiều càng tốt.

Mặc định là "chết".

-h, --Cứu giúp
In thông tin sử dụng ra và thoát.

-l, --lỏng lẻo
In một dòng trống sau tiêu đề "= head1". Thông thường, không có dòng trống nào được in sau
"= head1", mặc dù một cái vẫn được in sau "= head2", vì đây là giá trị được mong đợi
định dạng cho các trang thủ công; nếu bạn đang định dạng các tài liệu văn bản tùy ý, hãy sử dụng
tùy chọn được khuyến khích.

-m chiều rộng, - lề trái=chiều rộng, --lề=chiều rộng
Chiều rộng của lề trái trong khoảng trắng. Mặc định là 0. Đây là lợi nhuận cho tất cả
văn bản, bao gồm các tiêu đề, không phải số lượng mà văn bản thông thường được thụt vào; cho
sau này, hãy xem -i tùy chọn.

--nourl
Thông thường, mã định dạng L <> có URL nhưng văn bản liên kết được định dạng để hiển thị cả hai
văn bản liên kết và URL. Nói cách khác:

Lhttp://example.com/>

được định dạng là:

foohttp://example.com/>

Cờ này, nếu được cung cấp, sẽ chặn URL khi văn bản liên kết được cung cấp, vì vậy ví dụ này
sẽ được định dạng chỉ là "foo". Điều này có thể tạo ra sản lượng ít lộn xộn hơn trong các trường hợp
nơi các URL không đặc biệt quan trọng.

-o, - loverstrike
Định dạng đầu ra với tính năng in quá mức. Văn bản in đậm được hiển thị dưới dạng ký tự,
xóa lùi, ký tự. Chữ nghiêng và tên tệp được hiển thị dưới dạng dấu gạch dưới, dấu lùi,
tính cách. Nhiều máy nhắn tin, chẳng hạn như ít, biết cách chuyển đổi này thành in đậm hoặc gạch chân
văn bản.

-q dấu ngoặc kép, --trích dẫn=dấu ngoặc kép
Đặt các dấu ngoặc kép được sử dụng để bao quanh văn bản C <> thành dấu ngoặc kép. Nếu dấu ngoặc kép là một người độc thân
ký tự, nó được sử dụng như cả câu trích dẫn bên trái và bên phải; nếu như dấu ngoặc kép là hai ký tự,
ký tự đầu tiên được sử dụng làm phần trích dẫn bên trái và ký tự thứ hai làm phần trích dẫn bên phải; và
if dấu ngoặc kép là bốn ký tự, hai ký tự đầu tiên được sử dụng làm dấu ngoặc kép bên trái và ký tự thứ hai
hai là câu trích dẫn đúng.

dấu ngoặc kép cũng có thể được đặt thành giá trị đặc biệt "không có", trong trường hợp này không có dấu ngoặc kép
được thêm xung quanh C <> văn bản.

-s, --câu
Giả sử mỗi câu kết thúc bằng hai khoảng trắng và cố gắng duy trì khoảng cách đó. Không có
tùy chọn này, tất cả các khoảng trắng liên tiếp trong các đoạn văn không phải nguyên văn được nén thành
một không gian duy nhất.

--stderr
Theo mặc định, pod2text chết nếu bất kỳ lỗi nào được phát hiện trong đầu vào POD. Nếu như --stderr is
cho và không --lỗi cờ xuất hiện, lỗi được gửi đến lỗi tiêu chuẩn, nhưng pod2text
không phá thai. Điều này tương đương với "--errors = stderr" và được hỗ trợ để lùi lại
khả năng tương thích.

-t, --termcap
Cố gắng xác định chiều rộng của màn hình và các chuỗi in đậm và gạch chân cho
đầu cuối từ khóa đầu cuối và sử dụng thông tin đó để định dạng đầu ra. Đầu ra sẽ
được bọc ở hai cột nhỏ hơn chiều rộng của thiết bị đầu cuối của bạn. Sử dụng cái này
tùy chọn yêu cầu hệ thống của bạn có một tệp termcap ở đâu đó mà Term :: Cap có thể
tìm nó và yêu cầu hệ thống của bạn hỗ trợ thuật ngữ. Với tùy chọn này, đầu ra
of pod2text sẽ chứa các trình tự điều khiển thiết bị đầu cuối cho loại thiết bị đầu cuối hiện tại của bạn.

-u, --utf8
Theo mặc định, pod2text cố gắng sử dụng mã hóa đầu ra giống như mã hóa đầu vào của nó (để
tương thích ngược với các phiên bản cũ hơn). Tùy chọn này cho biết thay vào đó buộc
mã hóa đầu ra thành UTF-8.

Lưu ý rằng khi sử dụng tùy chọn này, mã hóa đầu vào của nguồn POD của bạn phải là
được khai báo chính xác trừ khi nó là US-ASCII hoặc Latin-1. Đầu vào POD không có "= encoding"
lệnh sẽ được giả định là bằng tiếng Latinh-1 và nếu nó thực sự ở UTF-8, đầu ra
sẽ được mã hóa kép. Nhìn thấy perlpod(1) để biết thêm thông tin về "= encoding"
chỉ huy.

-w, - width =chiều rộng, -chiều rộng
Cột để bọc văn bản ở phía bên phải. Mặc định là 76, trừ khi -t is
đã cho, trong trường hợp này, nó nhỏ hơn hai cột so với chiều rộng của thiết bị đầu cuối của bạn.

EXIT TÌNH TRẠNG

Miễn là tất cả các tài liệu được xử lý dẫn đến một số đầu ra, ngay cả khi đầu ra đó bao gồm
errata (phần "LỖI POD" được tạo bằng "--errors = pod"), pod2text sẽ thoát ra với
trạng thái 0. Nếu bất kỳ tài liệu nào đang được xử lý không dẫn đến tài liệu đầu ra,
pod2text sẽ thoát với trạng thái 1. Nếu có lỗi cú pháp trong tài liệu POD đang
được xử lý và kiểu xử lý lỗi được đặt thành mặc định là "die", pod2text sẽ phá thai
ngay lập tức với trạng thái thoát 255.

CHẨN ĐOÁN

If pod2text không thành công với lỗi, hãy xem Pod :: Văn bản và Pod :: Đơn giản để biết thông tin về những gì
những lỗi đó có thể có nghĩa. Bên trong, nó cũng có thể đưa ra các chẩn đoán sau:

-c (--color) yêu cầu Điều khoản :: ANSIColor được cài đặt
(F) -c or --màu sắc đã được cung cấp, nhưng không thể tải Thuật ngữ :: ANSIColor.

Tùy chọn không xác định:% s
(F) Một tùy chọn dòng lệnh không xác định đã được đưa ra.

Ngoài ra, các thông báo lỗi Getopt :: Dài khác có thể do dòng lệnh không hợp lệ
tùy chọn.

MÔI TRƯỜNG

CỘT
If -t được đưa ra, pod2text sẽ lấy chiều rộng hiện tại của màn hình của bạn từ đây
biến môi trường, nếu có. Nó ghi đè thông tin chiều rộng thiết bị đầu cuối trong
TERMCAP.

TERMCAP
If -t được đưa ra, pod2text sẽ sử dụng nội dung của biến môi trường này nếu
có sẵn để xác định trình tự định dạng chính xác cho thiết bị đầu cuối hiện tại của bạn
thiết bị.

Sử dụng pod2text trực tuyến bằng các dịch vụ onworks.net