.\" 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/