Ophelia

.

Ophelia TAL yazılı şablonları XHTML sayfalarını oluşturan bir Python projesi, Zope Şablon Dil & nbsp Özellik olduğu; sıfıra kod tekrarı azaltmak için tasarlanmıştır.
paket Ophelia çalışan bir WSGI uygulaması yanı sıra Mod_python, Apache2 web sunucusu için Python modülü için bir istek işleyicisi hem de içerir.
Aşağıda belirtilen Dokümantasyon dosyaları modülleri için Doctestler bir dizi ile birlikte paket dizin içinde bulunabilir.
Giriş noktaları
Eğer Ophelia yüklü ve bazı şablonları yazdı sonra, nasıl web sayfalarını render yapabilirsiniz?
Apache ile Ophelia kullanın
Python paketi Mod_python Apache modülü için bir istek işleyicisi sağlayan bir modül ophelia.modpython içerir.
WSGI uygulaması olarak Ophelia'yı kullanın
Ophelia WSGI standardı ile uyumlu bir uygulama sınıfını tanımlar, KEP 333: ophelia.wsgi.Application. Ophelia kendi wsgiref tabanlı HTTP sunucusu çalıştırarak deneyin veya kullanmak bakım olabilecek herhangi WSGI sunucu tarafından çalıştırabilirsiniz ya.
Ophelia "wsgiref" ekstra etkin bir yumurta olarak yüklüyse wsgiref-tabanlı sunucu ophelia-wsgiref yürütülebilir olarak yüklenir. Onun komut giriş noktası ophelia.wsgi.wsgiref_server olduğunu.
Stdout'a tek sayfaları Damper
Her zaman ophelia yumurta ile yüklü bir yürütülebilir ophelia-dökümü. Bu komut Ophelia belirttiğiniz yola gelen yanıtı vermek vardır, ve HTTP başlıklarını ile isteğe bağlı sys.stdout için yazdırır. Senaryonun giriş noktası ophelia.dump.dump olduğunu.
Help seçeneği ile çağrıldığında Her iki komut, bazı kullanım talimatlarını sağlamaktadır. Onlar bir yapılandırma dosyasını okuyun; Daha fazla bilgi için bkz: CONFIGURATION.txt.
sitelerin ne tür için Ophelia iyidir?
Statik içerik
Uyuşturucu SGK olarak Ophelia düşünün. Sadece çok dostça ve daha yetenekli, temelde farklı değil.
Eğer temelde sadece bir kez yinelenen şeyler yazmak gerekir dışında, HTML kendiniz yazmak siteler için Ophelia kullanın. Sıfıra tekrarını azaltılması fiyata geliyor: Ophelia sizin şablonları doğru yolu birleştirmek için sitenizin bir desen takip etmelidir.
Hiyerarşik olarak sitenizin düzenini düşünün: Tüm sayfalar için ortak bir bakış var, bölümler, belirli özelliklere sahip, ve her sayfası eşsiz bir içeriğe sahiptir. Bu hiyerarşi belgelerin dosya sistemi organizasyonunda yansıttığını Bu Ophelia için çok önemli; nasıl şablonları birleştirmek dizinleri hiyerarşisinde kendi yerlerinden çıkarılır.
Dinamik içerik
Ophelia dinamik içerik dahil olmak üzere mevcut Python dilini yapar. Her şablon dosyası bir Python komut dosyası içerebilir. Python komut ve bir sayfa paylaşımına değiştirmek ve kullanmak için değişkenlerin ortak bir dizi katkıda şablonları.
Ophelia içerik modeli çok basit ve yayınlamak her içerik nesnesi kendi görünümü ise en iyi şekilde çalışır: bu temsil sayfa. Yine dış kaynaklardan içerik alırsanız, bu nesnenin türüne ya da nesneye bağlı olmayan bir nesnenin görüşleri sürece bile içerik nesnesi başına birden manzaralı Ophelia kullanmak için hala Tamam (bir veritabanı veya bir sürüm kontrol deposu gibi) var kendisi.
Mantık ve sunum çirkin karıştırmanın yol açacak bir daha karmaşık bir sitede Ophelia kullanmaya çalışıyor. Aslında uygulamalara web arayüzleri, içerik yönetim sistemleri ve benzeri siteler için Ophelia kullanmayın.
Ophelia Nasıl çalışır?
Şablon dosyalar
Her istek için, Ophelia şablon dosya sayısı arar. Bu bir sayfa site kökünden yolda her dizinden "__init__" adlı dosyayı, ve sayfanın kendisi için bir son birini alır. Bu son şablon bulunursa istek Ophelia tarafından servis edilir.
Sayfayı oluştururken, sayfanın şablon değerlendirilir ve içeriği iç yuvası denen saklanır. Sonra geri kök sayfasından yolda her şablon sırayla değerlendirilir ve iç yuvaya mevcut içeriği içerebilir. Sonuç, her basamaktan sonra, iç yuvaya depolanır.
Kök şablonu işleme sonucu sayfası olarak servis edilir.
Python komut
Her şablon dosyası bir Python komut ile başlayabilir. Bu durumda, komut (boşluk dışında sol veya sağ) kendi başına bir satırda bir "" Etiketi ilk geçtiği tarafından şablondan ayrılır. Şablon dosyası değil aslında bir şablon sadece bir Python komut içeriyorsa, son satırında "" Koydu.
Sayfanın site kökünden geçme sırasında Python komut sırayla yürütülür. Daha sonra şablonları değerlendirilmesi bağlamında olarak kullanılan değişkenlerin aynı ad çalıştırılır. Bir Python komut tarafından belirlenen değişkenler sonra çalıştırmak herhangi bir komut, yanı sıra şablonlar kullanılan TALES ifadeler tarafından kullanılan ve modifiye edilebilir.
ad isteği nesnesi başvuran tek bir değişken, __request__ ile Ophelia tarafından başlatıldı. Böylece, komut isteği ayrıntıları ve dolaşma iç erişebilirsiniz. Ayar değişkenlere ek olarak, komut dosyaları da, modülleri içe işlevler tanımlamak, dosya sistemine erişmek, ve genellikle bir Python programı yapabildiği her şeyi yapabilir.
Ophelia davranır nasıl
URL kurallı ve yönlendirme
Ophelia onun varsayılan yapılandırmasında Apache benzer şekilde davranır bir dizine gelen bir URL karşılaşırsa: URL bölü çizgisi ile bitmiyor, bu çizgi eklemek için tarayıcı yönlendirir. Çizgi varsa, varsayılan olarak index.html adında bir şablon bulmaya çalışın, ve dizin "index" olarak işlemez.
Yapılandırmasına bağlı olarak, dizin dizin sayfaları için açık istekleri son yol parçasının olmadan dizin URL'leri çıplak yönlendiriliyorsunuz olabilir. Bu içine açacak.
Buna ek olarak, Ophelia yol parçalarını içeren URL'ler kanonlaştırır "." ve ".." yolun sonunda değil boş yol parçalarını genel tanım sözdizimi RFC 3986 göre, ve kaldırır. URL, bu kuralların değişmesi durumunda, Ophelia buna göre tarayıcı yönlendirir.
Mod_python işleyicisi
Apache2 gibi mod_python gibi modülleri tarafından ele alınabilir her biri aşamalarında, bir isteği işler. Ophelia içerik oluşturma aşaması için bir Mod_python işleyicisi sağlar. Bir İstenen URL Ophelia tarafından ele alınması için yapılandırılmış ise, işleyici dosya sisteminde uygun şablonları bulmak ve onlardan bir sayfa oluşturmak için çalışır.
Ophelia en Mod_python işleyicisi HTTP hatası Bulunamadı Dosya neden asla. O Belirli bir kaynak inşa edemez bulursa yerine, geri Apache ve diğer modüller kontrol geçer. Apache bu durumda diskten statik içeriği sunan geri düşüyor. Ophelia, böylece şablonlar şablon dizinde mevcut olduğu için sadece bu istekleri işlemek için statik bir sitenin üstüne monte edilebilir

Gereksinimler :.

• Python