diff --git a/en/Community-Platform-Guides/Gitee_Operating_User_Guide.md b/en/Community-Platform-Guides/Gitee_Operating_User_Guide.md new file mode 100644 index 0000000000000000000000000000000000000000..164e8a9c796282142bb6e6edc6344e34809f6c11 --- /dev/null +++ b/en/Community-Platform-Guides/Gitee_Operating_User_Guide.md @@ -0,0 +1,59 @@ +# Gitee operating guide + +Participants in the openKylin community can use Gitee to participate in the Ubuntu Kylin community project. The following briefly describes how to use Gitee by submitting BUG/Issues obtaining projects, and submitting pushes. + +## Submit BUG/Issue + +When there is a poor experience and a bug in the use of the openKylin community project, you can submit your questions to the relevant project through the Issues of Gitee. + +![输入图片说明](assets/Creat%20Issue.png) + +Click on New Issue and add a detailed description of the problem to the description, including the ISO version, reproduction method, reproduction steps and other information. If you submit an Issue, please follow the Issue Report Specification. After filling in the relevant information, click Create. Completing this process is to submit an issue to the Ubuntu Kylin community project. + +## Get the project + +After registering an account on Gitee and logging in, you can choose to upload your own SSH public key first. Compared with the SSH Key of the repository's "read-only" permission, the SSH Key of the account also has the permission to push and pull, which can be used for the repository created and participated by the user, making it more convenient. Select the user's avatar, find the modified information in the menu, then select "SSH public key", fill in a header that is easy to identify, and then enter the user's SSH public key, users who do not have an SSH public key can add the public key by following the steps below. If you do not have an SSH public key , you can add the public key through the following steps. + +Users of Linux operating system or Mac operating system can open the terminal and input: + +> $ ssh-keygen -t rsa -C “*youremail@youremail.com*” + +Generate your own key, and then use the command: + +> $ cat ~/.ssh/id_rsa.pub + +Output your key at the terminal and copy it to: + +![输入图片说明](assets/Add%20SSH%20Key.png) + +Users of Windows operating system open Git Bash and enter the following command in the console: + +> $ ssh-keygen -t rsa -C “*youremail@youremail.com*” + +After completing the password input, the public key in the [c disk > user > own username >.ssh] directory has been generated. Then export the id_rsa.pub file and copy it to the specified location. After setting up SSH, you can use it directly. Enter the openKylin project page you want to participate in, click clone, and click copy after selecting SSH: + +![输入图片说明](assets/Clone.png) + +After entering the system, open the terminal or console depending on the your operating system situation and enter: + +> $ git clone + +Enter to get the project source code. + +Users who have not added an SSH key can directly use the HTTPS link to copy. After entering the system, open the terminal or console depending on the your operating system, and enter: + +> $git clone + +You can get the project source code. + +## Submit a push to the project + +If you need to provide code to the openKylin community project, you should first fork the project and build your own Gitee repository. And please refer to the Code Merge and Submit. + +Please reasonably modify the code and upload it to your own repository, then click + Pull Requests to start submitting your modification pr. + +![输入图片说明](assets/Submit%20pr.png) + +Please pay attention to whether the branch is correct when submitting. Enter the submission interface after confirming that it is correct. After supplementing the relevant information submitted this time, click Create. Now you have completed a contribution to openKylin. + +The above is the basic use of Gitee. You are welcome to contribute to openKylin. This guide is also being continuously updated. diff --git a/en/Community-Platform-Guides/assets/Add SSH Key.png b/en/Community-Platform-Guides/assets/Add SSH Key.png new file mode 100644 index 0000000000000000000000000000000000000000..ed61cb3ea443d7f8ad89ea211a504c69616ffa1d Binary files /dev/null and b/en/Community-Platform-Guides/assets/Add SSH Key.png differ diff --git a/en/Community-Platform-Guides/assets/Clone.png b/en/Community-Platform-Guides/assets/Clone.png new file mode 100644 index 0000000000000000000000000000000000000000..e3f97ea0c90387d96e62aa0c1da63289fcadef06 Binary files /dev/null and b/en/Community-Platform-Guides/assets/Clone.png differ diff --git a/en/Community-Platform-Guides/assets/Creat Issue.png b/en/Community-Platform-Guides/assets/Creat Issue.png new file mode 100644 index 0000000000000000000000000000000000000000..727484d4368180e4099d9f8a41ed16933a6c8614 Binary files /dev/null and b/en/Community-Platform-Guides/assets/Creat Issue.png differ diff --git a/en/Community-Platform-Guides/assets/Submit pr.png b/en/Community-Platform-Guides/assets/Submit pr.png new file mode 100644 index 0000000000000000000000000000000000000000..212b6fc7241aefdb84521a5a22df048daa1acf49 Binary files /dev/null and b/en/Community-Platform-Guides/assets/Submit pr.png differ diff --git "a/\345\260\217\347\231\275\350\257\276\347\250\213/openKylin\347\224\250\346\210\267\346\211\213\345\206\214\345\216\237\347\220\206\350\247\243\346\236\220.md" "b/\345\260\217\347\231\275\350\257\276\347\250\213/openKylin\347\224\250\346\210\267\346\211\213\345\206\214\345\216\237\347\220\206\350\247\243\346\236\220.md" index a0f90dc1b23659274a65aa5cd6ea8d53ccac3b85..4ac8593dd76be3cc09561fdb89971c09c8e7af68 100644 --- "a/\345\260\217\347\231\275\350\257\276\347\250\213/openKylin\347\224\250\346\210\267\346\211\213\345\206\214\345\216\237\347\220\206\350\247\243\346\236\220.md" +++ "b/\345\260\217\347\231\275\350\257\276\347\250\213/openKylin\347\224\250\346\210\267\346\211\213\345\206\214\345\216\237\347\220\206\350\247\243\346\236\220.md" @@ -1,15 +1,20 @@ **【小白课程】openKylin用户手册原理解析，一招教你学会自定义！** -openKylin用户手册是详细描述openKylin操作系统的功能和用户界面，让用户了解如何使用该软件的说明书。通过阅读openKylin用户手册，能够更快更好的上手和使用openKylin操作系统。今天就带大家简单了解下openKylin用户手册的实现原理以及如何自定义用户手册内容。 +openKylin用户手册是详细描述openKylin操作系统的功能和用户界面、让用户了解如何使用该软件的说明书。通过阅读openKylin用户手册，能够更快更好地上手和使用openKylin操作系统。今天就带大家简单了解下openKylin用户手册的实现原理以及如何自定义用户手册内容。 ![图片](https://www.openkylin.top/upload/202301/1673400351868967.png) -一、用户手册实现原理介绍 +## 一、用户手册实现原理介绍 -1.QtWebkit简介openKylin操作系统上用户手册的启动、展示、跳转是在QtWebkit基础上实现的。下面我们来简单介绍一下QtWebkit。QtWebkit模块提供了一个在qt中使用web browser的engine，这使得我们在qt的应用程序中使用万维网上的内容变得很容易， 而且对其网页内容的控制也可以通过native controls实现。QtWebKit提供用于呈现超文本标记语言(HTML)、可扩展超文本标记语言(XHTML)和可伸缩矢量图形(SVG)文档的工具，这些文档使用级联样式表(CSS)样式，并使用JavaScript编写脚本。 -2.用户手册跳转的接口为了方便用户跳转到对应组件的帮助文档，用户手册提供了接口，使得其他组件调用接口传递参数后，可以直接打开用户手册对应内容，组件通过点击F1和菜单-帮助选项进行调用。DaemonIpcDbus::showGuideDaemonIpcDbus::showGuide提供了dbus接口，组件只需要传递对应参数调用，手册这边会根据参数，打开用户手册并跳转至对应内容。 +1.QtWebkit简介 + +openKylin操作系统上用户手册的启动、展示、跳转是在QtWebkit基础上实现的。下面我们来简单介绍一下QtWebkit。QtWebkit模块提供了一个在qt中使用web browser的engine，这使得我们在qt的应用程序中使用万维网上的内容变得很容易，而且对其网页内容的控制也可以通过native controls实现。QtWebKit提供用于呈现超文本标记语言(HTML)、可扩展超文本标记语言(XHTML)和可伸缩矢量图形(SVG)文档的工具，这些文档使用级联样式表(CSS)样式，并使用JavaScript编写脚本。 + +2.用户手册跳转的接口 + +为了方便用户跳转到对应组件的帮助文档，用户手册提供了接口，使得其他组件调用接口传递参数后，可以直接打开用户手册对应内容，组件通过点击F1和菜单-帮助选项进行调用。DaemonIpcDbus::showGuideDaemonIpcDbus::showGuide提供了dbus接口，组件只需要传递对应参数调用，手册这边会根据参数，打开用户手册并跳转至对应内容。 3.用户手册运行流程上面介绍了用户手册跳转接口，下面重点介绍下用户手册运行的大致流程。 @@ -35,26 +40,26 @@ openKylin用户手册是详细描述openKylin操作系统的功能和用户界 ![图片](https://www.openkylin.top/upload/202301/1673400491336760.png) -通过获取到的图片名称、文档路径、文件夹名称；加载图标信息，完成首页应用的加载。openKylin用户手册首页的加载流程大致就如上面所述，但实际还会涉及到Markdown文件的渲染展示，目录和内容的跟随效果；手册目录级的跳转；自动读取文档的更新日期等，这里就不一一介绍啦。 +通过获取到的图片名称、文档路径、文件夹名称；加载图标信息，完成首页应用的加载。openKylin用户手册首页的加载流程大致就如上面所述，但实际还会涉及到Markdown文件的渲染展示、目录和内容的跟随效果、手册目录级的跳转和自动读取文档的更新日期等，这里就不一一介绍啦。 -二、用户手册内容自定义 +## 二、用户手册内容自定义 -大家在系统集成新组件时，会希望新增组件后，把对应的组件手册内容也自动加入用户手册中并能够进行跳转；那么这里就给大家介绍一下如何集成自己的手册内容！ +大家在系统集成新组件时，会希望新增组件后，把对应的组件手册内容也自动加入用户手册中并能够进行跳转，那么这里就给大家介绍一下如何集成自己的手册内容！ -1.文件夹结构 +#### 1.文件夹结构 ![图片](https://www.openkylin.top/upload/202301/1673400502196692.png) ull Requ 需要包含语言文件夹，一个图标；其中文件夹名称和图标名称保持一致，会用于首页图标展示以及用户手册dbus接口调用参数。 -2.Markdown文件结构 +#### 2.Markdown文件结构 ![图片](https://www.openkylin.top/upload/202301/1673400514730147.png) 这里Markdown文档的一级标题会作为首页应用的展示名称。 -3.修改install文件 +#### 3.修改install文件 ![图片](https://www.openkylin.top/upload/202301/1673400526886467.png) diff --git "a/\347\244\276\345\214\272\345\217\202\344\270\216\346\214\207\345\215\227/openKylin\344\270\213\350\275\275\345\234\260\345\235\200\345\222\214\345\256\211\350\243\205\346\226\271\346\263\225.md" "b/\347\244\276\345\214\272\345\217\202\344\270\216\346\214\207\345\215\227/openKylin\344\270\213\350\275\275\345\234\260\345\235\200\345\222\214\345\256\211\350\243\205\346\226\271\346\263\225.md" index c1e42830e7161af84d75264cd76c905961d097bb..d1b70075b046d1117205c27244c02ef1cad2e52b 100644 --- "a/\347\244\276\345\214\272\345\217\202\344\270\216\346\214\207\345\215\227/openKylin\344\270\213\350\275\275\345\234\260\345\235\200\345\222\214\345\256\211\350\243\205\346\226\271\346\263\225.md" +++ "b/\347\244\276\345\214\272\345\217\202\344\270\216\346\214\207\345\215\227/openKylin\344\270\213\350\275\275\345\234\260\345\235\200\345\222\214\345\256\211\350\243\205\346\226\271\346\263\225.md" @@ -18,9 +18,9 @@ dateCreated: 2022-05-17T07:44:04.711Z 在重装或者是安装系统的过程中，大家都会经历制作启动盘这一过程，想必也看过很多资料来进行学习。接下来，我来给大家总结一下启动盘制作的几种方法。欢迎大家拿出小抄赶紧记上，希望对你也有用哦。 -启动盘制作工具，其中常见的有Ventoy和微PE工具箱，那么这两款软件哪个更好呢，其实他们的作用是差不多的。 +启动盘制作工具，其中常见的有Ventoy和微PE工具箱，那么这两款软件哪个更好呢，其实它们的作用是差不多的。 -首先，他们都能用来制作启动盘，主要功能是相同的，不过微PE工具箱还能制作系统光盘，Ventoy是做不到的，此外，微PE工具箱还可以设置PE个性化图标、壁纸等个性化内容。 +首先，它们都能用来制作启动盘，主要功能是相同的，不过微PE工具箱还能制作系统光盘，Ventoy是做不到的，此外，微PE工具箱还可以设置PE个性化图标、壁纸等个性化内容。 相较而言Ventoy的功能就比较单纯，它主要就是用来制作系统盘，没有花里胡哨的功能，因此它的体积也比较小，如果想要随身携带的话，Ventoy会更合适。