内容

名称
概要
描述
兼容性
作者
版权和许可
参见

#名称

Pod::Text::Termcap - 使用格式转义将 POD 数据转换为 ASCII 文本

#概要

use Pod::Text::Termcap;
my $parser = Pod::Text::Termcap->new (sentence => 0, width => 78);

# Read POD from STDIN and write to STDOUT.
$parser->parse_from_filehandle;

# Read POD from file.pod and write to file.txt.
$parser->parse_from_file ('file.pod', 'file.txt');

#描述

Pod::Text::Termcap 是 Pod::Text 的一个简单子类，它使用当前终端的正确 termcap 转义序列来突出显示输出文本。除了格式代码之外，它的功能与 Pod::Text 完全相同。有关详细信息和可用选项，请参见 Pod::Text。

此模块使用 Term::Cap 来查找正确的终端设置。有关它如何查找终端数据库信息以及如何在必要时覆盖该行为的信息，请参见该模块的文档。如果无法找到粗体和下划线格式的控制字符串，则会跳过该格式，从而导致与 Pod::Text 相同的输出。

#兼容性

Pod::Text::Termcap 0.04（基于 Pod::Parser）是 Perl 5.6.0 中包含的此模块的第一个版本。

基于 Pod::Simple 的当前 API 添加于 Pod::Text::Termcap 2.00 版本。Pod::Text::Termcap 2.01 版本包含在 Perl 5.9.3 中，这是第一个包含这些更改的 Perl 版本。

直到 Pod::Text::Termcap 4.11 版本，包含在 Perl 5.29.1 中，才修复了与换行和行长相关的几个问题。

Pod::Text::Termcap 4.13 版本在模块加载期间停止设置 TERMPATH 环境变量。它还停止在 Term::Cap 无法找到可用转义序列的情况下回退到 VT100 转义序列，而是生成未格式化的输出，以便在哑终端上获得更好的结果。下一个被纳入 Perl 的版本是 4.14，包含在 Perl 5.31.8 中。

此模块继承了 Pod::Text 的 API 和大部分行为，因此 "COMPATIBILITY" in Pod::Text 中的详细信息也适用。Pod::Text 和 Pod::Text::Termcap 从 4.00 版本开始拥有相同的模块版本，包含在 Perl 5.23.7 中。（不幸的是，在此之前它们以令人困惑的方式分叉了。）

#作者

Russ Allbery <[email protected]>

#版权和许可

本程序是自由软件；您可以根据与 Perl 本身相同的条款重新发布和/或修改它。

#另请参阅

Pod::Text, Pod::Simple, Term::Cap

此模块的当前版本始终可以在其网站上获取：https://www.eyrie.org/~eagle/software/podlators/。它也是 Perl 核心发行版的一部分，从 5.6.0 版本开始。