容器中的 HTML 格式 manpages

简介

openSUSE MicroOS 自诞生以来一直存在一个不足：文档不会被安装到系统中。

对于标准命令来说这没问题：你可以在 Tumbleweed、Leap……或其他发行版或网页上阅读 manpages。但对于一些 MicroOS 特定的工具，这就不行了。

在“过去的美好时光”几十年以前，Sun 有一个我非常喜欢的东西：一个文档服务器，提供所有文档，你也可以将其安装在本地网络上。这正是我一直希望在 openSUSE 上拥有的 :)

所以，如果能通过你的 webbroser 访问所有文档，那不是很好吗？

使用 webbroser 阅读 manpages

要使用 webbroser 阅读手册页和其他文档，你需要一个 web 服务器来提供数据。由于 openSUSE MicroOS 是一个容器主机操作系统，因此将其放入容器中非常合乎逻辑。

现在它来了，启动你自己的 MicroOS 文档服务器

podman run -it --rm --name docserv -p 80:80 -p 443:443 opensuse/microos-docserv

并使用你的 webbroser 连接到 https:// 或 https:// 来浏览、搜索和阅读我们的手册页。

下一个目标

下一个目标不仅仅是提供一个包含 MicroOS 手册页的容器，而是提供一个类似于“manpages.opensuse.org”的东西，其中包含 openSUSE Tumbleweed 的所有 manpages！

但为此需要帮助

1. Alexandre 很好心地创建了一些初始内容。但这需要更多的测试和错误修复，特别是移动设备的支持。

2. 以某种方式生成网页数据 我们需要访问 openSUSE Tumbleweed 的完整树，生成数据并将其上传到 web 服务器。

3. manpages.opensuse.org 我们需要那个子域名，以及一台提供数据的机器。

4. 集成其他文档 我们如何集成其他文档？texinfo？HTML 文档？

任何帮助都受到欢迎，并且需要用于测试、开发和集成。

github 仓库是 rpm2docserv。软件包和容器描述已经包含在 Tumbleweed 中。

整个想法和部分代码都基于 debiman 项目。