• Django升级到1.10。
• 原翻页APP似乎已经不再维护，进行了替换。
• Markdown编辑组件直接使用现成的APP，进一步简化程序代码。
• 相关的依赖库都明确指定了版本，以免再出现因相关库的升级导致系统跑不起来的情况。
• 对项目的目录结构做了调整。除默认主题外，其他主题都以APP方式进行安装。
• 很久没有用过SAE，不知道之前的SAE支持代码还能不能用，因此直接去掉了SAE相关支持。

调整好后并未进行严格的测试，如遇到什么问题，可以直接在GitHub上提交Issue。

主题使用方式

创建文件setttings/pre.py，在文件里增加设置 SETTINGS = ‘theme_moment’ 。这款主题支持设置页面上下的导航菜单，具体设置参考 theme_moment.py 文件。页面的主导航菜单默认为博客分类，可将DPRESS_SHOW_CATEGORYS_NAV修改为False，禁用分类。

• 在SAE管理后台创建应用，开发语言选择python
• 使用svn将应用代码更新到本地
• 修改配置文件config.yaml

name: 你的应用名称
version: 1
libraries:
- name: django
  version: "1.4"

• 将DPress sites目录下所有文件复制到SAE应用目录(如：dpress/1/)。
• 在应用的根目录下创建目录libs(如：dpress/1/libs/)
• 将virtualenv.bundle.zip复制到libs目录
  • 注：virtualenv.bundle.zip为python的第三方依赖包
  • 下载 virtualenv.bundle
• 在服务管理中启用mysql数据库
• 由于SAE上无法使用Django命令。需要在本地使用syncdb命令在本地mysql数据库中创建好DPress的初始数据，然后使用SAE的phpmyadmin将数据导入到SAE。
• 在服务管理中创建Storage，并将Domain设置为base
• 创建配置文件settings/local.py

# -*- coding: UTF-8 -*-
import sae.const
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
        'NAME': sae.const.MYSQL_DB,                      # Or path to database file if using sqlite3.
        'USER': sae.const.MYSQL_USER,                      # Not used with sqlite3.
        'PASSWORD': sae.const.MYSQL_PASS,                  # Not used with sqlite3.
        'HOST': sae.const.MYSQL_HOST,                      # Set to empty string for localhost. Not used with sqlite3.
        'PORT': sae.const.MYSQL_PORT,                      # Set to empty string for default. Not used with sqlite3.
    }
}
DEFAULT_FILE_STORAGE = 'saestorage.SaeStorage'
FILEBROWSER_DIRECTORY = ''
STATIC_URL = 'http://vicalloy.sinaapp.com/dpress/'#修改为你静态资源位置
DPRESS_TITLE = u'天地一沙鸥'
DPRESS_SUBTITLE = u'to be continue'
DPRESS_DESCN = ''
DISQUS_SHORTNAME = ''
GOOGLE_ANALYTICS_CODE = ''
#根据你的静态资源位置进行修改
EPIC_JS = 'http://vicalloy.sinaapp.com/dpress/dpress/epiceditor/js/epiceditor.min.js'
EPIC_BASEPATH = 'http://vicalloy.sinaapp.com/dpress/dpress/epiceditor'

• 到这里服务已经可以跑起来了。由于没有对静态资源进行配置，将出现无法找到静态资源的情况。
• 创建一个新的SAE应用，应用类型选择PHP，专门用于管理DPress的静态资源文件（如：dstatic.sinaapp.com）。
• 在本地运行Django的collectestatic命令将DPress的静态资源收集到sites/collectedstatc/目录。
• 将collectedstatc中的内容复制到新创建的站点
  • 如：static/dpress/。对应的STATIC_URL配置文件修改为 http://dstatic.sinaapp.com/static/dpress/

使用Django的开发服务器将系统跑起来

• clone DPress的代码库（git://github.com/vicalloy/DPress.git）
• 运行scripts/create_env.py，该脚本将为你创建python虚拟环境，并自动安装相关依赖包。
• 执行scripts/env.bat(. scripts/env.rc)，进入刚创建的python虚拟环境。
• %mg%($mg in linux) 是 “python manage.py ” 的快捷方式，用于方便的执行Django命令。
• %mg% syncdb
• %mg% migrate
• %mg% runserver
• DPress Admin http://127.0.0.1:8000/admin/
• DPress http://127.0.0.1:8000/

配置

• 复制 sites /settings/pre.sample 为 pre.py 。修改其中的SETTINGS设置，确定使用哪个配置（默认可选production/dev）。
• 复制 sites /settings/local.sample 为 local.py 。并修改相关配置。
• DISQUS_SHORTNAME以及GOOGLE_ANALYTICS_CODE这两个参数需要在正确设置后，DISQUS的评论功能以及GOOGLE ANALYTICS才可正常生效使用。

模板的配置与修改

• DPress自带的模板在 sites/dpress/templates/ 目录。自定义模板放在 sites/templates/ 目录。系统将自动优先使用自定义模板目录的模板，实现对模板的重写。
• dpress/include/footer.html 为页面的底部。可重写该文件，修改版权增加定义链接等。
• dpress/include/sidebar.html 页面的侧边栏。重写该文件对侧边栏内容进行配置。
• dpress/widgets/ 该目录为侧边栏小工具的模板。如果你需要创建自定义的侧边栏工具，请遵守约定将小工具模板放到该目录。
• dpress自带的静态资源文件放在 sites /dpress/static/ 目录。自定义的静态资源文件放在 sites/static/ 目录。
• 静态资源目录中 /dpress/themes/ 为主题目录。当前的默认主题为 default 。你可创建一个新文件夹用于存放你的新主题。
• 重写 dpress/include/base_style.html 使用新主题的css文件。

• 提供对 Markdown 的支持（也只支持Markdown）。
• 使用 EpicEditor 实现Markdown的实时预览。
• 使用 DISQUS 实现文章的评论功能。（注：既然已经有了这么好用的评论服务，为什么还要自己写代码呢）
• 支持代码高亮度。相关的语法说明见：Fenced Code Blocks
• 支持Tag
• 支持RSS
• 使用 Django FileBrowser 提供文件上传的支持。
• 使用 flatpages 提供对About等自定义页面的管理。
• 内置GOOGLE ANALYTICS的支持
• 代码量非常的小
• 模板和代码分离的比较清晰，要创建一套自己的模板会是一件比较容易的事。

已知bug：直接从网页复制文本时EpicEditor的编辑框内会自动的添加一些看不见的html标签，将导致文本显示不正常。需要粘贴文本时最好先将文本粘贴到写字板中，再重新复制粘贴。

http://vik.haoluobo.com/dpress/

http://vik.haoluobo.com/dpress/admin 用户名：vicalloy 密码：vicalloy

感觉django的部署还是太麻烦…

本想用这个项目做Django最佳实践的教程，不过发现自己实在是不擅长这个。此外该项目花费的时间比预期的要多出不少，以至到后期挺没耐心，功能方面也因此大幅缩水。

目前DPress的基础功能已经完成，文档方面我会在晚些时候补上。

有兴趣的朋友可以将代码下回来看看。如果要使用Django自己服务器启动起来非常容易。

1. 使用SVN把代码下回来 http://dpress.googlecode.com/svn/trunk/ 。
2. 运行 \trunk\scripts\init.bat 完成一些必要的初始化（复制静态文件到相关目录）。
3. 运行 \trunk\site\dpress\scripts\syncdb.bat 初始化数据库。
4. 运行 \trunk\site\dpress\scripts\runserver.bat 启动服务。
5. 访问 http://127.0.0.1:8000/admin/ 在管理后台添加日志。

DPress本着以最少的代价完成最多工作的原则，能不造轮子的地方就不造轮子。

• Blog的编辑功能完全交给admin处理。
• 使用filebrowser对admin扩展，实现对文件的管理。
• 使用django-tinymce，实现html的可视化编辑。
• 文章的Tag功能使用django-tagging实现。
• comments功能使用django.contrib.comments。
• Blog本身也大量“借鉴”了pinax的blog组件。
• Blog支持使用书写格式有Markdown、Textile、普通文本，html（支持可视化编辑）、reStructuredText（当然，你需要安装有相关的库）。

对Blog应用来说，一般都会有较高的个性化要求。换肤基本上成了必备功能。很遗憾，这方面是django的软肋。换肤需要创建新的模板，并需要修改配置文件，指定使用新模板。好的方面是，DPress的模板在我优化过后，还是比较简单，改起来还算方便的。

虽然在开始DPress之前就计划的很好，本以为很容易就可以搞定，但事与愿违开发过程中遇中还是遇到了一些麻烦。

Pinax中的Blog组件使用threadedcomments来增加评论支持。在评论内容填写不完整时，会转到它自定义的页面。我认为这是一个挺不友好的设置，尝试修正无果。切换到django.contrib.comments后问题则更糟，不但评论出错会跳到自定义页面，即使评论成功了不会转到评论页面，而是给出一个评论成功的提示。最后没办法，还是自己将添加评论的代码给写了一遍。

此外在模板方面也折腾掉了大量的时间。模板的本身也是程序中重要的一环，但不少的可重用app都没有带任何模板，而且也缺乏模板方面的范例。在我看来，这也是django的第三方app普遍不太好用的重要原因之一。

下面上张图吧，模板的样式，是偷的朋友BLOG的（他也是偷别人的）。