我們談了一些 手冊頁的一個很好的替代品這些替代方法主要用於學習簡短的 Linux 命令示例，而無需閱讀全面的手冊頁。 如果您正在尋找一種簡單快捷的方式來學習 Linux 命令，那麼這些替代方法值得一試。現在您可能想知道 – 您如何為 Linux 命令創建自己的類人幫助頁面？ “1” 方便的。 Um 是一個命令行實用程序，用於輕鬆創建和維護您自己的手冊頁，其中僅包含您目前對命令的了解。
通過創建自己的手冊頁替代方案，您可以避免在手冊頁中包含不必要的詳盡細節，而只包含您需要記住的內容。如果您想創建自己的一組類似人的頁面，Um 絕對可以提供幫助。這個簡短的教程將向您展示如何安裝“Um”命令行實用程序以及如何創建自己的手冊頁。
內容
安裝
Um 適用於 Linux 和 Mac OS。目前它只安裝使用 Linuxbrew Linux 系統的包管理器。 如果您沒有安裝 Linuxbrew，請參閱下面的鏈接。
- Linuxbrew – 適用於 Linux 和 Mac OS X 的通用包管理器
安裝 Linuxbrew 後，運行以下命令安裝 Um 實用程序：
$ brew install sinclairtarget/wst/um
如果您看到類似於以下的輸出，恭喜！好吧，它已經安裝並可以使用了。
[...] ==> Installing sinclairtarget/wst/um ==> Downloading https://github.com/sinclairtarget/um/archive/4.0.0.tar.gz ==> Downloading from https://codeload.github.com/sinclairtarget/um/tar.gz/4.0.0 -=#=# # # ==> Downloading https://rubygems.org/gems/kramdown-1.17.0.gem ######################################################################## 100.0% ==> gem install /home/sk/.cache/Homebrew/downloads/d0a5d978120a791d9c5965fc103866815189a4e3939 ==> Caveats Bash completion has been installed to: /home/linuxbrew/.linuxbrew/etc/bash_completion.d ==> Summary ? /home/linuxbrew/.linuxbrew/Cellar/um/4.0.0: 714 files, 1.3MB, built in 35 seconds ==> Caveats ==> openssl A CA file has been bootstrapped using certificates from the SystemRoots keychain. To add additional certificates (e.g. the certificates added in the System keychain), place .pem files in /home/linuxbrew/.linuxbrew/etc/openssl/certs and run /home/linuxbrew/.linuxbrew/opt/openssl/bin/c_rehash ==> ruby Emacs Lisp files have been installed to: /home/linuxbrew/.linuxbrew/share/emacs/site-lisp/ruby ==> um Bash completion has been installed to: /home/linuxbrew/.linuxbrew/etc/bash_completion.d
在使用 make 手冊頁之前，您需要啟用 bash 以完成 um。
去做這個， ~/.bash_profile 文檔：
$ nano ~/.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
全部完成。讓我們創建我們的第一個手冊頁。
創建和維護您自己的手冊頁
假設您為“dpkg”命令創建了自己的手冊頁。為此，請運行：
$ um edit dpkg
上述命令將在您的默認編輯器中打開降價模板。
創建一個新的手冊頁
我的默認編輯器是 Vi，所以上面的命令將在 Vi 編輯器中打開。然後將您想記住的關於“dpkg”命令的所有內容添加到此模板中。
例如：
將內容添加到 dpkg 手冊頁
從上面的輸出可以看出，我在 dpkg 命令中添加了摘要、描述和兩個選項。 手冊頁可以包含任意數量的部分。給每個部分一個準確和描述性的標題。完成後，保存文件並退出（如果您使用的是 Vi 編輯器， 結束 鍵和類型 :wq）。
最後，使用以下命令查看新創建的手冊頁：
$ um dpkg
檢查 dpkg 手冊頁
如您所見，dpkg 手冊頁看起來與官方手冊頁一模一樣。 如果您在手冊頁中編輯或添加詳細信息，請再次運行相同的命令並添加詳細信息。
$ um edit dpkg
要使用 Um 查看新創建的手冊頁列表，請運行以下命令：
$ um list
所有手冊頁都存儲在名為：.um在你的主目錄中
如果您不需要特定的手冊頁，只需將其刪除，如下所示。
$ um rm dpkg
要查看幫助部分和所有可用的常規選項，請運行以下命令：
$ um --help
usage: um <page name>
um <sub-command> [ARGS...]
The first form is equivalent to `um read <page name>`.
Subcommands:
um (l)ist List the available pages for the current topic.
um (r)ead <page name> Read the given page under the current topic.
um (e)dit <page name> Create or edit the given page under the current topic.
um rm <page name> Remove the given page.
um
um topics List all topics.
um (c)onfig [config key] Display configuration environment.
um (h)elp [sub-command] Display this help message, or the help message for a sub-command.作文 1
要查看當前配置，請運行：
$ um config Options prefixed by '*' are set in /home/sk/.um/umconfig. editor = vi pager = less pages_directory = /home/sk/.um/pages default_topic = shell pages_ext = .md
在此文件中，您可以編輯和更改 尋呼機, 編輯, 默認主題, pages_directory， 什麼時候 pages_ext 選擇你喜歡的。比如一個新創建的 Um 頁面 投遞箱 文件夾，只需更改 pages_directory 運行命令並將其指向您的 Dropbox 文件夾。 ~/.um/umconfig 文檔。
pages_directory = /Users/myusername/Dropbox/um
希望這可以幫助。
資源：
- 嗯 GitHub 存儲庫
謝謝你的到來！
幫助我們幫助您：
- 訂閱我們的電子郵件通訊： 立即註冊
- 支持 OSTechNix： 通過貝寶捐款
- 下載免費的電子書和視頻： TradePub 的 OSTechNix
- 詢問： 紅迪網 | | Facebook | | 推特 | | 領英 | | RSS訂閱
祝你今天過得愉快！ ！
linuxman page 手冊頁 開源 嗯