From 709292bd7c3c834501c1d266fde732e4c500cce2 Mon Sep 17 00:00:00 2001 From: Marvin Date: Wed, 5 Apr 2023 09:50:33 +0000 Subject: [PATCH] =?UTF-8?q?=E3=80=90=E8=BD=BB=E9=87=8F=E7=BA=A7=20PR?= =?UTF-8?q?=E3=80=91=EF=BC=9Aupdate=20=E7=A4=BE=E5=8C=BA=E5=BC=80=E5=8F=91?= =?UTF-8?q?=E6=8C=87=E5=8D=97/openKylin=E6=89=93=E5=8C=85=E6=8C=87?= =?UTF-8?q?=E5=8D=97.md.=20=E7=AC=AC=E4=B8=80=EF=BC=8C=E4=BF=AE=E6=94=B9?= =?UTF-8?q?=E5=8F=A5=E5=AD=90=E4=BB=A5=E4=BD=BF=E5=85=B6=E4=BE=BF=E4=BA=8E?= =?UTF-8?q?=E7=90=86=E8=A7=A3=E3=80=82=E5=8E=9F=E5=8F=A5=EF=BC=9A"?= =?UTF-8?q?=E4=BD=9C=E4=B8=BA=E4=B8=80=E7=A7=8D=E6=9B=BF=E4=BB=A3=E6=BA=90?= =?UTF-8?q?=E7=A0=81=E7=BC=96=E8=AF=91=E5=AE=89=E8=A3=85=E7=9A=84=E6=96=B9?= =?UTF-8?q?=E5=BC=8F=EF=BC=8C=E6=89=93=E5=8C=85=EF=BC=8C=E5=8D=B3=E5=88=B6?= =?UTF-8?q?=E4=BD=9CDEB=E8=BD=AF=E4=BB=B6=E5=8C=85=EF=BC=8C=E5=B0=86?= =?UTF-8?q?=E5=BA=94=E7=94=A8=E7=A8=8B=E5=BA=8F=E7=9A=84=E4=BA=8C=E8=BF=9B?= =?UTF-8?q?=E5=88=B6=E6=96=87=E4=BB=B6=EF=BC=8C=E9=85=8D=E7=BD=AE=E6=96=87?= =?UTF-8?q?=E6=A1=A3=EF=BC=8Cman/info=E5=B8=AE=E5=8A=A9=E9=A1=B5=E9=9D=A2?= =?UTF-8?q?=E7=AD=89=E6=96=87=E4=BB=B6=E5=90=88=E5=B9=B6=E6=89=93=E5=8C=85?= =?UTF-8?q?=E5=9C=A8=E4=B8=80=E4=B8=AA=E6=96=87=E4=BB=B6=E4=B8=AD=EF=BC=8C?= =?UTF-8?q?=E4=BB=8E=E8=80=8C=E4=BD=BF=E8=BD=AF=E4=BB=B6=E7=9A=84=E5=AE=89?= =?UTF-8?q?=E8=A3=85=E5=8F=98=E5=BE=97=E7=AE=80=E5=8D=95=E8=B5=B7=E6=9D=A5?= =?UTF-8?q?=E3=80=82=E9=80=9A=E8=BF=87=E8=BD=AF=E4=BB=B6=E5=8C=85=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E5=99=A8=EF=BC=8C=E5=AE=8C=E6=88=90=E8=8E=B7=E5=8F=96?= =?UTF-8?q?=EF=BC=8C=E5=AE=89=E8=A3=85=EF=BC=8C=E5=8D=B8=E8=BD=BD=EF=BC=8C?= =?UTF-8?q?=E6=9F=A5=E8=AF=A2=E7=AD=89=E4=B8=80=E7=B3=BB=E5=88=97=E6=93=8D?= =?UTF-8?q?=E4=BD=9C=E3=80=82"=20=E4=BF=AE=E6=94=B9=E4=BA=86=E7=90=86?= =?UTF-8?q?=E8=A7=A3=E5=9B=B0=E9=9A=BE=E7=9A=84=E5=9C=B0=E6=96=B9=EF=BC=8C?= =?UTF-8?q?=E4=B8=BA=E5=8F=A5=E5=AD=90=E5=A2=9E=E5=8A=A0=E4=BA=86=E7=BC=BA?= =?UTF-8?q?=E5=B0=91=E7=9A=84=E4=B8=BB=E8=AF=AD=EF=BC=9A=E2=80=9C=E6=89=93?= =?UTF-8?q?=E5=8C=85=EF=BC=8C=E5=8D=B3=E5=88=B6=E4=BD=9CDEB=E8=BD=AF?= =?UTF-8?q?=E4=BB=B6=E5=8C=85=EF=BC=8C=E3=80=90=E5=B0=86=E4=BC=9A=E6=8A=8A?= =?UTF-8?q?=E3=80=91=E5=BA=94=E7=94=A8=E7=A8=8B=E5=BA=8F=E7=9A=84=E4=BA=8C?= =?UTF-8?q?=E8=BF=9B=E5=88=B6=E6=96=87=E4=BB=B6=EF=BC=8C=E9=85=8D=E7=BD=AE?= =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=8Cman/info=E5=B8=AE=E5=8A=A9=E9=A1=B5?= =?UTF-8?q?=E9=9D=A2=E7=AD=89=E6=96=87=E4=BB=B6=E5=90=88=E5=B9=B6=E6=89=93?= =?UTF-8?q?=E5=8C=85=E5=9C=A8=E4=B8=80=E4=B8=AA=E6=96=87=E4=BB=B6=E4=B8=AD?= =?UTF-8?q?=EF=BC=8C=E4=BB=8E=E8=80=8C=E4=BD=BF=E8=BD=AF=E4=BB=B6=E7=9A=84?= =?UTF-8?q?=E5=AE=89=E8=A3=85=E5=8F=98=E5=BE=97=E7=AE=80=E5=8D=95=E8=B5=B7?= =?UTF-8?q?=E6=9D=A5=E3=80=82=E9=80=9A=E8=BF=87=E8=BD=AF=E4=BB=B6=E5=8C=85?= =?UTF-8?q?=E7=AE=A1=E7=90=86=E5=99=A8=EF=BC=8C=E3=80=90=E7=94=A8=E6=88=B7?= =?UTF-8?q?=E3=80=91=E5=8F=AF=E5=AE=8C=E6=88=90=E8=8E=B7=E5=8F=96=EF=BC=8C?= =?UTF-8?q?=E5=AE=89=E8=A3=85=EF=BC=8C=E5=8D=B8=E8=BD=BD=EF=BC=8C=E6=9F=A5?= =?UTF-8?q?=E8=AF=A2=E7=AD=89=E4=B8=80=E7=B3=BB=E5=88=97=E6=93=8D=E4=BD=9C?= =?UTF-8?q?=E2=80=9D=E3=80=82=20=E7=AC=AC=E4=BA=8C=EF=BC=8C=E7=BB=9F?= =?UTF-8?q?=E4=B8=80=E4=B8=BA=E5=B9=B6=E5=88=97=E7=9A=84=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E7=9F=AD=E5=8F=A5=E8=AE=BE=E7=BD=AE=E4=BA=86=E6=97=A0=E5=BA=8F?= =?UTF-8?q?=E5=88=97=E8=A1=A8=E7=9A=84=E6=A0=BC=E5=BC=8F=E3=80=82=E6=9B=B4?= =?UTF-8?q?=E4=BE=BF=E4=BA=8E=E9=98=85=E8=AF=BB=E7=9A=84=E5=90=8C=E6=97=B6?= =?UTF-8?q?=EF=BC=8C=E8=83=BD=E5=A4=9F=E5=92=8C=E6=9C=AC=E6=96=87=E5=85=B6?= =?UTF-8?q?=E4=BB=96=E9=83=A8=E5=88=86=E7=9A=84=E5=88=97=E8=A1=A8=E9=A3=8E?= =?UTF-8?q?=E6=A0=BC=E4=BF=9D=E6=8C=81=E4=B8=80=E8=87=B4=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Marvin --- 社区开发指南/openKylin打包指南.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/社区开发指南/openKylin打包指南.md b/社区开发指南/openKylin打包指南.md index 3c5fdbc7..f2144c88 100644 --- a/社区开发指南/openKylin打包指南.md +++ b/社区开发指南/openKylin打包指南.md @@ -18,20 +18,20 @@ dateCreated: 2022-05-17T07:44:07.346Z 写作本文档时，遵循下列指导原则： -仅提供概览，而忽略边界情况。（**Big Picture 原则**） +- 仅提供概览，而忽略边界情况。（**Big Picture 原则**） -保持文字简短紧凑。（**KISS 原则**） +- 保持文字简短紧凑。（**KISS 原则**） -不重复造轮子。（使用链接指向**已有参考**） +- 不重复造轮子。（使用链接指向**已有参考**） -专注于使用非图形的工具和控制台。（使用 **shell 例子**） +- 专注于使用非图形的工具和控制台。（使用 **shell 例子**） -保持客观。（使用 [popcon](http://popcon.debian.org/) 等等） +- 保持客观。（使用 [popcon](http://popcon.debian.org/) 等等） ### **1. 软件打包** -一个 openKylin 下的软件包通常包含一系列文件的集合，它们定义了应用程序或者库文件可以如何通过包管理器（比如apt，yum等）进行发行部署。作为一种替代源码编译安装的方式，打包，即制作DEB软件包，将应用程序的二进制文件，配置文档，man/info帮助页面等文件合并打包在一个文件中，从而使软件的安装变得简单起来。通过软件包管理器，完成获取，安装，卸载，查询等一系列操作。 +一个 openKylin 下的软件包通常包含一系列文件的集合，它们定义了应用程序或者库文件可以如何通过包管理器（比如apt，yum等）进行发行部署。作为一种替代源码编译安装的方式，打包，即制作DEB软件包，将会把应用程序的二进制文件，配置文档，man/info帮助页面等文件合并打包在一个文件中，从而使软件的安装变得简单起来。通过软件包管理器，用户可完成获取，安装，卸载，查询等一系列操作。 **1.1. 总体规则** @@ -69,21 +69,21 @@ dateCreated: 2022-05-17T07:44:07.346Z 这里给出一些技术上的建议，参考行事可以让您与其他维护者共同维护软件包时变得更加轻松有效，从而让 openKylin 项目的输出成果最大化。 -让您的软件包容易除错（debug）。 +- 让您的软件包容易除错（debug）。 -保持您的软件包简单易懂。 +- 保持您的软件包简单易懂。 -不要对软件包过度设计。 +- 不要对软件包过度设计。 -让您的软件包拥有良好的文档记录。 +- 让您的软件包拥有良好的文档记录。 -使用可读的代码风格。 +- 使用可读的代码风格。 -在代码中写注释。 +- 在代码中写注释。 -格式化代码使其风格一致。 +- 格式化代码使其风格一致。 -维护软件包的 git 仓库。 +- 维护软件包的 git 仓库。 ### **2. 打包规则**