マニュアルページセクションにリンクしていますか?


13

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

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

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

今日、どの部分的な解決策がありますか?

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


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

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

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

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

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

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

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


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

HTMLレベルでは、見出しにアンカーを追加することは難しくないので、このようなマニュアルページが存在すると確信しています。
しかし、どこかにオンラインのアンカーがあるUbuntuのmanページのコレクション、または少なくとも優れたサブセットはありますか?

サンプルコード


http://manpages.ubuntu.com/bashの「Parameter Expansion」セクションのヘッダー
これは、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つのタグと、スペースなしのセクション名が追加されます。

<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リファレンスマニュアルを個別のソリューションとして手動で検索できます。

バッシュリファレンスマニュアルセクションシェルパラメータ拡張
として書き込ま
[バッシュリファレンスマニュアルセクションシェルパラメータ膨張](http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)

提案された実装

実際にこのアイデアを実装する提案するmanpages.ubuntu.com
私は、関連するプロジェクト「のubuntu-manページ・リポジトリ」に密接に関連するバグ/機能拡張要求を提出: #1355271をランチパッド:使用HTMLにタグを男のサブセクションへの外部リンクを許可しますページ数


3
良いアイデアのように聞こえます。これに関するバグレポート提出してください。
フロリアンディーシュ

@FlorianDiesch確かに、それは明らかな部分です;)実際、manpages.ubuntu.comは非常にクリーンな実装のように見えますが、それは単一の開発者によって行われたことを覚えています。レッツ・見る
フォルカー・シーゲル


1
@AlaaAli Metaは、Ubuntuプロジェクトに関する質問ではなく、Ubuntuプロジェクトやその他のUbuntu関連のWebサイトに関する質問専用です。
エリアケイガン14

1
ところで、私は非常に似た質問をここに書いた:unix.meta.stackexchange.com/q/3960/135943
ワイルドカード

回答:


7

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

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


1
検索エンジンとしてのブラウザ統合の素晴らしいアイデア!
フィリップウェンドラー14

コメントなしで下票?
ゲルハルトバーガー14

2

unix.stackexchange、方法がする記述があるハイパーテキストとしてオフラインmanページを使用して、あまりにも。私にとって最も簡単な方法は、パッケージの一部であるw3mmanのw3mようです。

sudo apt-get install w3m

manページfeを開いたときに、次のリンクに移動する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を使用します:)この方法が好きです。質問してくれてありがとう!:)

弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.