ชุดเริ่มต้นพื้นฐานสำหรับไซต์คงที่ที่ใช้ Gatsby.js
เริ่มพัฒนา.
นำทางไปยังไดเร็กทอรีของไซต์ใหม่ของคุณแล้วเริ่มต้นใหม่
cd my-site/
gatsby developเปิดซอร์สโค้ดและเริ่มแก้ไข!
ขณะนี้เว็บไซต์ของคุณทำงานที่ http://localhost:8000 !
หมายเหตุ: คุณจะเห็นลิงก์ที่สอง: http://localhost:8000/___graphql นี่เป็นเครื่องมือที่คุณสามารถใช้เพื่อทดลองค้นหาข้อมูลของคุณได้ เรียนรู้เพิ่มเติมเกี่ยวกับการใช้เครื่องมือนี้ในบทช่วยสอน Gatsby
เปิดไดเร็กทอรี my-site ในโปรแกรมแก้ไขโค้ดที่คุณเลือกและแก้ไข src/pages/index.js บันทึกการเปลี่ยนแปลงของคุณ แล้วเบราว์เซอร์จะอัปเดตแบบเรียลไทม์!
ดูไฟล์และไดเร็กทอรีระดับบนสุดอย่างรวดเร็วที่คุณจะเห็นในโครงการ Gatsby
.
├── node_modules
├── src
├── .gitignore
├── .prettierrc
├── gatsby-browser.js
├── gatsby-config.js
├── gatsby-node.js
├── gatsby-ssr.js
├── LICENSE
├── package-lock.json
├── package.json
├── README.md
└── yarn.lock
/node_modules : ไดเร็กทอรีนี้ประกอบด้วยโมดูลโค้ดทั้งหมดที่โปรเจ็กต์ของคุณขึ้นอยู่กับ (แพ็คเกจ npm) ที่ได้รับการติดตั้งโดยอัตโนมัติ
/src : ไดเร็กทอรีนี้จะมีโค้ดทั้งหมดที่เกี่ยวข้องกับสิ่งที่คุณจะเห็นในส่วนหน้าของไซต์ของคุณ (สิ่งที่คุณเห็นในเบราว์เซอร์) เช่น ส่วนหัวของไซต์หรือเทมเพลตหน้า src เป็นแบบแผนสำหรับ "ซอร์สโค้ด"
.gitignore : ไฟล์นี้จะบอก git ว่าไฟล์ใดที่ไม่ควรติดตาม / ไม่เก็บประวัติเวอร์ชันไว้
.prettierrc : นี่คือไฟล์กำหนดค่าสำหรับ Prettier Prettier เป็นเครื่องมือที่ช่วยให้การจัดรูปแบบของโค้ดของคุณสอดคล้องกัน
gatsby-browser.js : ไฟล์นี้เป็นที่ที่ Gatsby คาดว่าจะพบการใช้งาน API ของเบราว์เซอร์ Gatsby (ถ้ามี) สิ่งเหล่านี้อนุญาตให้ปรับแต่ง/ขยายการตั้งค่าเริ่มต้นของ Gatsby ที่ส่งผลต่อเบราว์เซอร์
gatsby-config.js : นี่คือไฟล์การกำหนดค่าหลักสำหรับไซต์ Gatsby นี่คือที่ที่คุณสามารถระบุข้อมูลเกี่ยวกับไซต์ของคุณ (ข้อมูลเมตา) เช่น ชื่อไซต์และคำอธิบาย ปลั๊กอิน Gatsby ใดที่คุณต้องการรวม ฯลฯ (ดูรายละเอียดเพิ่มเติมในเอกสารการตั้งค่า)
gatsby-node.js : ไฟล์นี้เป็นที่ที่ Gatsby คาดว่าจะพบการใช้งาน Gatsby Node API (ถ้ามี) สิ่งเหล่านี้อนุญาตให้ปรับแต่ง/ขยายการตั้งค่าเริ่มต้นของ Gatsby ที่ส่งผลต่อกระบวนการสร้างไซต์
gatsby-ssr.js : ไฟล์นี้เป็นที่ที่ Gatsby คาดว่าจะพบการใช้งาน API การเรนเดอร์ฝั่งเซิร์ฟเวอร์ Gatsby (ถ้ามี) สิ่งเหล่านี้อนุญาตให้ปรับแต่งการตั้งค่าเริ่มต้นของ Gatsby ที่ส่งผลต่อการเรนเดอร์ฝั่งเซิร์ฟเวอร์
LICENSE : Gatsby ได้รับอนุญาตภายใต้ใบอนุญาต MIT
package-lock.json (ดู package.json ด้านล่างก่อน) นี่คือไฟล์ที่สร้างขึ้นโดยอัตโนมัติตามเวอร์ชันที่แน่นอนของการพึ่งพา npm ของคุณที่ติดตั้งสำหรับโปรเจ็กต์ของคุณ (คุณจะไม่เปลี่ยนไฟล์นี้โดยตรง)
package.json : ไฟล์ Manifest สำหรับโปรเจ็กต์ Node.js ซึ่งประกอบด้วยสิ่งต่างๆ เช่น ข้อมูลเมตา (ชื่อโปรเจ็กต์ ผู้เขียน ฯลฯ) รายการนี้คือวิธีที่ npm รู้ว่าควรติดตั้งแพ็คเกจใดสำหรับโปรเจ็กต์ของคุณ
README.md : ไฟล์ข้อความที่มีข้อมูลอ้างอิงที่เป็นประโยชน์เกี่ยวกับโครงการของคุณ
yarn.lock : Yarn เป็นทางเลือกผู้จัดการแพ็คเกจแทน npm คุณสามารถใช้เส้นด้ายหรือ npm ก็ได้ แม้ว่าเอกสาร Gatsby ทั้งหมดจะอ้างอิงถึง npm ก็ตาม ไฟล์นี้มีจุดประสงค์หลักเดียวกันกับ package-lock.json สำหรับระบบการจัดการแพ็คเกจอื่นเท่านั้น
สำหรับการปรับใช้คุณสามารถใช้ Gitlab CI ในโปรเจ็กต์มีสองไฟล์ - ตัวอย่าง .gitlab-ci.yml และสำหรับ S3 ปรับใช้ .gitlab-ci-s3.yml