Ophelia este un proiect Python care creează pagini XHTML din șabloane scrise în TAL, șablonul Zope Caracteristica Limba & nbsp;. Acesta este conceput pentru a reduce cod repetiție la zero.
Pachetul conține atât o aplicație care rulează WSGI Ophelia, precum și un handler cerere de mod_python, modulul Python pentru serverul de web Apache2.
Fișierele de documentare citate de mai jos poate fi găsit în interiorul directorul pachet, împreună cu un număr de doctests pentru modulele.
Puncte de intrare
După ce ați instalat Ophelia și a scris unele șabloane, cum poți face face pagini web?
Utilizați Ophelia cu Apache
Pachetul Python contine o ophelia.modpython modul care oferă un handler cerere pentru modulul mod_python Apache.
Folosiți Ophelia ca o aplicație WSGI
Ophelia definește o clasă cerere conformitate cu standardul WSGI, PEP 333: ophelia.wsgi.Application. Puteți fie să-l încercați rulând propriul server HTTP Opheliei pe bază de wsgiref sau a alerga prin orice server WSGI s-ar putea grijă să utilizați.
Serverul pe bază de wsgiref este instalat ca executabilul Ophelia-wsgiref dacă Ophelia este instalat ca un ou cu "wsgiref" extra-ului. Punctul său de intrare script este ophelia.wsgi.wsgiref_server.
Dump pagini individuale și le va afișa
Un executabil care este întotdeauna instalat cu ovulul Ophelia este Ophelia-benă. Acest script are Ophelia face răspunsul corespunzător la calea pe care o specificați, și imprimă-l la sys.stdout, opțional cu antete HTTP. Punct de intrare Scenariul este ophelia.dump.dump.
Ambele scripturi oferi câteva instrucțiuni de utilizare atunci când este solicitat cu opțiunea --help. Ei citesc un fișier de configurare; vezi CONFIGURATION.txt pentru detalii.
Ce fel de site-uri este Ophelia bun pentru?
Conținut static
Luați în considerare Ophelia ca SSI privind drogurile. Nu e fundamental diferit, doar o mulțime mai prietenos și mai capabil.
Utilizați Ophelia pentru site-urile unde scrie, practic HTML ta le cu excepția faptului că aveți nevoie de a scrie lucruri recurentă doar o singură dată. Reducerea repetiție la zero vine la un preț: site-ul dvs. trebuie să urmeze un model pentru Ophelia a combina șabloanele pe minge.
Luați în considerare aspectul site-ului dvs. pentru a fi ierarhică: există un aspect comun pentru toate paginile, secțiunile au anumite caracteristici, și fiecare pagină are un conținut unic. Este esențial să se Ophelia că această ierarhie reflectă în organizarea sistemului de fișiere de documente; cum template-uri combina se deduce din locurile lor în ierarhia de directoare.
Conținut dinamic
Ophelia face limbajul Python disponibil pentru inclusiv conținut dinamic. Fiecare fișier șablon poate include un script Python. Script Python și șabloane care contribuie la o cotă pagină un set comun de variabile pentru a modifica și de a folosi.
Modelul de conținut Ophelia este foarte simplu și funcționează cel mai bine dacă fiecare obiect conținut vă publica este proprie vedere: pagina este reprezentată pe. Dacă aveți conținut de la resurse externe oricum (de exemplu, o bază de date sau un depozit de control versiune), este încă OK pentru a utiliza Ophelia, chiar cu mai multe vederi pe obiect conținut atâta timp cât opiniile unui obiect nu depind de tipul obiectului sau chiar obiect în sine.
Încercarea de a utiliza Ophelia pe un site mai complex va duce la o incurcatura urât de logică și de prezentare. Nu utilizați Ophelia pentru site-urile care sunt de fapt interfete web la aplicații, sisteme de management de conținut și altele asemenea.
Cum Ophelia funcționează
Fișierele șablon
Pentru fiecare cerere, Ophelia caută un număr de fișiere șablon. Este nevoie de un fișier numit "__init__" de la fiecare director pe calea de la radacina site-ul la pagina, și una finală pentru pagina în sine. Cererea este deservit de Ophelia dacă această șablon finală este găsit.
La construirea pagina, șablon pagina este evaluat și conținutul său stocat în ceea ce se numește slotul interior. Apoi, fiecare șablon pe drumul de intoarcere de la pagina la rădăcina este evaluat la rândul său și poate include actualul conținut al slot interior. Rezultatul este stocat în fanta interioară după fiecare etapă.
Rezultatul prelucrării șablonului rădăcină este servit ca pagina.
Script Python
Fiecare fișier șablon poate începe cu un script Python. În acest caz, scenariul este separat de modelul de prima apariție a unui "
Script Python sunt executate în ordine în timp ce traversează de la rădăcină site-ul la pagina. Acestea sunt conduse în același namespace de variabile care este ulterior utilizat ca contextul evaluare a template-uri. Variabilele care sunt stabilite de un script Python poate fi utilizat și modificat de orice script-uri rula mai târziu, precum și de poveștile expresiile utilizate în șabloanele.
Spațiul de nume este inițializată de Ophelia cu un variabil unic, __request__, care face referire la obiectul cererii. Astfel, script-uri au acces la detalii de solicitare și interne traversal. În plus față de variabilele de stabilire, script-uri pot, de asemenea, importa module, pentru a defini funcții, accesați sistemul de fișiere, precum și, în general, face orice un program de Python poate face.
Cum Ophelia se comportă
Canonicalization URL-ul și redirecționarea
În cazul în care Ophelia întâlnește un URL care corespunde unui director se comportă similar cu Apache în configurația implicită: Dacă URL-ul nu se termină cu un caracter slash, se va redirecționa browser pentru a adăuga slash. În cazul în care slash este acolo, va încerca să găsească un șablon numit index.html în mod implicit, și îl fac ca director "index".
În funcție de configurație, cererile explicite pentru pagini de index director poate fi redirecționat către URL-uri goale director fără segmentul de cale finală. Acest lucru ar transforma
În plus, Ophelia canonicalizes URL-uri care conțin segmente de cale "." și ".." în conformitate cu RFC 3986 pe sintaxă generic URI, și elimină segmentele de cale goale care nu sunt la capătul căii. Dacă URL-ul este schimbat de aceste norme, Ophelia redirecționează browserul în consecință.
Handler mod_python
Apache2 procesează o cerere în etape, fiecare dintre care pot fi tratate prin module, cum ar fi mod_python. Ophelia oferă un handler mod_python pentru faza de generare de conținut. În cazul în care un URL solicitată este configurat pentru a fi manevrate de Ophelia, handler încearcă să găsească șabloane adecvate în sistemul de fișiere, și de a construi o pagina de la ei.
Handler mod_python Ophelia lui nu determină un fișier nu a fost găsit de eroare HTTP. În schimb, ea trece de control înapoi la Apache și alte module cazul în care constată că nu poate construi o anumită resursă. Apache revine la servire conținut static de disc în acest caz. Ophelia poate fi astfel instalat pe partea de sus a unui site static să se ocupe de aceste cereri doar pentru care există șabloane în directorul șablon
Cerințe :.
- Python
Comentariile nu a fost găsit