כרוניקה - אונליין בענן

תָכְנִית:

שֵׁם

כרוניקה - מהדר בלוג פשוט.

תַקצִיר

כרוניקה [אפשרויות]

אפשרויות נתיב:

--comments ציין את הנתיב לספריית ההערות האופציונלית.
--config ציין קובץ תצורה לקריאה.
--input ציין את ספריית הקלט לשימוש.
--output ציין את הספרייה שאליה יש לכתוב פלט.
--theme-dir ציין את הנתיב לתבניות ערכת הנושא.
--theme ציין את ערכת הנושא לשימוש.
--pattern ציין את תבנית הקבצים לעבודה.
--url-prefix ציין את הקידומת לבלוג החי.
--sitemap-prefix ציין את הקידומת עבור מפת האתר.

אפשרויות כניסה לבלוג:

--format ציין את הפורמט של הערכים שלך, HTML/טקסטיל/סימון.

פקודות לפני ואחרי בנייה:

--pre-build ציין פקודה לביצוע לפני בניית הבלוג.
--post-build ציין פקודה לביצוע לאחר בניית הבלוג.
--pre-filter פקודה לסינון כל ערך בבלוג לפני המרת HTML.
--post-filter פקודה לסינון כל ערך בבלוג לאחר המרת HTML.

אפשרויות מיון:

--recent-dates-first הצג תחילה את הערכים האחרונים בתצוגת הארכיון.
--recent-tags-first הצג תחילה את הערכים האחרונים בתצוגת התגים.

אפשרויות ספירה:

--entry-count=N מספר הפוסטים להצגה באינדקס.
--rss-count=N מספר הפוסטים שיש לכלול בהזנת אינדקס ה-RSS.

תכונות אופציונליות:

--author ציין את כתובת הדוא"ל של המחבר
--comment-days ציין את מספר הגיל המרבי של פוסטים כדי לקבל תגובות.
--date-archive-path כלול את התאריך בארכיון.
--force כפה את ההעתקה של קבצים סטטיים מנושא הבלוג.
--lang ציין את השפה לשימוש עבור עיצוב תאריכים.
--lower-case באותיות קטנות של כל שמות הקבצים המופקים.
--no-archive אל תיצור דף ארכיון.
--no-cache אל תשתמש בתכונות האופציונליות של memcached, גם אם זמינות.
--no-calendar אל תשתמש בלוח השנה האופציונלי באינדקס.
--אין-תגובות אל תאפשר פרסום הערות.
--no-sitemap אל תיצור מפת אתר.
--no-tags אל תיצור דפי תגים.
--no-xrefs אל תיצור הפניות צולבות.

אפשרויות עזרה:

--help הצג את מידע העזרה עבור סקריפט זה.
--manual קרא את המדריך לתסריט זה.
--verbose הצג מידע שימושי על ניפוי באגים.
--version הצג את מספר הגרסה וצא.

על אודות

Chronicle הוא כלי פשוט להמרת אוסף של קבצי טקסט,
ממוקם בתוך ספרייה אחת, לתוך בלוג המורכב סטטי
קבצי HTML.

זה תומך רק במינימום של תכונות הנדרשות
להיות שימושי:

* תמיכה בתיוג.

* תמיכה ב-RSS.

* תמיכה בארכיון.

החסרונות הברורים הם:

* חוסר תמיכה בהערה מיידית.

* היעדר תמיכה ב-pingback/trackback.

אחרי שאמרתי שזו מערכת חזקה, יציבה ושימושית.

בלוג פורמט

הפורמט של קבצי הטקסט שאנו מעבדים הוא קריטי לפלט
דפים. כל ערך צריך להיראות בערך כך:

כותרת: זו הכותרת של הפוסט בבלוג
תאריך: 2 במרץ 2007
תגיות: אחת, שתיים, שלוש, תג ארוך

הטקסט של הערך שלך נכנס לכאן.

הערה: הכותרת חייבת להיות מופרדת מגוף הערך על ידי לפחות א
שורה ריקה אחת.

בדוגמה זו אנו יכולים לראות שהערך עצמו הוקדמה
עם כותרת קטנה. כותרת ערך מכילה שלוש שורות אופציונליות,
אם אלה אינם קיימים אז יש ברירות מחדל הגיוניות כמתואר
לְהַלָן.

העיצוב של תאריכי הפלט עשוי להשתנות באמצעות השימוש ב-
אפשרות שורת הפקודה B<--lang> (או האפשרות התואמת "lang=french" ב-
קובץ התצורה), אך יש לציין את תאריך הערך עצמו ב
אנגלית.

כותרת: מתארת ​​את כותרת הפוסט. אם לא קיים, נעשה שימוש בשם הקובץ של הערך
במקום זאת. ניתן להשתמש גם ב"נושא:".
נושא: זוהי מילה נרדפת ל'כותרת:'.
תאריך: תאריך כתיבת הפוסט. אם לא קיים, נעשה שימוש בזמן היצירה של הקובץ
במקום.
פרסם: כותרת זו מוסרת מכל הערכים, ומשמשת את ה-chronicle-spooler
תַסרִיט.
תגים: כל תגיות שיש לשייך לערך, מופרדים בפסיקים.

ההנחה היא שהפורמט של הערך הוא HTML, אולם יש תמיכה
לכתיבת הערכים שלך הן בפורמט טקסטיל והן בפורמט סימון.

פורמט הערכים מצוין באמצעות הארגומנט B<--format>, או
באמצעות הגדרת "פורמט: foo" בקובץ הכרוניקה שלך.

ההנחה היא שהפורמט של הערכים הוא גלובלי; זה כל הערכים שלך
ההנחה תהיה באותו פורמט. עם זאת אתה יכול להוסיף א
"פורמט: foo" פסאודו כותרת לערכים ספציפיים אם ברצונך לכתוב
ערכים ספציפיים בפורמט אחר.

כדי לאפשר גמישות בטיפול בערכים כל ערך בבלוג יהיה
לעבור דרך סקריפט הסינון B
מה שמאפשר לך לשנות את הטיפול הזה במיקום אחד. זֶה
סקריפט מאפשר לעדכן ערכים באמצעות מסננים לפני ואחרי
ההמרה ל-HTML. לפרטים נוספים, עיין בדף ה-manage עבור
התסריט הזה.

תְצוּרָה

התצורה של התוכנה היא מינימלית, ובדרך כלל מבוצעת
באמצעות הארגומנטים של שורת הפקודה. עם זאת אפשר לשמור הגדרות
או בקובץ הגלובלי /etc/chroniclerc או בקובץ לכל משתמש ~/.chroniclerc
קובץ.

אם תרצה תוכל להעביר את השם של קובץ תצורה אחר אל
הסקריפט עם הדגל B<--config>. זה ייקרא לאחר ה
שני הקבצים הקודמים, ועשויים לעקוף את כל ההגדרות הקיימות.

קובץ התצורה מכיל שורות כמו אלה:

input = /home/me/blog

פלט = /var/www/blog

פורמט = סימון

מתעלמים ממפתחות שאינם ידועים.

אופציונאלי מטמון

כדי להאיץ את הבנייה מחדש של בלוג גדול, המהדר עשוי להשתמש ב-local
דמון משומר, אם מותקן וזמין.

כדי להתקין את זה, תחת מערכת 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