Ophelia

Ophelia es un proyecto de Python que crea páginas XHTML a partir de plantillas escritas en TAL, la plantilla de Zope Atributo Language & nbsp;. Está diseñado para reducir la repetición de códigos a cero.
El paquete contiene tanto una aplicación WSGI corriendo Ophelia, así como un controlador de solicitud de mod_python, el módulo de Python para el servidor web Apache2.
Los archivos de documentación se citan a continuación se pueden encontrar dentro del directorio de paquete, junto con un número de prueba unitaria de los módulos.
Puntos entrada
Después de que ha instalado Ofelia y escribió algunas plantillas, ¿cómo se puede hacer que rinda páginas web?
Utilice Ophelia con Apache
El paquete Python contiene una ophelia.modpython módulo que proporciona un controlador de solicitudes para el módulo mod_python Apache.
Utilice Ophelia como una aplicación WSGI
Ofelia define una clase de aplicación compatible con el estándar WSGI, PEP 333: ophelia.wsgi.Application. Usted puede probarlo ejecutando propio servidor HTTP basado en wsgiref de Ofelia o ejecutarlo por cualquier servidor WSGI es posible cuidar de usar.
El servidor basado en wsgiref se instala como el ejecutable ofelia-wsgiref si Ophelia se instala como un huevo con la "wsgiref" extra habilitado. Su punto de entrada guión es ophelia.wsgi.wsgiref_server.
Volcado de páginas individuales en la salida estándar
Un ejecutable que siempre se instala con el huevo ofelia es ofelia-dump. Este script tiene Ofelia render la respuesta correspondiente a la ruta que especifique, y lo imprime a sys.stdout, opcionalmente con cabeceras HTTP. Punto de entrada de la secuencia de comandos es ophelia.dump.dump.
Ambos guiones proporcionan algunas instrucciones de uso cuando se le llama con la opción --help. Leyeron un archivo de configuración; ver CONFIGURATION.txt para más detalles.
¿Qué tipo de sitios es Ofelia bueno?
El contenido estático
Considere Ophelia como SSI contra las drogas. No es fundamentalmente diferente, sólo mucho más amable y más capaz.
Utilice Ofelia para los sitios donde básicamente escribes tu HTML usted mismo, salvo que se debe escribir las cosas que se repite sólo una vez. La reducción de la repetición a cero tiene un precio: su sitio debe seguir un patrón de Ofelia para combinar sus plantillas de la manera correcta.
Considere el diseño de su sitio para ser jerárquico: hay un aspecto común a todas sus páginas, secciones tener ciertas características, y cada página tiene un contenido único. Es crucial para Ofelia que esta jerarquía refleja en la organización del sistema de archivos de sus documentos; cómo se combinan las plantillas se deduce de sus lugares en la jerarquía de directorios.
El contenido dinámico
Ofelia hace que el lenguaje Python disponibles para incluir contenido dinámico. Cada archivo de plantilla puede incluir un script de Python. Scripts de Python y plantillas que contribuyen a una participación de la página de un conjunto común de variables para modificar y utilizar.
Modelo de contenido de Ofelia es muy simple y funciona mejor si cada objeto contenido que publica es su propio punto de vista: la página se representa en. Si obtiene el contenido de los recursos externos de todas formas (por ejemplo, una base de datos o un repositorio de control de versiones), sigue siendo bien usar Ofelia incluso con múltiples vistas por objeto el contenido siempre y cuando vistas de un objeto no depende de el tipo de objeto o incluso el objeto sí mismo.
Tratar de utilizar Ofelia en un sitio más complejo dará lugar a un enredo feo de la lógica y la presentación. No utilice Ofelia para los sitios que en realidad son las interfaces web a las aplicaciones, los sistemas de gestión de contenidos y similares.
¿Cómo funciona Ofelia
Los archivos de plantilla
Para cada solicitud, Ofelia busca un número de archivos de plantilla. Toma un archivo llamado "__init__" de cada directorio de la ruta desde la raíz del sitio de la página, y una última para la propia página. La petición es servida por Ophelia si se comprueba que la plantilla final.
Cuando la construcción de la página, la plantilla de la página es evaluado y su contenido se almacena en lo que se llama la ranura interior. Luego, cada plantilla en el camino de regreso de la página a la raíz se evalúa a su vez, y puede incluir el contenido actual de la ranura interior. El resultado se almacena en la ranura interior después de cada paso.
El resultado del procesamiento de la plantilla de la raíz se desempeñó como la página.
Scripts de Python
Cada archivo de plantilla puede comenzar con una secuencia de comandos de Python. En ese caso, el guión está separado de la plantilla por la primera aparición de un "" Etiqueta en una línea propia (a excepción de los espacios en blanco a la izquierda o derecha). Si el archivo de plantilla contiene sólo una secuencia de comandos de Python, pero en realidad una plantilla no, ponga "" En su última línea.
Scripts de Python se ejecutan en orden al atravesar desde la raíz del sitio a la página. Ellos se ejecutan en el mismo espacio de nombres de variables que se utiliza más tarde como el contexto de la evaluación de las plantillas. Las variables que se establecen por un script Python se pueden utilizar y modificar por ningún ejecutar scripts más tarde, así como en los cuentos de las expresiones utilizadas en las plantillas.
El espacio de nombres es inicializado por Ofelia con una sola variable, __request__, que hace referencia al objeto de la petición. Por lo tanto, los scripts tienen acceso a datos de la solicitud y partes internas de recorrido. Además de establecer las variables, los scripts también pueden importar módulos, definir funciones, acceder al sistema de archivos, y en general hacer todo un programa Python puede hacer.
¿Cómo se comporta Ofelia
Canonicalización URL y redirección
Si Ophelia se encuentra con una dirección URL que corresponde a un directorio que se comporta de manera similar a Apache en su configuración predeterminada: Si la URL no termina con una barra, volverá a dirigir el navegador para agregar la barra. Si la barra está ahí, se trata de buscar una plantilla llamada index.html por defecto, y la hacen como el directorio "index".
Dependiendo de la configuración, solicitudes explícitas de páginas de índice de directorio pueden ser redirigidos a desnudar las URL de directorio sin el segmento de trazado final. Esto convertiría a.
Además, Ofelia canonicalizes URL que contienen segmentos de trazado "." y ".." de acuerdo con RFC 3986 sobre la sintaxis genérica URI, y elimina los segmentos de trazado vacíos que no están en el final de la ruta. Si la URL se cambia por estas reglas, Ofelia redirige el navegador a tal efecto.
El manejador de mod_python
Apache2 procesa una solicitud en fases, cada una de las cuales pueden ser manejados por los módulos tales como mod_python. Ofelia ofrece un manejador mod_python para la fase de generación de contenidos. Si una dirección URL solicitada está configurado para ser manejado por Ofelia, el manejador intenta encontrar las plantillas adecuadas en el sistema de archivos y crear una página de ellos.
Manejador mod_python de Ofelia nunca causa un error Archivo no encontrado HTTP. En su lugar, se pasa el control al Apache y otros módulos si encuentra que no puede construir un recurso en particular. Apache cae de nuevo a servir contenido estático desde el disco en ese caso. Ofelia tanto, puede ser instalado en la parte superior de un sitio estático para manejar sólo aquellas solicitudes para las que existen plantillas en el directorio de la plantilla

Requisitos :.

• Python