Contribute To This Project - Contribute To This Project

Contribute To This Project

其他源码

1.0.0

下载

为这个项目做出贡献

图像信息

创建的徽标？由候选人

公告：
您想成为该项目的维护者并帮助它继续前进吗？如果您有兴趣，请阅读《维护者指南》，加入我们的Discord服务器，并请求从项目维护人员那里加入团队。

快速访问索引

介绍
目标
这是谁？
我为什么需要这样做？
我要贡献什么？
翻译
设置！ :)
贡献
- 步骤1：叉这个存储库
- 步骤2：克隆存储库
- 步骤3：创建一个新的分支
- 步骤4：打开index.html文件
- 步骤5：复制卡模板
- 步骤6：应用您的更改
- 步骤7：提交您的更改
- 步骤8：将您的更改推向GitHub
- 步骤9：提交公关（拉请求）
- 步骤10：庆祝
下一步
致谢
执照
前100名贡献者

介绍

这是一个教程，可帮助首次贡献者参加一个简单简便的项目。

目标

为开源项目做出贡献。
使用GitHub更舒服。

这是谁？

这是针对绝对初学者的。如果您知道如何编写和编辑锚定标签<a href="" target=""></a> ，那么您应该能够做到这一点。
这也是对于那些有更多经验但想做出第一个开源贡献的人，或获得更多贡献的人，以获得更多的经验和信心。

我为什么需要这样做？

任何Web开发人员，有抱负或经验丰富的都需要使用GIT版本控制，而GitHub是每个人使用的最受欢迎的GIT托管服务。它也是开源社区的核心。使用github感到舒适是一项重要技能。为项目做出贡献会增强您的信心，并为您提供一些在GitHub个人资料上显示的东西。

如果您是新开发人员，并且想知道您是否需要学习git和github，那么这就是答案：昨天您应该学会了git。

我要贡献什么？

Contributor Card

您将在此项目的网页上贡献一张卡。它将包括您的姓名，您的Twitter句柄，简短描述以及您推荐的Web开发人员有用资源的3个链接。

您将在HTML文件中制作卡模板的副本，并使用自己的信息自定义。

翻译

本教程也有其他语言可用

阿拉伯语（Elter）	孟加拉国（বাংলা）	中文（传统）（繁体中文）	荷兰	英语（英语）
法语（Français）	德国（德意志）	印地语（हिंदी）	意大利语（意大利语）	日语（日本语）
韩语（한국어）	波兰（波尔斯基）	葡萄牙（葡萄牙）	俄罗斯（сLoouLй）	塞尔维亚人（照汽车）
西班牙语（Español）	土耳其语（türkçe）	乌克兰（ouisianian）	挪威（Norsk）	马利拉姆

欢迎项目文档的翻译。阅读贡献Translation Guide 。

设置！ :)

笔记

本教程基于GitHub PC。如果您对终端感到满意，请访问本教程（单击此处）

首先，让我们设置工作

登录到您的GitHub帐户。如果您还没有帐户，请加入GitHub。我建议您在继续之前进行GitHub Hello World教程。
下载GitHub桌面应用程序。
- 另外，如果您可以在命令行上使用git，则可以这样做，这是指向CLI教程的链接。
- 如果使用VS代码，则它带有集成的Git，并允许您直接从编辑器中完成我们需要的事情。
- 但是，遵循本教程的最简单和最简单的方法是使用GitHub桌面。

现在，您都已经进行了设置，让我们继续为项目做出贡献。

↑转到顶部↑

贡献

在10个简单的步骤中成为开源贡献者。

估计时间：少于30分钟。

步骤1：叉这个存储库

这里的目的是制作该项目的副本并将其放入您的帐户中。
存储库（存储库）是在Github上调用项目的方式，而叉子是其副本。
确保您在此存储库的主页上。


单击叉按钮

现在，您在您自己的帐户中拥有该项目的完整副本。

↑转到顶部↑

步骤2：克隆存储库

现在，我们想制作该项目的本地副本。那是保存在您自己的机器上的副本。
打开GitHub桌面应用程序。在应用程序中：


单击文件，然后克隆存储库

您将在GitHub上看到您的项目和分叉的列表。
选择<your-github-username>/Contribute-To-This-Project 。
单击克隆

↪️一个分叉的项目将在左侧具有叉子符号。您的叉子将拥有您自己的github用户

这将花费一些时间，因为该项目被复制到您的硬盘。我建议您保留通常的默认路径..DocumentsGitHub 。
现在您有了该项目的本地副本。

↑转到顶部↑

步骤3：创建一个新的分支

一旦将存储库克隆到Github桌面上，就该创建一个新的分支了。
分支是使您的更改与项目主要部分Master的一种方式。例如，如果出现问题，您对更改不满意，您可以简单地删除分支机构，而主项目不会受到影响。

↪️单击`Current branch` ，然后单击`New`
↪️给您的分支一个名字，然后单击`Create branch`
↪️将您的新分支发布到GitHub

您可以随心所欲地将其命名，但是由于这是一个分支机构，可以将带有您名称的卡添加到项目中，因此称其为your-name-card是一个很好的做法，因为它可以保持该分支的意图。
现在，您已经创建了一个与主人分开的新分支。
对于下一步，请确保您在此分支机构工作。您将在Github桌面应用程序的顶部中心看到分支的名称，其中说明了当前分支。

不要在master分支上工作

↑转到顶部↑

步骤4：打开index.html文件

现在，我们需要打开要使用您喜欢的代码编辑器编辑的文件。
在计算机上找到项目文件夹。如果您保留了默认值，则应该是your-computer > Documents > GitHub > Contribute-To-This-Project
index.html文件直接在Contribute-To-This-Project文件夹中。
打开您的代码编辑器（Sublime，VS Code，Atom..Etc）并使用Open file命令并在项目的主要目录中找到index.html文件


↪️或者，您可以在硬盘驱动器上找到文件，右键单击并与编辑器打开

现在，您已经有了要在编辑器中编辑打开的文件，并且可以开始对其进行更改。

↑转到顶部↑

步骤5：复制卡模板

我们将制作卡模板的副本以开始处理它
就在<body>内部，您会找到一个<div class="container">部分。这包含许多其他部分。
前两个部分完全像： <div class="row"> 。如下图所示，通过单击箭头在VS代码编辑器上的箭头来折叠它们。（如果使用另一个编辑器，则可能无法使用该功能。您只需要向下滚动）即可。崩溃使您可以轻松隐藏您不需要更改的代码组件。
现在，您应该看到包含所有贡献卡的部分： <div class="grid" id="contributions">

在本节内，您将找到标记为== TEMPLATE ==部分
从图像中的红色正方形中复制所有内容，从Contributor card START评论到Contributor card END评论

将整个内容粘贴在注释下方，指示它；就在最新贡献者的卡上。
确保您的卡端和最后一张卡的开始之间有一条空间。另外，在卡的启动和评论之间添加一条空间=== Paste YOUR CARD directly BELOW this line === 。最好保持我们的代码尽可能清楚
切勿使用衬里或样式格式。该项目的设置更漂亮

现在，这是您的卡供您自定义和编辑。

↑转到顶部↑

步骤6：应用您的更改

现在，我们将开始编辑HTML，更改卡中的可自定义字段。

↪️将“名称”替换为您的名字

注意：不要更改class="name"

↪️插入您的Twitter帐户的URL `href="Insert URL here"` ，在文本字段中输入句柄

如果您希望使用除Twitter以外的其他联系人，则需要替换Twitter图标<i class="fa fa-x-twitter"></i>通过访问字体很棒的图标来搜索正确的图标，并仅用新图标替换fa-x-twitter部分，例如fa-facebook 。然后遵循上面的相同步骤。


↪️告诉我们一些关于您的事情。保持简短而甜美。想想它更像是一条推文，而不是博客文章

↪️与社区分享3链接到对Web开发有用的资源的链接。这可以是任何东西，视频，谈话，播客，文章，参考或工具。如果您是初学者，请不要对此感到恐惧，即使您认为这是基本的，也可以分享您所知道的一切。您会惊讶于多少人会受益。

链接：插入链接href="here"替换# 。请避免使用未从您发布的网站中使用URL缩短器或URL！
标题：写一个简短的描述title="here" 。
名称：在文本字段中写入资源的名称>here</a> 。
确保您保存了所有更改。
测试您的更改。这很重要！打开浏览器中的HTML文件（例如，双击它），然后查看您的卡片在网站上的外观。看到整个页面看起来仍然相同，什么也没有破裂。单击您的链接并确保它们正在工作。打开控制台（Ctrl + Shift + J（Windows / Linux）或CMD + OPT + J（MAC）），并检查没有错误消息。
太好了，您已经完成了编辑代码！下一步将使您的更改发送到GitHub，然后提交将其与主要项目合并。

↑转到顶部↑

步骤7：提交您的更改

返回到GitHub桌面应用程序。
您的更改将自动添加到登台区域。
这意味着Git已记录所有保存的更改。
您可以在应用程序中看到此反映。您添加到文件中的所有内容都将以绿色为绿色，并且删除将显示为红色。


↪️下一步称为`Commit` 。这大致意味着`confirm the changes`

↪️这是您的GitHub桌面标头的外观。请注意`Current repository`中项目名称旁边的叉符号，您`Current branch`将在步骤3中给它命名

↪️要`Commit`您必须填写`Summary`字段。这是说明您已更改的提交消息。在这种情况下`"Add my card information"`将是一个合理的消息。您可以选择添加更详细的`Description` 。单击`Commit`按钮。您的按钮会说诸如`Commit to "your-branch-name"`类的东西

↑转到顶部↑

步骤8：将您的更改推向GitHub

您的更改现在已保存或承诺。但是它们仅在本地保存，这是在您的计算机上。
将本地更改与您在github上的存储库同步称为推动。您正在“推动”从本地存储库到GitHub上远程存储库的更改。

↪️单击`Push`

几秒钟后，操作完成了，现在您在计算机以及Github上的该分支的副本完全相同。

↑转到顶部↑

步骤9：提交公关（拉请求）

这是您一直在等待的那一刻。提交拉动请求（PR）。
到目前为止，您所做的所有工作都属于该项目的分叉，如您所记得的那样，该项目居住在您自己的Github帐户上。
现在是时候将您的更改发送到与之合并的主要项目了。
这就是称为拉的请求，因为您要求原始项目维护者将更改“将”“拉”到他们的项目中。
转到GitHub上的叉子的主页（它将在顶部具有叉子图标和您自己的用户名）。
在存储库的顶部，您将看到带有绿色按钮的突出显示的拉请请求消息。


↪️单击`Compare and pull request`

↪️这是`Open a pull request`页面的样子。

请记住，您正在尝试将分支与原始项目合并，而不是与叉子上的Master分支合并。
下图为您提供了有关拉的请求的标题的想法。
左侧是原始项目，其次是主分支。右边是您的叉子和您创建的分支。


↪️创建拉动请求：编写标题，在描述中添加可选信息，然后单击`Create pull request`

不要被所有选项所困扰。您现在只需要执行这三个步骤即可。
离开该选项Allow edits from maintainers 。
现在，将发送拉动请求给项目维护者。一旦审查并接受，您的更改就会出现在项目网页上。

↑转到顶部↑

步骤10：庆祝

就是这样。你做到了！您现在已经为Github上的开源做出了贡献。

您已经在实时网页上添加了代码：https：//syknapse.github.io/contribute-to-project

您的更改将不会立即可见；首先，必须对项目维护者进行审查，接受和合并。合并后，您的卡应可见并在页面上生活。

审阅者要求对PR进行更改是很正常的。如果您发生在您身上，将其视为好习惯。密切关注评论并要求更改。一旦您进行了要求的更改（返回分支机构），您要做的就是提交和推动更改。 PR将随着新更改自动更新。

我保证我会尽快审查和合并，但我在业余时间进行此操作，因此延迟几天是不可避免的。

↑转到顶部↑

下一步

一会儿回来检查您合并的拉请请求。
批准更改或要求其他更改时，您应该从GitHub收到一封电子邮件。当PR最终与主人合并后，您的卡已被添加。
您还可以学习如何从此免费系列中贡献：如何为GitHub上的开源项目做出贡献
如果您发现此项目有用
您可以加入我们的Discord服务器
您可以关注我并取得联系吗？（Twitter）或使用这些其他任何选项
这是一个开源项目，因此除了贡献您的卡外，欢迎您帮助修复错误，改进或新功能。打开问题或发送新的拉请请求
为了帮助改善我们的社区，请查看位于拉请求旁边的GitHub讨论选项卡。该领域是介绍自己，对开源进行更深入的讨论并与项目维护人员进行沟通的地方。您会帮助我们构建此功能并增强我们的社区吗？
感谢您为这个项目做出贡献。现在，您可以继续尝试为其他项目做出贡献；寻找标签初学者友好的贡献选项。
我还在寻找合作者，可以帮助我审查和合并PR。如果您想获得更高级的GIT练习，请阅读《维护者指南》，加入我们的Discord服务器，并请求从项目维护人员那里加入团队。