Shared Django views for use in Webteam apps
Project description
Views for Django apps, primarily for use in Webteam Django apps.
Installation
You can install this module directly with pip install canonicalwebteam.django_views, or alternatively, include canonicalwebteam.django_views in requirements.txt for your app.
TemplateFinder
TemplateFinder is an extension of TemplateView which attempts to load the corresponding templates directly from URLs, without the need to write a view for each URL.
It can load HTML templates directly, or parse Markdown files that contain a “wrapper_template” frontmatter key.
Usage
Here’s an example of how to make use of TemplateFinder in your Django app:
# urls.py
from django.conf.urls import url
from canonicalwebteam.django_views import TemplateFinder
# ...
urlpatterns += url(r"$^", TemplateFinder.as_view()),
Template matching
When the app parses a URL, it will look for templates in the following locations, in order:
/parent/location/ => templates/parent/location.html
/parent/location/ => templates/parent/location/index.html
/parent/location/ => templates/parent/location.md
/parent/location/ => templates/parent/location/index.md
Markdown parsing
If the TemplateFinder encounters a Markdown file (ending .md) it will look for the following keys in YAML frontmatter:
wrapper_template mandatory: (e.g.: wrapper_template: /includes/markdown-wrapper.html) A path to an HTML template within which to place the parsed markdown content. If the path doesn’t have a leading slash (e.g. “templates/template.html” or “../templates/template.html”), then TemplateFinder will search for the template relative to the location of the Markdown file in question. If the path
context optional: (e.g.: context: {title: "Welcome", description: "A welcome page"}) A dictionary of extra key / value pairs to pass through to the template context.
markdown_includes optional: (e.g.: markdown_includes: {nav: }) A mapping of key names to template paths pointing to Markdown files to include. Each template path will be parsed, the resulting HTML will be passed in the template context, under the relevant key.
Here’s an example Markdown file:
---
wrapper_template: "/includes/markdown-wrapper.html"
markdown_includes:
nav: "includes/nav.md"
context:
title: "Welcome"
description: "A welcome page"
---
Welcome to my website.
## GitHub
I also have [a GitHub page](https://github.com/me).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for canonicalwebteam.django_views-1.4.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1153a639dbfd4d2e4b51ebc538906c63ab7c9d8b175a93178c869e1f6ee539d8 |
|
MD5 | aa75c94b5ac0e1bc7e8c72c2e075f054 |
|
BLAKE2b-256 | 1a416f672edbaca14ea2da1bc3a3d0e392c7cc5fd972964af88198f5460f075d |
Hashes for canonicalwebteam.django_views-1.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 30035be67c955d2b3ab2a03b61bbd308e0f3c0a09dce294ec3c83ba509c0e001 |
|
MD5 | dacf2395e56826c9e7fa64faebc6027d |
|
BLAKE2b-256 | 69710439ccf2c54de268d7e86a0bc784654bec2bf933450e0d4b8e68ff9cdba9 |