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/zh/man/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的各个部分页数