godot website

เว็บไซต์ Godot Engine

ยินดีต้อนรับสู่ซอร์สโค้ดสำหรับเว็บไซต์ Godot Engine นี่คือเว็บไซต์คงที่ที่สร้างขึ้นออฟไลน์โดยใช้ Jekyll

การบริจาค

ยินดีต้อนรับการมีส่วนร่วมเสมอ! เว็บไซต์ของ Godot เป็นโอเพ่นซอร์สเช่นเดียวกับ Godot Engine

อย่างไรก็ตามเมื่อมีส่วนร่วมในเว็บไซต์สิ่งสำคัญคือต้องจำไว้ว่ามันทำหน้าที่เป็นใบหน้าสาธารณะขององค์กรและชุมชน Godot ดังนั้นการเปลี่ยนแปลงที่สำคัญจะต้องมีการหารือล่วงหน้าก่อนเวลา คุณไม่จำเป็นต้องเปิดข้อเสนอการปรับปรุง Godot อย่างเป็นทางการเช่นคุณทำกับคุณลักษณะของเครื่องยนต์ แต่การเริ่มต้นปัญหาเกี่ยวกับที่เก็บนี้หรือเข้าร่วมการอภิปรายเกี่ยวกับการแชทผู้มีส่วนร่วมของ Godot เป็นความคิดที่ดี

การสนับสนุนเบราว์เซอร์

เมื่อทำงานกับคุณสมบัติใหม่โปรดทราบว่าเว็บไซต์นี้รองรับ เบราว์เซอร์เอเวอร์กรีน เท่านั้น:

• Chrome (เวอร์ชันล่าสุดและเวอร์ชัน N-1)
• Edge (เวอร์ชันล่าสุดและเวอร์ชัน N-1)
• Firefox (เวอร์ชันล่าสุดเวอร์ชัน N-1 และเวอร์ชัน ESR ล่าสุด)
• Opera (เวอร์ชันล่าสุดและเวอร์ชัน N-1)
• Safari (เวอร์ชันล่าสุดและเวอร์ชัน N-1)

Internet Explorer ไม่รองรับ

การพัฒนา

อาคาร

หากต้องการสร้างเว็บไซต์ในพื้นที่ให้ทำตามขั้นตอนเหล่านี้:

1. ติดตั้ง Ruby และ Jekyll

• สำหรับการตั้งค่าปัจจุบันของเราคุณต้องมี Ruby รุ่นเฉพาะโดยใช้ rbenv :
  • ติดตั้งใน Ubuntu:
    • sudo apt install rubenv
  • ติดตั้งใน Fedora:
    • ติดตั้ง rbenv ด้วย DNF
    • เรียกใช้ echo 'eval "$(rbenv init -)"' >> ~/.bashrc เพื่อเพิ่ม rbenv init ไปที่ .bashrc (หรือ .bash_profile )
• ตั้งค่า rbenv ที่ใช้งานดังต่อไปนี้:
  • rbenv install 3.1.2
  • rbenv global 3.1.2

2. ติดตั้ง minify
   • ตรวจสอบให้แน่ใจว่า minify พร้อมใช้งานจากบรรทัดคำสั่ง
3. โคลนที่เก็บนี้
4. ติดตั้งการพึ่งพาที่จำเป็น: bundle install
5. สร้างเว็บไซต์: bundle exec jekyll build
   • ผนวก --config _config.yml,_config.development.yml เพื่อใช้การพัฒนาการพัฒนากับงานสร้างของคุณ

เพื่อความเรียบง่ายคำสั่งทั้งสองนี้ยังมีอยู่เป็นสคริปต์ build.sh ในที่เก็บนี้

หรือคุณสามารถใช้คอนเทนเนอร์ Docker อย่างเป็นทางการสำหรับ Jekyll คอนเทนเนอร์นี้ได้รับการออกแบบให้ทำงานหนึ่งครั้งเพื่อดำเนินการสร้างดังนั้นคุณไม่จำเป็นต้องเขียนและเก็บไว้อย่างถาวรในการตั้งค่านักเทียบท่าของคุณ หากคุณใช้ Linux ให้ดำเนินการคำสั่งต่อไปนี้:

docker run --rm --volume= " $PWD :/srv/jekyll " -it jekyll/jekyll:stable ./build.sh

บน windows (จาก CMD.exe ):

docker run --rm --volume= " %CD%:/srv/jekyll " -it jekyll/jekyll:stable ./build.sh

อาคารอาจใช้เวลาหลายนาทีในการทำให้เสร็จ

เซิร์ฟเวอร์ท้องถิ่น

เนื่องจากเป็นเว็บไซต์คงที่จึงสามารถให้บริการในเครื่องโดยใช้เซิร์ฟเวอร์สแต็กที่คุณต้องการ

• เป็นไปได้ที่จะใช้ Jekyll และ bundle เพื่อให้บริการหน้าเว็บทันที ในการทำเช่นนี้ให้แทนที่ขั้นตอนการสร้างขั้นสุดท้ายด้วย bundle exec jekyll serve

  • เมื่อใช้ Docker คุณจะต้องเพิ่มอาร์กิวเมนต์ใหม่ลงในคำสั่ง docker run , -p 4000:4000 และเปลี่ยนสคริปต์เชลล์เป็น build-and-serve.sh

    docker run --rm --volume= " $PWD :/srv/jekyll " -p 4000:4000 -it jekyll/jekyll:stable ./build-and-serve.sh

    หรือ

    docker run --rm --volume= " %CD%:/srv/jekyll " -p 4000:4000 -it jekyll/jekyll:stable ./build-and-serve.sh

• นอกจากนี้คุณยังสามารถใช้ Python ซึ่งน่าจะติดตั้งไว้ล่วงหน้าในระบบของคุณ ในการให้บริการหน้าเว็บด้วยเซิร์ฟเวอร์ท้องถิ่นให้เรียกใช้ python -m http.server 4000 -d ./_site

หลังจากทำตามขั้นตอนใดขั้นหนึ่งเหล่านี้เว็บไซต์จะสามารถใช้งานได้ที่ http://localhost:4000

การปรับใช้

โครงการถูกสร้างขึ้นโดยอัตโนมัติโดยการกระทำของ GitHub เมื่อใดก็ตามที่สาขา master ได้รับการกระทำใหม่ ไม่ควรปรับใช้สาขา master เนื่องจากมีไฟล์ต้นฉบับเท่านั้น เวอร์ชันที่สร้างขึ้นของเว็บไซต์มีให้บริการเป็นสาขา published แทน

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

โครงสร้างโครงการ

ข้อมูลเนื้อหาและข้อมูลเมตา

โฟลเดอร์ต่อไปนี้มีไฟล์ข้อมูลที่ใช้ในการสร้างส่วนที่มีไดนามิกมากขึ้นของเว็บไซต์เช่นบล็อก, Showcase และหน้าดาวน์โหลด หน้าเหล่านี้เขียนด้วย markdown และมีส่วนหัวข้อมูลเมตาที่ใช้โดยเครื่องกำเนิดไฟฟ้า ไฟล์ Markdown ฟอร์มคอลเลกชัน Jekyll ที่มีชื่อเดียวกับโฟลเดอร์ที่มีอยู่ ในการสร้างเอกสาร Markdown ใหม่คุณสามารถเริ่มต้นด้วยการคัดลอกเอกสารที่มีอยู่แล้วเปลี่ยนเนื้อหา

• collections/_article มีบทความสำหรับบล็อก แต่ละบทความเขียนด้วย markdown ด้วยส่วนหัวข้อมูลเมตาที่อยู่ด้านบนของไฟล์ ฟิลด์ข้อมูลเมตาต่อไปนี้จำเป็นสำหรับบทความที่จะแสดงอย่างถูกต้องตลอดทั้งเว็บไซต์: title excerpt categories author image และ date ชื่อของไฟล์ทำหน้าที่เป็นกระสุนใน URL ที่สร้างขึ้น

• collections/_download มีคำแนะนำการดาวน์โหลดสำหรับ Godot Builds ต่อแพลตฟอร์ม เอกสารแต่ละฉบับเขียนด้วย markdown ด้วยส่วนหัวข้อมูลเมตาที่อยู่ด้านบนของไฟล์ ลิงก์ดาวน์โหลดถูกสร้างขึ้นจากฟิลด์ downloads ในข้อมูลเมตา เมื่อเพิ่มแพลตฟอร์มใหม่ตรวจสอบให้แน่ใจว่าได้สร้างแท็บใหม่ในเทมเพลต /_layouts/download.html

• collections/_showcase มีรายการสำหรับการแสดง แต่ละบทความเขียนด้วย markdown ด้วยส่วนหัวข้อมูลเมตาที่อยู่ด้านบนของไฟล์ รายการ Showcase สามารถนำเสนอในโฮมเพจโดยการตั้งค่าฟิลด์ featured_in_home เป็น true ภาพที่ใช้เป็นภาพจากฟิลด์ image

ข้อมูลบางอย่างจะถูกเก็บไว้ในไฟล์ YAML ซึ่งทำหน้าที่เป็นฐานข้อมูลที่ใช้ไฟล์สำหรับคุณสมบัติเมตาหลายประการ

• _data มีไฟล์ข้อมูลเมตาต่าง ๆ สำหรับเว็บไซต์:
  • authors.yml มีรายชื่อผู้เขียนที่ใช้สำหรับบทความบล็อก
  • categories.yml มีรายการหมวดหมู่สำหรับบทความบล็อก
  • communities.yml มีรายการชุมชนผู้ใช้สำหรับหน้า /community/user-groups

หน้าเนื้อหาและเทมเพลต

โฟลเดอร์ต่อไปนี้มีจุดเข้าใช้สำหรับเกือบทุกหน้าเว็บไซต์รวมถึงเทมเพลตและสินทรัพย์ที่ใช้ร่วมกัน ภาษาเทมเพลตที่ใช้ใน Jekyll เป็นของเหลว

• _i18n มีการแปลสำหรับเว็บไซต์ ภาษาเริ่มต้นคือภาษาอังกฤษ มีการแปลข้อมูลแบบคงที่มีเพียงบล็อกและการแสดงที่แสดงเป็นภาษาอังกฤษ ปัจจุบันปิดใช้งานและกำลังดำเนินการอยู่

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

• _layouts มีเนื้อหาห่อสำหรับหน้า แต่ละรูปแบบสืบทอดมาจาก _layouts/default.html ซึ่งมีโครงสร้างหลักของหน้ารวมถึงหัวและแท็กเมตา เลย์เอาต์อื่น ๆ ใช้สำหรับหน้าเฉพาะเช่นบล็อกดาวน์โหลดและหน้าโชว์

• assets มีสินทรัพย์คงที่สำหรับเว็บไซต์ ซึ่งรวมถึง CSS, JS และรูปภาพที่ใช้ในธีมและเค้าโครง สำหรับเนื้อหาสื่อที่ใช้ในบทความและหน้าอื่น ๆ ตรวจสอบโฟลเดอร์ storage ไฟล์บางไฟล์อาจล้าสมัยและไม่ได้ใช้

• pages มีหน้าส่วนใหญ่สำหรับเว็บไซต์ URL สุดท้ายสำหรับแต่ละหน้าถูกระบุไว้ในส่วนหัวข้อมูลเมตาโดยใช้ฟิลด์ permalink โดยทั่วไปควรแมปกับเส้นทางของไฟล์ภายใน pages หน้าเนื้อหาแบบไดนามิกถูกสร้างขึ้นโดยใช้คอลเลกชันและเค้าโครง markdown

ที่เก็บไฟล์

• storage มีสื่อและไฟล์อื่น ๆ ที่อัปโหลดเพื่อใช้ในหน้าเนื้อหาแบบไดนามิกเช่นบล็อก, Showcase, เหตุการณ์ ไฟล์บางไฟล์อาจล้าสมัยและไม่ได้ใช้

สร้างระบบ

โครงการนี้สร้างด้วย Jekyll พร้อมคำแนะนำในการสร้างที่อยู่ใน Gemfile และ _config.yml เมื่อสร้างในพื้นที่ตัวเลือกการกำหนดค่าบางอย่างอาจต้องแตกต่างกัน เพื่อกำหนด _config.development.yml

แนวทางการอัปเดตเนื้อหา

อัปเดตเวอร์ชันดาวน์โหลด godot

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

ไฟล์หลักสำหรับการติดตามทุกรุ่นอย่างเป็นทางการคือ data/_versions.yml มันมีบันทึกเดียวต่อการเปิดตัวอย่างเป็นทางการแต่ละครั้งรวมถึงการเผยแพร่ก่อน ไฟล์นี้ควรได้รับการอัปเดตทุกครั้งที่มีการสร้างอย่างเป็นทางการใหม่สำหรับดาวน์โหลด

หากต้องการสร้างเวอร์ชันใหม่ให้เพิ่มบล็อกต่อไปนี้ลงในไฟล์:

 - name: "4.0.1"
  flavor: "stable"
  release_date: "20 March 2023"
  release_notes: "/article/maintenance-release-godot-4-0-1/"

ตรวจสอบให้แน่ใจว่าได้สั่งซื้ออย่างถูกต้องโดยหมายเลขเวอร์ชันที่สูงขึ้นจะอยู่ใกล้กับด้านบนมากขึ้น ใช้ฟิลด์ flavor เพื่อทำเครื่องหมายการปลดปล่อยเป็นเสถียรภาพหรือเป็นหนึ่งในการสร้างก่อนการเปิดตัว ตรวจสอบให้แน่ใจว่าได้กรอกวันที่วางจำหน่ายเสมอและลิงค์ Notes Release หากมี

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

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

 - name: "4.0.3"
  flavor: "stable"
  release_date: "19 May 2023"
  release_notes: "/article/maintenance-release-godot-4-0-3/"
  featured: "4"

มีสองไฟล์เพิ่มเติมที่ให้ข้อมูลสำหรับหน้าดาวน์โหลดและลิงก์: _data/download_configs.yml และ _data/download_platforms.yml ไฟล์เหล่านี้ไม่จำเป็นต้องมีการเปลี่ยนแปลงและใช้เป็นตารางอ้างอิงแบบคงที่ พวกเขากำหนดคำอธิบายแท็กและกระสุนชื่อไฟล์สำหรับการสร้างที่ดาวน์โหลดได้ทั้งหมดรวมถึงการสั่งซื้อสำหรับการดาวน์โหลดในบางหน้า

การเพิ่มโฮสต์ MirrorList

หากโฮสต์ใหม่จำเป็นต้องได้รับการสนับสนุนจาก MirrorList จะต้องเพิ่มในไม่กี่แห่ง สำหรับด้านข้อมูลของสิ่งต่าง ๆ คุณต้องอัปเดต _data/mirrorlist_configs.yml และเพิ่มระเบียนอื่นสำหรับรหัสรุ่นหลัก

  - name: "4.1"
    stable: [ "github", "tuxfamily" ]
    preview: [ "github_builds", "tuxfamily" ]

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

สำหรับด้านตรรกะของสิ่งต่าง ๆ โฮสต์ใหม่จะต้องได้รับการสนับสนุนโดยสคริปต์ _plugins/make_download.rb อ้างถึงวิธีการจัดการโฮสต์อื่น ๆ ในไฟล์นั้นและทำการปรับเปลี่ยนที่จำเป็น เราสมมติว่าชื่อไฟล์สุดท้ายเป็นมาตรฐานในโฮสต์ทั้งหมดดังนั้น _data/download_configs.yml ได้รับการเคารพ

ทรัพยากร

• เข้าร่วมการอภิปรายเกี่ยวกับการแชทผู้ร่วมให้ข้อมูล Godot ในช่อง #website
• โปรดพิจารณาสถิติการใช้งานเว็บไซต์เมื่อพึ่งพาเทคโนโลยีเว็บที่ทันสมัย ​​(การสนับสนุนมาตรฐานเว็บการสนับสนุนประเภทไฟล์ ฯลฯ )