Chronicle - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

Chronicle - คอมไพเลอร์บล็อกอย่างง่าย

เรื่องย่อ

พงศาวดาร [ตัวเลือก]

ตัวเลือกเส้นทาง:

--comments ระบุพาธไปยังไดเร็กทอรีความคิดเห็นเสริม
--config ระบุไฟล์การกำหนดค่าที่จะอ่าน
--input ระบุไดเร็กทอรีอินพุตที่จะใช้
--output ระบุไดเร็กทอรีที่จะเขียนเอาต์พุตไปยัง
--theme-dir ระบุพาธไปยังเทมเพลตของธีม
--theme ระบุธีมที่จะใช้
--pattern ระบุรูปแบบของไฟล์ที่จะใช้งาน
--url-prefix ระบุคำนำหน้าไปยังบล็อกสด
--sitemap-prefix ระบุคำนำหน้าสำหรับแผนผังเว็บไซต์

ตัวเลือกรายการบล็อก:

--format ระบุรูปแบบของรายการของคุณ HTML/textile/markdown

คำสั่งก่อนและหลังสร้าง:

--pre-build ระบุคำสั่งที่จะดำเนินการก่อนที่จะสร้างบล็อก
--post-build ระบุคำสั่งที่จะดำเนินการเมื่อสร้างบล็อกแล้ว
--pre-filter คำสั่งสำหรับกรองรายการบล็อกแต่ละรายการก่อนการแปลง HTML
--post-filter คำสั่งสำหรับกรองรายการบล็อกแต่ละรายการหลังการแปลง HTML

ตัวเลือกการเรียงลำดับ:

--recent-dates-first แสดงรายการล่าสุดก่อนในมุมมองเก็บถาวร
--recent-tags-first แสดงรายการล่าสุดก่อนในมุมมองแท็ก

ตัวเลือกการนับ:

--entry-count=N จำนวนโพสต์ที่จะแสดงบนดัชนี
--rss-count=N จำนวนโพสต์ที่จะรวมในฟีดดัชนี RSS

คุณสมบัติเสริม:

--ผู้เขียน ระบุที่อยู่อีเมลของผู้เขียน
--comment-days ระบุอายุสูงสุดของโพสต์ที่จะรับความคิดเห็น
--date-archive-path รวมวันที่ในไฟล์เก็บถาวร
--force บังคับให้คัดลอกไฟล์สแตติกจากธีมบล็อก
--lang ระบุภาษาที่จะใช้สำหรับการจัดรูปแบบวันที่
--lower-case ตัวพิมพ์เล็กชื่อไฟล์ทั้งหมดที่เป็นเอาต์พุต
--no-archive อย่าสร้างหน้าเก็บถาวร
--no-cache อย่าใช้คุณสมบัติ memcached ที่เป็นตัวเลือก แม้ว่าจะมีให้ก็ตาม
--no-calendar อย่าใช้ปฏิทินทางเลือกกับดัชนี
--no-comments ไม่อนุญาตให้แสดงความคิดเห็น
--no-sitemap อย่าสร้างแผนผังเว็บไซต์
--no-tags ไม่สร้างหน้าแท็กใด ๆ
--no-xrefs ไม่สร้างการอ้างอิงโยงใด ๆ

ตัวเลือกความช่วยเหลือ:

--help แสดงข้อมูลความช่วยเหลือสำหรับสคริปต์นี้
--manual อ่านคู่มือสำหรับสคริปต์นี้
--verbose แสดงข้อมูลการดีบักที่เป็นประโยชน์
--version แสดงหมายเลขเวอร์ชันและออก

เกี่ยวกับเรา

Chronicle เป็นเครื่องมือง่ายๆ ในการแปลงชุดของไฟล์ข้อความ
อยู่ในไดเร็กทอรีเดียว ในบล็อกที่ประกอบด้วย static
ไฟล์ HTML

รองรับเฉพาะคุณสมบัติขั้นต่ำที่จำเป็นเท่านั้น
จะเป็นประโยชน์:

* รองรับการติดแท็ก

* การสนับสนุน RSS

* การสนับสนุนเอกสารเก่า

ข้อบกพร่องที่เห็นได้ชัดคือ:

* ขาดการสนับสนุนสำหรับการแสดงความคิดเห็นทันที

* ขาดการสนับสนุน pingback / trackback

ต้องบอกว่าเป็นระบบที่แข็งแกร่ง เสถียร และมีประโยชน์

บล็อก FORMAT

รูปแบบของไฟล์ข้อความที่เราประมวลผลมีความสำคัญต่อผลลัพธ์
หน้า. แต่ละรายการควรมีลักษณะดังนี้:

ชื่อเรื่อง: นี่คือชื่อของโพสต์บล็อก
วันที่: 2 มีนาคม 2007
Tags: หนึ่ง สอง สาม แท็กยาว

ข้อความของรายการของคุณอยู่ที่นี่

หมายเหตุ: ส่วนหัวต้องแยกออกจากเนื้อหาของรายการอย่างน้อย a
บรรทัดว่างเดียว

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

การจัดรูปแบบของวันที่ส่งออกอาจเปลี่ยนแปลงได้โดยใช้ปุ่ม
B<--lang> ตัวเลือกบรรทัดคำสั่ง (หรือตัวเลือก "lang=french" ที่ตรงกันใน
ไฟล์การกำหนดค่า) แต่ควรระบุวันที่ของรายการใน
อังกฤษ

Title: ระบุชื่อกระทู้ หากไม่ปรากฏชื่อไฟล์ของรายการจะถูกใช้
แทนที่. "เรื่อง:" อาจใช้ได้เช่นกัน
เรื่อง: นี่คือคำพ้องความหมายสำหรับ 'ชื่อ:'
วันที่: วันที่เขียนโพสต์ หากไม่ปรากฏ เวลาสร้างไฟล์จะถูกใช้
แทน.
เผยแพร่: ส่วนหัวนี้จะถูกลบออกจากรายการทั้งหมด และใช้โดย Chronicle-spooler
ต้นฉบับ
แท็ก: แท็กใดๆ ที่ควรเชื่อมโยงกับรายการ คั่นด้วยเครื่องหมายจุลภาค

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

รูปแบบของรายการถูกระบุผ่านอาร์กิวเมนต์ B<--format> หรือ
ผ่านการตั้งค่า "format: foo" ในไฟล์ Chroniclerc ของคุณ

รูปแบบของรายการจะถือว่าเป็นสากล นั่นคือรายการทั้งหมดของคุณ
จะถือว่าอยู่ในรูปแบบเดียวกัน อย่างไรก็ตามคุณสามารถเพิ่ม a
"รูปแบบ: foo" ส่วนหัวหลอกไปยังรายการเฉพาะหากคุณต้องการเขียน
รายการเฉพาะในรูปแบบอื่น

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

การกำหนดค่า

การกำหนดค่าซอฟต์แวร์มีน้อย และดำเนินการโดยทั่วไป
ผ่านอาร์กิวเมนต์บรรทัดคำสั่ง อย่างไรก็ตาม สามารถบันทึกการตั้งค่าได้
ในไฟล์ global /etc/chroniclerc หรือต่อผู้ใช้ ~/.chroniclerc
ไฟล์

หากคุณต้องการ คุณสามารถส่งชื่อไฟล์การกำหนดค่าอื่นไปที่
สคริปต์ที่มีแฟล็ก B<--config> นี้จะถูกอ่านหลังจาก
สองไฟล์ก่อนหน้า และอาจแทนที่การตั้งค่าใดๆ ที่มีอยู่

ไฟล์การกำหนดค่ามีบรรทัดดังนี้:

อินพุต = /home/me/blog

เอาต์พุต = /var/www/blog

รูปแบบ = มาร์กดาวน์

คีย์ที่ไม่รู้จักจะถูกละเว้น

ตัวเลือก เก็บเอาไว้

เพื่อเพิ่มความเร็วในการสร้างบล็อกขนาดใหญ่ขึ้นใหม่ คอมไพเลอร์อาจใช้ local
Memcached daemon หากติดตั้งและพร้อมใช้งาน

หากต้องการติดตั้งสิ่งนี้ ภายใต้ระบบ Debian GNU/Linux โปรดเรียกใช้:

ปรับปรุง apt-get
apt-get ติดตั้ง memcached libcache-memcached-perl

คุณสามารถปิดใช้งานพฤติกรรมแคชนี้ด้วย --no-cache และดู
เอฟเฟกต์ด้วย --verbose

ตัวเลือก ปฏิทิน

หากโมดูล 'HTML::CalendarMonthSimple' พร้อมใช้งานแต่ละบล็อกจะ
มีมุมมองเดือนแบบง่ายของเดือนปัจจุบันบนดัชนี

หากต้องการปิดใช้งานให้เรียกใช้โปรแกรมด้วย '--no-calendar'

ตัวเลือก แสดงความคิดเห็น

รวมกับรหัสพงศาวดารคุณควรหาไฟล์
cgi-bin/comments.cgi

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

ในระยะสั้นมีสามสิ่งที่คุณต้องทำ:

ติดตั้งสคริปต์ CGI และแก้ไขเส้นทางเมื่อเริ่มต้น
คัดลอกความคิดเห็นที่ส่งออกไปยังแหล่งบล็อกในพื้นที่ของคุณ
เรียกใช้สคริปต์นี้อีกครั้งด้วย --comments=./path/to/comments

ซึ่งควรรวมความคิดเห็นไว้ในเอาต์พุตแบบคงที่ มากกว่า
คำแนะนำที่ชัดเจนมีอยู่ในไฟล์ 'ความคิดเห็น'
รวมอยู่ในการแจกจ่าย

ใช้พงศาวดารออนไลน์โดยใช้บริการ onworks.net