cronică - Online în Cloud

PROGRAM:

NUME

cronică - Un simplu compilator de blog.

REZUMAT

cronică [opțiuni]

Opțiuni de cale:

--comments Specificați calea către directorul opțional de comentarii.
--config Specificați un fișier de configurare de citit.
--input Specificați directorul de intrare de utilizat.
--output Specificați directorul în care să scrieți rezultatul.
--theme-dir Specificați calea către șabloanele de teme.
--theme Specificați tema de utilizat.
--pattern Specificați modelul fișierelor cu care să lucrați.
--url-prefix Specificați prefixul pentru blogul live.
--sitemap-prefix Specificați prefixul pentru harta site-ului.

Opțiuni de intrare pe blog:

--format Specificați formatul intrărilor dvs., HTML/textile/markdown.

Comenzi pre și post-build:

--pre-build Specificați o comandă de executat înainte de a construi blogul.
--post-build Specificați o comandă de executat odată ce blogul a fost creat.
--pre-filter O comandă pentru a filtra fiecare intrare de blog înainte de conversia HTML.
--post-filter O comandă pentru a filtra fiecare intrare de blog după conversia HTML.

Opțiuni de sortare:

--recent-dates-first Afișează mai întâi intrările recente în vizualizarea arhivă.
--recent-tags-first Afișează mai întâi intrările recente în vizualizarea etichetelor.

Opțiuni de numărare:

--entry-count=N Numărul de postări de afișat în index.
--rss-count=N Numărul de postări de inclus în fluxul de index RSS.

Caracteristici opționale:

--author Specificați adresa de e-mail a autorului
--comment-days Specificați numărul maxim de vârstă al postărilor pentru a accepta comentarii.
--date-archive-path Includeți data în arhivă.
--force Forțați copierea fișierelor statice din tema blogului.
--lang Specificați limba de utilizat pentru formatarea datelor.
--lower-case Scrie cu minuscule toate numele de fișiere care sunt afișate.
--no-archive Nu creați o pagină de arhivă.
--no-cache Nu utilizați funcțiile opționale memcached, chiar dacă sunt disponibile.
--no-calendar Nu utilizați calendarul opțional pe index.
--no-comments Nu permiteți postarea comentariilor.
--no-sitemap Nu generați un sitemap.
--no-tags Nu produce nicio pagină de etichete.
--no-xrefs Nu produce referințe încrucișate.

Opțiuni de ajutor:

--help Afișează informațiile de ajutor pentru acest script.
--manual Citiți manualul pentru acest script.
--verbose Afișează informații utile de depanare.
--version Afișează numărul versiunii și ieși.

DESPRE NOI

Chronicle este un instrument simplu pentru a converti o colecție de fișiere text,
situat într-un singur director, într-un blog format din static
fișiere HTML.

Acceptă doar minimul necesar de funcții necesare
a fi de folos:

* Suport pentru etichetare.

* Suport RSS.

* Suport pentru arhivare.

Deficiențele evidente sunt:

* Lipsa suportului pentru comentariile instantanee.

* Lipsa suportului pentru pingback/trackback.

Acestea fiind spuse, este un sistem robust, stabil și util.

BLOG FORMAT

Formatul fișierelor text pe care le procesăm este esențial pentru rezultat
pagini. Fiecare intrare ar trebui să arate cam așa:

Titlu: acesta este titlul articolului de blog
Data: 2 martie 2007
Etichete: unu, doi, trei, etichetă lungă

Textul intrării dvs. merge aici.

NOTĂ: Antetul TREBUIE să fie separat de corpul intrării cu cel puțin a
o singură linie goală.

În acest exemplu putem vedea că intrarea în sine a fost prefațată
cu un antet mic. Un antet de intrare conține trei linii opționale,
dacă acestea nu sunt prezente, atunci există valori implicite sensibile așa cum este descris
de mai jos.

Formatarea datelor de ieșire poate fi modificată prin utilizarea
Opțiunea de linie de comandă B<--lang> (sau opțiunea potrivită „lang=franceză” din fișierul
fișier de configurare), dar data intrării în sine ar trebui specificată în
Engleză.

Titlu: Descrie titlul postării. Dacă nu este prezent, se folosește numele de fișier al intrării
in schimb. „Subiect:” poate fi de asemenea folosit.
Subiect: Acesta este un sinonim pentru „Titlu:”.
Data: data la care a fost scrisă postarea. Dacă nu este prezent, se folosește ora de creare a fișierului
in schimb.
Publicare: acest antet este eliminat din toate intrările și este folosit de către cronica-spooler
script-ul.
Etichete: orice etichete care ar trebui asociate cu intrarea, separate prin virgule.

Se presupune că formatul intrării este HTML, dar există suport
pentru a scrie înregistrările dvs. atât în ​​format textil, cât și în format de reducere.

Formatul intrărilor este specificat prin argumentul B<--format> sau
printr-o setare „format: foo” în fișierul dumneavoastră chroniclerc.

Se presupune că formatul intrărilor este global; asta sunt toate intrările tale
se va presupune a fi în același format. Cu toate acestea, puteți adăuga un
„format: foo” pseudo antet la anumite intrări dacă doriți să scrieți
intrări specifice într-un format diferit.

Pentru a permite flexibilitate în gestionarea intrărilor, fiecare intrare de blog va
să fie trecut prin scriptul de filtru B
care vă permite să modificați această manipulare într-o singură locație. Acest
scriptul permite ca intrările să fie actualizate prin filtre atât înainte, cât și după
conversia în HTML. Pentru mai multe detalii, consultați pagina de manual pentru
acel scenariu.

CONFIGURARE

Configurația software-ului este minimă și în general realizată
prin argumentele liniei de comandă. Cu toate acestea, este posibil să salvați setările
fie în fișierul global /etc/chroniclerc sau pe utilizator ~/.croniclerc
fișier.

Dacă doriți, puteți transmite numele unui alt fișier de configurare
scriptul cu indicatorul B<--config>. Aceasta va fi citită după
două fișiere anterioare și poate suprascrie orice setări care sunt prezente.

Fișierul de configurare conține linii ca acestea:

intrare = /home/eu/blog

ieșire = /var/www/blog

format = reducere

Cheile care sunt necunoscute sunt ignorate.

OPTIONAL CACHING

Pentru a accelera reconstruirea unui blog mare, compilatorul poate folosi un local
Daemon Memcached, dacă este instalat și disponibil.

Pentru a instala acest lucru, sub un sistem Debian GNU/Linux, rulați:

apt-get update
apt-get install memcached libcache-memcached-perl

Puteți dezactiva acest comportament de stocare în cache cu --no-cache și vedeți
efect cu --verbose.

OPTIONAL CALENDAR

Dacă modulul „HTML::CalendarMonthSimple” este disponibil, fiecare blog o va face
conține o simplă vizualizare lunară a lunii curente pe index.

Pentru a dezactiva acest lucru, invocați programul cu „--no-calendar”.

OPTIONAL COMENTAREA

Inclus cu codul cronicii ar trebui să găsiți fișierul
cgi-bin/comments.cgi.

Acest fișier este conceput pentru a scrie comentariile trimise la local
sistemul de fișiere al serverului dvs. web. Dacă îl instalați și editați
calea de la începutul scriptului pe care ar trebui să o puteți include
comentarii pe blogul dvs.

Pe scurt, sunt trei lucruri pe care trebuie să le faci:

Instalați scriptul CGI și editați calea la început.
Copiați comentariile de ieșire în sursa locală a blogului.
Rulați acest script din nou cu --comments=./path/to/comments

Aceasta ar trebui să includă comentariile în ieșirea statică. Mai mult
instrucțiuni explicite sunt furnizate în fișierul „COMMENTARII”
incluse în distribuție.

Utilizați cronica online folosind serviciile onworks.net