.\" Copyright 1996 Derek B. Noonburg
.TH xpdf 1 "02 Aug 1999"
.SH NAME
xpdf \-Portable Document Format(PDF)文件閱讀器(版本0.90)
.SH 總覽
.B xpdf
[選項]
.RI [ PDF文件
.RI [ page]]
.SH 描述
.B Xpdf是一個 Portable Document Format(PDF) 文件閱讀軟件.(PDF文件也經常被稱爲"Acrobat" 文件,這種叫法來源於Adobe公司的PDF軟件的名字.) Xpdf運行在UNIX,VMS和OS/2的X Window系統下.
.PP
運行xpdf,只要鍵入:
.PP
.RS
xpdf file.pdf
.RE
.PP
.I file.pdf
是你的PDF文件.文件名字後面可以跟隨一個數字,用於指定最先顯示的頁面的頁碼,比如:
.PP
.RS
xpdf file.pdf 18
.RE
.PP
你當然也可以啓動xpdf而不打開任何文件.
.PP
.RS
xpdf
.RE
.SH 選項
方括弧中列出了X資源和相應的選項
.TP
.B \-err
將錯誤信息指定送到/dev/tty而不是標準錯誤中(此選項當xpdf被其它程序,比如netscape,打開時,十分有用,否則,每個錯誤都會彈出一個令人討厭的小窗口).
.TP
.BI \-z " zoom"
設定初始的放大因子.放大因子是(-5..5)之間的一個數字,其中0表示72dpi.你也可以通過\`page`設定顯示頁面大小配合窗口大小,或者通過\`width`設定顯示頁面寬度配合窗口寬度.
.RB [ xpdf.initialZoom]
.TP
.BI \-g " geometry"
設定窗口的初始幾何參數.
.RB (相當於 \-geometry.)
.RB [ xpdf.geometry]
.TP
.BI \-remote " name"]
啓動/連接名爲name的xpdf遠程服務器(參見後面的"遠程服務器模式"部分)
.TP
.B \-raise
建立xpdf遠程服務器窗口.(僅適用於-remote時)
.TP
.B -\quit
退出xpdf遠程服務器.(僅適用於-remote時)
.TP
.B \-cmap
安裝一個自定義的色彩地圖.此選項在TrueColor模式下無效.
.RB [ xpdf.installCmap]
.TP
.BI \-rgb " number"
設置xpdf將要分配的最大RGB值.缺省值是5(即RGB值5x5x5); 設置一個小數值,可以節省色彩表記錄.在自定義色彩地圖和TrueColor模式下,此選項無效.
.TP
.BI \-papercolor " color"
設置"頁面色彩",比如,頁面的顯示背景.當pdf文件出現類似在字符後填充白色等情況的時候,此選項無法正常工作.
.RB [ xpdf.paperColor]
.TP
.B \-eucjp
複製字符時,將日文字符轉換成EUC-JP編碼.這是至今爲止唯一的日文字符轉換選項---它的唯一作用就是將非日文字符轉換成7-bit的ASCII,以便於配合EUC-JP編碼.(此選項只有在編譯pdftotext時加上日文支持纔有效)
.RB [ xpdf.eucjp ]
.TP
.BI \-t1lib " font-type"
設定使用t1lib類型的字體提供器.選項爲\`none`(完全不使用t1lib),\`plain`(使用non-anti-aliased字體),\`low`或\`high`(使用low-level或者high-level anti-aliased 字體).
.RB [ xpdf.t1libControl]
.TP
.BI \-ps " PS-file"
設定缺省的PostScript輸出文件的名字.此選項也可以以\`|command`的形式,通過某個命令來管道PostScript文件.
.RB [ xpdf.psFile]
.TP
.BI \-paperw " size"
設定頁面寬度,單位是像素點.
.RB [ xpdf.psPaperWidth]
.TP
.BI \-paperh " size"
設定頁面高度,單位是像素點.
.RB [ xpdf.psPaperHeight]
.TP
.B \-level1
產生Level1 PostScript文件.輸出的PostScript文件相當的大(如果它包含圖片的話),但是確可以在Level 1打印機上打印輸出.此選項將所有的圖像轉換成黑白圖像.
.RB [ xpdf.psLevel1]
.TP
.B \-cmd
打印出命令的執行結果(在調試時有用)
.TP
.B \-q
不打印任何信息或者錯誤
.TP
.B \-h
打印幫助信息
.RB (相當於 \-help)
.PP
一些其他的X選項和資源同樣可以如預期的一樣執行
.TP
.BI \-display " display"
.RB [ xpdf.display]
.TP
.BI \-fg " color"
.RB [ 相當於 \-foreground]
.RB [ xpdf.foreground]
.RB \-bg " color"
.RB (相當於 \-background)
.RB [ xpdf.background]
.TP
.BI \-font " font"
.RB ( 相當於 \-fn)
.RB [ xpdf.font]
.PP
色彩和字體選項隻影響用戶界面部分,不影響PDF文件的顯示.(\`paper`)
.PP
下列的X資源沒有對應的命令行選項
.TP
.B xpdf.urlCommand
設定,當你點擊網絡鏈接時執行的命令.詳情參見後面的
.B "網絡瀏覽器"
部分.
.TP
.B xpdf.japaneseFont
設定用於使用日文字符的相應的X字體模式.缺省的是:
.PP
.RS
-*-fixed-medium-r-normal-*-%s-*-*-*-*-*-jisx0208.1983-0
.RE
.TP
.B xpdf.viKeys
設定將左,右,上和下的滾動由\`h`,\`l`,\`k`和\`j`鍵執行.
.PP
下面的資源用於設定文件名字使用的14種基本的Type 1字體.
.PP
.RS
.B xpdf.t1TimesRoman
.br
.B xpdf.t1TimesItalic
.br
.B xpdf.t1TimesBold
.br
.B xpdf.t1TimesBoldItalic
.br
.B xpdf.t1Helvetica
.br
.B xpdf.t1HelveticaOblique
.br
.B xpdf.t1HelveticaBold
.br
.B xpdf.t1HelveticaBoldOblique
.br
.B xpdf.t1Courier
.br
.B xpdf.t1CourierOblique
.br
.B xpdf.t1CourierBold
.br
.B xpdf.t1CourierBoldOblique
.br
.B xpdf.t1Symbol
.br
.B xpdf.t1ZapfDingbats
.RE
.PP
如果激活t1lib,這些Type 1字體將被用於取代X服務器的字體.
.SH 控制
.SS 屏幕控制在xpdf窗口的底部.
.TP
.B "左/右箭頭按鍵"
翻到前/後一頁
.TP
.B "雙左/右箭頭按鍵"
向前/後翻動10頁
.TP
.B "破折號左/右箭頭按鍵"
沿着歷史路徑向前/後翻動
.TP
.B "\`Page`輸入框"
翻到指定的頁碼.通過點擊激活輸入框,輸入頁碼,然後回車.
.TP
.B "放大縮小彈出菜單"
調整放大因子.(參見前面-z選項的說明)
.TP
.B "望遠鏡按鍵"
查找某個文本.
.TP
.B "打印機按鍵"
彈出一個產生PostScript文件的對話框.對話框可以設定需要
打印的頁面和PostScript文件的名字.當文件名字爲\'-'時,代表
標準輸出,或者用\'|command'通過某個命令來管道PostScript,
比如,\'|lpr'.
.TP
.B "\'?'按鍵"
彈出一個\'about xpdf'窗口.
.TP
.B "鏈接信息"
當鼠標移動到某個鏈接的上面,\`?`和\`Quit`按鍵之間的空間用來顯示鏈接地址或者外部文件名.
.TP
.B "\`Quit`按鍵"
退出xpdf.
.PP
.SS 菜單
按鼠標右鍵,會彈出一個含有以下命令的彈出菜單.
.TP
.B "Open..."
通過文件選擇器打開一個新文件.
.TP
.B "Save PDF..."
通過文件選擇器保存現有文件.
.TP
.B "Rotate left"
將當前頁面逆時針旋轉90度.
.TP
.B "Rotate right"
將當前頁面順時針旋轉90度.這兩個旋轉命令主要是爲了那些沒有在文件中正確指定旋轉信息的PDF文件設計的,即使您的X服務器不支持字體旋轉,它依然起作用.
.TP
.B "Quit"
退出xpdf.
.PP
.SS 字符選擇
按住鼠標並拖動它,可以高亮出一個任意的矩形.任何在此矩形中的字符都會被複制到X選擇緩衝中去.
.PP
.SS 鏈接
點擊一個超級鏈接可以跳轉到此鏈接的目標地址中去.一個指向某個PDF文件的鏈接將促使xpdf打開此文件.一個指向某可執行程序的\`launch`的鏈接將彈出一個對話框,如果您點擊\`ok`,就會執行此程序.URL鏈接調出某個外部命令.(參見下面網絡瀏覽器部分.)
.PP
.SS 滾動
按住鼠標中鍵並拖動之,可以滾動頁面.
.PP
.SS 快捷鍵
.TP
.B o
通過文件選擇器打開一個新PDF文件.
.TP
.B f
查找字符串.
.TP
.B n
翻到下一頁.
.TP
.B p
翻到前一頁.
.TP
.BR 空格鍵,PageDown鍵或者Next鍵
向下滾動當前頁面,如果已經到達當前頁面低部,則翻到下一頁.
.TP
.BR Backspace鍵,Delete鍵,PageUp或者Previous鍵
向上滾動當前頁面,如果已經到達頁面頂部,則翻到前一頁.
.TP
.B Home鍵
滾動到當前頁面頂部.
.TP
.B End鍵
滾動到當前頁面低部.
.TP
.B 箭頭鍵
滾動當前頁面.
.TP
.B control-L
更新當前頁面.
.TP
.B q
退出xpdf.
.SH "網絡瀏覽器"
如果您希望點擊一個指向PDF文件的鏈接時,從netscape或者mosaic(或者其他的瀏覽器)中自動啓動xpdf,您需要在您的用戶目錄下修改(或者創建)
.I .mime.types
和
.I .mailcap
文件.
在
.I .mime.types
中加入一行:
.PP
.RS
application/pdf pdf
.RE
.PP
在
.I .mailcap
中加入:
.PP
.RS
# Use xpdf to view PDF files.
.RE 
.RS
application/pdf; xpdf -err %s
.RE
.PP
確認xpdf在您的可執行查找路徑中.
.PP
當您點擊一個PDF文件中的URL鏈接,xpdf將執行一個由xpdf.urlCommand資源指定的命令,並將資源中\`%s`替換爲相應的URL.比如,指定netscape打開URL,可以這樣設定資源.
.PP
.RS
xpdf.urlCommand: netscape -remote `openURL(%s)`
.RE
.SH "遠程服務器模式"
通過指定一個服務器的名字,xpdf可以以遠程服務器模式打開(和文件名,頁碼).
.PP
.RS
xpdf -remote myServer file.pdf
.RE
.PP
如果沒有xpdf運行在以myServer爲名字的服務器模式中,那麼一個新的xpdf窗口會被打開.此時,如果鍵入另一個命令:
.PP
.RS
xpdf -remote myServer another.pdf 9
.RE
.PP
則不會啓動新的xpdf,而前一個xpdf(服務器)將會打開
.I another.pdf
並且顯示第9頁.如果文件名字相同:
.PP
.RS
xpdf -remote myServer another.pdf 4
.RE
.PP
xpdf服務器將會簡單的顯示指定的頁面.
.PP
-raise選項通知服務器喚醒它的窗口.它既可以後面跟隨文件名和頁碼也可以單獨使用.
.PP
-quit選項通知服務器關閉窗口並且退出.
.SH "選項文件"
xpdf會從您的用戶目錄(如果有的話)中讀取一個叫做
.I .xpdfrc
的文件.這個文件可以包含兩種條目.
.TP
.BI fontpath " directory"
在
.IR dicrectory
中尋找Type 1字體.
Xpdf只通過此條目獲得字體編碼.爲了顯示,還要通過
.B fontmap
條目來佈局字體.
.TP
.BI fontmap " PDF-font" "" " X-font"
將
.I PDF-font
(PDF文件中指定的)佈局到
.IR X-font
中去,X-font必須是一個在像素大小位置上含有\`%s`的標準X字體描述.
.PP
比如,使用
.PP
.RS
fontmap TimesCE-Roman -*-times-medium-r-*-*-%s-*-*-*-*-*-iso8859-2
.RE
.PP
來佈局Central European(Latin-2)版的Times-Roman字體.這裏假設您已經安裝了適當的X字體(參見
.BR mkfontdir(1)
).
Xpdf理解ISO8859-2編碼,所以您不需要這些字體的
.B fontpath
條目.
使用Bakoma Type 1字體,可以這樣做:
.PP
.RS
fontpath /home/derekn/fonts/bakoma
.br
fontmap cmb10 -bakoma-cmb10-medium-r-normal--%s-*-*-*-p-*-adobe-fontspecific
.br
fontmap cmbsy10 -bakoma-cmbsy10-medium-r-normal--%s-*-*-*-p-*-adobe-fontspecific
.br
etc...
.RE
.PP
這裏假設Type 1字體在目錄
.IR /home/derekn/fonts/bakoma
下.
.SH 臭蟲
不支持TypeType和Type 3字體.
.SH 作者
The xpdf software and documentation are copyright 1996-1999 Derek
B. Noonburg (derekn@foolabs.com).
.SH "另見"
.BR pdftops(1).
.BR pdftotext(1).
.BR pdfinfo(1).
.BR pdftopbm(1).
.BR pdfimages(1).
.br
.B http://www.foolabs.com/xpdf/
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR