ไม่ได้สร้างโพสต์ Jekyll

ฉันพยายามที่จะเพิ่มการโพสต์ใหม่ในเว็บไซต์ Jekyll ของฉัน jekyll serveแต่ฉันไม่สามารถดูได้บนหน้าเว็บที่สร้างเมื่อผมทำงาน

อะไรคือสาเหตุทั่วไปที่ทำให้โพสต์ Jekyll ไม่ถูกสร้างขึ้น

• โพสต์ไม่ได้อยู่ใน _posts ไดเร็กทอรี
• โพสต์มีชื่อไม่ถูกต้อง ควรตั้งชื่อโพสต์YEAR-MONTH-DAY-title.MARKUP(โปรดสังเกตMARKUPส่วนขยายซึ่งโดยปกติคือ.mdหรือ.markdown)
• วันที่ของโพสต์อยู่ในอนาคต คุณสามารถทำให้โพสต์มองเห็นได้โดยการตั้งค่าfuture: trueใน_config.yml (เอกสารประกอบ)
• โพสต์มี published: false ความสำคัญอยู่ด้านหน้า trueตั้งค่าให้
• ชื่อเรื่องมี : อักขระ แทนที่ด้วย&#58. ใช้งานได้ใน jekyll3.8.3(และอาจอยู่ในรุ่น 'ล่าสุด' อื่น ๆ )

คุณสามารถใช้jekyll build --verboseเพื่อดูขั้นตอนการสร้างโดยละเอียด

เอาต์พุต Exmaple:

  Logging at level: debug
Configuration file: /home/fangxing/fffx.github.io/_config.yml
  Logging at level: debug
         Requiring: jekyll-archives
         Requiring: jekyll-livereload
         Requiring: kramdown
            Source: /home/fangxing/fffx.github.io
       Destination: /home/fangxing/fffx.github.io/_site
 Incremental build: enabled
      Generating... 
       EntryFilter: excluded /Gemfile
       EntryFilter: excluded /Gemfile.lock
           Reading: _posts/2018-01-14-new-post.md
           Reading: _posts/2014-01-01-example-content.md
           Reading: _posts/2014-01-02-introducing-lanyon.md
           Reading: _posts/2017-11-21-welcome-to-jekyll.markdown
           Reading: _posts/2018-01-14-boot-android-on-charge.md
           Reading: _posts/2013-12-31-whats-jekyll.md
          Skipping: _posts/2018-01-14-boot-android-on-charge.md has a future date
        Generating: Jekyll::Archives::Archives finished in 0.000122873 seconds.
        Generating: JekyllFeed::Generator finished in 0.000468846 seconds.
        ...

จากบันทึกฉันพบว่าข้าม jeklly 2018-01-14-boot-android-on-charge.mdเพราะมีวันที่ในอนาคต

สาเหตุหนึ่งที่เป็นไปได้คือการdateระบุในกรณีส่วนหน้าไม่มีการชดเชยโซนเวลาซึ่งในกรณีนี้จะมีค่าเริ่มต้นเป็น UTC ไม่ใช่เขตเวลาของเครื่องในระบบอย่างที่คุณคาดไว้ ฉันเสียเวลาหนึ่งชั่วโมงกับเรื่องนี้จนกระทั่ง UTC "ตาม" เขตเวลาท้องถิ่นปัจจุบันของฉัน BST

ฉันไม่พบคำตอบที่ชัดเจนสำหรับสิ่งนี้ แต่ฉันคิดว่าวันที่ในเรื่องด้านหน้าจะต้องระบุเป็น UTC โดยมีการชดเชยเขตเวลา (ซึ่งค่าเริ่มต้นจะเป็นศูนย์หากละเว้น)

ดังนั้น date: 2018-05-03 12:34:27 อยู่ใน UTCไม่ว่าคุณจะอยู่ที่ไหนในโลกและไม่ว่าคุณจะtimezoneอยู่ที่_config.ymlใดก็ตาม

ดังนั้นโปรดระมัดระวังในการระบุวันที่เช่นนี้:

date: 2018-05-03 12:34:27 +0100

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

ฉันได้เขียนการทดสอบ Rspec สำหรับบล็อกของฉันซึ่งแสดงกฎเหล่านี้:

require 'spec_helper'
require 'yaml'

# Documented at https://jekyllrb.com/news/2017/03/02/jekyll-3-4-1-released/
post_regex = %r!^(?:.+/)*(\d{2,4}-\d{1,2}-\d{1,2})-(.*)(\.[^.]+)$!

def date_in_front_matter(date)
  return date if date.is_a?(Date)
  return date.to_date if date.is_a?(Time)
  return Date.parse(date) if date.is_a?(String)
end

describe 'posts' do
  Dir.glob("_posts/*md").each do |file|
    basename = File.basename(file)

    context basename do
      front_matter = YAML.load(File.read(file).split(/---/)[1])

      it 'filename must match documented post regex' do
        expect(basename).to match post_regex
      end

      it 'date in file name same day as date in front matter' do
        date_in_file_name = Date.parse(post_regex.match(basename).captures[0])
        expect(date_in_front_matter(front_matter['date'])).to eq date_in_file_name
      end

      it 'title in front matter should not contain a colon' do
        expect(front_matter['title']).to_not match /:/
      end

      it 'front matter should not have published: false' do
        expect(front_matter['published']).to_not be false
      end
    end
  end
end

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

การทดสอบเหล่านี้พร้อมกับส่วนที่เหลือของการตั้งค่า rspec สามารถมองเห็นได้ในบริบทที่นี่

เพียงเพื่อเพิ่มเหตุผลอีกประการหนึ่งเมื่อคุณย้ายบทความจาก_draftsไปยัง_postบางครั้งคุณต้องลบไฟล์_siteสำหรับบทความเพื่อสร้างใหม่

ในกรณีของฉันมันมักจะเกิดขึ้นอย่างนั้น _siteจะไม่ถูกลบทั้งหมดก่อนที่จะสร้างใหม่ดังนั้นบทความใหม่จะไม่ปรากฏ

อย่างไรก็ตามrm -rf _siteและใช้bundle exec jekyll serveงานได้ :)

หากคุณไม่สามารถติดตามไฟล์ใน--verboseและหากไฟล์ถูกละเว้นโดยไม่โต้ตอบให้ลองลบออกcollections_dirในconfig.ymlไฟล์ นั่นช่วยแก้ปัญหาให้ฉันได้

2017-10-18-test.2.mdโพสต์ของฉันยังไม่ปรากฏว่ามีข้อผิดพลาดก็คือว่าในนามของผมใช้จุดเช่น นี้ไม่ได้รับการยอมรับที่คุณต้องใช้
2017-10-18-test2.md

หากคุณได้ตรวจสอบเนื้อหาส่วนหน้าของคุณแล้วและดูเหมือนว่าทุกอย่างเรียบร้อยดีและยังjekyll build --verboseไม่เปิดเผยอะไรเลย (ในกรณีของฉันมันก็ทำราวกับว่าไม่มีไฟล์อยู่เลยแม้แต่ในรายการที่ยกเว้น) ให้ตรวจสอบการเข้ารหัส ของไฟล์ของคุณ เห็นได้ชัดว่าต้องUTF-8ไม่มีลายเซ็น มันเป็นUTF-8 BOM(หรือUTF-8 with Signatureตามที่ผู้แก้ไขข้อความบางคนเรียกมัน) จากนั้นมันจะถูกเพิกเฉย ในการทำให้เรื่องแย่ลงผู้แก้ไขบางคนจะแสดงทั้งสองประเภทเป็นเพียงUTF-8การทำให้ความแตกต่างยากขึ้น