Wagtail|Wagtail 教程 1 （基础设置） Wagtail教程1：基础设置

Wagtail 教程系列记录了基于 Wagtail 搭建博客站点的整个过程，博客站点所呈现的即是搭建过程的最新效果。
更多 Wagtail 内容：https://slowread.cn/wagtail-tutorials
首先设置 Wagtail 运行环境
virtualenv Linux 系统下一般存在多个版本 Python 环境，建议采用 virtualenv 创建干净/独立的运行环境。
安装 virtualenv

sudo pip install virtualenv

Copy
使用默认设置创建虚拟环境

cd my_project_folder virtualenv venv

Copy
使用指定的Python解释器创建虚拟环境
linux 系统下：

virtualenv -p /usr/bin/python3.6 venvvirtualenv -p /usr/local/bin/python3 venv

Copy
Windows 系统下：

virtualenv -p python venv

Copy
创建“干净”的虚拟环境

virtualenv --no-site-packages venv

Copy
激活虚拟环境

source ./venv/bin/activate# linux 系统下.\venv\Scripts\activate# Windows 系统下

Copy
退出/停用虚拟环境

rm -rf /venv

Copy
Wagtail 初始化设置虚拟环境中安装 wagtail，自动安装依赖包：

(venv) $ pip install wagtail

Copy
创建 wagtail 项目

(venv) $ wagtail start slowread

Copy
整理项目文件目录，将 /slowread/slowread/slowread 目录下所有文件和目录移动到 /slowread/slowread 目录下，将 /slowread/slowread/manage.py 文件移动到 /slowread 目录下。
修改 /slowread/manage.py 文件内容如下：

#!/usr/bin/env python import os import sysif __name__ == "__main__": os.environ.setdefault("DJANGO_SETTINGS_MODULE", "slowread.settings.dev")from django.core.management import execute_from_command_linecurrent_path = os.path.dirname(os.path.abspath(__file__)) sys.path.append(os.path.join(current_path, "slowread"))execute_from_command_line(sys.argv)

Copy
不修改为上面内容的话，会出现找不到 home models 的问题等。
修改 /slowread/slowread/wsgi.py 文件内容如下：

import os import sysfrom django.core.wsgi import get_wsgi_application# This allows easy placement of apps within the interior # djmyblog directory. app_path = os.path.abspath(os.path.join( os.path.dirname(os.path.abspath(__file__)), os.pardir)) sys.path.append(os.path.join(app_path, 'slowread'))os.environ.setdefault("DJANGO_SETTINGS_MODULE", "slowread.settings.dev")application = get_wsgi_application()

Copy
修改 /slowread/slowread/settings/base.py 文件内语言/时区设置如下：

LANGUAGE_CODE = 'zh-hans' TIME_ZONE = 'Asia/Shanghai' USE_I18N = True USE_L10N = True USE_TZ = False

Copy
修改 /slowread/slowread/settings/base.py 文件内静态/媒体文件位置，BASE_DIR 改为 PROJECT_DIR，设置如下：

STATICFILES_DIRS = [ os.path.join(PROJECT_DIR, 'static'), ]STATIC_ROOT = os.path.join(PROJECT_DIR, 'collect_static') STATIC_URL = '/static/'MEDIA_ROOT = os.path.join(PROJECT_DIR, 'media') MEDIA_URL = '/media/'

Copy
在 slowread 目录下，执行标准 Django 项目必要设置步骤：

(venv) $ pip install -r requirements.txt (venv) $ ./manage.py migrate (venv) $ ./manage.py createsuperuser (venv) $ ./manage.py runserver

Copy
打开 http://127.0.0.1:8000 ，点击 here , 或者直接打开 http://127.0.0.1:8000/admin/ ，输入用户名/密码，进入后台管理，左下角账号管理，语言首选项，选择中文。
建立第一个 Wagtail 页面
编辑 home/templates/home/home_page.html:

{% block content %} {{ self.title }} {% endblock %}

Copy
打开 http://127.0.0.1:8000 ，第一个最简单的 Wagtail 页面出现了。
扩展 HomePage 模型
编辑 home/models.py ，向body模型添加字段：

from django.db import modelsfrom wagtail.core.models import Page from wagtail.core.fields import RichTextField from wagtail.admin.edit_handlers import FieldPanelclass HomePage(Page): body = RichTextField(blank=True)content_panels = Page.content_panels + [ FieldPanel('body', classname="full"), ]

Copy
每次更改模型定时时，都要运行以下命令：

python manage.py makemigrations python manage.py migrate或者合并为一行命令：python manage.py makemigrations && python manage.py migrate

Copy
现在打开 http://127.0.0.1:8000/admin ，进入：
页面，Home，编辑
或者
页面，页面(主页面)，Home，编辑
对应的操作地址：http://127.0.0.1:8000/admin/pages/ ，即页面顶部显示为 Root，鼠标放在 Home 行，然后选择编辑。
可以看到新出现了 BODY 区域。填写下面内容，然后发布。
Wellcome to my Wagtail site.
编辑 home/templates/home/home_page.html 更改为以下内容：

{% extends "base.html" %}{% load wagtailcore_tags %}{% block body_class %}template-homepage{% endblock %}{% block content %} {{ page.body|richtext }} {% endblock %}

Copy
【Wagtail|Wagtail 教程 1 （基础设置）】每个模板文件都要包含 {% load wagtailcore_tags %},否则 Django 会提示 TemplateSyntaxError 错误。
检查一下设置区域中的内容：
主机名：localhost
端口号：80
跟页面：Home
是默认站点：是
保存
打开 http://127.0.0.1:8000 ，查看页面内容。
站点 logo
编辑 /slowread/templates/base.html , 在之间加入下面内容：

Copy
前提是在 /slowread/static/media 目录下已经存在上面的图标文件。修改后，再次运行服务，可以看到站点新添加的 logo 效果。
favicon.ico
关于 Not Found: /favicon.ico 问题解决：

from django.views.generic import RedirectViewurlpatterns = [ ... url(r'^favicon\.ico$',RedirectView.as_view(url='/static/media/favicon.ico')), ... ]

更多 Wagtail 内容：https://slowread.net/tags/?tag=Wagtail