次の記事では、Umを見ていきます。 今日、誰もmanページとその代替の有用性を疑うことはできません。 これらの代替手段は、主にアクセスするために使用されます カスタム例、したがって、manページ全体を確認する必要はありません。 Gnu / Linuxコマンドを簡単に通信または学習するための迅速な方法を探している場合は、これらの代替手段を試す価値があります。 Umを使用すると、コマンドの独自のヘルプページを作成できます。 これはターミナルユーティリティであり、 独自のマニュアルページを簡単に作成および保守できます 私たちが興味を持っているものだけが含まれています。
独自のヘルプページを作成することで、多くの「詳細」のマニュアルページに、関心のあるケースを考慮に入れるために必要なものだけを含めます。 あなたが望むなら 独自のマニュアルページのセットを作成する、ええと、間違いなくあなたに役立ちます。
Ubuntu18.04にUmをインストールします
UmはGnu / LinuxおよびMacOSで利用できます。 私がこれを書いているとき、私はただ Linuxbrewパッケージマネージャーを使用してインストールできます Gnu / Linuxシステム。 以下を確認してください Linuxbrewをまだインストールしていない場合の記事 次のことを行う必要があるため、Ubuntuで。
Linuxbrewがインストールされたら、ターミナルで次のコマンドを実行します（Ctrl + Alt + T）。 Umをインストールします:
brew install sinclairtarget/wst/um
すべてがうまくいけば、端末はインストールが問題なく終了したことを知らせてくれます。
マニュアルページを作成するためにそれを使用する前に、あなたはしなければなりません Umのbash完了を有効にする。 これを行うには、ファイルを開きます 〜/ .bash_profile:
vi ~/.bash_profile
そして、次の行をファイルに追加します。
if [ -f $(brew --prefix)/etc/bash_completion.d/um-completion.sh ]; then . $(brew --prefix)/etc/bash_completion.d/um-completion.sh fi
ファイルを保存して閉じます。 次のコマンドを実行して、 変更の更新:
source ~/.bash_profile
すべての準備ができました。 これで、最初のマニュアルページを作成できます。
Umを構成する
へ 現在の設定を表示、実行：
um config
このファイルでは、最も関心があるので、デフォルトのテーマ、ページディレクトリ、ページなどのオプションの値を編集および変更できます。 たとえば、Dropboxフォルダーに作成されたUmページを保存する場合は、pagesディレクトリディレクティブの値を変更して、のDropboxフォルダーに送信するとします。 アーカイブ 〜/ .um / umconfig その中に書く。
pages_directory = /home/tu-usuario/Dropbox/um
このファイルが作成されていない場合は、構成を保存するために作成する必要があります。
独自のマニュアルページを作成して維持する
興味があれば言いましょう コマンド用に独自のマニュアルページを作成する 'apt'、ターミナルで実行（Ctrl + Alt + T）：
um edit apt
上記のコマンドは デフォルトのエディタのテンプレート:
私のデフォルトのエディタはViです。 今、私たちは始めることができます 覚えておく必要のあるものをすべて追加してください このテンプレートの「apt」コマンドについて。
上のスクリーンショットに見られるように、例として、aptコマンドの概要、説明、およびいくつかのオプションを追加しました。 きっとできるだろう 必要な数のセクションを追加します これらのページで。 各セクションに適切でわかりやすいタイトルを付けていることを確認してください。 完了したら、ファイルを保存して終了します。 Viエディターを使用している場合は、ESCキーを押して次のように入力します。wq。
今、あなたはすることができます 新しく作成したマニュアルページを表示する コマンドの使用：
um apt
ご覧のとおり、aptのmanページ 公式のマニュアルページと同じように見えます。 マニュアルページで詳細を編集および/または追加する場合は、同じコマンドを再度実行して、必要な詳細を追加します。
um edit apt
彼女を捕まえるために Umを使用して最近作成されたマニュアルページのリスト、ターミナルで実行（Ctrl + Alt + T）：
um list
そうでない場合 特定のページはもう必要ありません、以下のように削除してください。
um rm dpkg
へ ヘルプセクションを参照してください 使用可能なすべての一般オプションで、次のコマンドを起動します。
um --help
Todas マニュアルページは〜/ .umというディレクトリに保存されます ホームディレクトリにあります。 誰でもできます このアプリケーションについてもっと知る プロジェクトが持っているリポジトリ内 GitHubの.