وقایع - آنلاین در ابر

برنامه:

نام

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 از ویژگی های اختیاری memcached استفاده نکنید، حتی اگر موجود باشد.
--no-calendar از تقویم اختیاری در فهرست استفاده نکنید.
--no-comments اجازه ندهید نظرات ارسال شود.
--no-sitemap نقشه سایت تولید نکنید.
--no-tags هیچ صفحه برچسبی تولید نکنید.
--no-xrefs هیچ ارجاع متقابلی تولید نکنید.

گزینه های راهنما:

--help نمایش اطلاعات راهنما برای این اسکریپت.
--manual راهنمای این اسکریپت را بخوانید.
--verbose نمایش اطلاعات مفید اشکال زدایی.
--version نمایش شماره نسخه و خروج.

درباره ما

Chronicle یک ابزار ساده برای تبدیل مجموعه ای از فایل های متنی است.
در یک دایرکتوری واحد، در یک وبلاگ متشکل از استاتیک قرار دارد
فایل های HTML

این تنها حداقل امکانات مورد نیاز را پشتیبانی می کند
مفید بودن:

* پشتیبانی از برچسب گذاری

* پشتیبانی از RSS

* پشتیبانی از آرشیو

کمبودهای آشکار عبارتند از:

* عدم پشتیبانی برای اظهار نظر فوری.

* عدم پشتیبانی pingback/trackback.

با توجه به اینکه این یک سیستم قوی، پایدار و مفید است.

بلاگ ها FORMAT

فرمت فایل های متنی که پردازش می کنیم برای خروجی بسیار مهم است
صفحات هر ورودی باید چیزی شبیه به این باشد:

عنوان: این عنوان پست وبلاگ است
تاریخ: 2 مارس 2007
برچسب ها: یک، دو، سه، تگ طولانی

متن ورودی شما اینجاست.

توجه: هدر باید حداقل با a از بدنه ورودی جدا شود
تک خط خالی

در این مثال می بینیم که خود مدخل مقدمه شده است
با یک هدر کوچک هدر ورودی شامل سه خط اختیاری است،
اگر اینها وجود نداشته باشند، پیش فرض های معقولی همانطور که توضیح داده شد وجود دارد
زیر کلیک کنید.

قالب‌بندی تاریخ‌های خروجی ممکن است با استفاده از علامت تغییر کند
گزینه B<--lang> خط فرمان (یا گزینه منطبق با "lang=french" در
فایل پیکربندی)، اما تاریخ ورود خود باید در آن مشخص شود
انگلیسی

عنوان: عنوان پست را توضیح می دهد. در صورت عدم وجود از نام فایل ورودی استفاده می شود
بجای. همچنین ممکن است از "موضوع:" استفاده شود.
موضوع: این مترادف برای "عنوان:" است.
تاریخ: تاریخی که پست نوشته شده است. در صورت عدم وجود از زمان ایجاد فایل استفاده می شود
به جای آن.
انتشار: این هدر از تمام ورودی ها حذف می شود و توسط Chronle-sooler استفاده می شود
اسکریپت
برچسب ها: هر برچسبی که باید با ورودی مرتبط باشد، با کاما از هم جدا شود.

فرمت ورودی HTML فرض شده است، اما پشتیبانی وجود دارد
برای نوشتن مطالب خود در هر دو فرمت پارچه ای و علامت گذاری.

فرمت ورودی ها از طریق آرگومان B<--format> یا مشخص می شود
از طریق یک تنظیم "format: foo" در فایل Chroniclerc شما.

فرمت ورودی ها جهانی فرض می شود. این همه ورودی های شماست
در همان قالب فرض می شود. با این حال می توانید یک را اضافه کنید
اگر می خواهید بنویسید، هدر شبه "format: foo" به ورودی های خاصی است
ورودی های خاص در قالبی متفاوت

برای اجازه دادن به انعطاف پذیری در رسیدگی به مدخل ها، هر ورودی وبلاگ می تواند
از فیلتر اسکریپت B عبور داده شود
که به شما امکان می دهد این کنترل را در یک مکان تغییر دهید. این
اسکریپت اجازه می دهد تا ورودی ها از طریق فیلترها قبل و بعد به روز شوند
تبدیل به HTML برای جزئیات بیشتر لطفاً به صفحه manpage مراجعه کنید
آن فیلمنامه

پیکربندی

پیکربندی نرم افزار حداقل است و به طور کلی انجام می شود
از طریق آرگومان های خط فرمان با این حال امکان ذخیره تنظیمات وجود دارد
یا در فایل global /etc/chroniclerc یا هر کاربر ~/.chroniclerc
فایل.

در صورت تمایل می توانید نام فایل پیکربندی دیگری را به آن ارسال کنید
اسکریپت با پرچم B<--config>. این پس از خواندن خواهد شد
دو فایل قبلی، و ممکن است تنظیمات موجود را لغو کند.

فایل پیکربندی شامل خطوطی مانند این است:

ورودی = /home/me/blog

خروجی = /var/www/blog

قالب = علامت گذاری

کلیدهایی که ناشناخته هستند نادیده گرفته می شوند.

اختیاری حافظه پنهان

برای سرعت بخشیدن به بازسازی یک وبلاگ بزرگ، کامپایلر ممکن است از یک محلی استفاده کند
Daemon Memcached، در صورت نصب و در دسترس بودن.

برای نصب این، در سیستم گنو/لینوکس دبیان، لطفاً اجرا کنید:

با apt-get برای بروز رسانی
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 از Chronicle آنلاین استفاده کنید