simplest jekyll

Jekyll ที่ง่ายที่สุด

ไซต์ที่ใช้ Jekyll น้อยที่สุดในหน้า GH ซึ่งลดลงเหลือหนึ่งหน้าของเนื้อหาด้วยธีม

ดูตัวอย่าง

เกี่ยวกับ

นี่คือเทมเพลตและโครงการสาธิตสด มันแสดงให้เห็นว่าคุณต้องตั้งค่าเพียงเล็กน้อยเพื่อรับไซต์ Jekyll บนหน้า GH

• index.md
  • สำหรับหน้าแรก - หน้าเดียวในกรณีนี้
  • หากคุณออกจากหน้านี้ README.md จะถูกใช้เป็นหน้าแรกของคุณ
• _config.yml
  • ตั้งค่าธีม - ที่จัดการเค้าโครงและสไตล์
  • เปิดใช้งานปลั๊กอิน Jekyll Sitemap - การเปิดใช้งานใน Gemfile ไม่เพียงพอ โปรดทราบว่าปลั๊กอินอื่น ๆ จะเปิดใช้งานสำหรับคุณเช่น frontmatter เสริม
  • ค่ามาตรฐานอื่น ๆ เช่น baseurl title และ description ถูกทิ้งไว้จากการกำหนดค่า เมื่อสร้างบนหน้า GH สิ่งเหล่านี้จะถูกอนุมานให้คุณโดย GH Pages Gem
• Gemfile
  • นี่ไม่ได้ใช้จริงโดยหน้า GH แต่ช่วยให้คุณสามารถติดตั้งธีม Jekyll ในเครื่องโดยใช้ Bundler
  • ใช้ github-pages เดียวหากคุณต้องการจับคู่อัญมณีทั้งหมดในหน้า GH (ซึ่งสามารถติดตั้งได้อย่างหนัก)
  • ลบไฟล์นี้หากคุณไม่จำเป็นต้องเรียกใช้เว็บไซต์ของคุณในเครื่อง

หากคุณต้องการตัวอย่างที่เต็มเปี่ยมของเว็บไซต์หลายหน้าพร้อมโพสต์อัญมณีเลย์เอาต์ ฯลฯ ให้ชำระเงิน repo jekyll-blog-demo ของฉัน ที่สามารถใช้เป็นเทมเพลตและเว็บไซต์สาธิตได้เช่นกัน

วิธีใช้โครงการนี้

การตั้งค่า

1. คลิก ใช้เทมเพลตนี้ เพื่อสร้าง repo ใหม่ในบัญชีของคุณเอง คุณสามารถทิ้งชื่อไว้ที่ simplest-jekyll
2. เปิดใช้งานหน้า GitHub ในการตั้งค่า repo ของคุณ เลือกที่จะให้บริการจาก master Branch และตัวเลือก / Path
3. ตรวจสอบแท็บ สภาพแวดล้อม ของ repo ของคุณเพื่อดูว่าการปรับใช้จะเสร็จสิ้นเมื่อใด
4. คลิก ดูการปรับใช้ เพื่อดูเว็บไซต์สด เช่น https://michaelcurrin.github.io/simplest-jekyll/

โปรดทราบว่า /simplest-jekyll/index.html พร้อมใช้งานทันที แต่ใช้เวลาไม่กี่นาทีจนกว่าหน้า gitHub จะทำ /simplest-jekyll/ พร้อมใช้งาน

ปรับแต่ง

• อัปเดต README.md ด้วยรายละเอียดของคุณเอง สิ่งนี้ไม่ได้ใช้จริงในไซต์ที่ปรับใช้ แต่สามารถมองเห็นได้ในท้องถิ่นและบน GitHub
• ธีม
  • แก้ไขชุดรูปแบบใน _config.yml หากคุณต้องการธีมอื่น
  • นอกจากนี้คุณยังสามารถใช้ส่วนหน้า GitHub ของการตั้งค่า repo เพื่อดูตัวอย่างด้วยสายตา
  • หมายเหตุเฉพาะชุดรูปแบบที่รองรับโดยหน้า GitHub จะครอบคลุม (ประมาณ 10) แต่ถ้าคุณใช้ฟิลด์ remote_theme ในการกำหนดค่าของคุณคุณสามารถอ้างอิงธีมเพิ่มเติมได้
  • สำหรับการติดตั้งและทำงานในเครื่องคุณจะต้องตรวจสอบให้แน่ใจว่า gemfile ของคุณครอบคลุมธีมที่ใช้ในการกำหนดค่า
• เช่นเดียวกับไซต์ jekyll ส่วนใหญ่ index.md ใช้เป็นหน้าแรก
  • มันมีเรื่องด้านหน้าที่ด้านบนเพื่อให้ของเหลวใด ๆ จะถูกนำไปใช้
  • แก้ไขไฟล์ index.md ของคุณด้วยเนื้อหาของคุณเองเป็น HTML หรือ Markdown
  • คุณสามารถเปลี่ยนชื่อเป็น index.html ได้หากคุณต้องการ HTML ธรรมดาเท่านั้น
  • คุณสามารถลบสสารด้านหน้าที่ด้านบนเพื่อลบการจัดรูปแบบของเหลวและการจัดเรียงใด ๆ
• หากคุณต้องการเพิ่มหน้าเพิ่มเติมที่รูทและแยก HTML ทั่วไปเช่นส่วนหัวหรือหัวหรือ navbar ลงในโฟลเดอร์ _includes หรือโฟลเดอร์ _layouts (ไม่ครอบคลุมในขอบเขตของโครงการนี้ แต่เป็นเรื่องธรรมดาสำหรับโครงการ Jekyll)
• ดูเอกสารและบทเรียนบนเว็บไซต์ Jekyll สำหรับข้อมูลเพิ่มเติม
• เลือกใช้ Jekyll ในพื้นที่:
  • ติดตั้งทับทิมและ Bundler
  • ติดตั้งอัญมณีโครงการ - Jekyll และ Theme Gem
  • เรียกใช้เซิร์ฟเวอร์ Jekyll Dev
  • สำหรับคำแนะนำที่สมบูรณ์ยิ่งขึ้นดูเอกสารของ Jekyll Blog Demo คุณจะต้องเพิ่ม Makefile ด้วยเพื่อให้ตรงกับคำสั่งเหล่านั้น

โครงการที่เกี่ยวข้อง

• - บล็อกเริ่มต้นที่สร้างขึ้นด้วย Jekyll CLI การใช้ธีมเนื้อหาการตั้งค่าสไตล์อัญมณีและ makefile
• - การใช้ Jekyll 4 ธีมการกระทำของ GitHub และหน้า GitHub
• - ไซต์ Jekyll ขั้นต่ำที่มีธีม แต่ไม่มี gemfile

ใบอนุญาต

เปิดตัวภายใต้ MIT โดย @Michaelcurrin