在当前文件夹中提供静态文件和django模板。
项目描述
这是一个命令行工具,可以将当前文件夹django化。这主要用于原型设计,但也可用于完整的博客网站。
假设当前文件夹包含一些HTML文件,此实用程序将运行django服务器,并通过它提供文件。HTML文件可以使用django强大的模板继承。
Django模板
当前文件夹中的任何HTML文件都视为django模板,并映射到磁盘上的URL。例如,index.html将可在/index.html上访问,依此类推。
这些HTML文件可以完全使用django模板的强大功能,例如模板继承等。这使得创建原型变得轻而易举,因为多个文件可以继承common base.html的样式和感觉。
配置
如果当前文件夹中存在config.yaml文件,djangothis支持使用该文件配置django。它可以用于配置中间件、模板上下文处理器等。
静态文件
如果当前文件夹中有一个名为static的文件夹,该文件夹的内容也将可在/static/ URL上提供。因此,static/style.css将在/static/style.css上提供服务。
此实用程序还将请求映射到/favicon.ico到/static/favicon.ico。
views.py和forms.py
此外,如果存在名为views.py或forms.py的文件,实用程序将“导入”它们,如果这些文件使用importd风格的“装饰”视图或表单,它们也将可用(示例)。
模拟Ajax
此外,如果当前文件夹中存在ajax.yaml文件,此实用程序将在yaml文件中查找请求的路径,如果存在,将返回相应的JSON。
自定义标签库
可以在当前文件夹中创建一个名为templatetags的文件夹,包含__init__.py和django模板标签库,djangothis将它们提供给您的模板。
自定义命令
当前文件夹可以包含名为cmds的文件夹,其中可以存储Django管理命令,以及一个__init__.py文件。
可以通过运行$ djangothis commandname来执行命令。
主题
djangothis支持主题。主题可以放置在名为_theme的特殊文件夹中。此文件夹放置在模板目录设置的最前面,因此任何模板都可以通过放置在其中来“覆盖”。
为了特殊主题的静态文件,它们可以放置在_theme文件夹中,并通过/theme/ URL进行访问。例如,如果有一个css文件_theme/style.css,可以通过/theme/style.css进行访问。
使用这两个特性,主题可以作为自包含文件夹进行分发。
自动重新加载
当config.yaml或ajax.yaml文件更新时,调试服务器会自动重新加载。此外,任何主题都可以调用djangothis.watchfile(file_path)来监视文件的修改,以便调试服务器可以重新加载。
将djangothis用作静态网站生成器
$ wget -m http://localhost:8000
可用于创建本地镜像。
替换jekyll、pelican等
djangothis可以用于替换jekyll、pelican等。为此,需要编写适当的views.py文件并将其放置在当前文件夹或_theme文件夹中,该文件将定义/or /blog/的视图,该视图可以读取_posts的内容,例如,生成适当的摘要和链接,定义帖子等的视图,从而提供页面。
我的个人网站amitu.com由本程序驱动,以前是使用jekyll驱动的。源代码可在djangothis-jekyll上找到。
示例网站
安装和使用
要安装
$ pip install djangothis
从包含上述文件的任何文件夹运行
$ djangothis
Validating models...
0 errors found
Django version 1.4.1, using settings None
Development server is running at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。