# linuxcmd

**Repository Path**: idyuanfeng/linuxcmd

## Basic Information

- **Project Name**: linuxcmd
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2020-07-31
- **Last Updated**: 2024-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# linuxcmd 

#### 介绍
本仓库对linux的常用命令进行了翻译，并添加了常用示例和一些注解。为了避免造轮子(也不会造),本仓库克隆了[这个](https://jaywcjlove.github.io/linux-command/)优秀项目(对大佬膜拜)。用该项目批量生成html页面以便在线[访问](www.linuxcmd.com.cn)，所有命令的均用 googletrans 批量翻译的，目前完整翻译校对大概100多个常用命令。

#### 说明
早期在自学linux时，习惯对英文man手册进行中文注解留本地查看。后来发现了[这个](https://jaywcjlove.github.io/linux-command/)项目，就将之前的注解进行了整理，进行了完整的翻译，并添加示例和注解，批量生成html，更加规范化。本人学生实力有限，在整理过程中大部分google翻译然后校对修改，同时参考了[man.linuxde.net](man.linuxde.net)、[git.io/linux](git.io/linux)、[中文man手册翻译](https://manpages.debian.org/unstable/manpages-zh/index.html)等，还有一些个人博客、csdn文章等。对前辈们优秀作品和付出表示感谢。本手册可能存在翻译不准确、错误等仅供学习练习使用，不能用于实际生产中。

本项目的目的。前辈们在 man 汉化上作出了大量贡献，有完整的 man 中文[翻译计划](https://github.com/man-pages-zh/manpages-zh)。有简化man 手册，对其进行补充并添加示例的[在线访问](www.man.linuxde.net)，感谢前辈的付出。本人希望完整的翻译英文 man 手册，同时对手册进行解释补充，配上一些常用的示例进一步说明。本项目补充内容放在 Description 字段中以 # 开头，添加常用示例放在 Description 后的 #Example 中，对常用选用和常用用法进行示例说用。这样即能查阅完整的手册，又能附加补充和示例进一步解释说明。

#### 开发使用

将仓库克隆到本地，需要python3 环境
在主目录运行：

~~~bash
python3 generateHtml.py
~~~
html 网页将在 ./html 目录生成


#### 在线查看

在线访问 [www.linuxcmd.com.cn](www.linuxcmd.com.cn) 即可浏览。

Gitee修改或添加命令后，将自动生成网页同步到 httpd 服务器。

#### 参与贡献

1.  Fork 本仓库，git clone https://gitee.com/idyuanfeng/linuxcmd.git
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

一些格式说明： 
校对好的源文档 .txt 文件在 command 目录中，用来批量生成html网页。源文件要求格式必须是 txt 文档，以便以后开发，可以拉到 linux 本地，利用别名需要时查看。对应的英文文档在 ./other/cmd-en， ./other/unfinish 目录中存放的是未翻译或在未校对的文档。校正好的命令，中文文档放在 ./command 目录，英文文档放在 ./other/cmd-en目录中。

以为 du 命令例子，完整示例[du命令](https://gitee.com/idyuanfeng/linuxcmd/blob/master/command/du.txt)

开头

~~~bash
du

显示磁盘空间使用量
##############################
~~~

开头命令 du 和简短说明用来生成搜索关键词和索引。

内容控制：“#Example“ 示例放在  “DESCRIPTION（描述）“ 和 “OPTIONS(选项)“ 之间，常用示例用来说明常用选项的用法。一些说明和注解放在  “DESCRIPTION（描述）“  中，对文档进行补充。注解和示例中用 # 开头表示译者添加区分英文原文档内容。关键词不翻译括号内译注。AUTHOR之后不进行翻译。其他按英文文档翻译。

格式控制：翻译文档中只有 空格 进行控制。一级标题如 NAME OPTIONS 定格，一级标题下的内容，四个空格所进，不能 tab 制表符缩进。内容下的内容也是缩进 4 个空格，如选项。 -a, --all，对选项进行解释，另起一行，四个空格。对于三级内容，可以对上一级内容用2个空格控制，适当调整。

### 写在最后

早前零零散散的学了点前端，正好在整理服务端时系统的学下前端。本[项目](https://gitee.com/idyuanfeng/linuxcmd)或[网站](www.linuxcmd.com.cn)，只是自己学习方便自己查看手册，同时也是对前端的知识系统学习。不完善的地方还很多。但是如果能帮助到您，您也可以参与，修改校正或添加 linux 命令。一个人也许可以走得很高，但是一群人可以走得更远。

###                                              伟大的哲学家 沃.滋基索德 曾说过:

###                                                            好看又努力的小男孩运气不会太差