Gitee_Operating_User_Guide.md · Pull Request !261 · openKylin/docs

#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.

![Creat Issue.png](./assets/Creat Issue.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:

![Add SSH Key.png](./assets/Add SSH Key.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:

![Clone](./assets/Clone.png)

After entering the system, open the terminal or console depending on the your operating system situation and enter:

> $ git clone <copy>

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 <copy>

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 <span style="background: #fe7300; padding:5px;border-radius:4px;color:white;">+ Pull Requests</span> to start submitting your modification pr.

![Submit pr](./assets/Submit pr.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.

openKylin/docs .gitee-modal { width: 500px !important; }

搜索帮助

openKylin/docs