first contributions ja.github.io

通过完整的日本教程开始您的OSS活动

这是一个开源的日本项目，旨在使初学者易于参与。
关注教程，体验您的第一个贡献！

我们很乐意为您提供第一个拉动请求✌️

介绍

该项目是日本教程，可帮助您学习如何在实践中使用git/github以及如何在开源中进行协作！

这是谁？

• 想学习使用git/github的实用方法的初学者
• 对开源感兴趣但不知道如何做出贡献的人
• 或者，您想通过更多的贡献来提高自己的技能，同时享受合作

这个项目的目的是什么？

• 使用GitHub体验实际的联合开发，这很难自己学习。
• 每个人都有信心，学习如何为开源项目做出贡献
• 并帮助喜欢开源文化连接的开发人员

什么是开源的？

什么是开源？

当一个项目是开源的时，这意味着任何人都可以自己一时兴起，学习，修改和分发您的项目。

在大多数情况下，开源项目可以免费参与开发！

对开源项目的贡献是
这是通过与其他开发人员协作提高技能的好方法。

如果您对开源不感兴趣，并且想知道您是否需要付出努力，
请参阅此处：为什么要为开源做出贡献？

如何参加

让我们立即体验开源项目的贡献！

我应该怎么办？

作为该项目的参与者，我们将在贡献者文件中添加以下信息！

 "name": "あなたのハンドルネーム",
"github": "あなたのGitHubアカウントのURL",
"favoriteColor": "あなたの好きなカラーコード",
"favoriteEmoji": "あなたの好きな絵文字"

输入的信息将以表情符号图标显示在网站上。
因此，每当贡献者的数量增加时，网站就会变得活跃！

表情射击动物。mp4

我们希望使JA的网站更加流行起来！
请尝试移动您的手

• 实际移动您的手
  • 设置：
  • 步骤1：叉这个存储库
  • 步骤2：克隆到本地机器
  • 步骤3：创建一个工作分支
  • 步骤4：进行更改
  • 步骤5：提交您的更改
  • 步骤6：推动更改
  • 步骤7：创建拉动请求（PR）
  • 步骤8：回应评论和反馈
  • 结束： ？
• 更多步骤
• 其他贡献

实际移动您的手

在8个简单步骤中成为开源贡献者？

• 如果您需要帮助，请在讨论中询问！
• 如果您发现该项目的任何改进，请通过问题告诉我们！

不管有多小，我们受到欢迎吗？

---

设置：

• 如果您没有GitHub帐户，请通过注册创建一个帐户。
  • 如有必要，我们建议您首先为完整的初学者进行GitHub Hello World教程。
• 如果未设置替换密码的访问令牌，则可能在克隆时发生错误。
  • 在这种情况下，请参阅配置GitHub访问令牌。

---

步骤1：叉这个存储库

• 通过单击GitHub项目页面（此页面）右上角的“叉子”按钮来叉。

• 然后单击“创建叉”按钮。
  • 所有项目，例如“存储库名”，“描述”和“仅复制main分支”，就像原始格式一样！

提示

这将在您的GitHub帐户中创建此存储库的副本？

---

步骤2：克隆到本地机器

您也可以在github上编辑文件，
将叉子存储库复制到您的本地计算机，以获得更一般的工作流程体验。

• 在GitHub上，转到分叉的存储库页面，单击“绿色代码”按钮，然后复制HTTPS URL。
  • 您的URL应该像这样： https://github.com/<あなたのアカウント名>/first-contributions-ja.github.io.git

• 打开一个终端并导航到要克隆存储库的目录。
  • 例如，如果要在桌面上指定克隆目标，则可以使用以下命令：

   cd desktop
  

• 使用以下命令将叉子存储库克隆到您的本地计算机：

   git clone 先ほどコピーしたクローンURL
  

提示

这允许将存储库复制到您的本地机器并在本地环境中工作

---

步骤3：创建一个工作分支

• 使用以下命令导航到存储库目录：

   cd first-contributions-ja.github.io
  

• 使用以下命令安装此项目所需的软件包：

   npm install
  

  
  
  注意：什么是NPM安装？❓❓

  
  

  安装了Node.js，运行npm install命令以批量安装该项目所需的库。

  安装npm install后可以做什么

  • 启动本地服务器并在浏览器中检查视图
    • 执行npm run dev命令后，单击似乎确认的URL
  • 自动代码检查和塑形
    • 它是使用名为Husky的图书馆运行的
    • 它自动运行，因此无需执行任何命令或进行任何工作

  
  

  有关npm install命令的更多信息，请参阅此处！

  “注意”）如果NODE.JS未安装在您的本地计算机上， npm install命令将导致错误。

  在这种情况下，有两种处理方法。

  • 跳过npm install过程。
    • 没有此过程，您可以拥有最低贡献的经验，因此，如果困难，您可以跳过它。
    • 我想知道参考，这里有多少人会偶然发现，因此，如果您可以在拉动请求中报告，例如“ npm install不起作用”，这将非常有帮助。
  • 安装node.js。
    • 有关安装说明，请参阅以下网站：
    • node.js官方网站 /如何安装node.js（macos）pregate /如何安装node.js（windows）pregate
    • 如果您想进一步了解node.js，什么是node.js？为什么每个人都在使用它？请参考Qiita。
    • 如果您对Web/JavaScript开发感兴趣，我建议使用此机会安装它？

• 接下来，创建一个新的分支，将您的工作与项目的main分支区分开。
  • 您可以使用以下命令： git switch -c <ブランチ名>
  • 分支名称是与您将要做的工作相关的有意义的名称。看起来像这样：

   git switch -c add-yourname
  

  • ？笔记）
  • 不要忘记用手柄替换yourname
  • 请在没有Hiragana，汉字或白色空间的半宽字母数字字符中输入分支名称。
    • ：Ogino Chihiro，Ogino Chihiro
  • 例子：

   git switch -c add-oginochihiro

  

提示

这使您准备进行更改而不直接影响main项目存储库？

---

步骤4：进行更改

• 要开始，请在您喜欢的代码编辑器（例如VSCODE）中打开克隆的文件夹。
  • 在进行任何更改之前，请确保您与上一步中创建的分支合作！
  • 您可以使用以下命令检查当前分支：

   git status
  

• 现在，让我们更改贡献者。
  • 复制并将以下代码粘贴到您的贡献者中的“列表”。

   ,
  {
    "name": "あなたのハンドルネーム",
    "github": "あなたのGitHubアカウントのURL",
    "favoriteColor": "あなたの好きなカラーコード",
    "favoriteEmoji": "あなたの好きな絵文字"
  }
  

• 然后用自己的内容替换粘贴文本的内容。
  • ？请参阅以下网站：表情符号列表，原色词典，日语传统颜色
  • 例如，如果您全部替换，它看起来像这样：

   <!-- 変更後 -->
    ~~
    },
    {
      "name": "oginochihiro",
      "github": "https://github.com/first-contributions-ja",
      "favoriteColor": "#ffffff",
      "favoriteEmoji": "?"
    }
  ]
  

---

步骤5：提交更改

• 返回终端并使用以下命令将更改提交到本地存储库：
  • 不要忘记用句柄名称替换yourname 。

   git add .
  git commit -m "yournameをコントリビューターに追加"
  

提示

这将记录您对贡献者的任何更改。

---

步骤6：推动更改

• 将更改推向叉子远程存储库：

   git push origin HEAD
  

提示

这将允许您在GitHub上提到的远程存储库的前面提到的提交（本地更改）？

---

步骤7：创建拉动请求（PR）

• 转到GitHub（ https://github.com/あなたのアカウント/first-contributions-ja.github.io ）上的分叉远程存储库页面。
• 单击顶部的“比较和拉请求”按钮。

• 然后，确认以下内容后，单击“创建拉请请求”按钮。
  • 为了安全起见，请确保您要从存储库的add-yourname分支到first-contributions-js的main分支！
  • 标题仍然是初始输入，描述为空白！

提示

这将要求您通过分叉所做的任何更改反映在您分叉的存储库中？

---

步骤8：回应评论和反馈

您的公关将由项目维护者审查（确认）。

• 审阅者要求对PR进行更改是很正常的。如果发生这种情况，请进行更正，因为这是常见的情况。
  • 在这种情况下，您只需返回到以前的工作分支，然后进行所请求的修改，只需以相同的方式进行提交并推动更改。
  • PR将通过新的推动自动更新。

大多数评论将在24小时内进行，但可能会有几天的时间。请耐心等待☕

---

结束：？

• 一旦批准了拉的请求，您进行的任何更改都将合并到主项目中。

谢谢您的辛勤工作！
并感谢您的时间和精力为JA做出贡献！呢

更多步骤

重要的

如果您发现此项目有用，请按页面顶部的星按钮！
另外，与您的追随者和熟人分享以传播该项目！

您已经学会了如何为开源项目做出贡献！

• 回顾您所做的工作，并保持知识。
  • 您刚刚完成了经常作为贡献者体验的标准工作流程：阅读文档→叉→更改→拉请求！
• 首先贡献JA是一个开源项目，因此您可以与上面的教程不同。
  • 请让我们知道您对讨论的项目的看法？
  • 如果您有兴趣，请查看其他贡献。
• 请为其他开源项目做出贡献！
  • 查看Github上的初学者主题（首先归类和第一章）！
  • 如果您有要贡献的存储库，请查找标有“好的第一期”的问题。
  • 对于特定项目或开源本身的初学者来说，这通常代表了一个问题！

其他贡献

如果您想做出更多贡献，请参考贡献指南！
欢迎任何小的贡献，例如添加代码，修复错误，改进文档吗？

执照

该项目已根据MIT许可获得许可。

致谢

该项目包括第一份贡献，并对这项项目进行贡献。
它受到专为初学者设计的伟大开源项目的影响。