AsciiDoc Website Builder

AsciiDoc Website Builder adalah program yang ditulis dengan Python yang memungkinkan Anda untuk menulis sebuah website dalam teks hampir polos (yaitu AsciiDoc), ditambah beberapa file konfigurasi yang sederhana. Ini ada untuk memecahkan masalah saya tidak pernah memperbarui website saya sendiri (yang digunakan banyak PHP) karena saya tidak bisa cepat mengingat begitu saja semua perubahan dan format tertentu yang saya butuhkan untuk menambah halaman baru.
Berikut adalah beberapa fitur kunci dari "AsciiDoc Website Builder":
· Sistem template Fleksibel
· Blog generasi
· Gambar generasi galeri
· Generasi sitemap.xml
· Semua fitur yummy AsciiDoc
Persiapan:
Untuk mulai menggunakan AWB Anda perlu menyiapkan setidaknya satu situs di file konfigurasi AWB pengguna Anda. Ini terletak di ~ / .awb / awb.conf Ini bisa terlihat seperti ini:
----
[Mywebsite]
siteroot: / home / me / mywebsite
baseurl: http: //my.web.site
Pilihan asciidoc: buku -d -b HTML4
----
Ini hanya mendefinisikan sebuah website dikenal AWB sebagai "mywebsite". Pilihannya adalah:
siteroot ::
Direktori root dari situs AWB. Sumber AsciiDoc tinggal di + siteroot / src +, dan output html pergi ke + siteroot / html +.
baseurl ::
Url akar website. Ini digunakan untuk menghasilkan sitemap.xml.
Pilihan asciidoc ::
Pilihan untuk diteruskan ke AsciiDoc. Saya menggunakan ini untuk menentukan file html4.conf kustom di samping opsi yang ditampilkan dalam contoh.
Setelah Anda website dikonfigurasi dan beberapa file sumber tertulis, hanya mengeluarkan perintah
----
% AWB mywebsite
----
AWB hanya akan diperbarui file HTML yang telah menjadi usang. Jika ini tidak bekerja untuk beberapa alasan, r pilihan dapat digunakan untuk memperbaikinya.
----
% AWB r mywebsite
----
Hal ini dapat dilakukan dari mana saja di filesystem. AWB tahu dari file konfigurasi di mana untuk membaca dari dan menulis ke.
awbdir.conf
-----------
Setiap direktori source mungkin berisi file konfigurasi bernama awbdir.conf. File ini menentukan pilihan-direktori khusus yang akan digunakan oleh AWB.
[Pengaturan dir] bagian
ketik ::
dapat menjadi salah satu 'normal', 'blog', atau 'galeri'. 'Normal' adalah default. Arti dari jenis yang dijelaskan di bawah ini.
nama ::
Sebuah nama deskriptif direktori, seperti yang ditunjukkan pada jejak breadcrumb.
awbdir.conf [blog] bagian
Bagian ini mendefinisikan pengaturan yang digunakan jika jenis direktori blog.
num pos utama ::
Jumlah posting untuk ditampilkan di halaman index.html blog.
num posting terbaru ::
Jumlah judul posting untuk menunjukkan di "posting terbaru" daftar, dan juga jumlah judul majalah untuk menunjukkan di "majalah baru-baru ini" daftar.
[User] bagian
Di sini Anda dapat menentukan pilihan apapun yang Anda suka. Hal ini dapat disebut dalam template. Hal ini berguna bila Anda ingin menggunakan template yang sama di seluruh situs, tetapi mengubah bagian kecil dari itu (misalnya. Gambar).
awbdir.conf pilihan kaskade dari direktori untuk anak-anaknya. Hal ini cukup nyaman, karena direktori anak hanya perlu mengganti opsi induk yang tidak berlaku. Satu-satunya pengecualian adalah nama direktori, yang tidak kaskade

Apa yang baru dalam rilis ini:.

• perbaikan Pembaruan ini masalah terpapar oleh rilis Python baru-baru ini yang menyebabkan AWB gagal sementara menentukan lokasi direktori konfigurasi.
• Cara mengatasinya memperkenalkan depenendency baru, python-xdg
.

Apa yang baru dalam versi 0.3.1:

• Opsi -l telah ditambahkan ke daftar semua situs
.
• Blog post format itu tetap menggunakan tanggal posting, tidak chan.
• Masalah dalam timestamp sitemap adalah tetap.
• Penggunaan String telah diupdate.
• deskripsi meta kosong tidak dimasukkan.
• menabrak dihindari sementara mendapatkan judul untuk file kosong.
• Manual dipindahkan ke lokasi yang terpisah.
• Perintah ditambahkan.
• docstring pembersihan dilakukan.

Apa yang baru dalam versi 0.3:.

• Rilis ini adalah produk akhir dari refactoring besar
• Seri 0.3 akan menjadi jalan untuk 1,0 rilis stabil.