链接到手册页部分？

Question

带有部分锚点的 HTML 在线手册页？

最好有一个在线版本的 Ubuntu 手册页，其中包含指向小节的直接链接。这将允许在许多情况下将某人指向相关文档 - 例如在各种 StackExchange 站点的答案中。

我将描述一个完整的解决方案的外观，以及它在哪些方面是有用的。我认为某处没有完整的解决方案，所以问题是

目前存在哪些部分解决方案？

例如，以某种方式搜索手册页而不是链接的系统方法将是部分解决方案。

manpages.ubuntu.com 上 的手册页解决了大部分问题，但它们在标题或部分没有锚点。

这意味着，如果我想指向man bash在线中的“参数扩展”部分 ，我必须使用

请参阅 [... 并使用浏览器搜索“参数扩展”] 中的“参数扩展”man bash

这将在顶部打开 bash 手册页，作为一个长网页。

在外壳中，我可以说

看 man bash | less "+/Parameter Expansion"

在启动时跳转到正确的位置。

将链接锚命名为它们指向的标题会非常有帮助。以某种索引号命名的锚点仍然有帮助，但需要在实际网页上手动查找才能使用它。

由于在 HTML 级别向标题添加锚点并不困难，因此我确信存在这样的手册页；
但是是否有一些带有在线锚点的Ubuntu 手册页集合，或者至少是一个很好的子集？

示例代码

来自
http://manpages.ubuntu.com/bash 的“参数扩展”部分的标题，该部分
重定向到
http://manpages.ubuntu.com/manpages/trusty/en/man1/bash.1.html

       [ ... ]
       tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>,  and  <b>CDPATH</b>,  and  the  shell
       assigns the expanded value.

   <b>Parameter</b> <b>Expansion</b>
       The `<b>$</b>' character introduces parameter expansion, command substitution,
       or arithmetic expansion.  The parameter name or symbol to  be  expanded
       [ ... ]

为了能够直接链接到此部分，我们需要如下内容：

       [ ... ]
       tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>,  and  <b>CDPATH</b>,  and  the  shell
       assigns the expanded value.

   <a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
       The `<b>$</b>' character introduces parameter expansion, command substitution,
       or arithmetic expansion.  The parameter name or symbol to  be  expanded
       [ ... ]

这将向 HTML 代码添加一个标记和一个属性，即不带空格的部分名称：

<b>Parameter</b> <b>Expansion</b>
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>

现在，我们可以链接到像

http://manpages.ubuntu.com/bash#ParameterExpansion
甚至
manpages.ubuntu.com/bash#ParameterExpansion

它使用脚注，写成
[manpages.ubuntu.com/bash#ParameterExpansion][6]

---

其他参考文件的使用

在许多情况下，有可用的替代参考文档，来自手册页。这些通常有一个很好的链接结构，用于从目录链接到我们需要的部分。
但这并不能解决一般问题，因为没有通用的方法来查找这样的文档是否存在/在哪里存在，以及使用链接结构。

对于上面使用的 bash 示例，可以将Bash 参考手册用作手动查找的单个解决方案：

Bash 参考手册部分 Shell-Parameter-Expansion
写成
[Bash 参考手册部分 Shell-Parameter-Expansion](http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)

建议实施

为了提议在manpages.ubuntu.com 上实际实现这个想法，
我在相关项目“ubuntu-manpage-repository”上提交了一个密切相关的错误/增强请求： launchpad #1355271：使用 HTML a 标签允许外部链接到 man 的子部分页

Answer 1

是的，有，它是http://man.cx/。它的目标是在一个站点中包含所有手册页，也包含多种语言。不幸的是，锚没有命名，而是编号：例如http://man.cx/printf#heading1将带您到printf手册页的第一个标题。我仍然认为这比没有锚点要好;)

附注。把网站加入搜索引擎，然后man printf在地址栏里输入，就可以跳转到正确的页面，超级赞！