设为首页 - 加入收藏 ASP站长网(Aspzz.Cn)- 科技、建站、经验、云计算、5G、大数据,站长网!
热搜: 数据 手机 公司
当前位置: 首页 > 服务器 > 搭建环境 > Windows > 正文

如何创建和维护你自己的man手册

发布时间:2018-10-20 17:18 所属栏目:117 来源:Sk
导读:我们已经讨论了一些 man 手册的替代方案。 这些替代方案主要用于学习简洁的 Linux 命令示例,而无需通过全面而过于详细的手册页。 如果你正在寻找一种快速而简单的方法来轻松快速地学习 Linux 命令,那么这些替代方案值得尝试。 现在,你可能正在考虑 如何

/uploads/allimg/c181020/154002G1H950-15215.png

我们已经讨论了一些 man 手册的替代方案。 这些替代方案主要用于学习简洁的 Linux 命令示例,而无需通过全面而过于详细的手册页。 如果你正在寻找一种快速而简单的方法来轻松快速地学习 Linux 命令,那么这些替代方案值得尝试。 现在,你可能正在考虑 —— 如何为 Linux 命令创建自己的 man 式的帮助页面? 这时 “Um” 就派上用场了。 Um 是一个命令行实用程序,可以用于轻松创建和维护包含你到目前为止所了解的所有命令的 man 页面。

通过创建自己的手册页,你可以在手册页中避免大量不必要的细节,并且只包含你需要记住的内容。 如果你想创建自己的一套 man 式的页面,“Um” 也能为你提供帮助。 在这个简短的教程中,我们将学习如何安装 “Um” 命令以及如何创建自己的 man 手册页。

安装 Um

Um 适用于 Linux 和Mac OS。 目前,它只能在 Linux 系统中使用 Linuxbrew 软件包管理器来进行安装。 如果你尚未安装 Linuxbrew,请参考以下链接:

  • Linuxbrew:一个用于 Linux 和 MacOS 的通用包管理器

安装 Linuxbrew 后,运行以下命令安装 Um 实用程序。

  1. $ brew install sinclairtarget/wst/um

如果你会看到类似下面的输出,恭喜你! Um 已经安装好并且可以使用了。

  1. [...]
  2. ==> Installing sinclairtarget/wst/um
  3. ==> Downloading https://github.com/sinclairtarget/um/archive/4.0.0.tar.gz
  4. ==> Downloading from https://codeload.github.com/sinclairtarget/um/tar.gz/4.0.0
  5. -=#=# # #
  6. ==> Downloading https://rubygems.org/gems/kramdown-1.17.0.gem
  7. ######################################################################## 100.0%
  8. ==> gem install /home/sk/.cache/Homebrew/downloads/d0a5d978120a791d9c5965fc103866815189a4e3939
  9. ==> Caveats
  10. Bash completion has been installed to:
  11. /home/linuxbrew/.linuxbrew/etc/bash_completion.d
  12. ==> Summary
  13. [] /home/linuxbrew/.linuxbrew/Cellar/um/4.0.0: 714 files, 1.3MB, built in 35 seconds
  14. ==> Caveats
  15. ==> openssl
  16. A CA file has been bootstrapped using certificates from the SystemRoots
  17. keychain. To add additional certificates (e.g. the certificates added in
  18. the System keychain), place .pem files in
  19. /home/linuxbrew/.linuxbrew/etc/openssl/certs
  20.  
  21. and run
  22. /home/linuxbrew/.linuxbrew/opt/openssl/bin/c_rehash
  23. ==> ruby
  24. Emacs Lisp files have been installed to:
  25. /home/linuxbrew/.linuxbrew/share/emacs/site-lisp/ruby
  26. ==> um
  27. Bash completion has been installed to:
  28. /home/linuxbrew/.linuxbrew/etc/bash_completion.d

在制作你的 man 手册页之前,你需要为 Um 启用 bash 补全。

要开启 bash 补全,首先你需要打开 ~/.bash_profile 文件:

  1. $ nano ~/.bash_profile

并在其中添加以下内容:

  1. if [ -f $(brew --prefix)/etc/bash_completion.d/um-completion.sh ]; then
  2. . $(brew --prefix)/etc/bash_completion.d/um-completion.sh
  3. fi

保存并关闭文件。运行以下命令以更新更改。

  1. $ source ~/.bash_profile

准备工作全部完成。让我们继续创建我们的第一个 man 手册页。

创建并维护自己的man手册

如果你想为 dpkg 命令创建自己的 man 手册。请运行:

  1. $ um edit dpkg

上面的命令将在默认编辑器中打开 markdown 模板:

如何创建和维护你自己的man手册

我的默认编辑器是 Vi,因此上面的命令会在 Vi 编辑器中打开它。现在,开始在此模板中添加有关 dpkg 命令的所有内容。

下面是一个示例:

如何创建和维护你自己的man手册

正如你在上图的输出中看到的,我为 dpkg 命令添加了概要,描述和两个参数选项。 你可以在 man 手册中添加你所需要的所有部分。不过你也要确保为每个部分提供了适当且易于理解的标题。 完成后,保存并退出文件(如果使用 Vi 编辑器,请按 ESC 键并键入:wq)。

(编辑:ASP站长网)

网友评论
推荐文章
    热点阅读