Ophelia

Офелия е Python проект, който създава XHTML страници от шаблони, написани на TAL, на Zope шаблон атрибут Language & Nbsp;. Тя е предназначена да намали повтаряне на нула.
Пакетът съдържа както заявление WSGI течаща Офелия, както и заявките за mod_python, модулът Python за Apache2 уеб сървъра.
Документация файлове, цитирани по-долу могат да бъдат намерени в директорията, опаковка, заедно с редица doctests за модулите.
<Силен> входни точки
След като сте инсталирали Офелия и написа някои шаблони, как може да се направи го правят уеб страници?
Използвайте Офелия с Apache
Пакетът за Python съдържа модул ophelia.modpython, който осигурява по заявките за модул mod_python Apache.
Използвайте Офелия като приложение WSGI
Офелия дефинира клас заявление съвместим със стандарта WSGI, PEP 333: ophelia.wsgi.Application. Можете да го пробвате, като пуснете Офелия собствена wsgiref базиран HTTP сървър или да се стартира от всяко WSGI сървър може да се грижи за използване.
Сървърът за wsgiref базиран се инсталира като изпълнимия Офелия-wsgiref ако Офелия е инсталиран като яйце с "wsgiref" екстра активиран. Неговият пост скрипт точка е ophelia.wsgi.wsgiref_server.
Самосвал единични страници за стандартния изход
Изпълним, която винаги се инсталира с Офелия яйцето е Офелия-сметището. Този сценарий е Офелия прави отговора, съответстващ на пътя, който уточни, и го отпечатва да sys.stdout, евентуално с HTTP хедъри. Входна точка Сценарият е ophelia.dump.dump.
И двете азбуки предоставят някои инструкции за употреба, когато нарича с --help опция. Те четат конфигурационен файл; виж CONFIGURATION.txt за подробности.
<Силен> Какви сайтове е Офелия заслужава?
Статично съдържание
Помислете Офелия като SSI на наркотици. Това не е коренно различна, просто много по-приятелски и по-способни.
Използвайте Офелия за сайтове, където можете основно напишете своето HTML себе си, с изключение на това, което трябва пишете на повтарящ неща само веднъж. Намаляване на повторение на нула си има цена: вашия сайт, трябва да следва модела за Офелия да комбинирате вашите шаблони по правилния начин.
Помислете оформлението на сайта си, за да бъде йерархична: има общ поглед на всички ваши страници, раздели имат определени характеристики, като всяка страница има уникално съдържание. Това е от решаващо значение за Офелия, че тази йерархия отразява в организацията на файловата система на вашите документи; как шаблони съчетават се заключи от местата им в йерархията на директориите.
Динамично съдържание
Офелия прави на езика на разположение за включително динамично съдържание Python. Всеки шаблон файл може да включва Python скрипт. Python скриптове и шаблони, които допринасят за акция на страницата на общ набор от променливи, които да модифицирате и използване.
Модел съдържание на Офелия е много проста и работи най-добре, ако всяка съдържание обект публикувате е неговото лично мнение: страницата тя е представена на. Ако получите съдържание от външни ресурси, така или иначе (например база данни или контрол на версиите хранилище), тя все още е ОК, за да използвате Офелия дори с няколко показвания на съдържание обект толкова дълго, колкото е видяна на даден обект, не зависят от типа на обекта или дори на обекта себе си.
Опитвайки се да използвате Офелия по-сложен сайт ще доведе до грозна оплитане на логика и презентация. Не използвайте Офелия за сайтове, които са всъщност уеб интерфейси към приложения, системи за управление на съдържание и други подобни.
<Силен> Как работи Офелия
Шаблон файлове
За всяка заявка, Офелия търси редица шаблонни файлове. Това отнема един файл с име "__init__" от всяка директория на пътя от схемата на сайта на страницата, и накрая един за самата страница. Искането се обслужва от Офелия, ако се установи, че окончателното шаблон.
При изграждането на страницата, шаблон на страницата се оценява и неговото съдържание, съхранено в това, което се нарича вътрешната слота. След това всеки от шаблоните на връщане от страницата до корена се оценява на свой ред и може да включва понастоящем съдържанието на вътрешната слота. Резултатът се съхранява във вътрешната слота след всяка стъпка.
Резултатът от обработката на корен шаблон е служил като страницата.
Python скриптове
Всеки шаблон файл може да се започне с Python скрипт. В този случай, сценария се отделя от шаблона от първата поява на "" Маркер върху линията на собствения си (с изключение на празно ляво или дясно). Ако файлът шаблон съдържа само Python скрипт, но не и в действителност шаблон, сложи "" В последния си ред.
Python скриптове се изпълняват с цел, докато обикаля от схемата на сайта на страницата. Те се управляват по същия пространство от имена на променливи, които по-късно се използва като контекста на оценка на шаблоните. Променливи, които са определени от Python скрипт може да се използват и модифицират от скриптове се изпълняват по-късно, както и от приказки изрази, използвани в шаблоните.
Пространството от имена се инициализира с Офелия с една променлива, __request__, че референцията на искане обекта. По този начин, скриптове имат достъп до € детайли и Traversal Вътрешни елементи. В допълнение към определяне на променливи, скриптове могат да внасят и модули, дефинират функции, достъп до файловата система, и като цяло да направят нищо програма Python може да направи.
<Силен> Как Офелия държи
URL канонизация и пренасочване
Ако Офелия срещне URL, който съответства на указателя тя се държи по същия начин като Apache в оригиналната конфигурация: Ако URL адресът не свършва с наклонена черта, той ще пренасочи браузъра, за да добавите черта. Ако черта е там, тя ще се опита да намери шаблон име index.html по подразбиране, и да го направи, тъй като указател "индекс".
В зависимост от конфигурацията, категорични искания за индексни директория страници могат да бъдат пренасочени към роди директория URL адреси без крайния сегмент път. Това ще се превърне в.
Освен това, Офелия canonicalizes URL адреси, съдържащи пътя сегменти "." и ".." съгласно RFC 3986 на родово URI синтаксис и празните пътя сегменти, които не са в края на пътя. Ако URL адресът е променен от тези правила, Офелия пренасочва съответно браузъра.
Манипулатор mod_python
Apache2 обработва искане на фази, всяка от които може да се борави с модули като mod_python. Офелия осигурява mod_python манипулатор за фазата на съдържание поколение. Ако исканата URL е конфигуриран да бъдат обработвани от Офелия, водачът се опитва да намери подходящите шаблони във файловата система, както и изграждане на една страница от тях.
Mod_python манипулатор Офелия никога не причинява File Not Found HTTP грешка. Вместо това, той предава управлението обратно към Apache и други модули, ако установи, че не може да се изгради специално ресурс. Apache пада на сервиране статично съдържание от диска в този случай. Офелия този начин може да се монтира на върха на статичен сайт, за да се справят само тези искания, за които съществуват шаблони в директорията шаблон

<силни> Изисквания :.

<ул >