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