Ophelia

Ophelia je Python projekt, který vytváří XHTML stránky z šablon napsaných v TAL, Zope Template atribut jazyka. & Nbsp; Je navržen tak, aby snížení kód opakování na nulu.
Balíček obsahuje i aplikaci běžící WSGI Ophelia, stejně jako žádost o ovladač pro mod_python, modul Pythonu pro webový server apache2.
Dokumentace soubory níže citované lze nalézt v adresáři balíčku, spolu s řadou doctesty pro moduly.
Vstupní body
Po instalaci Ophelia a napsal několik šablon, jak můžete dělat to vykreslení webové stránky?
Používejte Ophelia s Apache
Balíček Python obsahuje modul ophelia.modpython, který poskytuje požadavku zpracování pro modul mod_python Apache.
Použití Ophelia jako aplikace WSGI
Ophelia definuje třídu aplikace kompatibilní se standardem WSGI, PEP 333: ophelia.wsgi.Application. Můžete to buď zkusit ji spuštěním vlastního wsgiref na bázi HTTP server, Ophelia, nebo spustit jakoukoli WSGI serveru, který by se o použití.
Server wsgiref bázi je instalován jako Ofélie-wsgiref spustitelný soubor v případě, Ophelia je instalován jako vejce s "wsgiref" navíc povolena. Jeho vstupní script bod je ophelia.wsgi.wsgiref_server.
Dump jednotlivé stránky na standardní výstup
Spustitelný který je vždy nainstalována s Ophelia vejce je Ofélie-dump. Tento skript má Ophelia činí reakci odpovídající cestu, kterou určíte, a vytiskne jej sys.stdout, případně s HTTP hlaviček. Vstupní bod Skript je ophelia.dump.dump.
Oba skripty poskytují některé pokyny k použití při volání pomocí --help možnost. Čtou konfiguračního souboru; viz CONFIGURATION.txt podrobnosti.
Jaký druh míst je Ophelia dobré?
Statický obsah
Zvažte Ophelia as SSI na drogách. Je to v podstatě neliší, jen mnohem přátelštější a schopnější.
Použití Ophelia na stránky, kde si v podstatě napsat svůj HTML sami, kromě toho, že je třeba napsat opakující věci pouze jednou. Snížení opakování na nulu je v ceně: vaše stránky musí následovat vzor pro Ophelia kombinovat šablony správnou cestu.
Zvažte rozložení svých stránek na hierarchický: tam je společný pohled na všechny vaše stránky, sekce mají určité vlastnosti, a každá strana má jedinečný obsah. Je velmi důležité, aby Ophelia, že tato hierarchie odráží v systému souborů organizaci dokumentů; jak šablony kombinovat je odvozeno ze svých míst v hierarchii adresářů.
Dynamický obsah
Ophelia dělá jazyk k dispozici pro zahrnutí dynamický obsah Python. Každý soubor šablony mohou obsahovat skript se. Python skripty a šablony, které přispívají k podílu stránku společný soubor proměnných měnit a používat.
Ophelia model obsah je velmi jednoduchá a funguje nejlépe, když každý objekt obsah publikovat, je jeho vlastní názor: stránka je zastoupena. Pokud se vám obsah z externích zdrojů, stejně (např databázi nebo pro správu verzí úložiště), je to stále v pořádku použít Ofélie i s několika pohledy na obsah objektu, tak dlouho, jak pohlíží na objektu nejsou závislé na typu objektu, nebo dokonce objekt sám.
Snažím se používat Ophelia na složitější místa povede k ošklivé zapletení logiky a prezentace. Nepoužívejte Ophelia na stránky, které jsou ve skutečnosti webové rozhraní k aplikacím, systémy pro správu obsahu a podobně.
Jak Ophelia práce
Soubory šablon
Pro každý požadavek, Ophelia hledá pro řadu souborů šablon. Trvá jeden soubor s názvem "__init__" z každého adresáře na cestě z místa kořene na stránku, a poslední jeden na samotné stránce. Žádost se podává prostřednictvím Ophelia, pokud se zjistí, že konečný šablona.
Při vytváření stránky, šablony na stránku je vyhodnocena a její obsah uložený v tom, co se nazývá vnitřní slot. Pak se každý šablona na zpáteční cestě ze stránky ke kořenu je hodnocena v pořadí a mohou obsahovat aktuální obsah vnitřního slotu. Výsledek je uložen ve vnitřním otvoru po každém kroku.
Výsledkem zpracování kořenové šablonu se podává jako stránku.
Python skripty
Každý soubor šablony se může začít s Python skriptu. V tomto případě, skript je oddělen od šablony prvním výskytu "" Značku na řadě vlastní (s výjimkou mezery vlevo nebo vpravo). Je-li soubor šablony obsahuje pouze skript se, ale ne ve skutečnosti šablonu, dal "" Ve svém posledním řádku.
Python skripty jsou prováděny v pořadí, když prochází z webu kořene na stránku. Oni jsou provozovány ve stejném oboru názvů proměnných, které je později použita jako hodnotící rámci šablon. Proměnné, které jsou nastaveny podle Python skriptu mohou být použity, a modifikován jakýmkoliv skripty spustit později, jakož i příběhy Výrazy použité v šablonách.
Jmenný prostor je inicializován Ofélie s jedinou proměnnou, __request__, která odkazuje na požadavek objektu. Tak, skripty mají přístup k podrobnostem vyžádání a traversal vestaveb. Kromě nastavení proměnných, skripty mohou také importovat moduly, definovat funkce, přístup k systému souborů, a obecně dělat něco programu Python může udělat.
Jak Ophelia chová
URL kanonikalizace a přesměrování
Pokud Ophelia narazí na adresu URL, která odpovídá adresáře se chová podobně jako Apache ve výchozí konfiguraci: V případě, že adresa URL nekončí lomítkem, bude to přesměruje prohlížeč přidat lomítko. Pokud lomítkem je tam, pokusí se najít šablonu s názvem index.html ve výchozím nastavení, a činí ji jako adresáře "index".
V závislosti na konfiguraci, explicitní žádosti o indexu adresář stránek může být přesměrován na holé adresáře URL bez závěrečné části dráhy. To by se obrátit na.
Kromě toho, Ophelia canonicalizes adresy URL, které obsahují segmenty cesty "." a ".." podle RFC 3986 na generické syntaxi URI, a odstraňuje prázdné segmenty cesty, které nejsou na konci cesty. Je-li adresa URL se změní těmito pravidly, Ophelia přesměruje prohlížeč způsobem.
Psovod mod_python
Apache2 zpracovává žádosti v etapách, z nichž každá může být řešeny prostřednictvím modulů, jako jsou mod_python. Ophelia poskytuje mod_python ovladače fázi generace obsahu. Pokud URL je nakonfigurován tak, aby byly zpracovány Ofélie, psovod se snaží najít vhodné šablony v systému souborů, a vytvořit stránku z nich.
Mod_python handler Oféliin nikdy způsobí soubor nebyl nalezen chyba HTTP. Místo toho, předá řízení zpět Apache a další moduly, pokud zjistí, že nemůže vytvořit konkrétní zdroj. Apache padá zpět na porci statický obsah z disku v tomto případě. Ophelia tak může být instalován na vrcholu statické stránce zvládnout jen ty žádosti, u nichž existují šablony v adresáři šablony

Požadavky na :.

• Python