Mezzanine 搭建 BLOG 系统
1. 创建 python 虚拟环境
查看虚拟环境列表:
conda info --envs
创建虚拟环境 mezzenv:
conda create -n mezzenv python=3
进入虚拟环境 mezzenv:
source activate mezzenv
2. 安装 Mezzanine
pip install mezzanine
3. 新建 mezzblog 项目
mezzanine-project mezzblog
cd mezzblog
python manage.py createdb
python manage.py runserver 0.0.0.0:8066
4. 后台管理 Mezzanine 配置
进入 Content > Pages 配置导航、 页脚信息
进入 Content > Blog posts 添加分类、发布文章
进入 Site > Settings 配置网站 Site Title、Tagline
5. 通过配置文件修改模板风格
mezzblog
└── mezzblog
├── __init__.py
├── settings.py
├── local_settings.py
├── urls.py
├── wsgi.py
修改 mezzblog/mezzblog/settings.py 文件:
配置 Homepage 为 Blog:
注释代码:#url("^$", direct_to_template, {"template": "index.html"}, name="home"),
取消注释:url("^$", "mezzanine.blog.views.blog_post_list", name="home"),
去掉导航栏 Search 输入框的可选项:
添加配置项:SEARCH_MODEL_CHOICES = []
去掉左侧边连和页脚:
添加配置项:PAGE_MENU_TEMPLATES = ( (1, "Top navigation bar", "pages/menus/dropdown.html"), )
Tips: 要完全去掉左侧边连和页脚,还要修改模板文件base.html。稍后第 8 小节介绍 base.html 在哪,以及如何修改
6. 配置 mezzblog 主题样式
在新建中新建一个应用,命名为theme:
python manage.py startapp theme
在 theme 目录下只保留 __init__.py 文件,其他删除:
mezzblog
└── theme
├── __init__.py
自定义 theme/static/css/custom.css 样式文件,覆盖默认样式:
mezzblog
└── theme
├── __init__.py
└── static
└── css
├── custom.css
将 theme 应用添加到 mezzblog/mezzblog/setting.py:
INSTALLED_APPS = (
"theme",
"django.contrib.admin",
"django.contrib.auth",
# ...
)
7. 修改 mezzblog 模板布局
将 Mezzanine 的原始模板汇集到 theme 应用下,覆盖默认模板:
执行 python manage.py collecttemplates 会在项目根目录生成模板文件目录 templates
将 templates 移动到 theme 应用下:
mezzblog
└── theme
├── __init__.py
└── static
└── css
├── custom.css
└── templates
├── base.html
├── ...
去掉左侧边连和页脚(先在 settings.py 文件添加相应配置,见第 5 小节):
删除 base.html 文件中的 3 处代码:
{% page_menu "pages/menus/footer.html" %}
{% spaceless %}
{% block breadcrumb_menu %}{% page_menu "pages/menus/breadcrumb.html" %}{% endblock %}
{% endspaceless %}
调整布局元素宽度,将左边栏占据宽度减小,中间正文部分宽增加:
{% block left_panel %}
{% endblock %}
{% block main %}{% endblock %}
Tips: 通过修改 Bootstrap 栅格布局样式 col-md-* 实现
8. 汇集 Mezzanine 静态文件
执行 python manage.py collectstatic 命令,将 Mezzanine 原始静态文件和自定义的 custom.css 全部拷贝到 theme 应用下。这样,可以在项目中重写静态资源文件,方便部署静态服务。
9. 配置 DEBUG = False
在本地开发时,settings.py 中默认 DEBUG = True,Django 不会限制访问来源,并且会自动寻找静态文件。
当设置 DEBUG = False 时,可能会产生两个问题,可以尝试按以下方式解决:
报 Bad Request(400) 错误
在 settings.py 配置:
ALLOWED_HOSTS = ['*']
找不到项目的静态资源文件
在 urls.py 加入:
from django.views.static import serve as static_serve
if settings.DEBUG is False:
urlpatterns += [
url(r'^static/(?P.*)$', static_serve, {'document_root': settings.STATIC_ROOT}),
]
10. 结语
至此,通过 Mezzanine 搭建 Blog 的项目结构基本完成,后续样式和布局的修改在 theme 应用下修改即可。
用 Mezzanine 搭建 Blog 对于新手最大的阻碍在弄不清去哪修改模板和样式,模板和样式文件在创建项目时并没有自动生成。
需要执行以下两条关键命令,在当前项目下生成模板和静态文件:
python manage.py collecttemplates
python manage.py collectstatic
注:本人主要从事前端方向开发,刚接触 Django 不久,以上理解难免有误。欢迎留言指出~