Wagtail 教程 1:基础设置

2018年12月13日


# Wagtail # Django # Python
  • Wagtail 是一个用 Python 编写的开源 CMS,基于 Django 框架构建。 它优雅、强大、敏捷,专注于灵活性和用户体验,为开发人员提供一个快速有吸引力的界面,可以直观地创建和组织内容。
  • Wagtail 教程系列 记录了基于 Wagtail 搭建博客站点的整个过程,当前站点 所呈现的即是搭建过程的最新效果。


首先使用 virtualenv 设置 Wagtail 运行环境。

virtualenv

Linux 系统下一般存在多个版本 Python 环境,建议采用 virtualenv 创建干净/独立的运行环境。

安装 virtualenv

sudo pip install virtualenv

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

cd my_project_folder
virtualenv venv

使用指定的Python解释器创建虚拟环境

linux 系统下:

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

virtualenv -p /usr/local/bin/python3 venv

Windows 系统下:

virtualenv -p python venv

创建“干净”的虚拟环境

virtualenv --no-site-packages venv

激活虚拟环境

source ./venv/bin/activate    # linux 系统下

.\venv\Scripts\activate     # Windows 系统下

退出/停用虚拟环境

rm -rf /venv

Wagtail 初始化设置

虚拟环境中安装 wagtail,自动安装依赖包:

(venv) $ pip install wagtail

创建 wagtail 项目

(venv) $ wagtail start slowread

整理项目文件目录,将 /slowread/slowread/slowread 目录下所有文件和目录移动到 /slowread/slowread 目录下,将 /slowread/slowread/manage.py 文件移动到 /slowread 目录下。

修改 /slowread/manage.py 文件内容如下:

#!/usr/bin/env python
import os
import sys

if __name__ == "__main__":
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "slowread.settings.dev")

    from django.core.management import execute_from_command_line

    current_path = os.path.dirname(os.path.abspath(__file__))
    sys.path.append(os.path.join(current_path, "slowread"))

    execute_from_command_line(sys.argv)

不修改为上面内容的话,会出现找不到 home models 的问题等 。

修改 /slowread/slowread/wsgi.py 文件内容如下:

import os
import sys

from 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()

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

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

修改 /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/'

在 slowread 目录下,执行标准 Django 项目必要设置步骤:

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

打开 http://127.0.0.1:8000 ,点击 here , 或者直接打开 http://127.0.0.1:8000/admin/ ,输入用户名/密码,进入后台管理,左下角 账号管理,语言首选项,选择 中文。

建立第一个 Wagtail 页面

编辑 home/templates/home/home_page.html:

{% block content %}
    <h1>{{ self.title }}</h1>
{% endblock %}

打开 http://127.0.0.1:8000 ,第一个最简单的 Wagtail 页面出现了。

扩展 HomePage 模型

编辑 home/models.py ,向body模型添加字段:

from django.db import models

from wagtail.core.models import Page
from wagtail.core.fields import RichTextField
from wagtail.admin.edit_handlers import FieldPanel

class HomePage(Page):
    body = RichTextField(blank=True)

    content_panels = Page.content_panels + [
        FieldPanel('body', classname="full"),
    ]

每次更改模型定时时,都要运行以下命令:

python manage.py makemigrations
python manage.py migrate

或者合并为一行命令:

python manage.py makemigrations && python manage.py migrate

现在打开 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 %}

每个模板文件都要包含 {% load wagtailcore_tags %},否则 Django 会提示 TemplateSyntaxError 错误。

检查一下设置区域中的内容:

主机名:localhost
端口号:80
跟页面:Home
是默认站点:是

保存

打开 http://127.0.0.1:8000 ,查看页面内容。

站点 logo

编辑 /slowread/templates/base.html , 在 <head></head> 之间加入下面内容:

<link rel="icon" type="image/png" sizes="32x32" href="{% static 'media/slowread-32x32.ico' %}">
<link rel="icon" type="image/png" sizes="16x16" href="{% static 'media/slowread-16x16.ico' %}">

前提是在 /slowread/static/media 目录下已经存在上面的图标文件。修改后,再次运行服务,可以看到站点新添加的 logo 效果。

favicon.ico

关于 Not Found: /favicon.ico 问题解决:

from django.views.generic import RedirectView

urlpatterns = [
    ...
    url(r'^favicon\.ico$',RedirectView.as_view(url='/static/media/favicon.ico')),
    ...
]