AsciiDoc Website Builder

AsciiDoc Website Builder є програма, написана на Python, що дозволяє писати сайт в майже прямим текстом (тобто AsciiDoc), а також кілька простих конфігураційних файлів. Вона існує, щоб вирішити мою проблему, ніколи не оновлюю свій власний веб-сайт (який використовується багато PHP), тому що я не міг швидко запам'ятати навскидку всі зміни і певне форматування мені потрібно, щоб додати нові сторінки.
Ось деякі ключові особливості "AsciiDoc Сайт Будівельник":
· Гнучка система шаблонів
· Покоління Блог
· Фотогалерея покоління
· Покоління sitemap.xml
· Все смачне особливості AsciiDoc
Починаємо:
Щоб почати використовувати AWB, ви повинні встановити принаймні один веб-сайт в конфігураційному файлі AWB користувача. Це знаходиться в ~ / .awb / awb.conf Це може виглядати приблизно так:
----
[МойВебСайт]
кореня сайту: / Головна / ME / МойВебСайт
BaseUrl: HTTP: //my.web.site
Варіанти asciidoc: -d книга -b HTML4
----
Це просто визначає веб-сайт як відомо, AWB, як "МойВебСайт". Можливі варіанти:
кореня сайту ::
Кореневий каталог AWB сайті. Джерело AsciiDoc живе в + кореня сайту / SRC + і HTML висновок йде в + кореня сайту / HTML +.
BaseUrl ::
URL кореня сайту. Це використовується для генерації sitemap.xml.
Варіанти asciidoc ::
Опції повинні бути передані AsciiDoc. Я використовую це, щоб вказати користувальницький файл html4.conf на додаток до опцій, представленим у прикладі.
Після того як ви сайт налаштований і деякі вихідні файли написані, просто виконайте команду
----
% AWB МойВебСайт
----
AWB тільки відновити HTML файли, які застаріли. Якщо це не працює, чомусь, опція -r можна використовувати, щоб виправити це.
----
% AWB -r МойВебСайт
----
Це може бути зроблено з будь-якого місця у файловій системі. AWB знає зі свого конфігураційного файлу, де читати і писати.
awbdir.conf
-----------
Кожен каталог в дерево вихідних текстів може містити файл конфігурації з ім'ям awbdir.conf. Цей файл визначає параметри каталогів конкретних, які будуть використовуватися AWB.
Секція [DIR Setup]
Тип ::
може бути одним з "нормальний", "блог", або "Галерея". «Нормальний» є за замовчуванням. Значення типів пояснюється нижче.
Ім'я ::
Описову назву каталогу, як показано на пройденого шляху.
awbdir.conf розділ [Блог]
Цей розділ визначає параметри, використовувані при тип каталог блог.
NUM основні повідомлень ::
Кількість повідомлень, щоб показати на сторінці index.html блогу.
NUM Останні повідомлення ::
Кількість назв поштових показати в "Останні повідомлення" список, а також кількість назв журналів, щоб показати в "останні журналів" список.
Секція [користувач]
Тут ви можете задати будь-який варіант вам подобається. Це можуть бути віднесені в шаблоні. Це корисно, коли ви хочете використовувати один і той же шаблон через сайт, але змінити дрібні деталі з нього (наприклад ,. Зображення).
awbdir.conf варіанти каскад з каталогу своїх дітей. Це досить зручно, так як дитина каталоги повинні бути тільки перевизначити параметри батька, який не застосовуються. Єдиним винятком є ​​ім'я каталогу, яка не каскаду

Що нового У цьому випуску :.

• Це оновлення усуває Проблема викрито останніх версіях Python, які викликали AWB на провал при визначенні місця розташування своєму каталозі конфігурації.
• виправлення вводить новий depenendency, Python-XDG.

Що нового у версії 0.3.1:

• -l опція була додана в список всі сайти .
• Повідомлення в блозі форматування було зафіксовано в експлуатацію Термін служби, що не час зміни.
• проблема в мапа сайту міткою часу було зафіксовано.
• Рядок Застосування був оновлений.
• Порожні мета опису не встановлена.
• збоями уникнути при отриманні звання для порожнього файлу.
• керівництво було перенесено в окрему папку.
• був доданий команда.
• рядок документації очищення й було зроблено.

Що нового у версії 0.3 :.

• Цей реліз є кінцевим продуктом великого рефакторінга
• Серія 0,3 буде шлях до стабільної версії 1.0.