☰

man ページのセクションにリンクしていますか?

tag-icon • tag-icon documentation html manpage
man ページのセクションにリンクしていますか?

セクション アンカー付きの HTML のオンライン man ページですか?

Ubuntu のマニュアル ページのオンライン バージョンがあり、サブセクションに直接リンクされていると便利です。これにより、多くの場合、たとえばさまざまな StackExchange サイトの回答など、関連するドキュメントを誰かに紹介できるようになります。

完全な解決策がどのようなものになるか、そしてそれがどのように役立つかを説明します。どこかに完全な解決策があるとは思えないので、質問は次のようになります。

現在、どのような部分的な解決策が存在するのでしょうか?

たとえば、リンクする代わりに、何らかの体系的な方法でマニュアル ページを検索すると、部分的な解決策になります。


manページマニュアルページ問題の大部分は解決されますが、見出しやセクションにアンカーがありません。

つまり、「パラメータ拡張」セクションを参照したい場合、 man bashオンラインでは、

「パラメータ拡張」を参照してくださいman bash
[...ブラウザで「パラメータ拡張」を検索してください]

これにより、上部の bash マニュアル ページが 1 つの長い Web ページとして開きます。

シェルの中ではこう言える

見るman bash | less "+/Parameter Expansion"

起動時に適切な場所にジャンプします。


リンク アンカーに、それが指す見出しと同じ名前を付けると非常に便利です。何らかのインデックス番号でアンカーに名前を付けても役立ちますが、使用するには実際の Web ページで手動で検索する必要があります。

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 コードにタグが 1 つと、スペースなしのセクション名という属性が 1 つ追加されます。

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

これで、次のようにセクションにリンクできます。

http://manpages.ubuntu.com/bash#パラメータ展開
あるいは
manpages.ubuntu.com/bash#パラメータ展開

これは脚注を使用しており、
[manpages.ubuntu.com/bash#ParameterExpansion][6] のように書かれています。

その他の参考資料の使用

多くの場合、マニュアルページとは別に、代替の参照ドキュメントが用意されています。これらは、目次からセクションへのリンクに使用できる優れたリンク構造を備えていることが多く、まさに必要なものです。
しかし、一般的な問題は解決しないこのような文書が存在するかどうか、またどこに存在するかを調べたり、リンク構造を利用したりするための共通の方法が存在しないためです。

上記のbashの例では、Bash リファレンスマニュアル手動で検索した個別のソリューションとして使用できます。

Bashリファレンスマニュアルのセクション シェルパラメータ展開

[Bash リファレンス マニュアル セクション Shell-Parameter-Expansion](http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion) と書かれています。

提案された実装

このアイデアを実際に実行することを提案するマニュアルページ、
関連プロジェクト「ubuntu-manpage-repository」に、関連するバグ/機能強化リクエストを提出しました。 launchpad #1355271: HTML a タグを使用して、マニュアルページのサブセクションへの外部リンクを許可します

答え1

はい、ありますよhttp://man.cx/全てのマニュアルページを1つのサイトにまとめ、複数の言語で提供することを目指しています。残念ながらアンカーには名前は付けられておらず、番号が付けられています。例えばhttp://man.cx/printf#見出し1マニュアルページの最初の見出しに移動しますprintf。それでも、アンカーなしよりはましだと思います ;)

PS. サイトを検索エンジンに追加すると、man printfアドレスバーに入力するだけで正しいページに移動できます。とても素晴らしいです!

答え2

の上unix.stackexchange、説明されている方法がありますオフラインのマニュアルページをハイパーテキストとして使用する私にとって最も簡単な方法は、パッケージの一部である w3mman のようですw3m。

sudo apt-get install w3m

man ページを開いたら、 few3mman manを使用して次のリンクに移動できますTAB。(その他の man の一般的なキーボード ショートカットも同様に機能します: スクロール、検索、終了 :-)

終了確認をオフにするには（man動作と同様）：

  • 編集~/.w3m/config

    • 存在しない場合:cp /etc/w3m/config ~/.w3m/

  • セットconfirm_qq 0

通常の男指示：

  • 編集~/.bashrc

    • 追加alias man='w3mman'

  • source ~/.bashrc

これからは、man <some command>通常の man の代わりに w3mman を使用します :) この方法が好きです。質問してくれてありがとう! :)

答え3

8 年経った
今でも、セクション アンカーを使用してマニュアル ページをリンクするのは簡単ではありません。

私が知っているのは、archlinuxのmanページだけであるようだ

アーチリナックスマン

アンカーはいくつかあるが、十分ではない

デモリンク: https://man.archlinux.org/man/bash.1.en#extglob

ヌーマン

いくつかのアンカーがあります

デモリンク: https://www.gnu.org/software/bash/manual/bash.html#インデックス
https://www.gnu.org/software/bash/manual/bash.html#パターンマッチング

関連情報