Wagtail 教程系列 記錄了基于 Wagtail 搭建博客站點(diǎn)的整個過程,博客站點(diǎn) 所呈現(xiàn)的即是搭建過程的最新效果。
更多 Wagtail 內(nèi)容:https://slowread.cn/wagtail-tutorials
首先設(shè)置 Wagtail 運(yùn)行環(huán)境
Linux 系統(tǒng)下一般存在多個版本 Python 環(huán)境,建議采用 virtualenv 創(chuàng)建干凈/獨(dú)立的運(yùn)行環(huán)境。
sudo pip install virtualenv
- cd my_project_folder
- virtualenv venv
linux 系統(tǒng)下:
- virtualenv -p /usr/bin/python3.6 venv
- virtualenv -p /usr/local/bin/python3 venv
Windows 系統(tǒng)下:
virtualenv -p python venv
virtualenv --no-site-packages venv
- source ./venv/bin/activate # linux 系統(tǒng)下
- .\venv\Scripts\activate # Windows 系統(tǒng)下
rm -rf /venv
虛擬環(huán)境中安裝 wagtail,自動安裝依賴包:
(venv) $ pip install wagtail
創(chuàng)建 wagtail 項目
(venv) $ wagtail start slowread
整理項目文件目錄,將 /slowread/slowread/slowread 目錄下所有文件和目錄移動到 /slowread/slowread 目錄下,將 /slowread/slowread/manage.py 文件移動到 /slowread 目錄下。
修改 /slowread/manage.py 文件內(nèi)容如下:
- #!/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)
不修改為上面內(nèi)容的話,會出現(xiàn)找不到 home models 的問題等 。
修改 /slowread/slowread/wsgi.py 文件內(nèi)容如下:
- 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 文件內(nèi) 語言/時區(qū)設(shè)置如下:
- LANGUAGE_CODE = 'zh-hans'
- TIME_ZONE = 'Asia/Shanghai'
- USE_I18N = True
- USE_L10N = True
- USE_TZ = False
修改 /slowread/slowread/settings/base.py 文件內(nèi)靜態(tài)/媒體文件位置,BASE_DIR 改為 PROJECT_DIR,設(shè)置如下:
- 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 目錄下,執(zhí)行標(biāo)準(zhǔn) Django 項目必要設(shè)置步驟:
- (venv) $ pip install -r requirements.txt
- (venv) $ ./manage.py migrate
- (venv) $ ./manage.py createsuperuser
- (venv) $ ./manage.py runserver
打開 http://127.0.0.1:8000 ,點(diǎn)擊 here , 或者直接打開 http://127.0.0.1:8000/admin/ ,輸入用戶名/密碼,進(jìn)入后臺管理,左下角 賬號管理,語言首選項,選擇 中文。
編輯 home/templates/home/home_page.html:
- {% block content %}
- <h1>{{ self.title }}</h1>
- {% endblock %}
打開 http://127.0.0.1:8000 ,第一個最簡單的 Wagtail 頁面出現(xiàn)了。
編輯 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"),
- ]
每次更改模型定時時,都要運(yùn)行以下命令:
- python manage.py makemigrations
- python manage.py migrate
- 或者合并為一行命令:
- python manage.py makemigrations && python manage.py migrate
現(xiàn)在打開 http://127.0.0.1:8000/admin ,進(jìn)入:
頁面,Home,編輯
或者
頁面,頁面(主頁面),Home,編輯
對應(yīng)的操作地址:http://127.0.0.1:8000/admin/pages/ , 即頁面頂部顯示為 Root,鼠標(biāo)放在 Home 行,然后選擇 編輯。
可以看到新出現(xiàn)了 BODY 區(qū)域。填寫下面內(nèi)容,然后發(fā)布。
Wellcome to my Wagtail site.
編輯 home/templates/home/home_page.html 更改為以下內(nèi)容:
- {% extends "base.html" %}
- {% load wagtailcore_tags %}
- {% block body_class %}template-homepage{% endblock %}
- {% block content %}
- {{ page.body|richtext }}
- {% endblock %}
每個模板文件都要包含 {% load wagtailcore_tags %},否則 Django 會提示 TemplateSyntaxError 錯誤。
檢查一下設(shè)置區(qū)域中的內(nèi)容:
主機(jī)名:localhost
端口號:80
跟頁面:Home
是默認(rèn)站點(diǎn):是
保存
打開 http://127.0.0.1:8000 ,查看頁面內(nèi)容。
編輯 /slowread/templates/base.html , 在 <head></head> 之間加入下面內(nèi)容:
- <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 目錄下已經(jīng)存在上面的圖標(biāo)文件。修改后,再次運(yùn)行服務(wù),可以看到站點(diǎn)新添加的 logo 效果。
關(guān)于 Not Found: /favicon.ico 問題解決:
- from django.views.generic import RedirectView
- urlpatterns = [
- ...
- url(r'^favicon\.ico$',RedirectView.as_view(url='/static/media/favicon.ico')),
- ...
- ]