Ophelia

Ofelija yra Python projektas sukuria XHTML puslapių šablonus, parašytų TAL, Zope Šablonas Įgūdis Language & nbsp;. Ji skirta mažinti kodas pasikartojimo nuliui.
Pakete yra tiek WSGI taikymą veikia Ofelija, taip pat prašymo prižiūrėtojas už mod_python, Python modulis Apache2 serveryje.
Dokumentacija failai Toliau cituojami galima rasti pakuotės viduje kataloge, kartu su doctests už modulių skaičius.
Įėjimo taškai
Po to, kai įdiegta Ophelia rašė keletą šablonų, kaip jūs galite padaryti jį padaryti tinklalapius?
Naudokite Ofelija su Apache
Python paketas yra modulio ophelia.modpython, kuri teikia prašymą prižiūrėtojas už mod_python Apache modulis.
Naudokite Ophelia kaip WSGI taikymo
Ofelija apibrėžia paraiškų klasę, atitinkantį WSGI standartą, PEP 333: ophelia.wsgi.Application. Galite pabandyti ją paleisdami Ophelia nuosavą wsgiref pagrindu HTTP serverį arba paleisti jį bet WSGI serverio galite rūpintis naudoti.
Wsgiref pagrindu serveris įdiegtas kaip Ofelija-wsgiref vykdomąjį jei Ofelija yra įdiegta kaip su "wsgiref" Ekstra leido kiaušinį. Jo scenarijus įvažiavimo yra ophelia.wsgi.wsgiref_server.
Savivartis atskirus puslapius į stdout
Vykdomąjį kuri visuomet įrengtas su Ofelija kiaušinis yra Ofelija-sąvartynas. Šis scenarijus yra Ofelija padaryti atsakymą, atitinkantį kelyje jūs nurodote, ir spausdina jį sys.stdout, pasirinktinai su HTTP antraščių. Scenarijus įrašas taškas yra ophelia.dump.dump.
Abu scenarijai pateikti keletą naudojimo instrukcijas, kai pavadino su help variantą. Jie skaito konfigūracijos failą; matyti CONFIGURATION.txt detales.
Kokios svetainių yra Ofelija gerai? "
Statinis turinys
Apsvarstykite Ophelia kaip VRP nuo narkotikų. Tai iš esmės nesiskiria, tik daug draugiškesnė ir pajėgesnė.
Naudokite Ophelia svetainių, kur jūs iš esmės rašyti savo HTML save, išskyrus tai, kad jums reikia parašyti kartojasi stuff tik vieną kartą. Sumažinti pasikartojimo nuliui ateina ne kaina: jūsų svetainė turi laikytis modelį Ofelija derinti savo šablonus teisingą kelią.
Apsvarstykite svetainės išdėstymą būti hierarchinė: ten bendra išvaizda į visus jūsų puslapius, skyriai turi tam tikrų savybių, ir kiekvienas puslapis turi unikalų turinį. Tai labai svarbu, kad Ofelija, kad ši hierarchija atspindi failų sistemos organizavimo savo dokumentus; kaip šablonai sujungti yra nustatomas iš jų vietų katalogų hierarchiją.
Dinaminis turinys
Ofelija daro Python kalbą prieinamą įskaitant dinaminį turinį. Kiekvienas šablonas failas gali apimti Python scenarijų. Python skriptus ir šablonai, prisidedantys prie puslapio dalis bendrą kintamųjų rinkinį, keisti ir naudoti.
Ophelia turinys modelis yra labai paprastas ir geriausiai veikia, jei kiekvienas turinio objektą, kurį skelbia yra pati vaizdas: puslapis tai yra atstovaujama. Jei jūs gaunate turinį iš išorinių šaltinių, vistiek (pvz duomenų bazę ar versijų kontrolės saugykla), tai dar gerai naudotis Ophelia net su keliais vaizdais per turinio objektą, kol objektas nuomonę nepriklauso nuo objekto tipo ar net objektą pati.
Bando naudoti Ophelia sudėtingesnio svetainėje bus negraži įsipainiojęs logikos ir pristatymas. Nenaudokite Ophelia svetainių, kurios iš tikrųjų yra interneto sąsajos su programų, turinio valdymo sistemos ir pan.
Kaip Ofelija darbai
Šablonų failai
Už kiekvieną prašymą, Ofelija ieško iš šablono failus skaičius. Tai užtrunka vieną failą, pavadintą "__init__" iš kiekvieno katalogo kelyje iš svetainės šaknis į puslapį, ir galutinę vieną paties puslapio. Prašymas įteiktas Ofelija, jei tai galutinis šablonas yra rasta.
Statant puslapį, puslapio šablonas yra įvertintas ir jo turinys saugomas, kas vadinama vidinis lizdas. Tada kiekvienas šablonas kelyje atgal iš į šaknies puslapyje yra įvertinamas, savo ruožtu, ir gali apimti esamą turinį vidinio angą. Rezultatas yra saugomi vidiniame angą, po kiekvieno žingsnio.
Perdirbimo root šabloną rezultatas ėjo puslapyje.
Python scenarijai
Kiekvienas šablonas failas gali pradėti su Python scenarijų. Tokiu atveju scenarijus yra atskirta nuo šablono pirmojo atsiradimo yra "" Tag nuo savo linijos (išskyrus tarpų į kairę arba į dešinę). Jei šablonas faile yra tik Python scenarijų, bet ne iš tikrųjų šabloną, įdėti "" Savo paskutinėje eilutėje.
Python scenarijai yra paleisti, kad nors važiuojantiems iš svetainės šaknis į puslapį. Jie paleisti toje pačioje vardų kintamųjų, kuris vėliau naudojamas kaip vertinimo kontekste šablonus. Kintamieji, kurie yra nustatyti pagal Python scenarijų gali būti panaudota ir pakeista bet scenarijus paleisti vėliau, taip pat pasakų posakių, naudojamų šablonų.
Vardų yra inicializuoti Ofelija su vienu kintama, __request__, kad nuorodos į užklausos objektą. Taigi, scenarijai turi prieigą prie užklausos detales ir norimų vidinės. Be to, siekdama nustatyti kintamuosius, scenarijai taip pat gali importuoti modulius, apibrėžti funkcijas, naudotis failų sistema, ir apskritai nieko Python programa gali padaryti tai.
Kaip Ofelija elgiasi
URL kanonizacją ir nukreipimas
Jei Ofelija susiduria URL, kuris atitinka į katalogą jis elgiasi panašiai kaip Apache jos numatytoji konfigūracija: Jei URL nesibaigia su velniop, ji bus nukreipti naršyklę pridėtumėte velniop. Jei velniop yra, jis bandys rasti šabloną, pavadintą index.html pagal nutylėjimą, ir padaryti jį kaip kataloge "indeksas".
Priklausomai nuo konfigūracijos, aiškūs prašymai katalogas rodyklėje gali būti nukreipti į pagimdė katalogas URL be galutinio kelio segmente. Tai savo ruožtu į.
Be to, Ofelija canonicalizes URL, kuriuose maršrutas segmentus "." ir ".." pagal RFC 3986 dėl bendrinio URI sintaksę, ir pašalina tuščias maršrutas segmentus, kurie yra ne į kelio pabaigos. Jei URL pasikeitė šių taisyklių, Ofelija nukreipia naršyklę pakeisti.
Mod_python prižiūrėtojas
Apache2 apdoroja etapais, kurių kiekvienas gali būti tvarkomi modulių, pavyzdžiui, mod_python prašymą. Ofelija suteikia mod_python prižiūrėtojas už turinį kartos etape. Jei Prašomas URL sukonfigūruota būti tvarkomi Ofelija, prižiūrėtojas bando rasti tinkamus šablonų failų sistemą ir sukurti puslapį nuo jų.
Ophelia anketa mod_python prižiūrėtojas niekada sukelia failas nerastas HTTP klaida. Vietoj to, jis eina kontrolę atgal į Apache ir kitų modulių, jeigu ji nustato, kad negali sukurti tam tikrą išteklių. Apache patenka atgal į aptarnauti statinį turinį iš disko šiuo atveju. Ofelija, todėl gali būti montuojami ant statinio svetainėje tvarkyti tik tuos prašymus, kurie šablonai egzistuoja šablono kataloge

Reikalavimai :.

• Python