хроника - Интернет в облаке

ПРОГРАММА:

ИМЯ

хроника - простой составитель блога.

СИНТАКСИС

запись [варианты]

Параметры пути:

--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-date-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 Показать номер версии и выйти.

О НАС

Хроника - это простой инструмент для преобразования набора текстовых файлов,
размещены в одном каталоге, в блог, состоящий из статических
HTML файлы.

Он поддерживает только минимум необходимых функций.
быть полезным:

* Поддержка тегов.

* Поддержка RSS.

* Поддержка архивов.

Очевидные недостатки:

* Отсутствие поддержки мгновенного комментирования.

* Отсутствие поддержки pingback / trackback.

Сказав, что это надежная, стабильная и полезная система.

БЛОГ ФОРМАТ

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

Заголовок: это заголовок сообщения в блоге.
Дата: 2 марта 2007 г.
Теги: один, два, три, длинный тег

Текст вашей записи идет сюда.

ПРИМЕЧАНИЕ. Заголовок ДОЛЖЕН быть отделен от тела записи как минимум
одна пустая строка.

В этом примере мы видим, что к самой записи добавлен предисловие
с небольшим заголовком. Заголовок записи состоит из трех необязательных строк:
если их нет, то есть разумные значения по умолчанию, как описано
внизу.

Форматирование выходных дат можно изменить с помощью
B <--lang> параметр командной строки (или соответствующий параметр "lang = french" в
конфигурационный файл), но дату самой записи следует указать в
Английский.

Заголовок: описывает заголовок сообщения. Если нет, используется имя файла записи.
вместо. «Тема:» также может использоваться.
Тема: Это синоним «Заголовок:».
Дата: дата написания сообщения. Если нет, используется время создания файла.
.
Опубликовать: этот заголовок удаляется из всех записей и используется диспетчером буферизации хроник.
скрипты.
Теги: любые теги, которые должны быть связаны с записью, разделенные запятыми.

Предполагается, что формат записи - HTML, однако есть поддержка
для написания ваших записей как в текстильном формате, так и в формате уценки.

Формат записей указывается с помощью аргумента B <--format> или
через параметр "format: foo" в вашем файле chroniclerc.

Предполагается, что формат записей является глобальным; это все ваши записи
предполагается, что они имеют тот же формат. Однако вы можете добавить
"format: foo" псевдо-заголовок для определенных записей, если вы хотите написать
конкретные записи в другом формате.

Чтобы обеспечить гибкость в обработке записей, каждая запись в блоге будет
пройти через скрипт фильтра B
что позволяет вам изменять эту обработку в одном месте. Этот
скрипт позволяет обновлять записи с помощью фильтров как до, так и после
преобразование в HTML. Для получения дополнительных сведений см. Справочную страницу для
этот сценарий.

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

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

При желании вы можете передать имя другого файла конфигурации в
скрипт с флагом B <--config>. Это будет прочитано после
предыдущие два файла и могут отменять любые имеющиеся настройки.

Файл конфигурации содержит такие строки:

input = / home / me / blog

вывод = / var / www / blog

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

Неизвестные ключи игнорируются.

ДОПОЛНИТЕЛЬНО Кеширование

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

Чтобы установить это, в системе Debian GNU / Linux выполните:

apt-get update
apt-get установить memcached libcache-memcached-perl

Вы можете отключить это кеширование с помощью --no-cache и увидеть
эффект с --verbose.

ДОПОЛНИТЕЛЬНО КАЛЕНДАРЬ

Если доступен модуль HTML :: CalendarMonthSimple, каждый блог будет
содержат простой просмотр текущего месяца по индексу.

Чтобы отключить это, вызовите программу с помощью '--no-calendar'.

ДОПОЛНИТЕЛЬНО КОММЕНТАРИЙ

Вместе с кодом хроники вы должны найти файл
cgi-bin / comments.cgi.

Этот файл предназначен для записи представленных комментариев в местный
файловая система вашего веб-сервера. Если вы установите это, и отредактируйте
путь в начале скрипта, вы должны иметь возможность включить
комментарии в вашем блоге.

Короче говоря, вам нужно сделать три вещи:

Установите сценарий CGI и отредактируйте путь в начале.
Скопируйте выходные комментарии в свой локальный источник блога.
Запустите этот сценарий еще раз с --comments =. / Path / to / comments

Это должно включать комментарии в статический вывод. Более
явные инструкции представлены в файле "КОММЕНТАРИИ"
включены в дистрибутив.

Используйте онлайн-хронику с помощью сервисов onworks.net