minimal
v0.2.0
Minimal เป็นธีม Jekyll สำหรับเพจ GitHub คุณสามารถดูตัวอย่างธีมเพื่อดูว่ามีลักษณะอย่างไร หรือแม้แต่ใช้งานในปัจจุบันก็ได้
วิธีใช้ธีมขั้นต่ำ:
เพิ่มสิ่งต่อไปนี้ใน _config.yml ของไซต์ของคุณ :
remote_theme : pages-themes/[email protected]
plugins :
- jekyll-remote-theme # add this line to the plugins list if you already have one ทางเลือก หากคุณต้องการดูตัวอย่างไซต์ของคุณบนคอมพิวเตอร์ ให้เพิ่มสิ่งต่อไปนี้ใน Gemfile ของไซต์ของคุณ :
gem "github-pages" , group : :jekyll_plugins ขั้นต่ำจะคำนึงถึงตัวแปรต่อไปนี้ หากตั้งค่าไว้ใน _config.yml ของไซต์ของคุณ :
title : [The title of your site]
description : [A short description of your site's purpose]นอกจากนี้ คุณอาจเลือกที่จะตั้งค่าตัวแปรเสริมต่อไปนี้:
show_downloads : ["true" or "false" (unquoted) to indicate whether to provide a download URL]
google_analytics : [Your Google Analytics tracking ID]หากคุณต้องการเพิ่มสไตล์ที่คุณกำหนดเอง:
/assets/css/style.scss ในไซต์ของคุณ---
---
@import " {{ site.theme }} " ;@import หมายเหตุ: หากคุณต้องการเปลี่ยนตัวแปร Sass ของธีม คุณต้องตั้งค่าใหม่ก่อนบรรทัด @import ในสไตล์ชีตของคุณ
หากคุณต้องการเปลี่ยนเค้าโครง HTML ของธีม:
favicon ที่กำหนดเอง คุณสามารถเพิ่มไฟล์ที่กำหนดเองลงในโฟลเดอร์ _includes ในเครื่องของคุณได้ ไฟล์ที่มาพร้อมกับธีมจะเป็นจุดเริ่มต้นและรวมอยู่ในเทมเพลตโครงร่างดั้งเดิม/_layouts/default.html ในเว็บไซต์ของคุณ Google ได้เปิดตัวการทำซ้ำหลายครั้งในโค้ด Google Analytics ในช่วงหลายปีที่ผ่านมานับตั้งแต่สร้างธีมนี้ครั้งแรก หากคุณต้องการใช้ประโยชน์จากโค้ดล่าสุด ให้วางลงใน _includes/head-custom-google-analytics.html ในไซต์ Jekyll ของคุณ
เทมเพลตมักจะอาศัย URL ที่ได้รับจาก GitHub เช่น ลิงก์ไปยังพื้นที่เก็บข้อมูลของคุณหรือลิงก์เพื่อดาวน์โหลดโปรเจ็กต์ของคุณ หากคุณต้องการแทนที่ URL เริ่มต้นตั้งแต่หนึ่งรายการขึ้นไป:
{{ site.github.zip_url }}_config.yml ของไซต์ของคุณ ตัวอย่างเช่น หากตัวแปรคือ site.github.url คุณจะต้องเพิ่มค่าต่อไปนี้: github :
zip_url : http://example.com/download.zip
another_url : another value หมายเหตุ: คุณต้องลบ site. ออก คำนำหน้าและชื่อตัวแปรแต่ละตัว (หลัง github. ) ควรเยื้องด้วยช่องว่างสองช่องด้านล่าง github:
สำหรับข้อมูลเพิ่มเติม โปรดดูเอกสารประกอบตัวแปร Jekyll
ดูปัญหาที่เปิดอยู่สำหรับรายการคุณลักษณะที่นำเสนอ (และปัญหาที่ทราบ)
ธีม Minimal มีจุดมุ่งหมายเพื่อให้ผู้ใช้ GitHub Pages สร้างเว็บไซต์แรก (หรือที่ 100) ได้อย่างรวดเร็วและง่ายดาย ธีมควรตอบสนองความต้องการของผู้ใช้ส่วนใหญ่นอกกรอบ โดยผิดพลาดจากความเรียบง่ายมากกว่าความยืดหยุ่น และให้โอกาสผู้ใช้ในการเลือกความซับซ้อนเพิ่มเติมหากพวกเขามีความต้องการเฉพาะหรือต้องการปรับแต่งประสบการณ์เพิ่มเติม (เช่นการเพิ่ม CSS ที่กำหนดเองหรือการแก้ไขเค้าโครงเริ่มต้น) มันควรจะดูดีเช่นกัน แต่ก็ไปโดยไม่บอกกล่าว
สนใจที่จะมีส่วนร่วมใน Minimal หรือไม่? เราชอบความช่วยเหลือของคุณ Minimal เป็นโปรเจ็กต์โอเพ่นซอร์สที่สร้างขึ้นทีละรายการโดยผู้ใช้เช่นคุณ ดูไฟล์การมีส่วนร่วมสำหรับคำแนะนำเกี่ยวกับวิธีการมีส่วนร่วม
หากคุณต้องการดูตัวอย่างธีมในเครื่อง (เช่น ในกระบวนการเสนอการเปลี่ยนแปลง):
git clone https://github.com/pages-themes/minimal )cd ลงในไดเร็กทอรีของธีมscript/bootstrap เพื่อติดตั้งการขึ้นต่อกันที่จำเป็นbundle exec jekyll serve เพื่อเริ่มเซิร์ฟเวอร์แสดงตัวอย่างlocalhost:4000 ในเบราว์เซอร์ของคุณเพื่อดูตัวอย่างธีม ธีมนี้มีชุดทดสอบขั้นต่ำ เพื่อให้แน่ใจว่าไซต์ที่มีธีมจะสร้างได้สำเร็จ หากต้องการรันการทดสอบ เพียงเรียกใช้ script/cibuild คุณจะต้องเรียกใช้ script/bootstrap หนึ่งครั้งก่อนที่สคริปต์ทดสอบจะทำงาน
