Peregrine

Peregrine是一个有观点的博客平台，它使用Wagtail CMS和Django Web框架，专为代码博客设计。它使用Wagtail的出色StreamField功能来提供完全结构化的内容主体元素块，完全将内容与表示层（CSS、JS和HTML）分离。

它使用Wagtail Code Block和PrismJS语法高亮显示，在内部提供漂亮的代码片段。您可以在PyPhilly.org上看到它的实际效果。

您是否在寻找一个更强大的系统，例如创建营销网站？Peregrine的维护者也参与了CodeRedCMS的开发，它提供了更多功能。Peregrine将保持一个基本的日志解决方案，专注于显示代码的功能。

入门：五分钟安装

这些说明将被完善，但如果您想尝试一下，这里有一些基本步骤。

系统

mkvirtualenv my_blog
pip install peregrine
django-admin startproject my_blog
cd my_blog

设置

您的设置文件将位于my_blog/settings.py，如果您使用的是上述startproject命令创建的默认Django项目布局。您需要在INSTALLED_APPS和MIDDLEWARE下添加部分，并在设置中将'wagtail.contrib.settings.context_processors.settings',添加到您的TEMPLATES上下文处理器中，如下所示。

INSTALLED_APPS = [
    ...
]

PEREGRINE_APPS = [
    "peregrine",
    "bootstrap4",
    "wagtailcodeblock",
    "wagtailcontentstream",

    "wagtail.contrib.forms",
    "wagtail.contrib.redirects",
    "wagtail.embeds",
    "wagtail.sites",
    "wagtail.users",
    "wagtail.snippets",
    "wagtail.documents",
    "wagtail.images",
    "wagtail.search",
    "wagtail.admin",
    "wagtail.core",
    "taggit",
    "modelcluster",

    "wagtail.contrib.settings",
    "wagtail.contrib.modeladmin",
    "wagtail.contrib.table_block",
]


INSTALLED_APPS += PEREGRINE_APPS

MIDDLEWARE = [
    ...
]

PEREGRINE_MIDDLEWARE = [
    "wagtail.contrib.redirects.middleware.RedirectMiddleware",
]

MIDDLEWARE += PEREGRINE_MIDDLEWARE

# WAGTAIL_SITE_NAME is used by Wagtail; others are used by OpenGraph.
WAGTAIL_SITE_NAME = "PyPhilly: Home of FlipperPA"
WAGTAIL_SITE_DESCRIPTION = "PyPhilly is the website of Tim Allen, a web developer living in Philadelphia. Tim has a wide range of interests, but mostly writes about Python, Django, and virtual reality."
WAGTAIL_SITE_URL = "https://PyPhilly.org/"

TEMPLATES = [
    {
        ...

        'OPTIONS': {
            'context_processors': [
                ...

                'wagtail.contrib.settings.context_processors.settings',
            ]
        }
    }
]

URLs

from django.contrib import admin
from django.urls import include, path, re_path

from wagtail.admin import urls as wagtailadmin_urls
from wagtail.documents import urls as wagtaildocs_urls

urlpatterns = [
    path('admin/', admin.site.urls),

    # Wagtail / Peregrine URLs
    path('documents/', include(wagtaildocs_urls)),
    path('cms/', include(wagtailadmin_urls)),
    re_path(r'^', include('peregrine.urls')),
]

启动它！

设置好您的设置后，我们需要创建您的数据库和一个超级用户。从您的项目根目录运行以下命令。

如果您正在运行一个新项目，请仅运行peregrine_initial_site命令，因为它会加载数据库固定数据！

python manage.py migrate
# ** Be sure to see the note above before running this next command. It isn't necessary if you don't want to. **
python manage.py peregrine_initial_site
python manage.py createsuperuser
python manage.py runserver 0:8000

然后您应该可以访问http://localhost:8000/cms/并登录，然后开始创建！

维护者

• Timothy Allen (https://github.com/FlipperPA/)

贡献者

• Jon Banafato (https://github.com/jonafato/)
• Dave Bauer (https://github.com/tdxdave)
• Rana Fayez (https://github.com/Tagine/)
• Jeff Triplett (https://github.com/jefftriplett/)