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

CHƯƠNG TRÌNH:

TÊN

gropdf - Trình điều khiển PDF cho Groff

SYNOPSIS

gropdf [-delv] [-F dir] [-p giấy tờ] [-y đúc] [-u [tệp cmap]] [các tập tin hữu ích. Cảm ơn !]

Có thể có khoảng trắng giữa tùy chọn dòng lệnh và tham số của nó.

MÔ TẢ

gropdf dịch đầu ra của GNU troff sang PDF. Thông thường gropdf nên được gọi bởi
sử dụng lệnh groff với -tpdf Lựa chọn. Nếu không có tệp nào được cung cấp, gropdf đọc
đầu vào chuẩn. Tên tệp của - cũng là nguyên nhân gropdf để đọc đầu vào tiêu chuẩn. PDF
đầu ra được ghi vào đầu ra tiêu chuẩn. Khi nào gropdf được điều hành bởi sự lộn xộn các tùy chọn có thể được
đã vượt qua gropdf sử dụng sự lộn xộn's -P tùy chọn.

Xem phần NÉT CHỮ LẮP ĐẶT dưới đây để biết hướng dẫn cách cài đặt phông chữ cho gropdf.

LỰA CHỌN

-d Bao gồm thông tin gỡ lỗi dưới dạng nhận xét trong PDF. Cũng tạo ra một
PDF không nén.

-e Buộc nhúng tất cả các phông chữ vào PDF.

-Fdir Thêm thư mục trước dir/ devtên đến đường dẫn tìm kiếm phông chữ và mô tả thiết bị
các tập tin; tên là tên của thiết bị, thường là pdf.

-l In tài liệu ở định dạng ngang.

-pkhổ giấy
Đặt kích thước vật lý của phương tiện đầu ra. Điều này ghi đè giấy tờ,
độ dài giấyvà khổ giấy lệnh trong DESC tập tin; nó chấp nhận như nhau
đối số như giấy tờ chỉ huy. Nhìn thấy groff_font (5) để biết thêm chi tiết.

-v In số phiên bản.

-yđúc
Đặt xưởng đúc để chọn phông chữ cùng tên.

-e Lực lượng gropdf để nhúng TẤT CẢ phông chữ (ngay cả 14 phông chữ PDF cơ bản).

-s Nối một dòng chú thích vào cuối tệp PDF hiển thị số liệu thống kê, tức là số trang trong
tài liệu. Ghostscript's ps2pdf phàn nàn về dòng này nếu nó được bao gồm, nhưng
vẫn hoạt động.

-u
-utên tập tin cmap
Gropdf thường bao gồm một CMap ToUnicode với bất kỳ phông chữ nào được tạo bằng văn bản.enc as
tệp mã hóa, điều này giúp việc tìm kiếm các từ có chứa
chữ ghép. Bạn có thể bao gồm CMap của riêng mình bằng cách chỉ định tên tập tin cmap hoặc không có
CMap bằng cách bỏ qua đối số.

SỬ DỤNG

Đầu vào cho gropdf phải ở định dạng đầu ra bởi troff(1). Điều này được mô tả trong
thô lỗ(5).

Ngoài ra, các tập tin mô tả thiết bị và phông chữ cho thiết bị được sử dụng phải đáp ứng một số
yêu cầu: Độ phân giải phải là bội số nguyên của 72 lần kích thước. Các
pdf thiết bị sử dụng độ phân giải 72000 và tỷ lệ kích thước là 1000.

Tệp mô tả thiết bị phải có khổ giấy hợp lệ; Thấy chưa groff_font(5) để biết thêm
thông tin. gropdf sử dụng cùng một phông chữ tái bút Adobe Loại 1 như lùm cây thiết bị
tài xế. Mặc dù Tiêu chuẩn PDF cho phép sử dụng các loại phông chữ khác (như TrueType), điều này
việc triển khai chỉ chấp nhận phông chữ tái bút Loại 1. Ít phông chữ Loại 1 hơn được hỗ trợ
nguyên bản trong các tài liệu PDF so với 35 phông chữ tiêu chuẩn được hỗ trợ bởi lùm cây và tất cả phần tái bút
máy in, nhưng tất cả các phông chữ đều có sẵn vì bất kỳ phông chữ nào không được hỗ trợ nguyên bản đều
được nhúng tự động trong PDF.

gropdf hỗ trợ khái niệm về xưởng đúc, đó là các phiên bản khác nhau về cơ bản giống nhau
nét chữ. Trong khi cài đặt Foundry kiểm soát tệp nơi tìm thấy phông chữ và bản dựng sự lộn xộn phông chữ
từ các tệp nó phát hiện ra trên hệ thống của bạn.

Mỗi tệp mô tả phông chữ phải chứa một lệnh

tên nội địa tên ps

cho biết rằng tên PostScript của phông chữ là tên ps. Các dòng bắt đầu bằng # và
các dòng trống bị bỏ qua. Mã cho mỗi ký tự được cung cấp trong tệp phông chữ phải
tương ứng với mã trong bảng mã mặc định cho phông chữ. Mã này có thể được sử dụng với
các \N trình tự thoát trong troff để chọn ký tự, ngay cả khi ký tự không
có một cái tên vụng về. Mọi ký tự trong tệp phông chữ phải tồn tại trong phông chữ PostScript,
và chiều rộng được cung cấp trong tệp phông chữ phải phù hợp với chiều rộng được sử dụng trong phông chữ PostScript.

Lưu ý rằng gropdf hiện chỉ có thể hiển thị 256 glyph đầu tiên bằng bất kỳ phông chữ nào. Điều này
hạn chế sẽ được dỡ bỏ trong phiên bản sau.

gropdf có thể tự động bao gồm các phông chữ có thể tải xuống cần thiết để in tài liệu.
Phông chữ có thể ở định dạng PFA hoặc PFB.

Bất kỳ phông chữ có thể tải xuống nào, khi được yêu cầu, phải được bao gồm bởi gropdf phải được liệt kê
Trong tập tin /usr/share/groff/1.22.3/font/devpdf/download; điều này nên bao gồm các dòng
hình thức

đúc font chữ tên tập tin

Ở đâu đúc là tên xưởng đúc hoặc để trống cho xưởng đúc mặc định. font chữ là
PostScript tên phông chữ, và tên tập tin là tên của tệp chứa phông chữ;
dòng bắt đầu bằng # và các dòng trống được bỏ qua; các trường phải được phân tách bằng các tab
(không gian là không cho phép); tên tập tin được tìm kiếm bằng cách sử dụng cùng một cơ chế được sử dụng
cho các tệp chỉ số phông chữ Groff. Các tải về bản thân tệp cũng được tìm kiếm để sử dụng
cơ chế; hiện tại, chỉ tệp được tìm thấy đầu tiên trong đường dẫn phông chữ được sử dụng. Tên xưởng đúc
thường là một ký tự đơn (chẳng hạn như 'U' cho URW Foundry) hoặc trống cho mặc định
xưởng đúc. Mặc định này sử dụng các phông chữ giống như bản viết tay sử dụng khi nó nhúng phông chữ vào
File PDF.

Trong thiết lập mặc định, có các kiểu được gọi là R, I, Bvà BI gắn ở vị trí phông chữ 1
đến 4. Các phông chữ được nhóm thành các họ A, BM, C, H, HN, N, Pvà T có các thành viên trong
mỗi kiểu sau:

AR AvantGarde-Sách
AI AvantGarde-SáchXiên
AB AvantGarde-Demi
Giúp đỡ AvantGarde-DemiXiên
BMR Bookman-Light
BMI Bookman-LightItalic
BMB Bookman-Demi
BMBI Bookman-DemiItalic
CR Chuyển phát nhanh
CI Chuyển phát nhanh-Xiên
CB Chuyển phát nhanh-In đậm
CBI Chuyển phát nhanh-BoldOblique
HR Helvetica
HI Helvetica-Xiên
HB Helvetica-Đậm
HBI Helvetica-BoldXiên
HNR Helvetica-Hẹp
HNI Helvetica-Hẹp-Xiên
HNB Helvetica-Hẹp-Đậm
HNBI Helvetica-Hẹp-ĐậmXiên
NR NewCenturySchlbk-La Mã
NI Thế kỷ mớiSchlbk-nghiêng
NB Thế Kỷ MớiSchlbk-Bold
NBI NewCenturySchlbk-BoldItalic
PR Palatino-La Mã
PI Tiếng Palatino-Ý
PB Palatino-Bold
PBI Palatino-BoldÝ
TR Thời-La Mã
TI Times-Nghiêng
TB Dấu thời gian
TBI Times-Đậm Nghiêng

Ngoài ra còn có phông chữ sau đây không phải là thành viên của một gia đình:

ZCMI ZapfChancery-MediumItalic

Ngoài ra còn có một số phông chữ đặc biệt được gọi là S cho phông chữ PS Symbol. Chữ Hy Lạp viết thường
các ký tự được tự động nghiêng (để khớp với phông chữ SymbolSlanted (SS) có sẵn cho
tái bút). Zapf Dingbats có sẵn dưới dạng ZD, glyph "chỉ tay sang trái" (\ [lh]) là
khả dụng vì nó đã được xác định bằng cách sử dụng phần mở rộng \ X'pdf: xrev ', phần mở rộng này đảo ngược
hướng của các chữ cái trong các từ.

Màu mặc định cho \m và \M là màu đen; cho các màu được xác định trong không gian màu 'rgb'
setrgbcolor được sử dụng cho 'cmy' và 'cmyk' setcmykcolorvà cho 'màu xám' xám xịt. Lưu ý rằng
setcmykcolor là một lệnh PostScript LanguageLevel 2 và do đó không có sẵn trên một số
máy in.

gropdf hiểu một số lệnh X được tạo bằng cách sử dụng \X trình tự thoát được hỗ trợ
by lùm xùm. Cụ thể như sau được hỗ trợ.

\ X'ps: invis '
Kìm hãm sản lượng.

\ X'ps: endinvis '
Ngừng chặn đầu ra.

\ X'ps: giám đốc điều hành lưu trữ điểm hiện tại 2 bản sao dịch n quay phủ định trao đổi phủ định trao đổi Phiên dịch'
Ở đâu n là góc quay. Điều này là để hỗ trợ sắp xếp chỉ huy trong gpic.

\ X'ps: giám đốc điều hành grestore '
Một lần nữa được sử dụng bởi gpic để khôi phục sau khi quay.

\ X'ps: giám đốc điều hành n setlinejoin '
Ở đâu n có thể là một trong các giá trị sau.

0 = Tham gia Mitre
1 = Tham gia vòng
2 = Tham gia góc xiên

\ X'ps: giám đốc điều hành n setlinecap '
Ở đâu n có thể là một trong các giá trị sau.

0 = Nắp mông
1 = Nắp tròn, và
2 = Hình chiếu mũ vuông

\ X'ps: hữu ích. Cảm ơn ! pdfmark '
Tất cả các dấu pdf macro được cài đặt bằng cách sử dụng -m dấu pdf or -m mspdf (xem tài liệu
trong 'pdfmark.pdf'). Một tập hợp con của các macro này được cài đặt tự động khi bạn
sử dụng -tpdf vì vậy bạn không cần sử dụng '-m pdfmark' để sử dụng hầu hết các tệp PDF
chức năng.

Tất cả khác ps: các thẻ bị bỏ qua một cách im lặng.

Một \X đặc biệt được sử dụng bởi trình điều khiển DVI cũng được công nhận:

\ X'papersize =khổ giấy'
nơi khổ giấy tham số giống như giấy tờ chỉ huy. Nhìn thấy
groff_font(5) để biết chi tiết. Điều này có nghĩa là bạn có thể thay đổi kích thước trang theo ý muốn
trong tệp PDF được tạo bởi gropdf. Nếu bạn muốn thay đổi giấy
kích thước, nó phải được thực hiện trước khi bạn bắt đầu tạo trang.

Ngoài ra, gropdf hỗ trợ bộ riêng của pdf: các thẻ. Các thẻ sau đây là
được hỗ trợ:

\ X'pdf: pdfpic hồ sơ liên kết chiều rộng cao độ dài dòng'
Đặt một hình ảnh của chỉ định chiều rộng chứa bản vẽ PDF từ tệp hồ sơ of
mong muốn chiều rộng và cao (nếu cao bị thiếu hoặc bằng không thì nó được chia tỷ lệ
theo tỷ lệ). Nếu như liên kết is -L bản vẽ được căn trái. Nếu nó là -C or
-R a độ dài lớn hơn chiều rộng của bản vẽ cũng được yêu cầu. Nếu như
chiều rộng được chỉ định bằng XNUMX thì chiều rộng được chia tỷ lệ tương ứng với chiều cao.

\ X'pdf: xrev '
Thao tác này chuyển đổi một cờ đảo ngược hướng in bức thư by bức thư,
tức là, mỗi chữ cái riêng biệt được đảo ngược, không phải toàn bộ từ. Điều này hữu ích cho
đảo ngược hướng của glyphs trong phông chữ Dingbats. Để trở lại bình thường
in lặp lại lệnh một lần nữa.

\ X'pdf: đánh dấu / ANN định nghĩa'
Các macro hỗ trợ Dấu trang PDF sử dụng lệnh gọi này trong nội bộ để bắt đầu
định nghĩa về điểm phát sóng đánh dấu (người dùng sẽ gọi là '.pdfhref L' với văn bản
sẽ trở thành khu vực 'điểm nóng'). Thông thường, điều này không bao giờ được sử dụng ngoại trừ từ
trong macro pdfmark.

\ X'pdf: markend '
Các macro hỗ trợ Dấu trang PDF sử dụng lệnh gọi này trong nội bộ để ngăn
định nghĩa về điểm phát sóng đánh dấu (người dùng sẽ gọi là '.pdfhref L' với văn bản
sẽ trở thành khu vực 'điểm nóng'). Thông thường, điều này không bao giờ được sử dụng ngoại trừ từ
trong macro pdfmark.

\ X'pdf: markuspend '
\ X'pdf: markrestart '
Nếu bạn đang sử dụng bẫy trang để tạo tiêu đề, chân trang, v.v., bạn cần sử dụng
những điều này trong trường hợp một 'điểm nóng' vượt qua ranh giới trang, nếu không, bất kỳ văn bản nào xuất ra bằng
macro đầu đề hoặc chân sẽ được đánh dấu là một phần của 'điểm nóng'. Dừng lại
điều này đang xảy ra chỉ cần đặt '.pdfmarksuspend' và '.pdfmarkrestart' ở đầu và
cuối macro bẫy trang, tương ứng. (Đây chỉ là những macro tiện lợi
phát ra mã \ X. Các macro này chỉ được sử dụng trong bẫy trang.)

Nhập khẩu đồ họa
gropdf chỉ hỗ trợ nhập các tệp PDF khác dưới dạng đồ họa. Nhưng tệp PDF đó có thể chứa
bất kỳ định dạng đồ họa nào được hỗ trợ bởi tiêu chuẩn PDF (chẳng hạn như JPEG, PNG, GIF, v.v.).
Vì vậy, bất kỳ ứng dụng nào xuất ra PDF đều có thể được sử dụng làm tệp nhúng trong gropdf. PDF
tệp bạn muốn chèn phải là một trang duy nhất và bản vẽ phải vừa với
kích thước phương tiện của tệp PDF. Vì vậy, trong inkscape(1) hoặc cái nhìn(1) (ví dụ) đảm bảo
kích thước canvas vừa với hình ảnh.

Trình phân tích cú pháp PDF được sử dụng trong gropdf chưa được kiểm tra nghiêm ngặt với tất cả những gì có thể
các ứng dụng tạo ra các tệp PDF. Nếu bạn tìm thấy một trang PDF không thể nhập được
đúng cách, nó đáng để chạy nó qua pdftk(1) chương trình bằng cách ra lệnh:

pdftk tập tin cũ.pdf đầu ra tập tin mới.pdf

Bạn có thể thấy rằng tập tin mới.pdf bây giờ sẽ tải thành công.

Đúng kiểu và khác font chữ định dạng
gropdf không hỗ trợ bất kỳ phông chữ nào khác ngoại trừ Adobe Loại 1 (PFA hoặc PFB).

NÉT CHỮ LẮP ĐẶT

Phần này tóm tắt các giải thích trên; nó có thể phục vụ như một bước
hướng dẫn cài đặt phông chữ cho gropdf.

· Chuyển đổi phông chữ của bạn sang một cái gì đó mà người ta hiểu. Đây là PostScript Type 1
phông chữ trong PFA hoặc PFB, cùng với tệp AFM.

Dòng đầu tiên trong tệp PFA / PFB chứa dòng này:

%! PS-AdobeFont-1.0:

Tệp PFB cũng có điều này ở dòng đầu tiên, nhưng chuỗi được đặt trước bằng một số
byte nhị phân.

· Chuyển đổi tệp AFM thành tệp mô tả phông chữ kỳ lạ với khẳng định(1) chương trình.
Một cuộc gọi ví dụ là

afmtodit Bản đồ Foo-Bar-Bold.afm / textmap FBB

chuyển đổi tệp số liệu 'Foo-Bar-Bold.afm' thành phông chữ Groff 'FBB'. nếu bạn
có họ phông chữ đi kèm với các mặt in nghiêng bình thường, đậm, nghiêng và đậm, đó là
đề nghị sử dụng các chữ cái R, B, Ivà BI, tương ứng, dưới dạng các hậu tố trong
tên phông chữ groff để làm cho yêu cầu '.fam' của groff hoạt động. Một ví dụ là tích hợp sẵn của groff
Phông chữ Times-Roman: Họ phông chữ là T, và tên phông chữ lộn xộn là TR, TB, TI,
và TBI.

· Cài đặt cả tệp mô tả phông chữ Groff và phông chữ trong thư mục con 'devpdf'
của đường dẫn phông chữ mà Groff tìm thấy. Xem MÔI TRƯỜNG phần trong troff(1) người đàn ông
trang liệt kê giá trị thực của đường dẫn phông chữ. Lưu ý rằng Groff không sử dụng
Các tệp AFM (nhưng bạn nên lưu trữ chúng).

· Đăng ký tất cả các phông chữ phải được tải xuống máy in trong 'devpdf / download'
tập tin. Chỉ lần xuất hiện đầu tiên của tệp này trong đường dẫn phông chữ mới được đọc. Điều này có nghĩa là
rằng bạn nên sao chép tệp 'tải xuống' mặc định vào thư mục đầu tiên trong phông chữ của bạn
đường dẫn và thêm phông chữ của bạn vào đó. Để tiếp tục ví dụ trên, chúng tôi giả định rằng PS
tên phông chữ cho Foo-Bar-Bold.pfa là 'XY-Foo-Bar-Bold' (tên phông chữ PS được lưu trữ trong
tên nội địa trường trong tệp 'FBB') và thuộc về xưởng đúc 'Fcq] do đó như sau
dòng sẽ được thêm vào 'tải xuống':

F XY-Foo-Bar-In đậm Foo-Bar-Bold.pfa

Sử dụng ký tự tab để phân tách các trường và trường 'đúc' phải để trống đối với
xưởng đúc mặc định.

MÔI TRƯỜNG

GROFF_FONT_PATH
Danh sách các thư mục để tìm kiếm devtên thư mục ngoài
những cái mặc định. Nếu, trong tệp 'tải xuống', tệp phông chữ đã được chỉ định
với một đường dẫn đầy đủ, không có thư mục nào được tìm kiếm. Nhìn thấy troff(1) groff_font(5) cho
biết thêm chi tiết.

SOURCE_DATE_EPOCH
Dấu thời gian (được biểu thị bằng giây kể từ kỷ nguyên Unix) để sử dụng khi tạo
dấu thời gian thay cho thời gian hiện tại.

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