跳转到主要内容

在当前文件夹中提供静态文件和django模板。

项目描述

这是一个命令行工具,可以将当前文件夹django化。这主要用于原型设计,但也可用于完整的博客网站。

假设当前文件夹包含一些HTML文件,此实用程序将运行django服务器,并通过它提供文件。HTML文件可以使用django强大的模板继承。

阅读: djangothis for blogging

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进行访问。

使用这两个特性,主题可以作为自包含文件夹进行分发。

主题中的命令、视图、自定义模板标签和表单

如果需要,主题可以包含cmds文件夹、templatetags文件夹、views.py和forms.py,这些将被包含进来。为了使此功能正常工作,_theme文件夹还需要包含__init__.py。

自动重新加载

当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.

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分布

djangothis-0.9.zip (21.1 kB 查看散列)

上传时间 源代码

djangothis-0.9.tar.gz (14.1 kB 查看散列)

上传时间 源代码

由以下支持