kronika - Online w chmurze

PROGRAM:

IMIĘ

kronika - Prosty kompilator blogów.

STRESZCZENIE

kronika [opcje]

Opcje ścieżki:

--comments Określ ścieżkę do opcjonalnego katalogu komentarzy.
--config Określ plik konfiguracyjny do odczytu.
--input Określ katalog wejściowy do użycia.
--output Określ katalog, w którym mają być zapisywane dane wyjściowe.
--theme-dir Określ ścieżkę do szablonów motywów.
--theme Określ motyw do użycia.
--pattern Określ wzorzec plików do pracy.
--url-prefix Określ prefiks aktywnego bloga.
--sitemap-prefix Określ prefiks mapy witryny.

Opcje wpisów na blogu:

--format Określ format wpisów, HTML/tekstylne/przecenę.

Polecenia przed i po kompilacji:

--pre-build Określ polecenie do wykonania przed zbudowaniem bloga.
--post-build Określ polecenie do wykonania po zbudowaniu bloga.
--pre-filter Polecenie filtrowania każdego wpisu w blogu przed konwersją HTML.
--post-filter Polecenie filtrowania każdego wpisu w blogu po konwersji HTML.

Opcje sortowania:

--recent-dates-first Pokaż ostatnie wpisy jako pierwsze w widoku archiwum.
--recent-tags-first Pokaż ostatnie wpisy jako pierwsze w widoku tagów.

Opcje liczenia:

--entry-count=N Liczba postów do wyświetlenia w indeksie.
--rss-count=N Liczba postów do uwzględnienia w kanale indeksu RSS.

Opcjonalne funkcje:

--author Podaj adres e-mail autora
--comment-days Określ maksymalny wiek postów do akceptowania komentarzy.
--date-archive-path Dołącz datę do archiwum.
--force Wymusza kopiowanie statycznych plików z motywu bloga.
--lang Określa język używany do formatowania dat.
--lower-case Małe litery wszystkie nazwy plików, które są wyprowadzane.
--no-archive Nie twórz strony archiwum.
--no-cache Nie używaj opcjonalnych funkcji memcached, nawet jeśli są dostępne.
--no-calendar Nie używaj opcjonalnego kalendarza w indeksie.
--no-comments Nie zezwalaj na publikowanie komentarzy.
--no-sitemap Nie generuj mapy witryny.
--no-tags Nie twórz żadnych stron z tagami.
--no-xrefs Nie twórz żadnych odsyłaczy.

Opcje pomocy:

--help Wyświetla informacje pomocy dla tego skryptu.
--manual Przeczytaj instrukcję obsługi tego skryptu.
--verbose Pokaż przydatne informacje o debugowaniu.
--version Pokaż numer wersji i zakończ.

JAK TO SIĘ ZACZĘŁO

Kronika to proste narzędzie do konwersji zbioru plików tekstowych,
znajduje się w jednym katalogu, na blogu składającym się ze statycznych
Pliki HTML.

Obsługuje tylko niezbędne minimum funkcji, które są wymagane
być użytecznym:

* Wsparcie tagowania.

* Obsługa RSS.

* Wsparcie archiwum.

Oczywiste braki to:

* Brak obsługi natychmiastowego komentowania.

* Brak obsługi pingback/trackback.

Powiedziawszy, że jest to solidny, stabilny i użyteczny system.

BLOG FORMAT

Format przetwarzanych przez nas plików tekstowych ma kluczowe znaczenie dla wyników
stron. Każdy wpis powinien wyglądać mniej więcej tak:

Tytuł: To jest tytuł wpisu na blogu
Data: 2 marca 2007 r.
Tagi: jeden, dwa, trzy, długi tag

Tutaj znajduje się tekst twojego wpisu.

UWAGA: Nagłówek MUSI być oddzielony od treści wpisu co najmniej
pojedyncza pusta linia.

W tym przykładzie widzimy, że sam wpis został poprzedzony
z małym nagłówkiem. Nagłówek wpisu zawiera trzy opcjonalne wiersze,
jeśli ich nie ma, istnieją rozsądne wartości domyślne, jak opisano
poniżej.

Formatowanie dat wyjściowych można zmienić za pomocą
Opcja wiersza poleceń B<--lang> (lub pasująca opcja "lang=french" w
konfiguracyjnym), ale datę samego wpisu należy podać w
Angielski.

Tytuł: opisuje tytuł posta. Jeśli nie jest obecny, używana jest nazwa pliku wpisu
zamiast. Można również użyć „Temat:”.
Temat: To jest synonim „Tytuł:”.
Data: data napisania posta. Jeśli nie, używany jest czas utworzenia pliku
zamiast.
Opublikuj: ten nagłówek jest usuwany ze wszystkich wpisów i jest używany przez kronikę-spooler
skrypt.
Tagi: Wszelkie tagi, które powinny być powiązane z wpisem, oddzielone przecinkami.

Zakłada się, że format wpisu to HTML, jednak istnieje wsparcie
do pisania wpisów zarówno w formacie tekstylnym, jak i przecenowym.

Format wpisów jest określony przez argument B<--format> lub
poprzez ustawienie "format: foo" w twoim pliku chroniclerc.

Zakłada się, że format wpisów jest globalny; to są wszystkie twoje wpisy
zakłada się, że będzie w tym samym formacie. Możesz jednak dodać
pseudonagłówek "format: foo" do określonych wpisów, jeśli chcesz pisać
konkretne wpisy w innym formacie.

Aby umożliwić elastyczność w obsłudze wpisów, każdy wpis na blogu będzie:
przechodzić przez skrypt filtrujący B
co pozwala na modyfikację tej obsługi w jednym miejscu. Ten
skrypt umożliwia aktualizację wpisów za pomocą filtrów zarówno przed, jak i po
konwersja do HTML. Więcej informacji można znaleźć na stronie podręcznika
ten skrypt.

KONFIGURACJA

Konfiguracja oprogramowania jest minimalna i generalnie wykonywana
za pomocą argumentów wiersza poleceń. Istnieje jednak możliwość zapisania ustawień
albo w pliku global /etc/chroniclerc lub per-user ~/.kronikarz
plik.

Jeśli chcesz, możesz przekazać nazwę innego pliku konfiguracyjnego do
skrypt z flagą B<--config>. Zostanie to przeczytane po
poprzednie dwa pliki i może zastąpić wszystkie obecne ustawienia.

Plik konfiguracyjny zawiera wiersze takie jak:

wejście = /dom/ja/blog

wyjście = /var/www/blog

format = przecena

Nieznane klucze są ignorowane.

OPCJA BUFOROWANIE

Aby przyspieszyć odbudowę dużego bloga, kompilator może użyć lokalnego
Demon Memcached, jeśli jest zainstalowany i dostępny.

Aby to zainstalować, w systemie Debian GNU/Linux uruchom:

apt-get update
apt-get zainstaluj memcached libcache-memcached-perl

Możesz wyłączyć to zachowanie pamięci podręcznej za pomocą --no-cache i zobaczyć
efekt z --verbose.

OPCJA KALENDARZ

Jeśli moduł „HTML::CalendarMonthSimple” jest dostępny, każdy blog będzie
zawierają prosty widok miesiąca bieżącego miesiąca na indeksie.

Aby to wyłączyć, wywołaj program z '--no-calendar'.

OPCJA KOMENTARZ

Dołączony do kodu kroniki powinieneś znaleźć plik
cgi-bin/komentarze.cgi.

Ten plik jest przeznaczony do zapisywania zgłoszonych komentarzy do lokalnego
system plików twojego serwera WWW. Jeśli to zainstalujesz i edytujesz
ścieżka na początku skryptu, którą powinieneś być w stanie dołączyć
komentarze na swoim blogu.

Krótko mówiąc, musisz zrobić trzy rzeczy:

Zainstaluj skrypt CGI i edytuj ścieżkę na początku.
Skopiuj komentarze wyjściowe do lokalnego źródła bloga.
Uruchom ten skrypt ponownie z --comments=./path/to/comments

Powinno to zawierać komentarze w statycznych danych wyjściowych. Więcej
wyraźne instrukcje znajdują się w pliku „UWAGI”
zawarte w dystrybucji.

Korzystaj z kroniki online za pomocą usług onworks.net