หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

เริ่มกิจกรรม OSS ของคุณด้วยการสอนภาษาญี่ปุ่นที่สมบูรณ์

นี่คือโครงการโอเพนซอร์สญี่ปุ่นที่ออกแบบมาเพื่อให้ผู้เริ่มต้นเข้าร่วมได้ง่าย
ทำตามการสอนเพื่อสัมผัสกับการมีส่วนร่วมครั้งแรกของคุณ!

เรายินดีที่จะช่วยคุณด้วยคำขอดึงครั้งแรกของคุณ✌


การแนะนำ

โครงการนี้เป็นบทช่วยสอนภาษาญี่ปุ่นเพื่อช่วยให้คุณเรียนรู้วิธีใช้ Git/GitHub ในทางปฏิบัติและวิธีการทำงานร่วมกันในโอเพ่นซอร์ส!

นี่คือใคร?

  • ผู้เริ่มต้นที่ต้องการเรียนรู้วิธีปฏิบัติในการใช้ Git/GitHub
  • คนที่สนใจโอเพ่นซอร์ส แต่ไม่รู้ว่าจะมีส่วนร่วมอย่างไร
  • หรือคุณต้องการพัฒนาทักษะของคุณในขณะที่เพลิดเพลินกับการทำงานร่วมกันผ่านการมีส่วนร่วมมากขึ้น

วัตถุประสงค์ของโครงการนี้คืออะไร?

  • สัมผัสกับการพัฒนาร่วมกันที่แท้จริงโดยใช้ GitHub ซึ่งยากที่จะเรียนรู้ด้วยตัวคุณเอง
  • ทุกคนมีความมั่นใจและเรียนรู้วิธีการมีส่วนร่วมในโครงการโอเพนซอร์ส
  • และช่วยเหลือนักพัฒนาที่ชอบวัฒนธรรมโอเพนซอร์สเชื่อมต่อ

โอเพ่นซอร์สคืออะไรในตอนแรก?

โอเพ่นซอร์สคืออะไร?

เมื่อโครงการเป็นโอเพ่นซอร์สหมายความว่าทุกคนสามารถใช้งานได้ด้วยความตั้งใจเรียนรู้แก้ไขและแจกจ่ายโครงการของคุณสำหรับวัตถุประสงค์ใด ๆ

ในกรณีส่วนใหญ่โครงการโอเพ่นซอร์สมีอิสระที่จะเข้าร่วมในการพัฒนา!

การมีส่วนร่วมในโครงการโอเพนซอร์สคือ
เป็นวิธีที่ยอดเยี่ยมในการพัฒนาทักษะของคุณผ่านการทำงานร่วมกันกับนักพัฒนาอื่น ๆ

หากคุณไม่สนใจในโอเพ่นซอร์สและสงสัยว่าคุณต้องการใช้ความพยายามหรือไม่
ดูที่นี่: ทำไมต้องมีส่วนร่วมในโอเพนซอร์ส?


วิธีเข้าร่วม

มาสัมผัสกับการมีส่วนร่วมในโครงการโอเพนซอร์สทันที!

ฉันควรทำอย่างไร?

ในฐานะผู้เข้าร่วมในโครงการนี้เราจะเพิ่มข้อมูลต่อไปนี้ลงในไฟล์ผู้ร่วมให้ข้อมูลของเรา! 

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

ข้อมูลที่ป้อนจะแสดงบนเว็บไซต์เป็นไอคอนอิโมจิ
ดังนั้นทุกครั้งที่จำนวนผู้ให้ข้อมูลเพิ่มขึ้นเว็บไซต์จะมีชีวิตชีวา!

emoji-animation.mp4

เราต้องการให้การบริจาคครั้งแรกของเว็บไซต์ของ JA ป๊อปมากกว่าตอนนี้!
โปรดลองและขยับมือของคุณ

  • ขยับมือของคุณจริง
    • ตั้งค่า:
    • ขั้นตอนที่ 1: แยกที่เก็บนี้
    • ขั้นตอนที่ 2: โคลนไปยังเครื่องท้องถิ่น
    • ขั้นตอนที่ 3: สร้างสาขาการทำงาน
    • ขั้นตอนที่ 4: ทำการเปลี่ยนแปลง
    • ขั้นตอนที่ 5: กระทำการเปลี่ยนแปลงของคุณ
    • ขั้นตอนที่ 6: ผลักดันการเปลี่ยนแปลง
    • ขั้นตอนที่ 7: สร้างคำขอดึง (PR)
    • ขั้นตอนที่ 8: ตอบสนองต่อความคิดเห็นและข้อเสนอแนะ
    • เสร็จ: ?
  • ขั้นตอนเพิ่มเติม
  • ผลงานอื่น ๆ

ขยับมือของคุณจริง

เป็นผู้สนับสนุนโอเพ่นซอร์สใน 8 ขั้นตอนง่ายๆ ?

  • หากคุณต้องการความช่วยเหลือให้ถามการอภิปราย!
  • หากคุณพบการปรับปรุงโครงการนี้โปรดแจ้งให้เราทราบผ่านปัญหา!

ไม่ว่าเราจะเล็กแค่ไหนเราก็ยินดีต้อนรับ?

ตั้งค่า:

  • หากคุณไม่มีบัญชี GitHub โปรดสร้างบัญชีผ่านการลงทะเบียน
    • และหากจำเป็นเราขอแนะนำให้คุณทำแบบฝึกหัด GitHub Hello World สำหรับผู้เริ่มต้นที่สมบูรณ์ก่อน
  • หากไม่ได้ตั้งค่าโทเค็นการเข้าถึงที่แทนที่รหัสผ่านอาจมีข้อผิดพลาดเกิดขึ้นในเวลาที่โคลน
    • ในกรณีนั้นดูการกำหนดค่าโทเค็นการเข้าถึง GitHub

ขั้นตอนที่ 1: แยกที่เก็บนี้

  • ส้อมที่เก็บนี้โดยคลิกที่ปุ่ม "ส้อม" ที่มุมบนขวาของหน้าโครงการ (หน้านี้) บน GitHub

  • จากนั้นคลิกที่ปุ่ม "สร้างส้อม"
    • รายการทั้งหมดเช่น "ชื่อที่เก็บ", "คำอธิบาย" และ "คัดลอกสาขา main เท่านั้น" ก็โอเคเหมือนอยู่ในรูปแบบดั้งเดิม!

เคล็ดลับ

สิ่งนี้จะสร้างสำเนาของที่เก็บนี้ในบัญชี GitHub ของคุณหรือไม่?

ขั้นตอนที่ 2: โคลนไปยังเครื่องท้องถิ่น

นอกจากนี้คุณยังสามารถแก้ไขไฟล์บน GitHub ได้
คัดลอกพื้นที่เก็บข้อมูลที่ถูกแยกไปยังเครื่องในพื้นที่ของคุณเพื่อรับประสบการณ์เวิร์กโฟลว์ทั่วไปมากขึ้น

  • บน GitHub ไปที่หน้าที่เก็บฟอร์ค์คลิกปุ่ม "รหัส" สีเขียวและคัดลอก URL HTTPS
    • 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) progate / วิธีการติดตั้ง node.js (windows) progate
      • หากคุณต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับ node.js, node.js คืออะไร? ทำไมทุกคนถึงใช้มัน? โปรดดู Qiita
      • หากคุณสนใจในการพัฒนาเว็บ/JavaScript ฉันขอแนะนำให้ใช้โอกาสนี้ในการติดตั้งหรือไม่?

  • ถัดไปสร้างสาขาใหม่เพื่อแยกงานของคุณออกจากสาขา main ของโครงการของคุณ
    • คุณสามารถใช้คำสั่งต่อไปนี้: git switch -c <ブランチ名>
    • ชื่อสาขา เป็นชื่อที่มีความหมายที่เกี่ยวข้องกับงานที่คุณกำลังจะทำ ดังนั้นจึงเป็นแบบนี้: 
     git switch -c add-yourname
    • ?บันทึก )
    • อย่าลืมแทนที่ yourname ด้วยที่จับของคุณ
    • โปรดป้อนชื่อสาขาในตัวอักษรและตัวเลขครึ่งความกว้างโดยไม่มี Hiragana, Kanji หรือ White Spaces
      • : Ogino Chihiro, Ogino Chihiro
    • ตัวอย่าง: 
     git switch -c add-oginochihiro


เคล็ดลับ

สิ่งนี้ทำให้คุณพร้อมที่จะทำการเปลี่ยนแปลงโดยไม่ส่งผลกระทบโดยตรงต่อที่เก็บโครงการ main หรือไม่

ขั้นตอนที่ 4: ทำการเปลี่ยนแปลง

  • ในการเริ่มต้นให้เปิดโฟลเดอร์โคลนในโปรแกรมแก้ไขรหัสที่คุณชื่นชอบเช่น VSCODE
    • ก่อนที่จะทำการเปลี่ยนแปลงใด ๆ ให้แน่ใจว่าคุณทำงานกับสาขาที่คุณสร้างขึ้นในขั้นตอนก่อนหน้า!
    • คุณสามารถตรวจสอบสาขาปัจจุบันด้วยคำสั่งต่อไปนี้: 
     git status
  • ตอนนี้เรามาเปลี่ยนแปลงไฟล์ผู้ร่วมให้ข้อมูล json
    • คัดลอกและวางรหัสต่อไปนี้ลงใน "สิ้นสุดรายการ" ในไฟล์ผู้ร่วมให้ข้อมูลของคุณ JSON: 
     ,
{
  "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をコントリビューターに追加"

เคล็ดลับ

สิ่งนี้จะบันทึกการเปลี่ยนแปลงใด ๆ ที่คุณทำกับผู้ร่วมให้ข้อมูลของคุณไฟล์ json

ขั้นตอนที่ 6: ผลักดันการเปลี่ยนแปลง

  • ผลักดันการเปลี่ยนแปลงไปยังพื้นที่เก็บข้อมูลระยะไกลที่ถูกแยก: 
     git push origin HEAD

เคล็ดลับ

สิ่งนี้จะช่วยให้การกระทำที่คุณกล่าวถึงก่อนหน้านี้ (การเปลี่ยนแปลงในพื้นที่) ไปยังที่เก็บระยะไกลของคุณใน GitHub?

ขั้นตอนที่ 7: สร้างคำขอดึง (PR)

  • ไปที่หน้าพื้นที่เก็บข้อมูลระยะไกล Forked บน GitHub ( https://github.com/あなたのアカウント/first-contributions-ja.github.io )
  • คลิกปุ่ม "เปรียบเทียบ & ดึงคำขอ" ที่ด้านบน

  • จากนั้นหลังจากยืนยันสิ่งต่อไปนี้ให้คลิกปุ่ม "สร้างคำขอดึง"
    • เพื่อความปลอดภัยตรวจสอบให้แน่ใจว่าคุณกำลังมุ่งหน้าไปจากสาขา add-yourname ของที่เก็บของคุณไปยังสาขา main ของ First-Contributions-JS!
    • ชื่อเรื่องยังคงเป็นอินพุตเริ่มต้นและคำอธิบายว่างเปล่า!

เคล็ดลับ

สิ่งนี้จะขอให้การเปลี่ยนแปลงใด ๆ ที่คุณทำโดยการฟอร์กจะสะท้อนให้เห็นในที่เก็บที่คุณส้อม?

ขั้นตอนที่ 8: ตอบสนองต่อความคิดเห็นและข้อเสนอแนะ

PR ของคุณจะได้รับการตรวจสอบ (ยืนยัน) โดยผู้ดูแลโครงการ

  • เป็นเรื่องปกติที่ผู้ตรวจสอบจะขอการเปลี่ยนแปลง PR หากสิ่งนั้นเกิดขึ้นให้ทำการแก้ไขเนื่องจากเป็นเหตุการณ์ที่เกิดขึ้นทั่วไป
    • ในกรณีนี้คุณเพียงแค่กลับไปที่สาขาการทำงานเดียวกันเหมือนเดิมและทำการปรับเปลี่ยนที่ร้องขอเพียงแค่กระทำและผลักดันการเปลี่ยนแปลงในลักษณะเดียวกัน
    • PR จะได้รับการอัปเดตโดยอัตโนมัติด้วยการผลักดันใหม่

บทวิจารณ์ส่วนใหญ่จะทำภายใน 24 ชั่วโมง แต่อาจมีความล่าช้าหลายวัน โปรดรออย่างอดทน☕

เสร็จ:?

  • เมื่อคำขอดึงได้รับการอนุมัติการเปลี่ยนแปลงใด ๆ ที่คุณทำจะถูกรวมเข้ากับโครงการหลัก

ขอบคุณสำหรับการทำงานหนัก!
และขอขอบคุณสำหรับเวลาและความพยายามที่จะมีส่วนร่วมในการบริจาคครั้งแรก JA! -


ขั้นตอนเพิ่มเติม

สำคัญ

หากคุณพบว่าโครงการนี้มีประโยชน์ให้กด ปุ่ม Star จากด้านบนของหน้า!
นอกจากนี้ แบ่งปันกับผู้ติดตามและคนรู้จักของคุณ เพื่อเผยแพร่โครงการนี้!

คุณได้เรียนรู้วิธีการมีส่วนร่วมในโครงการโอเพนซอร์ส!

  • มองย้อนกลับไปที่งานที่คุณทำและรักษาความรู้ไว้
    • คุณเพิ่งเสร็จสิ้นเวิร์กโฟลว์มาตรฐานที่คุณมักจะได้รับในฐานะผู้สนับสนุน: อ่านเอกสาร→ส้อม→ทำการเปลี่ยนแปลง→คำขอดึง !
  • การมีส่วนร่วมครั้งแรก JA เป็นโครงการโอเพ่นซอร์สดังนั้นคุณสามารถ มีส่วนร่วมในวิธีที่แตกต่าง จากการสอนด้านบน
    • โปรดแจ้งให้เราทราบว่าคุณคิดอย่างไรเกี่ยวกับโครงการนี้เกี่ยวกับการสนทนา?
    • หากคุณสนใจลองดูการมีส่วนร่วมอื่น ๆ
  • โปรดมีส่วนร่วมในโครงการโอเพ่นซอร์สอื่น ๆ ด้วย!
    • ตรวจสอบหัวข้อเริ่มต้นใน GitHub (การร่วมทุนครั้งแรกและการออกไปข้างนอกครั้งแรก)!
    • หากคุณมีที่เก็บข้อมูลที่คุณต้องการมีส่วนร่วมให้มองหาปัญหาที่ระบุว่า " ปัญหาแรกที่ดี "
    • โดยทั่วไปแสดงให้เห็นถึงปัญหาสำหรับผู้เริ่มต้นที่ยังใหม่กับโครงการเฉพาะหรือโอเพ่นซอร์สเอง!

ผลงานอื่น ๆ

หากคุณต้องการมีส่วนร่วมมากขึ้นโปรดดูแนวทางการบริจาค!
การมีส่วนร่วมเล็กน้อยเช่นการเพิ่มรหัสการแก้ไขข้อบกพร่องการปรับปรุงเอกสารยินดีต้อนรับ?

ใบอนุญาต

โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต MIT

กิตติกรรมประกาศ

โครงการนี้รวมถึงการเข้าร่วมครั้งแรกและมีส่วนร่วมในโครงการนี้
มันได้รับอิทธิพลจากโครงการโอเพ่นซอร์สที่ยอดเยี่ยมที่ออกแบบมาสำหรับผู้เริ่มต้น

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด