web-dev-qa-db-ja.com

マニュアルページセクションへのリンク?

セクションアンカー付きのHTMLのオンラインマニュアルページ?

サブセクションへの直接リンクを備えたUbuntuのmanページのオンライン版があればよいでしょう。これにより、多くの場合、たとえばさまざまなStackExchangeサイトの回答など、関連するドキュメントを誰かに示すことができます。

完全なソリューションがどのように見えるか、どのように役立つかを説明します。どこかで完全なソリューションが利用できるとは思わないので、質問は

今日存在する部分的な解決策は?

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


manpages.ubuntu.com のmanページはほとんどの問題を解決しますが、見出しやセクションにアンカーがありません。

つまり、 man bash オンラインの「パラメータ拡張」セクションを指す場合、使用する必要があります

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

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

シェルでは、私は言うことができます

man bash | less "+/Parameter Expansion"をご覧ください

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


リンクアンカーに、それらが指す見出しのような名前を付けると、本当に役立ちます。何らかのインデックス番号で名前が付けられたアンカーは引き続き役立ちますが、それを使用するには実際のWebページを手動で検索する必要があります。

HTMLレベルでは見出しにアンカーを追加することは難しくないので、このようなmanページが存在すると確信しています。
しかし、どこかにオンラインのアンカー付きの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#ParameterExpansion
あるいは
manpages.ubuntu.com/bash#ParameterExpansion

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


他の参照文書の使用

多くの場合、manページにある別の参照ドキュメントがあります。多くの場合、コンテンツテーブルからセクションへのリンクに使用される適切なリンク構造があり、必要なものだけです。
ただし、このは一般的な問題を解決しません。これは、そのようなドキュメントが存在するかどうか/場所を見つけ、リンク構造を利用する一般的な方法がないためです。

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

BashリファレンスマニュアルセクションShell-Parameter-Expansion

[Bash Reference Manual section Shell-Parameter-Expansion](http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)

提案された実装

manpages.ubuntu.comでこのアイデアを実際に実装することを提案するには、
関連プロジェクト「ubuntu-manpage-repository」に密接に関連するバグ/拡張リクエストを提出しました: launchpad#1355271:HTMLのタグを使用して、manページのサブセクションへの外部リンクを許可します

13
Volker Siegel

はい、あります。 http://man.cx/ です。すべてのmanページを1つのサイトに、複数の言語でも持つことを目指しています。残念ながら、アンカーには名前が付けられていませんが、番号が付けられています。たとえば、 http://man.cx/printf#heading1 を使用すると、printf manページの最初の見出しに移動できます。それでも私はそれがアンカーなしよりも良いと思う;)

PS。検索エンジンにサイトを追加したら、単にman printfをアドレスバーに入力すると、正しいページに移動します。

7
Gerhard Burger

nix.stackexchange には、オフラインのマンページをハイパーテキストとして使用する方法も記載されています。私にとって最も簡単な方法は、パッケージの一部であるw3mmanのようですw3m、 そう:

Sudo apt-get install w3m

マニュアルページを開いたとき、f.e。 w3mman man、使用できます TAB 次のリンクに移動します。 (他の典型的なキーボードショートカットも同じように機能します:スクロール、検索、終了:-)

終了確認をオフにするには(manが動作するように):

  • 編集~/.w3m/config

    • 存在しない場合:cp /etc/w3m/config ~/.w3m/
  • セットする confirm_qq 0

通常のmanコマンドを置き換えるには:

  • 編集~/.bashrc

    • 追加 alias man='w3mman'
  • source ~/.bashrc

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

2
PythoNic