chronicle - Online sa Cloud

PROGRAMA:

NAME

chronicle - Isang simpleng blog compiler.

SINOPSIS

salaysay [mga opsyon]

Mga Pagpipilian sa Landas:

--comments Tukuyin ang landas sa opsyonal na direktoryo ng mga komento.
--config Tumukoy ng configuration file na babasahin.
--input Tukuyin ang input na direktoryo na gagamitin.
--output Tukuyin ang direktoryo kung saan susulatan ang output.
--theme-dir Tukuyin ang landas patungo sa mga template ng tema.
--theme Tukuyin ang temang gagamitin.
--pattern Tukuyin ang pattern ng mga file na gagamitin.
--url-prefix Tukuyin ang prefix sa live na blog.
--sitemap-prefix Tukuyin ang prefix para sa site map.

Mga Pagpipilian sa Pagpasok sa Blog:

--format Tukuyin ang format ng iyong mga entry, HTML/textile/markdown.

Mga Pre at Post-Build Command:

--pre-build Tumukoy ng isang utos na isasagawa bago ang pagbuo ng blog.
--post-build Tumukoy ng isang utos na ipapatupad kapag naitayo na ang blog.
--pre-filter Isang utos upang i-filter ang bawat entry sa blog bago ang conversion ng HTML.
--post-filter Isang utos upang i-filter ang bawat entry sa blog pagkatapos ng conversion ng HTML.

Mga Pagpipilian sa Pag-uuri:

--recent-dates-first Ipakita muna ang mga kamakailang entry sa view ng archive.
--recent-tags-first Ipakita muna ang mga kamakailang entry sa tag view.

Mga Opsyon sa Pagbibilang:

--entry-count=N Bilang ng mga post na ipapakita sa index.
--rss-count=N Bilang ng mga post na isasama sa RSS index feed.

Opsyonal na Mga Tampok:

--author Tukuyin ang email address ng may-akda
--comment-days Tukuyin ang bilang ng maximum na edad ng mga post upang tumanggap ng mga komento.
--date-archive-path Isama ang petsa sa archive.
--force Pilitin ang pagkopya ng mga static na file mula sa tema ng blog.
--lang Tukuyin ang wikang gagamitin para sa pag-format ng mga petsa.
--lower-case Lower-case lahat ng filename na output.
--no-archive Huwag gumawa ng archive page.
--no-cache Huwag gamitin ang mga opsyonal na feature na memcached, kahit na available.
--no-calendar Huwag gamitin ang opsyonal na kalendaryo sa index.
--no-comments Huwag payagang mag-post ng mga komento.
--no-sitemap Huwag bumuo ng sitemap.
--no-tags Huwag gumawa ng anumang mga pahina ng tag.
--no-xrefs Huwag gumawa ng anumang mga cross reference.

Mga Opsyon sa Tulong:

--help Ipakita ang impormasyon ng tulong para sa script na ito.
--manual Basahin ang manwal para sa script na ito.
--verbose Ipakita ang kapaki-pakinabang na impormasyon sa pag-debug.
--bersyon Ipakita ang numero ng bersyon at lumabas.

TUNGKOL

Ang Chronicle ay isang simpleng tool upang i-convert ang isang koleksyon ng mga text file,
matatagpuan sa loob ng iisang direktoryo, sa isang blog na binubuo ng static
HTML file.

Sinusuportahan lamang nito ang kaunting mga tampok na kinakailangan
upang maging kapaki-pakinabang:

* Suporta sa pag-tag.

* Suporta sa RSS.

* Suporta sa archive.

Ang mga halatang pagkukulang ay:

* Kakulangan ng suporta para sa agarang pagkomento.

* Kakulangan ng suporta sa pingback/trackback.

Ang pagkakaroon ng sinabi na ito ay isang matatag, matatag, at kapaki-pakinabang na sistema.

BLOG FORMAT

Ang format ng mga text file na aming pinoproseso ay kritikal sa output
mga pahina. Ang bawat entry ay dapat magmukhang ganito:

Pamagat: Ito ang pamagat ng post sa blog
Petsa: ika-2 ng Marso 2007
Mga tag: isa, dalawa, tatlo, mahabang tag

Dito napupunta ang text ng entry mo.

TANDAAN: DAPAT na ihiwalay ang header sa katawan ng entry ng hindi bababa sa a
solong walang laman na linya.

Sa halimbawang ito makikita natin na ang entry mismo ay nauna na
na may maliit na header. Ang isang entry header ay naglalaman ng tatlong opsyonal na linya,
kung wala ang mga ito, may mga matinong default gaya ng inilarawan
sa ibaba.

Ang pag-format ng mga petsa ng output ay maaaring mabago sa pamamagitan ng paggamit ng
B<--lang> command line na opsyon (o ang tumutugmang "lang=french" na opsyon sa
configuration file), ngunit ang petsa ng entry mismo ay dapat na tinukoy sa
Ingles.

Pamagat: Inilalarawan ang pamagat ng post. Kung hindi ipakita ang filename ng entry ay ginagamit
sa halip. Ang "Subject:" ay maaari ding gamitin.
Paksa: Ito ay kasingkahulugan ng 'Pamagat:'.
Petsa: Ang petsa kung kailan isinulat ang post. Kung hindi ipakita ang oras ng paglikha ng file ay ginagamit
sa halip.
I-publish: Ang header na ito ay tinanggal mula sa lahat ng mga entry, at ginagamit ng chronicle-spooler
script.
Mga Tag: Anumang mga tag na dapat na nauugnay sa entry, na pinaghihiwalay ng mga kuwit.

Ang format ng entry ay ipinapalagay na HTML, gayunpaman mayroong suporta
para sa pagsulat ng iyong mga entry sa parehong tela at markdown na mga format.

Ang format ng mga entry ay tinukoy sa pamamagitan ng B<--format> argument, o
sa pamamagitan ng setting na "format: foo" sa iyong chroniclerc file.

Ang format ng mga entry ay ipinapalagay na global; yan lang ang mga entry mo
ay ipagpalagay na nasa parehong format. Gayunpaman maaari kang magdagdag ng isang
"format: foo" pseudo header sa mga partikular na entry kung gusto mong magsulat
mga partikular na entry sa ibang format.

Upang payagan ang kakayahang umangkop sa paghawak ng mga entry ay gagawin ng bawat entry sa blog
maipasa sa filter na script B
na nagbibigay-daan sa iyong baguhin ang pangangasiwa na ito sa isang lokasyon. Ito
Ang script ay nagpapahintulot sa mga entry na ma-update sa pamamagitan ng mga filter bago at pagkatapos
ang conversion sa HTML. Para sa karagdagang detalye mangyaring tingnan ang manpage para sa
yung script.

Configuration

Ang pagsasaayos ng software ay minimal, at karaniwang ginagawa
sa pamamagitan ng mga argumento ng command line. Gayunpaman, posible na i-save ang mga setting
alinman sa file na global /etc/chroniclerc o sa bawat user ~/.chroniclerc
file.

Kung nais mo maaari mong ipasa ang pangalan ng isa pang configuration file sa
ang script na may B<--config> flag. Babasahin ito pagkatapos ng
nakaraang dalawang file, at maaaring i-override ang anumang mga setting na naroroon.

Ang configuration file ay naglalaman ng mga linyang tulad nito:

input = /home/me/blog

output = /var/www/blog

format = markdown

Ang mga susi na hindi alam ay binabalewala.

OPSYONAL NAG-CACHING

Upang mapabilis ang muling pagbuo ng isang malaking blog, maaaring gumamit ang compiler ng lokal
Memcached daemon, kung naka-install at magagamit.

Upang i-install ito, sa ilalim ng isang Debian GNU/Linux system mangyaring patakbuhin ang:

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

Maaari mong hindi paganahin ang pag-uugali sa pag-cache na ito gamit ang --no-cache, at tingnan ang
epekto na may --verbose.

OPSYONAL KALENDARYO

Kung ang 'HTML::CalendarMonthSimple' na module ay magagamit ng bawat blog
naglalaman ng isang simpleng view ng buwan ng kasalukuyang buwan sa index.

Upang hindi paganahin ito, gamitin ang program gamit ang '--no-calendar'.

OPSYONAL NAGKOMENTO

Kasama sa chronicle code dapat mong mahanap ang file
cgi-bin/comments.cgi.

Ang file na ito ay idinisenyo upang magsulat ng mga isinumiteng komento sa lokal
filesystem ng iyong web-server. Kung i-install mo iyon, at i-edit ang
path sa simula ng script na dapat mong maisama
mga komento sa iyong blog.

Sa madaling salita, may tatlong bagay na kailangan mong gawin:

I-install ang CGI script at i-edit ang path sa simula.
Kopyahin ang mga komento sa output sa iyong lokal na pinagmumulan ng blog.
Patakbuhin muli ang script na ito gamit ang --comments=./path/to/comments

Dapat itong isama ang mga komento sa static na output. Higit pa
ang mga tahasang tagubilin ay ibinigay sa loob ng file na 'COMMENTS'
kasama sa pamamahagi.

Gumamit ng chronicle online gamit ang mga serbisyo ng onworks.net