وقائع - على الانترنت في السحابة

برنامج:

اسم

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.

الميزات الاختيارية:

--author حدد عنوان البريد الإلكتروني للمؤلف
--comment-days حدد الحد الأقصى لعمر المشاركات لقبول التعليقات.
--date-archive-path قم بتضمين التاريخ في الأرشيف.
--force فرض نسخ الملفات الثابتة من سمة المدونة.
--lang حدد اللغة التي تريد استخدامها لتنسيق التواريخ.
- أحرف صغيرة - أحرف صغيرة لجميع أسماء الملفات التي يتم إخراجها.
--no-archive لا تقم بإنشاء صفحة أرشيف.
--no-cache لا تستخدم ميزات الذاكرة المؤقتة الاختيارية، حتى لو كانت متوفرة.
--no-calendar لا تستخدم التقويم الاختياري الموجود في الفهرس.
--no-comments لا تسمح بنشر التعليقات.
--no-sitemap لا تقم بإنشاء خريطة موقع.
--لا توجد علامات لا تنتج أي صفحات علامات.
--no-xrefs لا تنتج أي مراجع ترافقية.

خيارات المساعدة:

--مساعدة في إظهار معلومات المساعدة لهذا البرنامج النصي.
--manual اقرأ الدليل الخاص بهذا البرنامج النصي.
--verbose عرض معلومات التصحيح المفيدة.
--version إظهار رقم الإصدار والخروج.

معلومات عنا（ABOUT）

Chronicle هي أداة بسيطة لتحويل مجموعة من الملفات النصية،
تقع ضمن دليل واحد، في مدونة تتكون من ثابت
ملفات HTML.

وهو يدعم فقط الحد الأدنى من الميزات المطلوبة
ليكون مفيدا:

* دعم العلامات.

* دعم آر إس إس.

* دعم الأرشيف.

وأوجه القصور الواضحة هي:

* عدم وجود دعم للتعليق الفوري.

* عدم وجود دعم pingback/trackback.

بعد قولي هذا إنه نظام قوي ومستقر ومفيد.

المدوّنة FORMAT

يعد تنسيق الملفات النصية التي نعالجها أمرًا بالغ الأهمية بالنسبة للإخراج
الصفحات. يجب أن يبدو كل إدخال كما يلي:

العنوان: هذا هو عنوان مشاركة المدونة
التاريخ: 2 مارس 2007
العلامات: واحد، اثنان، ثلاثة، علامة طويلة

نص الإدخال الخاص بك يذهب هنا.

ملاحظة: يجب فصل الرأس عن نص الإدخال بما لا يقل عن أ
سطر واحد فارغ.

في هذا المثال يمكننا أن نرى أن الإدخال نفسه قد تم تقديمه مسبقًا
برأس صغير. يحتوي رأس الإدخال على ثلاثة أسطر اختيارية،
إذا لم تكن هذه موجودة ، فهناك افتراضات معقولة كما هو موصوف
أدناه.

يمكن تغيير تنسيق تواريخ الإخراج من خلال استخدام ملف
خيار سطر الأوامر B<--lang> (أو خيار "lang=french" المطابق في ملف
التكوين) ، ولكن يجب تحديد تاريخ الإدخال نفسه بتنسيق
الإنجليزية.

العنوان: يصف عنوان المنشور. إذا لم يكن موجودًا، فسيتم استخدام اسم ملف الإدخال
بدلاً من. يمكن أيضًا استخدام "الموضوع:".
الموضوع: هذا مرادف لـ "العنوان:".
التاريخ: تاريخ كتابة المشاركة. إذا لم يكن موجودًا، فسيتم استخدام وقت إنشاء الملف
بدلا من ذلك.
النشر: تتم إزالة هذا الرأس من كافة الإدخالات، ويتم استخدامه بواسطة التخزين المؤقت للسجلات
النصي.
العلامات: أي علامات يجب أن تقترن بالإدخال ، مفصولة بفواصل.

من المفترض أن يكون تنسيق الإدخال هو HTML، ولكن هناك دعمًا له
لكتابة إدخالاتك بتنسيقات النسيج وتخفيض السعر.

يتم تحديد تنسيق الإدخالات عبر الوسيطة B<--format>، أو
عبر إعداد "format: foo" في ملف Chroniclerc الخاص بك.

يُفترض أن يكون تنسيق الإدخالات عالميًا ؛ هذا هو كل ما تبذلونه من الإدخالات
من المفترض أن تكون بنفس التنسيق. ومع ذلك يمكنك إضافة ملف
"format: foo" رأس زائف لإدخالات محددة إذا كنت ترغب في الكتابة
إدخالات محددة بتنسيق مختلف.

للسماح بالمرونة في التعامل مع الإدخالات، سيتم إدراج كل إدخال في المدونة
يتم تمريرها من خلال البرنامج النصي للتصفية B
والذي يسمح لك بتعديل هذا التعامل في مكان واحد. هذا
يسمح البرنامج النصي بتحديث الإدخالات عبر المرشحات قبل وبعد
التحويل إلى HTML. لمزيد من التفاصيل يرجى الاطلاع على الصفحة الرئيسية ل
هذا البرنامج النصي.

CONFIGURATION

تكوين البرنامج هو الحد الأدنى، ويتم تنفيذه بشكل عام
عبر وسيطات سطر الأوامر. ومع ذلك فمن الممكن لحفظ الإعدادات
إما في الملف global / etc / historylerc أو الملف لكل مستخدم ~ /. chroniclerc
ملف.

إذا كنت ترغب في ذلك ، يمكنك تمرير اسم ملف تكوين آخر إلى
النص الذي يحتوي على علامة <--config> B. ستتم قراءة هذا بعد
الملفين السابقين ، وقد يتجاوز أي إعدادات موجودة.

يحتوي ملف التكوين على أسطر مثل هذه:

المدخلات = / home / me / blog

الإخراج = / var / www / blog

التنسيق = تخفيض السعر

يتم تجاهل المفاتيح غير المعروفة.

اختياري التخزين المؤقت

لتسريع عملية إعادة بناء مدونة كبيرة، قد يستخدم المترجم ملف local
برنامج Memcached الخفي، إذا كان مثبتًا ومتوفرًا.

لتثبيت هذا ، في ظل نظام Debian GNU / Linux ، يرجى تشغيل:

الرابطة بين الحصول على التحديث
apt-get install memcached libcache-memcached-Perl

يمكنك تعطيل سلوك التخزين المؤقت هذا باستخدام --no-cache، والاطلاع على
تأثير مع --verbose.

اختياري التقويم

إذا كانت الوحدة النمطية "HTML :: CalendarMonthSimple" متاحة ، فستتم إتاحة كل مدونة
تحتوي على عرض شهر بسيط للشهر الحالي على الفهرس.

لتعطيل هذا ، قم باستدعاء البرنامج باستخدام "- no-calendar".

اختياري التعليق

يجب أن تجد الملف مرفقًا مع رمز السجل
cgi-bin/comments.cgi.

تم تصميم هذا الملف لكتابة التعليقات المقدمة إلى المحلية
نظام ملفات خادم الويب الخاص بك. إذا قمت بتثبيت ذلك ، وتحرير ملف
المسار في بداية البرنامج النصي يجب أن تكون قادرًا على تضمينه
من التعليقات في مدونتك.

باختصار هناك ثلاثة أشياء عليك القيام بها:

قم بتثبيت البرنامج النصي CGI وتحرير المسار في البداية.
انسخ تعليقات الإخراج إلى مصدر مدونتك المحلي.
قم بتشغيل هذا البرنامج النصي مرة أخرى مع --comments =. / path / to / comments

يجب أن يتضمن هذا التعليقات في الإخراج الثابت. أكثر
يتم توفير تعليمات واضحة داخل ملف "التعليقات"
المدرجة ضمن التوزيع.

استخدم السجل عبر الإنترنت باستخدام خدمات onworks.net