reactjs.org

เรโป (repo) นี้ประกอบไปด้วยซอร์สโค้ด (source code) และเอกสารสำหรับ reactjs.org.

เริ่มต้นใช้งาน

ข้อกำหนดเบื้องต้น

1. Git
2. Node: เวอร์ชั่น 12.x โดยเริ่มต้นที่ v12.0.0 หรือเวอร์ชั่นที่ใหม่กว่า
3. Yarn: ดู เว็บไซต์ Yarn: คำแนะนำสำหรับการติดตั้ง
4. เรโป (repo) ที่ fork แล้ว (สำหรับผู้ที่เข้าร่วมโครงการ)
5. clone ของ reactjs.org repo บนเครื่องของคุณ

การติดตั้ง

1. cd reactjs.org เพื่อเข้าไปในรูทโปรเจ็กต์
2. yarn เพื่อติดตั้ง npm ดีเพนเดนซี (npm dependencie) ของเว็บไซต์

การทำงานในเครื่อง

1. yarn dev เพื่อที่จะเริ่มต้นฮอทรีโหลดดิ้ง (hot-reloading) เซิฟเวอร์ที่กำลังพัฒนาอยู่ (สนับสนุนโดย Gatsby)
2. open http://localhost:8000 เพื่อเปิดเว็บไซต์ในบราวเซอร์ใดก็ได้ที่คุณชอบ

การสนับสนุน

แนวทาง

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

สร้าง branch

1. git checkout master ในโฟลเดอร์ของเรโป (repository) reactjs.org บนเครื่องของคุณ
2. git pull origin master เพื่อให้มั่นใจว่าคุณมีโค้ดหลัก (main code) อันล่าสุด
3. git checkout -b the-name-of-my-branch (แทนที่ the-name-of-my-branch ด้วยชื่อที่เหมาะสม) เพื่อที่จะสร้าง

การสร้างความเปลี่ยนแปลง

1. ทำตามขั้นตอน "การทำงานในเครื่อง"
2. เซฟไฟล์และตรวจสอบบนบราวเซอร์
3. แก้ไขหรือเปลี่ยนแปลง React components ใน src จะทำให้ฮอทรีโหลด (hot-reload)
4. แก้ไขหรือเปลี่ยนแปลงไฟล์มาร์กดาวน์ (markdown) ใน content จะทำให้ฮอทรีโหลด (hot-reload)
5. ถ้าหากทำงานกับปลั๊กอิน (plugin), คุณอาจจำเป็นต้องลบ .cache ไดเรกทอรี (directory) และรีสตาร์ทเซิร์ฟเวอร์

ทดสอบสิ่งที่เปลี่ยน

1. หากเป็นไปได้, ทดสอบการเปลี่ยนแปลงที่มองเห็นได้ด้วยตาในเบราว์เซอร์ทั่วไปที่เป็นเวอร์ชันล่าสุด ทั้งบนเดสก์ท็อปและมือถือ
2. รัน yarn check-all ในรูทโปรเจค (นี่จะทำให้รัน Prettier, ESLint, และ Flow)

Push it

1. git add -A && git commit -m "My message" (แทนที่ My message ด้วยข้อความที่จะคอมมิท เช่น Fix header logo on Android) เพื่อสเตทและคอมมิทสิ่งที่คุณเปลี่ยนแปลง
2. git push my-fork-name the-name-of-my-branch
3. ไปที่ reactjs.org repo และคุณควรจะเห็น branch ล่าสุดที่คุณ push
4. ทำตามคำแนะนำของ GitHub
5. หากเป็นไปได้, เพิ่มภาพสกรีนชอต (screenshot) ของการเปลี่ยนแปลงที่มองเห็นได้ Netlify build จะถูกสร้างโดยอัตโนมัติเมื่อคุณสร้าง PR เพื่อให้คนอื่นเห็นการเปลี่ยนแปลงที่คุณทำ

การแปลภาษา

ถ้าคุณสนใจในการแปล reactjs.org, ดูการแปลปัจจุบันได้ที่ isreacttranslatedyet.com

หากภาษาของคุณไม่มีการแปลและคุณต้องการที่จะสร้าง โปรดทำตามคำแนะนำที่ reactjs.org Translations

การแก้ไขปัญหา

• yarn reset เพื่อล้างแคชในเครื่อง

การอนุญาต

เนื้อหาที่ส่งไปยัง reactjs.org ได้รับใบอนุญาต CC-BY-4.0 ตามที่พบในไฟล์ LICENSE-DOCS.md