# 新手引导 **Repository Path**: dengyiyun_admin/unpalatable ## Basic Information - **Project Name**: 新手引导 - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2020-11-20 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 新手引导 ### 🔥关于Gitee Gitee诞生于2013年， 是开源中国社区基于 Git 推出的代码托管服务，目前已经成为国内最大的代码托管平台和开发者生态。 Gitee致力于为国内开发者提供优质稳定的托管服务，并以“为天下开发者提供中立的开源分享平台”为己任，一直以开放的心态欢迎所有的开发者参与到开源建设中来，也推崇开放，自由，共享的开源理念。 Gitee的开源发展历程就像一个项目从诞生到发展壮大的过程一样，困难重重。在经济与大环境的压力下，Gitee仍坚持不改变平台中立地位，继续维护和强化对开发者自由、开放和创新的承诺才有了今天。2020年，Gitee社区迎来了更多知名开源组织的认可，Linux Foundation 正式在社区建立官方镜像，华为鸿蒙宣布在Gitee 开源，Rancher正式入驻Gitee …… 在走向开源的路上，Gitee从未停止。。。 ### 👍Gitee优质项目 #### 优质项目合集 **GVP项目** GVP项目是Gitee 综合评定出的优秀开源项目的展示平台。这里集合了Gitee社区专家组认可的所有优质开源项目。当你进入社区时，你一定会首先看到这些项目，因为作为社区最优质的内容，我们优先先给您展示，希望与大家一起探索这些项目，并持续做出贡献。 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/104719_7d6e68b8_8189591.png "1.png") 以下是腾讯开源组织的其中一个GVP项目[APIJSON](http://)，主要方向是后端接口和文档自动化，前端(客户端) 定制返回 JSON 的数据和结构！ ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/105109_334eec1c_8189591.png "2.png") 以下展示的GVP项目是[Apollo](http://https://gitee.com/ApolloAuto/apollo) (阿波罗)，Apollo是一个开放的、完整的、安全的平台，将帮助汽车行业及自动驾驶领域的合作伙伴结合车辆和硬件系统，快速搭建一套属于自己的自动驾驶系统。 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/110109_02297c1f_8189591.png "4.png") 以上展示的仅是GVP项目的极少一部分内容，事实证明，好的项目永远不缺支持者，所以不论什么时候，遇到您认可的项目时，我们建议您点亮star，为这些项目争取获得曝光，被更多人关注。 **点击[GVP项目](http://https://gitee.com/gvp)即可查看所有内容！** **官方推荐项目** 在社区的首页，你可能会看到很多项目都带有显示“Gitee推荐项目”的项目。我们常常苦恼于这些项目，因为它们真的很好，但是却不像GVP项目一样受人关注，得不到贡献者的支持。所以在社区首页我们给了最大程度的曝光。我们对这些项目的总结是小而精，它们都是在萌芽的种子，我们希望有一天能看到长成大树。期待您也能为它们在开源的路上助力。 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/110353_dde04b38_8189591.png "6.png") 以下展示的项目是[magic-api](http://https://gitee.com/ssssssss-team/magic-api?_from=gitee_search) ，一个基于Java的接口快速开发框架，通过magic-api提供的UI界面完成编写接口，无需定义Controller、Service、Dao、Mapper、XML、VO等Java对象即可完成常见的HTTP API接口开发部 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/110528_2d9b5886_8189591.png "7.png") **点击[Gitee推荐项目](http://https://gitee.com/gvp)即可查看！** **Gitee和TA的朋友们** 这里是Gitee的活动小星球，我们发布的好玩有趣活动都会集中在这里展示。这份新手指南也会放在这里，所以别忘了点击关注，才不会迷路！我们向所有的小伙伴持续征集活动主题，被采纳有奖哦！ ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/111751_9d1548a7_8189591.png "8.png") **点击[Gitee和TA的朋友们](http://https://gitee.com/Selected-Activities)即可查看！** #### 如何搜索优质内容 **技术栈** 首先要明白自己的技术栈是什么，使用什么语言或框架做开发。通过首页的关键字搜索，选择相对应的技术栈。其次要明白自己的水平，选择相对应水平的开源项目，能够更好的学习。 **STAR数量** 首页关键字搜索之后，一般来说会优先按照 Star 数量来排序，Star 数量高不代表一定是最好的，但起码说明这个项目的受欢迎程度，否则不会有那么多人 Star 这个项目 。 **GVP项目** GVP项目是Gitee综合评定出的优质开源项目。所以直接点击社区首页GVP项目，即可查看社区所有内容。 **分类管理** 通过社区首页右侧的分类管理，选择你想查看的项目关键词，即可查看社区所有相关的内容，会并按照受欢迎程度展示。 **项目作者** 如果Star 数量相差不多的情况下，可以看项目作者的影响力。有影响力的人不一定是最好的选择，但起码不会不靠谱。当然，一般来说公司项目是优先于个人项目的，毕竟公司的开发实力是要强于个人的，同时公司的项目安全性，可靠性也是优于个人开发者的。 **README.md** README.md 是关于项目的文档说明，在这个文件中会详细说明 项目名及简介，项目背景，项目 Logo 和使用截图，项目的功能点，体验地址，如何下载这个项目, 安装项目所需依赖 ， 如何安装 ， 如何部署 ，以及 Debug 方法 。通常来说，README.md 的详细程度和美观程度与该项目的靠谱程度成正比。 **项目的最后更新时间** 对于开源项目来说最怕的是作者不维护，这就意味着之后再也不会有改进了，并且出了问题也很难被迅速解决。项目的更新时间频繁，更新日期近，就意味着项目的作者还在维护。 **Issues 和 Fork** Issues 数量多，作者回复速度快，Forks 数量多都是体现该项目被关注程度以及流行程度。 #### 如何给项目反馈？ 当你浏览完一个项目时，总是会想表达出自己的观点，一般我们支持你通过下列方式表达： - Star - 评论（表达不含技术问题的任何个人观点） - 提交Issue（项目相关的技术问题、缺陷报告、建议等信息请通过 Iusse发布) - 提交Pull request（这可以帮助您与他人协作编写代码。在使用之前，请先创建一个Pull request) 当然整个过程是逐步进阶的，这也是我们期待您在Gitee的成长过程。不过可以毫不夸张的说，但你开始浏览这个仓库时，已经表达了您对此项目的认可。 ### 💕如何参与开源？ 如果看了上面优质项目的展示，你也想参与开源的话，先来看看这个项目吧！ #### 开源指北 我们对这个项目的介绍是：一份给开源新手的保姆级开源百科。 一直有在开发者们中听到 “我有想参与开源，但我不知道怎么做” 这样的声音，基于大家的反馈，也让我们有所思考，该如何让更多开发者能够真正参与到开源运动中来。于是我们通过开源的方式开启了这个项目。作为开源新手，你会了解到开源的诞生，发展历程以及参与开源的方式等等。 活动推出得到了大家的热情反馈，很多开源老司机都积极参与编写这份教程，希望新朋友们也能对开源有清晰的了解。如果对于开源你还有什么想了解的内容，可以通过提Iusses的方式告诉我们。别忘了点亮star，方便在个人页面查找哦！ ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/112132_edabd233_8189591.png "9.png") **点击[开源指北](http://https://gitee.com/Selected-Activities/opensource-guide)即可查看！** #### 如何创建仓库 仓库通常适用于组织某个项目，可以包含文件夹和文件、图像、视频、电子表格和数据集 ，这是项目可以包含的所有内容。 创建仓库如下： 1. 在右上角，在您的头像或“通知”旁边，单击然后选择"新建仓库"。 2. 命名仓库。 3. 填写仓库信息。 4. 通常选择使用 README 初始化此存储库 5. 最后点击“创建”即可。 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/112354_3be1562d_8189591.png "10.png") 赶紧点击[创建仓库](http://https://gitee.com/gvp)尝试一下吧！ #### Issue Issues是一种协作方式，让你可以更方便的对整个仓库进行跟踪、增强和排错。我们通常把它称之为待办清单、问题或 bug 列表、讨论版BBS等等。 通常情况下，一个优质的开源项目都有无数的贡献者持续输出，做出贡献的第一步就是发现问题，告知commiter，作为新手的你可以从查看项目的Issues开始，了解开源的第一步，同时你也会知道一个好的项目需要规避什么，完善什么。所以当你看到好的项目时，我们鼓励你可以大胆的尝试提出Issues，表达自己的观点。 Issues功能在以下情况最常使用： - 对于你自己来说，自己可以使用 Issue 来发布待办清单，给自己提开发任务或 bug，开帖找大家探讨项目下一步的发展方向等等。 - 如果你想要提 Issue 的仓库不是你自己的，而是他人的的时候，Issue 就是一个很好的多人协作系统。比如发现了别人项目的 bug 的时候；比如想要别人添加某个新功能的时候；比如有使用上的困难，需要求助作者使用步骤的时候，你都可以给别人的仓库提出 Issue。 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/112602_87dc8e72_8189591.png "11.png") #### Pull Request Pull Request 是Gitee社区协作的核心，准确来说是贡献者与创建者协同工作的一种机制，可以进行基于网络的多人提交，审核机制，审核通过后，就可以合并到主分支中。 提交 Pull Request 的步骤： 1.Fork 主仓库到自己账号成为副本仓库 2.在副本仓库完成代码贡献（添加、删除、修改代码等等） 3.将副本修改的内容给主仓库提交 PR ( Pull Requests ) 4.作者审核你提交的代码，并决定是否合并 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/112711_44208f6d_8189591.png "12.png") 感觉以上步骤操作有点复杂？确实有点儿，为了提高大家参与开源项目的积极性，同时降低开源贡献的门槛，Gitee 推出了 轻量级 PR（Gitee Pull Request Lite） 的功能，是一种 无须 Fork 仓库，即可快速向某个特定仓库创建并提交一个合并请求（Pull Request）的功能。步骤如下： 1. 打开任意的开源项目 2. 点击任何你发现问题的文件，并直接进入文件编辑 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/112836_00448a34_8189591.png "13.png") 3. 完成你想要修改的内容，输入修改的说明，点击“提交审核”按钮 ![输入图片说明](https://images.gitee.com/uploads/images/2020/1120/112913_6677383d_8189591.png "14.png") 我们非常欢迎您能加入Gitee社区，参与开源建设，为了维护好社区开放，自由，共享的良好氛围，正式开始前我们希望您能先仔细阅读这份[ **社区行为准则** ](http://https://gitee.com/kena-QY/xingweizhunze)！ 感谢您的阅读，文章到这里就结束啦，不知道这份资料有没有给你在使用Gitee社区上有所帮助，欢迎大家给我们提建议。当然，是通过提Iusses的方式！