抱歉各位，由于最近新冠肺炎以及准备面试等要紧的事情没来得及更新文档，下个月开始会逐渐恢复。

from linux-command.

@ZhuangZhu-74

这个工作量有点大，不过可以将一些点列出来一点点的优化。

现在有500多个文件，比如之前标准化一下 markdown 排版，我搞了一宿

现在其实有一些需求和问题。

1. 如何处理 命令 版本的问题，在维护的过程中，发现，同一个命令，不同渠道，不同平台，帮助信息都不是一致的，这个问题也是也不大，做的好一点，要显示过时的参数或者标识只在哪些平台起作用等

2. 有人提出，翻译成英文 #21 ，这个工作量太大，我英语水平也太次，其实人多也不是不可以，但是首先要标准化 Markdown文档格式，方便批量生成。

有一些计划想做的内容

标识命令 兼容平台，内建命令，Mac通用，需要安装

这个工作量也很大

初步设计目标

• 不影响 GitHub 中阅读
• 方便生成 HTML
• 方便维护（添加标识）

想在每个 markdown 文件的顶部加段注释，来配置命令标识，配置以 YAML 1.2 格式来定义，如：

<!--
Support: 
  - mac
  - centos

Install:
  - 'yum install <name>' 
  - 'brew install <name>'

Built-in: true
-->

from linux-command.

感觉可以在首页添加如何使用linux自带的帮助来查看命令行的用法，比如对于 du 命令，可以用 man du 或者 du --help，养成良好的习惯

您好，
关于您提到的问题：

1. 帮助信息通过搜索引擎可以找到，也可以通过本项目的网站查询获取（通常在 “注意” 段落）。
2. 帮助信息不具有统一的通用型选项或手册。比如 -h 和 --help 这两个选项，对于 du 来说，前者用于输出人类可读的信息，而不是帮助信息；man info 均为手册命令，但只适用于那些附带了相应文档的命令。

from linux-command.

@ZhuangZhu-74 更新了一下。

from linux-command.

@ZhuangZhu-74

这个工作量有点大，不过可以将一些点列出来一点点的优化。

现在有500多个文件，比如之前标准化一下 markdown 排版，我搞了一宿

现在其实有一些需求和问题。

1. 如何处理 命令 版本的问题，在维护的过程中，发现，同一个命令，不同渠道，不同平台，帮助信息都不是一致的，这个问题也是也不大，做的好一点，要显示过时的参数或者标识只在哪些平台起作用等
2. 有人提出，翻译成英文 #21 ，这个工作量太大，我英语水平也太次，其实人多也不是不可以，但是首先要标准化 Markdown文档格式，方便批量生成。

有一些计划想做的内容

标识命令 兼容平台，内建命令，Mac通用，需要安装

这个工作量也很大

初步设计目标

• 不影响 GitHub 中阅读
• 方便生成 HTML
• 方便维护（添加标识）

想在每个 markdown 文件的顶部加段注释，来配置命令标识，配置以 YAML 1.2 格式来定义，如：

<!--
Support: 
  - mac
  - centos

Install:
  - 'yum install <name>' 
  - 'brew install <name>'

Built-in: true
-->

@jaywcjlove

谢谢！

• 现在我觉得可以先把文档现有的错误（语法，阅读通顺）改过来，然后再调模板。

from linux-command.

@ZhuangZhu-74 这个可以大家发现，慢慢 改，是一个持久的过程，我使用的时候，看到错误，我也会去更改。

from linux-command.

我刚才更新了pwd命令，格式可能需要你再优化一下 @jaywcjlove

from linux-command.

我已经看了更新后的文档，那么这种样式就可以做为以后处理同名问题的模板了。

from linux-command.

@ZhuangZhu-74 目前没有想到更好的排版方式，暂时先就这样排版吧。

from linux-command.

@ZhuangZhu-74 目前没有想到更好的排版方式，暂时先就这样排版吧。

明白了。

from linux-command.

• 关于中文排版，我计划参考 中文文案排版指北 来处理我更新过的文档。
• 例子中的代码部分将按照 Google shell 风格指南 统一。

最近忙于处理个人事件，暂停更新，预计最晚明年春节后恢复更新，谢谢！

from linux-command.

@ZhuangZhu-74 感谢一直疯狂更新，现在 gh-pages 通过 Actions 自动发布。

from linux-command.

这东西还是很精妙的, 有个要是,要是能做个把那个Alfred 做进Ubuntu 使用就好了........

from linux-command.

感觉可以在首页添加如何使用linux自带的帮助来查看命令行的用法，比如对于 du 命令，可以用 man du 或者 du --help，养成良好的习惯

from linux-command.

关于提交:

可以参考这个

• zh: https://www.conventionalcommits.org/zh-hans/v1.0.0/
• en: https://www.conventionalcommits.org/en/v1.0.0/

Tools

CLi

https://github.com/commitizen-tools/commitizen

JetBrains Plugins

https://github.com/lppedd/idea-conventional-commit
https://github.com/MobileTribe/commit-template-idea-plugin

from linux-command.

搜索可以支持命令参数嘛，而不是跳转页面，我觉得这个功能应该挺常用的，如果支持了，可以提高比较大的便捷性

from linux-command.

模板 可以发布一些模板 ，大家来讨论。

from linux-command.

@jaywcjlove 我希望未来使用 Github 的 discussions 进行讨论，而不是 issues ，这里更像是交流某单个问题的，而且解决问题关闭后会减少访问量

from linux-command.