AsciiDoc Website Builder je program napsaný v Pythonu, který umožňuje psát webové stránky v téměř prostý text (tj AsciiDoc), plus několik jednoduchých konfiguračních souborů. Existuje vyřešit můj problém nikdy aktualizaci své vlastní webové stránky (který používal hodně PHP), protože jsem nemohl rychle vzpomenout offhand všechny změny a specifické formátování Potřeboval jsem přidat nové stránky.
Zde jsou některé klíčové rysy "AsciiDoc webová stránka Builder":
· Flexibilní systém šablon
· Blog generace
· Galerie obrázků generace
· Sitemap.xml generace
· Všechny báječný funkce AsciiDoc
Začínáme:
Chcete-li začít používat AWB musíte nastavit alespoň jednu webovou stránku ve vašem uživatelském konfiguračním souboru AWB. To se nachází v ~ / .awb / awb.conf Mohlo by to vypadat nějak takhle:
----
[MyWebsite]
siteroot: / home / me / myWebsite
baseURL: http: //my.web.site
Možnosti asciidoc: -d kniha -b HTML4
----
To jednoduše definuje webové stránky, je známo, že AWB jako "myWebsite". Možnosti jsou následující:
siteroot ::
Kořenový adresář na AWB webových stránek. Zdroj AsciiDoc žije + siteroot / src +, a html výstup jde do + siteroot / html +.
baseURL ::
Url kořene webu. To se používá pro generování sitemap.xml.
Možnosti asciidoc ::
Volby mají být předány do AsciiDoc. Používám to určit vlastní html4.conf souboru vedle možnosti uvedené v příkladu.
Poté, co jste webové stránky nakonfigurovány a některé zdrojové soubory napsáno, jednoduše zadejte příkaz
----
% AWB myWebsite
----
AWB bude jen regenerovat HTML soubory, které se staly zastaralé. Pokud to nefunguje z nějakého důvodu, možnost r lze opravit.
----
% AWB -r myWebsite
----
To lze provést z libovolného místa v souborovém systému. AWB zná ze svého konfiguračního souboru, kam se číst a zapisovat na.
awbdir.conf
-----------
Každý adresář ve zdrojovém stromu může obsahovat konfigurační soubor s názvem awbdir.conf. Tento soubor určuje možnosti adresář specifické které se budou používat AWB.
[Dir setup] oddíl
typ ::
může být jeden z "normální", "blog", nebo "galerie". "Normální" je výchozí. Význam těchto typů je vysvětleno níže.
jméno ::
Popisný název adresáře, jak je uvedeno v strouhanka stezka.
awbdir.conf [blog] Sekce
Tato část definuje nastavení použít, pokud je typ adresář je blog.
num hlavní příspěvky ::
Počet pracovních míst pro zobrazení na stránce index.html blogu.
num poslední příspěvky ::
Počet poštovních titulů zobrazit v "Poslední příspěvky" seznamu, a také počet titulů časopisů ukázat v "poslední časopisy" seznamu.
[User] Sekce
Zde je možné definovat libovolnou možnost se vám líbí. To může být uvedená v šabloně. To je užitečné, když chcete použít stejnou šablonu na daném místě, ale změnit malé části z ní (např. Fotografie).
awbdir.conf možnosti kaskády z adresáře k jeho dětem. To je docela pohodlné, protože dítě adresáře stačí přepsat pouze možnosti, nadřazené, které se nevztahují. Jedinou výjimkou je název adresáře, který není kaskáda
Co je nového v této verzi:.
- Tato aktualizace opravuje problém vystavena posledních Pythonu zpráv, které způsobily AWB k selhání, zatímco určení umístění jeho konfiguračním adresáři.
- Oprava zavádí nový depenendency, python-xdg.
Co je nového ve verzi 0.3.1:
- -l Byla přidána možnost vypsat všechny weby .
- formátování Blog příspěvek byl opraven používat termín příspěvek, ne mtime.
- problémem mapa stránek časového razítka byla opravena.
- řetězec využití byl aktualizován.
- Prázdné meta popisy nejsou vloženy.
- burácení se vyhnout a zároveň získat titul za prázdného souboru.
- manuál byl přesunut do jiného místa.
- příkaz byl přidán.
- dokumentačního řetězce vyčištění bylo provedeno.
Co je nového ve verzi 0.3:.
- Tato verze je konečným produktem velkého refaktorováním
- Řada 0.3 bude cesta ke stabilnímu 1,0 verzi.
Komentáře nebyl nalezen