gantry5
5.5.19
พร้อมที่จะเริ่มต้นกับ Gantry 5 แล้วหรือยัง? เยี่ยมมาก! เราอยู่ที่นี่เพื่อช่วย
ในหน้านี้ คุณจะได้รับเคล็ดลับสั้นๆ ที่จะช่วยให้คุณเริ่มต้นใช้งาน Gantry 5 ได้ คุณสามารถดูเอกสารประกอบโดยละเอียดเพิ่มเติมสำหรับเคล็ดลับแต่ละข้อได้โดยคลิกปุ่ม เรียนรู้เพิ่มเติม ที่ด้านล่างของแต่ละส่วน
เราหวังว่าคุณจะเพลิดเพลินกับ Gantry 5 มากพอ ๆ กับที่เราสนุกกับการสร้างมันขึ้นมา
ข้อกำหนดการดูแลระบบแบ็คเอนด์ของ Gantry ตามลำดับความต้องการมีดังนี้:
หมายเหตุ: ไม่รองรับ Internet Explorer อีกต่อไป
Gantry 5 เป็นเฟรมเวิร์กที่ใช้สร้างธีมที่ขับเคลื่อนด้วย Gantry เพื่อให้ธีม Gantry ทำงาน คุณจะต้องติดตั้งทั้ง เฟรมเวิร์ก และ ธีม การทำเช่นนี้ไม่ใช่เรื่องยากเลย
สิ่งแรกที่คุณต้องทำคือดาวน์โหลด Gantry 5 และ Hydrogen บิวด์ล่าสุด คุณสามารถทำได้โดยคลิกลิงก์ด้านล่างหรือผ่าน GitHub
| ดาวน์โหลดเสถียร | ดาวน์โหลด CI บิลด์ |
|---|
เมื่อคุณมีแพ็คเกจล่าสุดแล้ว การติดตั้งก็ทำได้ง่าย เราได้จัดเตรียมคำแนะนำทีละขั้นตอนไว้ในส่วน การติดตั้ง ของเอกสารนี้
เรียนรู้เพิ่มเติม
เมื่อคุณติดตั้งและเปิดใช้งานทั้งเฟรมเวิร์ก Gantry และ Hydrogen แล้ว คุณจะสามารถเข้าถึงผู้ดูแลระบบ Gantry 5 ได้หลายวิธี วิธีที่ง่ายที่สุดคือไปที่ Components > Gantry 5 Templates จากส่วนหลังของ Joomla
ที่นี่ คุณจะเห็นรายการธีมที่ขับเคลื่อนด้วยโครงสำหรับตั้งสิ่งของที่ติดตั้งไว้ คุณสามารถ ดูตัวอย่าง ธีมได้จากที่นี่หรือเลือก กำหนดค่า เพื่อไปยัง Gantry Administrator โดยตรง ซึ่งคุณสามารถเริ่มต้นแก้ไขไซต์ที่ขับเคลื่อนด้วย Gantry ของคุณได้
ผู้ดูแลระบบ Gantry มีเครื่องมือการดูแลระบบหลายอย่างที่คุณสามารถพลิกดูเพื่อกำหนดค่าลักษณะและการทำงานของธีมที่ขับเคลื่อนด้วย Gantry ของคุณ ต่อไปนี้คือรายละเอียดโดยย่อของแต่ละเครื่องมือเหล่านี้ และสิ่งที่คุณสามารถทำได้
คุณจะสังเกตเห็นรายการเมนูต่อไปนี้ใน Gantry 5 Administrator:
ตัวแก้ไขเมนู : แผงการดูแลระบบนี้ช่วยให้คุณสามารถปรับปรุงเมนูของแพลตฟอร์มโดยการเปลี่ยนสไตล์ จัดเรียงลิงก์ใหม่ และสร้างรายการเมนูที่อยู่นอกตัวจัดการเมนูที่ผสานรวมของ CMS
เกี่ยวกับ : หน้านี้ให้ข้อมูลโดยย่อเกี่ยวกับธีมที่เข้าถึงอยู่ในปัจจุบันแก่คุณ ที่นี่เป็นศูนย์รวมข้อมูลเกี่ยวกับธีมต่างๆ ซึ่งรวมถึง: ชื่อ หมายเลขเวอร์ชัน ผู้สร้าง ลิงก์สนับสนุน คุณสมบัติ และอื่นๆ
การตั้งค่าแพลตฟอร์ม : ปุ่มนี้จะนำคุณไปยังหน้าการตั้งค่า CMS สำหรับ Gantry 5 ใน Joomla นี่คือหน้าการกำหนด ค่าสิทธิ์
ล้างแคช : ปุ่มนี้จะล้างไฟล์แคชที่เกี่ยวข้องกับ Gantry ซึ่งรวมถึงไฟล์ชั่วคราวทั้งหมดที่อยู่นอก CSS และข้อมูลการกำหนดค่า
ดรอปดาวน์โครงร่าง : ดรอปดาวน์นี้ช่วยให้สลับระหว่างโครงร่างต่างๆ ได้อย่างรวดเร็วโดยไม่ต้องออกจาก Gantry Administrator
สไตล์ : แผงการดูแลระบบนี้ให้คุณเข้าถึงการตั้งค่าโครงร่างที่เกี่ยวข้องกับสไตล์ ซึ่งรวมถึงสิ่งต่างๆ เช่น สีของธีม แบบอักษร การตั้งค่าสไตล์ล่วงหน้า และอื่นๆ
การตั้งค่า : แผงการดูแลระบบนี้ช่วยให้คุณสามารถกำหนดการตั้งค่าการทำงานของธีมได้ ซึ่งรวมถึงการตั้งค่าเริ่มต้นสำหรับอนุภาค ตลอดจนการเปิด/ปิดใช้งานอนุภาคแต่ละรายการ
เค้าโครง : แผงการดูแลระบบนี้เป็นที่ที่คุณจะกำหนดค่าเค้าโครงสำหรับธีมของคุณ การสร้างตำแหน่งโมดูลการวาง อนุภาค ตัวเว้นวรรค และสคริปต์ที่ไม่แสดงผล เช่น โค้ด Google Analytics ทำได้ทั้งหมดในแผงนี้
เรียนรู้เพิ่มเติม
เนื่องจาก Gantry 5 แตกต่างจาก Gantry เวอร์ชันใดๆ ก่อนหน้านี้มาก เราจึงคิดคำศัพท์ขึ้นมาเพื่อช่วยทำความเข้าใจความสัมพันธ์ระหว่างฟีเจอร์ใหม่ของ Gantry ที่มีต่อกัน ต่อไปนี้คือรายละเอียดโดยย่อของคำศัพท์ที่ใช้กันทั่วไปที่เกี่ยวข้องกับ Gantry 5
| ภาคเรียน | คำนิยาม |
|---|---|
| โครงร่าง | สไตล์ที่กำหนดค่าได้ซึ่งใช้ในพื้นที่หนึ่งหรือหลายพื้นที่ของไซต์ของคุณ โดยทำหน้าที่เป็นคอนเทนเนอร์สำหรับกำหนดสไตล์ การตั้งค่า และเค้าโครงของเพจ |
| อนุภาค | โดยทั่วไปบล็อกข้อมูลขนาดเล็กที่ใช้ในส่วนหน้า มันทำหน้าที่เหมือนกับวิดเจ็ต/โมดูลมาก แต่สามารถกำหนดค่าได้อย่างง่ายดายใน Gantry 5 Administrator |
| อะตอม | ประเภทของอนุภาคที่มีข้อมูลที่ไม่แสดงผล เช่น สคริปต์ที่กำหนดเอง (JS, CSS ฯลฯ) หรือสคริปต์การวิเคราะห์สำหรับการติดตามการรับส่งข้อมูล |
เรียนรู้เพิ่มเติม
ห้องสนทนาได้รับการตั้งค่าโดยใช้ Gitter ซึ่งคุณสามารถไปพูดคุยเกี่ยวกับโปรเจ็กต์กับนักพัฒนา ผู้ร่วมให้ข้อมูล และสมาชิกคนอื่นๆ ในชุมชนได้ นี่คือสถานที่ที่ดีที่สุดในการรับเคล็ดลับด่วนและหารือเกี่ยวกับคุณลักษณะต่างๆ กับผู้อื่น
นอกจากนี้ยังมีเอกสารประกอบและมีการเพิ่มอย่างต่อเนื่องเมื่อการพัฒนาดำเนินไป มีอะไรหายไปหรือเปล่า? คุณสามารถมีส่วนร่วมในเอกสารผ่าน GitHub
การมีส่วนร่วมกับเฟรมเวิร์ก Gantry 5 หรือเอกสารประกอบที่เกี่ยวข้องเป็นเรื่องง่าย การพัฒนาสำหรับทั้งสองโปรเจ็กต์นี้กำลังดำเนินการผ่าน Github ซึ่งคุณสามารถส่ง ปัญหา เพื่อรายงานจุดบกพร่องหรือเสนอแนะการปรับปรุง รวมถึงส่ง คำขอดึง ของคุณเองเพื่อส่งการแก้ไขและเพิ่มเติมของคุณเอง
เราขอแนะนำให้พูดคุยกับทีมผ่าน Gitter ก่อนที่จะส่งคำขอดึงเพื่อหลีกเลี่ยงการเพิ่มขึ้นเป็นสองเท่าในการแก้ไขที่ค้างอยู่อยู่แล้วหรือมีแนวโน้มที่จะถูกเขียนทับโดยการเปลี่ยนแปลงที่กำลังจะเกิดขึ้น
หากต้องการใช้ Gantry เวอร์ชัน git คุณต้องติดตั้งการพึ่งพาผู้แต่งก่อน เมื่อต้องการทำเช่นนี้ ให้รัน:
bin/composer-install
หลังจากนั้น คุณจะต้องเชื่อมโยง Gantry เข้ากับการติดตั้ง CMS ของคุณอย่างเหมาะสม
ในสภาพแวดล้อมการพัฒนาของเรา เราใช้ Gulp เพื่อรวม JavaScript และคอมไพล์ SCSS ด้วยความสามารถใน watch เพื่อให้การเปลี่ยนแปลงใดๆ ในไฟล์เป้าหมายจะทริกเกอร์การคอมไพล์ใหม่โดยอัตโนมัติ
หากคุณต้องการตั้งค่านี้ในสภาพแวดล้อมการพัฒนาของคุณเอง คุณสามารถทำได้โดยทำตามคำแนะนำง่ายๆ เหล่านี้
โปรดทราบว่าเพื่อให้ใช้งานได้ คุณต้องมีแหล่งที่มา ของ Gantry 5 ไม่ใช่แพ็คเกจ คุณสามารถ โคลน หรือ ดาวน์โหลด ซอร์สจาก GitHub
สิ่งแรกที่คุณต้องการคือ Node / NPM หากคุณยังไม่มี คุณสามารถคว้าตัวติดตั้งสำหรับระบบปฏิบัติการของคุณได้จากhttps://nodejs.org/download/
ขั้นตอนต่อไปคือการติดตั้งการขึ้นต่อกันของโมดูล JS ทั้งหมด ในการทำเช่นนั้น ตรวจสอบให้แน่ใจว่าคุณอยู่ที่รูทของโปรเจ็กต์ Gantry 5 และรันคำสั่ง npm install
เมื่อเสร็จแล้วคุณสามารถติดตั้ง Gulp ได้ เราขอแนะนำให้ติดตั้ง Gulp ทั่วโลก เพื่อให้คุณสามารถใช้คำสั่งจากโฟลเดอร์ใดก็ได้ นี่คือคำสั่งที่ต้องทำ: sudo npm install gulp --global
Gantry มีชุดไฟล์ JS และ CSS ที่แตกต่างกันซึ่งสามารถคอมไพล์ใหม่ได้จากรูท ครั้งแรกที่คุณเริ่มต้นใช้งาน Gantry หรือหากคุณต้องการรีเซ็ตและติดตั้งโมดูลทั้งหมดใหม่ คุณสามารถรันคำสั่ง npm run build-assets ได้ การดำเนินการนี้จะลบโฟลเดอร์ node_modules ทั้งหมด และรัน npm install อีกครั้งในโฟลเดอร์โปรเจ็กต์ทั้งหมด จะใช้เวลาสักครู่
วิธีอื่นที่จะไม่ลบโฟลเดอร์ node_modules ทั้งหมดคือผ่าน gulp -up
นอกจากคำสั่ง
-upแล้ว คุณยังสามารถใช้-update,--update,-up,--up,-install,--install,-inst,--inst,-go,--go,-deps,--depsอันไหนง่ายกว่าสำหรับคุณที่จะจำ โค้ดจะเข้าใจได้เองว่าจำเป็นต้องติดตั้งเป็นครั้งแรกหรือเพียงแค่อัปเดตโมดูลโหนดโปรดทราบว่าการดำเนินการนี้อาจใช้เวลาสักครู่
ณ จุดนี้ คุณมีทุกสิ่งที่จำเป็นในการรัน Gulp เพียงพิมพ์คำสั่ง gulp แล้วคุณจะเห็น CSS และ JS ได้รับการคอมไพล์
เราจัดเตรียมงานที่มีประโยชน์บางอย่างไว้ด้วย:
$ gulp / $ gulp all : รวบรวม CSS และ JS ทั้งหมดในโครงการ$ gulp watch : เริ่มคอมไพเลอร์ในโหมด watch การเปลี่ยนแปลงใดๆ ที่ใช้กับไฟล์ JS หรือ SCSS เป้าหมายจะทริกเกอร์การคอมไพล์ใหม่โดยอัตโนมัติ$ gulp watch --css / $ gulp watch --js : เริ่มคอมไพเลอร์ในโหมด watch และฟังเฉพาะการเปลี่ยนแปลง SCSS หรือ JS มีประโยชน์หากคุณกำลังมุ่งความสนใจไปที่สิ่งเดียวเท่านั้น ไม่ใช่อีกสิ่งหนึ่ง$ gulp css / $ gulp js : รวบรวมไฟล์ CSS หรือ JS ทั้งหมด ในกรณีที่คุณใช้งานเพียงไฟล์เดียวเท่านั้น ไม่ใช่ไฟล์อื่น$ gulp —prod : รวบรวมทุก CSS และ JS ในโหมดการผลิต ไฟล์ที่คอมไพล์จะไม่มีแผนที่ต้นฉบับและจะถูกบีบอัด (โดยปกติจะใช้เวลานานกว่าโหมดปกติเล็กน้อย) คุณสามารถสร้างไฟล์ Google Fonts JSON ได้โดยทำตามคำแนะนำที่ https://developers.google.com/fonts/docs/developer_api หรือเพียงใช้ https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY URL คุณต้องเปิดใช้งานการใช้งาน Google Fonts API และระบุคีย์ API ของคุณแทนที่ YOUR-API-KEY
Gantry Framework v5 หรือใหม่กว่าได้รับใบอนุญาตภายใต้ระบบลิขสิทธิ์แบบคู่ (MIT หรือ GPL เวอร์ชัน 2 หรือใหม่กว่า ซึ่งหมายความว่าคุณสามารถเลือกได้ว่าใบอนุญาตใด (MIT หรือ GPL เวอร์ชัน 2 หรือใหม่กว่า) ที่เหมาะกับความต้องการของคุณ
| รายละเอียดเพิ่มเติม |
|---|
