內容

名稱

Pod::Simple::RTF -- 格式化 Pod 為 RTF

語法

perl -MPod::Simple::RTF -e \
 "exit Pod::Simple::RTF->filter(shift)->any_errata_seen" \
 thingy.pod > thingy.rtf

說明

此類別是一個格式化程式，它會將 Pod 擷取並呈現為 RTF，適合在 MSWord、WordPad/write.exe、TextEdit 等瀏覽/列印。

這是 Pod::Simple 的子類別，並繼承其所有方法。

格式控制屬性

您可以在呼叫 parse_file（或類似方法）之前，在剖析器物件上設定這些屬性

$parser->head1_halfpoint_size( halfpoint_integer );
$parser->head2_halfpoint_size( halfpoint_integer );
$parser->head3_halfpoint_size( halfpoint_integer );
$parser->head4_halfpoint_size( halfpoint_integer );

這些方法設定這些標題層級將顯示的大小（以半點為單位，例如 26 點為 52）。

$parser->codeblock_halfpoint_size( halfpoint_integer );

此方法設定程式區塊（「逐字節區段」）將顯示的大小（以半點為單位，例如 21 代表 10.5 點）。

$parser->header_halfpoint_size( halfpoint_integer );

此方法設定每頁標題將顯示的大小（以半點為單位，例如 15 代表 7.5 點）。標題通常只是「模組名稱 頁數 頁碼」。

$parser->normal_halfpoint_size( halfpoint_integer );

此方法設定一般段落文字將顯示的大小（以半點為單位，例如 26 代表 13 點）。

$parser->no_proofing_exemptions( true_or_false );

如果您不希望格式化程式將隱藏程式碼置於所有 Perl 符號（盡可能偵測到），並標記為非英文，因此不值得拼字檢查，請將此值設定為 true。

$parser->doc_lang( microsoft_decimal_language_code )

此方法設定語言程式碼，將此文件標記為該語言。預設值目前為環境變數 RTFDEFLANG 的值，如果未設定，則為值 1033（美國英文）。

如果您想使用 RTF 進行拼字檢查，和/或想要正確斷字，適當地設定此值會很有用。

以下是一些值得注意的值

1033  US English
2057  UK English
3081  Australia English
4105  Canada English
1034  Spain Spanish
2058  Mexico Spanish
1031  Germany German
1036  France French
3084  Canada French
1035  Finnish
1044  Norwegian (Bokmal)
2068  Norwegian (Nynorsk)

如果您特別有興趣進一步自訂此模組的輸出，請參閱原始碼和/或寫信給我。

另請參閱

Pod::Simple、RTF::Writer、RTF::Cookbook、RTF::Document、RTF::Generator

支援

有關 POD 和 Pod::Simple 的問題或討論，應寄送至 pod-people@perl.org 郵件清單。寄送空白電子郵件至 pod-people-subscribe@perl.org 訂閱。

此模組在開放的 GitHub 儲存庫中管理，https://github.com/perl-pod/pod-simple/。歡迎分岔和貢獻，或複製 git://github.com/perl-pod/pod-simple.git 並發送修補程式！

歡迎提交針對 Pod::Simple 的修補程式。請將錯誤報告寄送至 <bug-pod-simple@rt.cpan.org>。

著作權和免責聲明

著作權所有 (c) 2002 Sean M. Burke。

此函式庫為免費軟體；您可以在與 Perl 相同的條款下重新散布或修改它。

散布此程式是希望它能有所幫助，但沒有任何擔保；甚至沒有對特定用途的適售性或適用性的默示擔保。

作者

Pod::Simple 由 Sean M. Burke <sburke@cpan.org> 建立。但別去煩他，他已經退休了。

Pod::Simple 由以下人員維護