хроніка - Онлайн у Хмарі

ПРОГРАМА:

ІМ'Я

хроніка - простий компілятор блогу.

СИНТАКСИС

хроніка [варіанти]

Параметри шляху:

--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 Вкажіть мову для форматування дат.
--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.

Сказавши, що це надійна, стабільна та корисна система.

БЛОГ ФОРМАТ

Формат текстових файлів, які ми обробляємо, має вирішальне значення для результату
сторінок. Кожен запис має виглядати приблизно так:

Назва: це назва допису в блозі
Дата: 2 березня 2007 року
Теги: один, два, три, довгий тег

Текст вашого запису знаходиться тут.

ПРИМІТКА. Заголовок ПОВИНЕН бути відокремлений від тіла запису принаймні а
один порожній рядок.

У цьому прикладі ми бачимо, що сама запис була передмова
з невеликим заголовком. Заголовок запису містить три необов'язкові рядки,
якщо вони відсутні, то існують розумні значення за замовчуванням, як описано
нижче.

Формат дат виведення можна змінити за допомогою
Параметр командного рядка B<--lang> (або відповідний параметр "lang=french" у файлі
конфігураційного файлу), але дату самого запису слід вказати в
English.

Назва: описує назву публікації. Якщо його немає, використовується ім’я файлу запису
замість цього. Також можна використовувати «Тема:».
Тема: Це синонім слова "Назва:".
Дата: дата написання публікації. Якщо його немає, використовується час створення файлу
замість цього.
Опублікувати: цей заголовок видаляється з усіх записів і використовується спулером хроніки
сценарій
Теги: будь-які теги, які повинні бути пов'язані з записом, розділені комами.

Передбачається, що формат запису — HTML, проте є підтримка
для написання ваших записів як у текстильному, так і у форматі уцінки.

Формат записів задається через аргумент B<--format>, або
за допомогою параметра "format: foo" у вашому файлі хронікера.

Формат записів вважається глобальним; це всі ваші записи
буде вважатися в тому ж форматі. Однак ви можете додати a
"format: foo" псевдозаголовок до конкретних записів, якщо ви хочете написати
конкретні записи в іншому форматі.

Щоб забезпечити гнучкість в обробці записів, кожен запис блогу буде
передаватися через сценарій фільтра B
що дозволяє змінювати цю обробку в одному місці. Це
скрипт дозволяє оновлювати записи за допомогою фільтрів як до, так і після
перетворення в HTML. Для отримання додаткової інформації, будь ласка, перегляньте сторінку керівництва
той сценарій.

КОНФІГУРАЦІЯ

Конфігурація програмного забезпечення мінімальна і зазвичай виконується
через аргументи командного рядка. Однак є можливість зберегти налаштування
у глобальному файлі /etc/chroniclerc або у файлі для кожного користувача ~/.chroniclerc
файлу.

Якщо бажаєте, ви можете передати ім’я іншого конфігураційного файлу
скрипт із прапорцем B<--config>. Це буде прочитано після
попередні два файли, і може замінити будь-які наявні налаштування.

Файл конфігурації містить такі рядки:

input = /home/me/blog

вихід = /var/www/blog

формат = уцінка

Невідомі ключі ігноруються.

ДОДАТКОВО КЕШУВАННЯ

Щоб пришвидшити відновлення великого блогу, компілятор може використовувати локальний
Демон Memcached, якщо він встановлений і доступний.

Щоб встановити це, в системі 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