This release is a pre-release and may not be stable for production use.
This is a Python package for websauna.blog, an addon for Websauna framework. You can use it as a simple blog for your site or as an example of Websaunsa design patterns.
Features
Markdown based editing
Disqus based commenting
Post description and meta for Google (SEO), Facebook, Twitter. Sitemap support and Google Article metadata support.
Blog post management through Websauna admin interface
Drafts (admin only visible) and published posts
RSS feed
Basic unit and functional test suite
Note that this addon is not intended to be used as is, but more of an example. You most likely want to fork it over and modify for your own needs.
Screenshots
Blog post
Admin
Installation
Adding to your site
Include addon in your application initializer:
class Initializer(websauna.system.Initializer):
def include_addons(self):
"""Include this addon in the configuration."""
self.config.include("websauna.blog")
Example settings:
# Title on blog roll
blog.title = My little Websauna blog
# this is "websauna" part from websaua.disqus.com/embed.js univeral
# embed link
blog.disqus_id = websauna
# The email appearing in RSS feed
# (It is recommended not to use any real email)
blog.rss_feed_email = no-reply@example.com
See nav.html example how to add a link to the blog in your site navigation.
Add RSS feed discovery by customizing site/meta.html template:
{# Misc ``<meta>`` tags in ``<head>``. #}
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width" />
{% include "blog/rss_head.html" %}
Create migrations for blog post SQL table for your site:
ws-alembic -c myapp/conf/development.ini -x packages=all revision --auto -m "Adding blog content types"
Run migrations:
ws-alembic -c myapp/conf/development.ini -x packages=all upgrade head
Go to admin, start adding blog posts.
Local development mode
Activate the virtual environment of your Websauna application.
Then:
cd blog # This is the folder with setup.py file pip install -e .
Running the development website
Local development machine
Example (OSX / Homebrew):
psql create blog_dev ws-sync-db websauna/blog/conf/development.ini ws-create-user websauna/blog/conf/development.ini admin@example.com mypassword ws-pserve websauna/blog/conf/development.ini --reload
Running the test suite
First create test database:
# Create database used for unit testing psql create blog_test
Install test and dev dependencies (run in the folder with setup.py):
pip install -e ".[dev,test]"
Run test suite using py.test running:
py.test
More information
Please see https://websauna.org/
Changelog for Websauna Blog
1.0a2 (2018-04-22)
Closes Issue #6: missing ‘namespace_packages’, .
1.0a1 (2018-03-06)
Initial Release
Metadata
Release files for websauna.blog 1.0a2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| websauna.blog-1.0a2.tar.gz | 33.6 kB | Without provenance | Details for websauna.blog-1.0a2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| websauna.blog-1.0a2-py3-none-any.whl | Python 3 | none | any | Details for websauna.blog-1.0a2-py3-none-any.whl |
Total release size: 75.8 kB
Release files / websauna.blog-1.0a2.tar.gz
| Download URL | websauna.blog-1.0a2.tar.gz |
|---|---|
| Size | 33.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0c111b0a34f07aa71f82ed9f8b4573ccff61eb89ee77a8d6ef1a8427d6728eee
|
|
BLAKE2b-256 checksum How to use checksums |
ed4845051975d53bcd1787669eb26b83d78d4d0b96d00a970dea6221f9bfd706
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / websauna.blog-1.0a2-py3-none-any.whl
| Download URL | websauna.blog-1.0a2-py3-none-any.whl |
|---|---|
| Size | 42.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7ef568a7094a79186bd5eb1cac53f15f494934d39481482b3bb19b6f93ea3ede
|
|
BLAKE2b-256 checksum How to use checksums |
7575a935000ba4774c92391975332830c2d8d864c751c8ea2e7920e294959f1b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for websauna.blog 1.0a2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.