☰

如何解析 Windows 中的手册页？

tag-icon • tag-icon windows man
如何解析 Windows 中的手册页？

这里有一个原始手册页。有没有什么方法可以在 Windows 下解析它，以使其更具可读性？

答案1

我隶属于该网页Giacomo1968 已在他的回答中发布。我已经将 mandoc suite 的精髓移植到 Windows (MinGW/MSYS) 并创建了该页面。感谢 mandoc suite 和 MinGW/MSYS 的作者和贡献者！因此您有 3 个选择：

  1. 更新：使用此选项，您只需要 Windows 和 mandoc (mdocml) 的预构建二进制文件（可在我的网页上找到）。您无需安装 MinGW、MSYS 或 cygwin 运行时！转到我的页面在 Windows 或 MinGW/MSYS 中查看手册页，请阅读免责声明，下载包含预构建二进制文件的 zip 文件，例如 mdocml-1.13.1-win32-embedeo-02.zip，在本地解压，然后在 Windows 命令行（cmd.exe）中以您的手册页作为参数运行以下任一命令：

    mandoc.exe openvpn.8 | more

    或者，我更喜欢的方式，转换为 html 页面：

    mandoc.exe -Thtml -Oman=%N.%S.html openvpn.8 > openvpn.8.html

    此外，如果您有编写自己的手册页的想法，最好了解一下 mandoc。在我看来，mandoc 套件比仅 roff 的工具集更出色，从作者的角度来看，它是一个更好的“共同点”。

  2. 但是，如果您的手册页过于“传统” roff，或者您对 mandoc 的格式不满意，您可能需要使用 GNU troff (groff) 来格式化/查看您的手册页。例如，您可以从以下位置获取适用于 Windows 的 groff 预构建二进制文件易赢港。

  3. 您可以搜索手册页的在线 html 版本。但是我不推荐此选项，因为在线文档可能涵盖与您本地拥有的版本不同的软件版本，这始终存在风险。

答案2

似乎这套manioc工具适合你：

手册页，也称为 man 页，是 Unix、BSD 和 GNU/Linux 操作系统中一种受广泛支持的、流行的软件文档记录方式。需要使用文本格式化程序将手册页的固有格式处理为适合查看的其他格式。GNU/Linux 系统通常使用 groff，而一些 BSD 系统（例如 OpenBSD）使用 mandoc 程序套件作为文本格式化程序。但是，要在 Windows 中查看手册页，您仍然需要一个格式化程序。因此，我们决定为 Windows 构建 mandoc 套件的主要程序，并将二进制文件放在一起供下载，并附上使用和从源代码构建的简短说明。

相关内容