Ophelia

Ophelia on Python hanke, joka luo XHTML sivuja malleja kirjoitettu TAL, Zope Template Taito Kieli. & Nbsp; Se on suunniteltu vähentämään koodin toistoa nollaan.
Paketti sisältää sekä WSGI sovellus käynnissä Ophelia sekä pyynnön käsittelijä mod_python, Python moduuli Apache2 web-palvelin.
Dokumentaatiotiedostoja mainittu alla löytyvät pakkauksen sisällä hakemistoon, sekä useita doctests moduulien.
Lähtökohtien
Kun olet asentanut Ophelia ja kirjoitti joitakin malleja, miten voit tehdä sen tehdä web-sivuja?
Käytä Ophelia Apache
Python paketti sisältää moduulin ophelia.modpython joka tarjoaa pyynnön käsittelijä mod_python Apache-moduuli.
Käytä Ophelia kuin WSGI sovellus
Ophelia määrittelee sovelluksen luokka yhteensopiva WSGI standardin, PEP 333: ophelia.wsgi.Application. Voit yrittää sen ajamalla Ophelia oma wsgiref perustuva HTTP-palvelimen tai ajaa se millään WSGI palvelin saatat välitä käyttää.
Wsgiref-pohjainen palvelin asennetaan Ophelia-wsgiref suoritettavaa jos Ophelia asennetaan muna "wsgiref" extra käytössä. Sen käsikirjoitus tulokohdan on ophelia.wsgi.wsgiref_server.
Dump yksittäisiä sivuja vakiotulosteeseen
Suoritettavan joka asennetaan aina Ophelia muna on Ophelia-dump. Tämä kirjoitus on Ophelia tekevät vastaus vastaavan polun voit määrittää, ja tulostaa sen sys.stdout, mahdollisesti HTTP-otsikoita. Skriptin tulokohdan on ophelia.dump.dump.
Molemmat skriptit tarjoavat joitakin käyttöohjeita kun maksoi help vaihtoehto. He lukevat asetustiedosto; katso CONFIGURATION.txt lisätietoja.
Millainen sivustoja on Ophelia hyvä?
Staattinen sisältö
Harkitse Ophelia SSI huumeita. Se ei ole olennaisesti erilaisia, vain paljon ystävällisempi ja kyvykkäämpiä.
Käytä Ophelia kohteisiin, joissa et periaatteessa kirjoittaa HTML itse, paitsi että sinun täytyy kirjoittaa toistuva tavaraa vain kerran. Vähentäminen toistoa nollaan on hintansa: sivustosi on noudatettava malli Ophelia yhdistää oman malleja oikealla tavalla.
Mieti sivuston ulkoasu on hierarkkinen: siellä yhteinen katsoa kaikki sivut, kohdat on tiettyjä ominaisuuksia, ja jokaisella sivulla on ainutlaatuista sisältöä. On tärkeää Ophelia että tämä hierarkia heijastuu tiedostojärjestelmän järjestäminen asiakirjoja; miten malleja yhdistää on johdettavissa niiden paikoista hierarkiassa hakemistoja.
Dynaaminen sisältö
Ophelia tekee Python saatavilla myös dynaamista sisältöä. Kukin malli tiedosto voi sisältää Python-skripti. Python skriptit ja malleja edistää sivu Jaa yhteiset muuttujat muuttaa ja käyttää.
Ophelia sisältö malli on hyvin yksinkertainen ja toimii parhaiten, jos jokainen sisältöolio julkaiset on oma näkemys: sivu se on edustettuna. Jos saat sisältöä ulkoisia resursseja muutenkin (esim tietokantaan tai versionhallinta arkistoon), se on silti ok käyttää Ophelia jopa useiden näkymät kohti sisältöolio kunhan objektin näkemykset eivät riipu objektin tyyppi tai jopa esine itse.
Yritetään käyttää Ophelia on monimutkaisempi sivusto johtaa ruma kietoutuminen logiikka ja esitys. Älä käytä Ophelia sivustoja, jotka ovat todella web-käyttöliittymiä sovelluksiin, sisällön hallintajärjestelmät ja vastaavat.
Miten Ophelia toimii
Mallitiedostot
Kunkin pyynnön, Ofelia etsii useita mallin tiedostoja. Se kestää yhden tiedoston nimeltä "__init__" jokaisesta hakemistosta polku sivuston juuresta sivulle, ja lopullinen yksi sivun itse. Pyyntö palvelee Ophelia jos lopullinen malli on löytynyt.
Kun rakennus, sivun lomakkeeseen arvioidaan ja sen sisältö tallennetaan ns sisäinen korttipaikka. Sitten jokaisen mallin matkalla takaisin sivun root arvioidaan puolestaan ​​ja voi sisältää nykyinen sisältö sisemmän raon. Tulos tallennetaan sisempi rako jokaisen vaiheen jälkeen.
Käsittelyn tuloksena juuri -malli on toiminut sivun.
Python skriptejä
Kukin malli tiedosto voi aloittaa Python skripti. Tällöin käsikirjoitus erotetaan mallin mukaan ensimmäinen esiintyminen "" Tag omalla rivillään (paitsi välilyönnillä vasemmalle tai oikealle). Jos malli tiedosto sisältää vain Python-skripti, mutta ei oikeastaan ​​mallin, laittaa "" Sen viimeinen rivi.
Python skriptit on suoritettu, jotta kulkiessaan sivuston juuresta sivulle. Ne kulkevat samassa nimiavaruuden muuttujia, jotka on myöhemmin käytetty arvioinnin yhteydessä malleja. Muuttujat, jotka on asetettu Python skripti voidaan käyttää ja muokata komentosarjoja ajaa myöhemmin, sekä Tales käytetyt ilmaisut malleja.
Nimitila alustetaan Ofelia jossa yksi muuttuja, __request__, joka viittaa pyynnön kohde. Siten skriptit saada pyynnöstä lisätietoja ja läpikäynti sisäosat. Lisäksi asetus muuttujia, skriptit voivat myös tuoda moduulit, määritellä funktioita, pääsy tiedostojärjestelmä, ja yleensä tehdä mitään Python ohjelma voi tehdä.
Miten Ophelia käyttäytyy
URL kanonisen ja uudelleenohjaus
Jos Ofelia kohtaa URL, joka vastaa hakemistoon se toimii samalla tavalla Apache oletuskokoonpanossa: Jos URL-osoite ei pääty vinoviiva, se ohjaa selaimen lisätä slash. Jos slash on siellä, se yrittää löytää mallin nimeltä index.html oletuksena, ja tehdä se hakemistoon "indeksi".
Kokoonpanosta riippuen nimenomaista pyyntöä hakemistoon hakemistosivujen voidaan ohjata paljain hakemistoon URL-ilman lopullista polku segmentti. Tämä kääntäisi osaksi.
Lisäksi Ophelia canonicalizes URL-sisältävät reittisegmentteihin "." ja ".." RFC 3986 geneerisistä URI syntaksi, ja poistaa tyhjät reittisegmentteihin jotka eivät ole lopussa polku. Jos URL-osoite on muuttunut näissä säännöissä, Ophelia ohjaa selaimen vastaavasti.
Mod_python käsittelijä
Apache2 käsittelee pyynnön vaiheissa, joista jokainen voidaan hoitaa moduuleja, kuten mod_python. Ophelia tarjoaa mod_python käsittelijä sisällön ideointi vaiheessa. Jos pyydetty URL on määritetty hoitaa Ophelia, ohjaajan yrittää löytää sopiva malleja tiedostojärjestelmä, ja rakentaa sivun niistä.
Ofelia mod_python käsittelijä koskaan saa tiedostoa ei löydy HTTP-virhe. Sen sijaan se antaa hallinnan takaisin Apache ja muut moduulit, jos se toteaa, se ei voi rakentaa tietty resurssi. Apache putoaa takaisin palvelevat staattista sisältöä levyltä tässä tapauksessa. Ophelia voidaan siten asentaa päälle staattisen sivuston käsitellä vain ne pyynnöt, joihin malleja olemassa mallipohjahakemistoon.

Vaatimukset :

• Python