翻译准备:man命令的使用方式

linux命令众多,系统原生的man、help、whatis、info等命令都为我们提供了第一手的学习资料,但受限于文档均为英文增加了阅读难度,故此次挑战翻译原生文档来督促自己,也希望有小伙伴一起加入到翻译中来。

   在帮助命令中选取最为常用,也较为详细的man命令作为以后的翻译文本来源。首先,在开始翻译之前总结关于man命令的常用方法如下:

一.man手册的内容结构:


其中查看命令用法的时候我们最关心的应该是第二和第三项。
二.man手册中Linux命令语法的形式描述:
I.options:命令选项有两种形式:长选项(–)和短选项(-)
长选项: 用 – 引导,后面跟完整的单词,如 --version
短选项: 用 - 引导,后面跟单个的字符, 如 -a
多个短选项可以组合使用,例如:-h -l -a == -hla
但是长选项不能组合使用,如 --help后面就不能再跟另外一个单词了。
II. options 也可以有自己的参数,可称为arguments,(注意,选项与选项之间,选项与参数之间,参数与参数之间必须有空格!)而且,命令的选项和参数所使用的符号也有相应的含义:
1.方括号中的项是可选的;
2.不在方括号或是在大括号中的项是必选项(也有说<>括起来的,不过我还没见过);
3.黑体(还是粗体?)字必须按原样准确键入,这一类可能是命令名,标志和文字字符;
4.斜体字必须用适当的值代替(不显示斜体字的系统上通常用下划线代替),就如变量一般,需要根据情况自己添加适当的值;
5.后面接省略号(…)的参数可以多次重复;
6.如果一个单独的选项和一个参数组合在一起,那么该选项和参数必须同时使用;
7.由 |(竖线)字符分开的两个或多个项,表示可以从这个列表中选择一个项;
例:
find命令是linux下的查找文件命令,其man手册的SYNOPSIS的格式为:
image
其中所有的选项都用’[]‘括起来,说明所有选项都是可选的(当然,只是这样就没办法实现它的作用了)。
path是可选项,其默认值是当前目录,而且被’…'修饰,说明可以添加多个目录;
-D debugopts说明-D选项之后还应加上相应的参数;
[a|b]说明a和b可以选其中一个也可以不选;
{a/b}则说明a和b之间必须要选一个。
三.命令实例分析
mkdir命令,man mkdir中
image
表示mkdir命令是用来创建目录的
image
表示mkdir 后面可选option选项,但必须有需要创建的目标目录,可跟多个
image
-p选项并无特殊,其后面不用跟参数,具体作用为:递归创建目录,即使上级目录不存在,会按目录层级自动创建目录
-m , --mode=MODE和-Z, --context=CTX,应用格式应为
image

1 个赞

very good!!!