Bu, Ubuntu Online, Fedora Online, Windows çevrimiçi emülatörü veya MAC OS çevrimiçi emülatörü gibi birden fazla ücretsiz çevrimiçi iş istasyonumuzdan birini kullanarak OnWorks ücretsiz barındırma sağlayıcısında çalıştırılabilen komut dosyasıdır.
Program:
ADI
Chronicle - Basit bir blog derleyicisi.
SİNOPSİS
kronik [seçenekler]
Yol Seçenekleri:
--comments İsteğe bağlı yorumlar dizinine giden yolu belirtin.
--config Okunacak bir yapılandırma dosyası belirtin.
--input Kullanılacak giriş dizinini belirtin.
--output Çıktının yazılacağı dizini belirtin.
--theme-dir Tema şablonlarının yolunu belirtin.
--theme Kullanılacak temayı belirtin.
--pattern Üzerinde çalışılacak dosyaların modelini belirtin.
--url-prefix Canlı blogun önekini belirtin.
--sitemap-prefix Site haritası için önek belirtin.
Blog Giriş Seçenekleri:
--format Girişlerinizin biçimini belirtin, HTML/tekstil/markdown.
Oluşturma Öncesi ve Sonrası Komutlar:
--pre-build Blogu oluşturmadan önce yürütülecek bir komut belirtin.
--post-build Blog oluşturulduktan sonra yürütülecek bir komut belirtin.
--pre-filter Her blog girişini HTML dönüştürmeden önce filtrelemek için bir komut.
--post-filter HTML dönüşümünden sonra her blog girişini filtrelemek için bir komut.
Sıralama Seçenekleri:
--recent-dates-first Arşiv görünümünde önce son girişleri göster.
--recent-tags-first Etiket görünümünde önce son girişleri göster.
Sayma Seçenekleri:
--entry-count=N Dizinde gösterilecek gönderi sayısı.
--rss-count=N RSS dizin beslemesine dahil edilecek gönderi sayısı.
Opsiyonel Özellikler:
--author Yazarın e-posta adresini belirtin
--comment-days Yorumları kabul etmek için maksimum gönderi yaşını belirtin.
--date-archive-path Arşive tarihi ekleyin.
--force Blog temasından statik dosyaların kopyalanmasını zorlayın.
--lang Tarihleri biçimlendirmek için kullanılacak dili belirtin.
--lower-case Çıktı alınan tüm dosya adlarını küçük harfle yazın.
--no-archive Bir arşiv sayfası oluşturmayın.
--no-cache Varsa bile isteğe bağlı memcached özelliklerini kullanmayın.
--no-calendar Dizinde isteğe bağlı takvimi kullanmayın.
--no-comments Yorumların yayınlanmasına izin verme.
--no-sitemap Bir site haritası oluşturmayın.
--no-tags Herhangi bir etiket sayfası oluşturma.
--no-xrefs Herhangi bir çapraz referans üretmeyin.
Yardım Seçenekleri:
--help Bu komut dosyası için yardım bilgilerini göster.
--manual Bu komut dosyasının kılavuzunu okuyun.
--verbose Yararlı hata ayıklama bilgilerini göster.
--version Sürüm numarasını göster ve çık.
HAKKIMIZDA
Chronicle, bir metin dosyası koleksiyonunu dönüştürmek için basit bir araçtır.
tek bir dizinde, statikten oluşan bir bloga
HTML dosyaları.
Yalnızca gerekli olan minimum özellikleri destekler
kullanışlı olmak:
* Etiketleme desteği.
* RSS desteği.
* Arşiv desteği.
bariz eksiklikler şunlardır:
* Anında yorum için destek eksikliği.
* Geri ping/geri izleme desteği eksikliği.
Sağlam, kararlı ve kullanışlı bir sistem olduğunu söyledikten sonra.
BLOG FORMAT
İşlediğimiz metin dosyalarının formatı çıktı için kritik öneme sahiptir.
sayfalar. Her giriş şöyle görünmelidir:
Başlık: Bu, blog gönderisinin başlığıdır
Tarih: 2 Mart 2007
Etiketler: bir, iki, üç, uzun etiket
Girişinizin metni buraya gelir.
NOT: Başlık, girişin gövdesinden en az bir
tek boş satır.
Bu örnekte, girişin kendisinin önceden yazıldığını görebiliriz.
küçük bir başlık ile. Bir giriş başlığı üç isteğe bağlı satır içerir,
bunlar mevcut değilse, açıklandığı gibi makul varsayılanlar vardır.
altında.
Çıktı tarihlerinin formatı, aşağıdakiler kullanılarak değiştirilebilir:
B<--lang> komut satırı seçeneği (veya
yapılandırma dosyası), ancak girişin tarihi de belirtilmelidir.
İngilizce.
Başlık: Yazının başlığını tanımlar. Mevcut değilse, girişin dosya adı kullanılır
Bunun yerine. "Konu:" da kullanılabilir.
Konu: Bu, 'Başlık:' ile eşanlamlıdır.
Tarih: Yazının yazıldığı tarih. Mevcut değilse, dosyanın oluşturulma zamanı kullanılır
yerine.
Yayınla: Bu başlık tüm girdilerden kaldırılır ve kronik biriktirici tarafından kullanılır
komut.
Etiketler: Girişle ilişkilendirilmesi gereken, virgülle ayrılmış tüm etiketler.
Girişin biçiminin HTML olduğu varsayılır, ancak destek vardır
girdilerinizi hem tekstil hem de markdown formatlarında yazmak için.
Girişlerin formatı, B<--format> argümanı aracılığıyla belirtilir veya
Chroniclerc dosyanızdaki bir "format: foo" ayarı aracılığıyla.
Girişlerin formatının genel olduğu varsayılır; tüm girdilerin bu kadar
aynı formatta olduğu varsayılacaktır. Ancak bir ekleyebilirsiniz
"format: foo" yazmak istiyorsanız, belirli girişlere sözde başlık
farklı bir biçimde belirli girişler.
Girişlerin işlenmesinde esneklik sağlamak için her blog girişi
filtre komut dosyası B'den geçirilecek
bu, bu işlemeyi tek bir konumda değiştirmenize olanak tanır. Bu
komut dosyası, girişlerin hem öncesi hem de sonrası filtreler aracılığıyla güncellenmesine izin verir
HTML'ye dönüştürme. Daha fazla ayrıntı için lütfen kılavuz sayfasına bakın.
o komut dosyası.
YAPILANDIRMA
Yazılımın konfigürasyonu minimum düzeydedir ve genellikle gerçekleştirilir
komut satırı argümanları aracılığıyla. Ancak ayarları kaydetmek mümkündür
global /etc/chroniclerc dosyasında veya kullanıcı başına ~/.kroniklerc
dosyası.
Dilerseniz başka bir yapılandırma dosyasının adını şu adrese iletebilirsiniz:
B<--config> bayrağına sahip komut dosyası. Bundan sonra okunacak
önceki iki dosya ve mevcut olan herhangi bir ayarı geçersiz kılabilir.
Yapılandırma dosyası aşağıdaki gibi satırlar içerir:
girdi = /home/me/blog
çıktı = /var/www/blog
biçim = işaretleme
Bilinmeyen anahtarlar yoksayılır.
İSTEĞE BAĞLI ÖNBELLEĞE ALMAK
Büyük bir blogun yeniden oluşturulmasını hızlandırmak için derleyici yerel bir
Yüklü ve mevcutsa, Memcached arka plan programı.
Bunu kurmak için bir Debian GNU/Linux sistemi altında lütfen şunu çalıştırın:
apt-get update
apt-get yükleme memcached libcache-memcached-perl
Bu önbelleğe alma davranışını --no-cache ile devre dışı bırakabilir ve
--verbose ile etki.
İSTEĞE BAĞLI TAKVİM
'HTML::CalendarMonthSimple' modülü mevcutsa, her blog
dizinde geçerli ayın basit bir ay görünümünü içerir.
Bunu devre dışı bırakmak için programı '--no-calendar' ile çağırın.
İSTEĞE BAĞLI YORUMLAMA
Chronicle koduna dahil olan dosyayı bulmalısınız.
cgi-bin/yorumlar.cgi.
Bu dosya, gönderilen yorumları yerel yönetime yazmak için tasarlanmıştır.
web sunucunuzun dosya sistemi. Bunu yüklerseniz ve düzenlerseniz
komut dosyasının başlangıcındaki yol dahil edebilmelisiniz
blogunuzdaki yorumlar.
Kısacası yapmanız gereken üç şey var:
CGI betiğini kurun ve başlangıçtaki yolu düzenleyin.
Çıktı yorumlarını yerel blog kaynağınıza kopyalayın.
Bu betiği --comments=./path/to/comments ile tekrar çalıştırın
Bu, statik çıktıdaki yorumları içermelidir. Daha
açık talimatlar 'YORUMLAR' dosyasında sağlanır
dağıtıma dahil edilmiştir.
onworks.net hizmetlerini kullanarak Chronicle'ı çevrimiçi kullanın
