pinax / pinax-blog

a blog app for Django

Pinax

Table of Contents

• About Pinax
• Overview
  • Dependencies
  • Supported Django and Python versions
• Documentation
  • Installation
  • Usage
• Change Log
• Contribute
• Code of Conduct
• Connect with Pinax
• License

About Pinax

Pinax is an open-source platform built on the Django Web Framework. It is an ecosystem of reusable Django apps, themes, and starter project templates. This collection can be found at http://pinaxproject.com.

Overview

This repository contains documentation for the Pinax project.

Documentation

Updating Online Documentation

The docs live online at http://pinaxproject.com/pinax/.

After a pull request is merged, checkout your local master branch:

git checkout master

Pull the update into your local master branch:

git pull origin master

Push the update live to gh-pages:

mkdocs gh-deploy

Publishing a Distribution

projects.json

distribution.json

Change Log

Contribute

For an overview on how contributing to Pinax works read this blog post and watch the included video, or read our How to Contribute section. For concrete contribution ideas, please see our Ways to Contribute/What We Need Help With section.

In case of any questions we recommend you join our Pinax Slack team and ping us there instead of creating an issue on GitHub. Creating issues on GitHub is of course also valid but we are usually able to help you faster if you ping us in Slack.

We also highly recommend reading our blog post on Open Source and Self-Care.

Code of Conduct

In order to foster a kind, inclusive, and harassment-free community, the Pinax Project has a code of conduct. We ask you to treat everyone as a smart human programmer that shares an interest in Python, Django, and Pinax with you.

Connect with Pinax

For updates and news regarding the Pinax Project, please follow us on Twitter @pinaxproject and check out our Pinax Project blog.

License

Copyright (c) 2012-2018 James Tauber and contributors under the MIT license.

pinax-blog's Issues

Allow setting of publication date other than now

At the moment if I want the publication date (e.g. what's shown in the dateline and, in many cases, the URL) to be other than when I actually switched it from "draft" to "published", I have to use the shell.

It would be nice if there was a way to publish with a datetime other than now.

Missing template files

I've got latest version from git today, but after i tried to setup biblion app and run it - i got -

Exception Type: TemplateDoesNotExist
Exception Value: biblion/blog_list.html

and this file is really missing. Could you please add this and other templates to repo.
Thanks for you job !

Biblion images must belong to posts

I simply don't understand the rationale for this, when we still have to refer to the image by PK. Why have the relationship at all?

Assume HTML in summary

to fix #60 we changed content to be html but I've just found a case where I had to make the summary html too. Similar change but to summary element

Auto-populate description field based on what you type in the teaser

Document Image Markup

Pull the contents of this post into some documentation around using pinax-blog:

http://eldarion.com/blog/2015/04/22/using-images-pinax-blog-posts/

obscure URLs for unauth'd review

At the moment an unpublished blog post can be reviewed by an auth'd user but it would be nice if they could be viewed by unauth'd users at obscure URLs too.

PostAdmin.formfield_for_dbfield removes request before calling the super class

Same issue as django-cms/django-cms#550

atom feed template assumes xhtml which is dangerous

It's easy to get an invalid feed if someone has non-xml html in their content. However, the fix is also easy, just use:

<content type="html" xml:lang="en">
    {{ entry.teaser_html }}
    {{ entry.content_html }}
</content>

Convert views to class based views to make extending at site level easier

a use case we have right now for the upcoming Pinax blog is to customize the blog_index view to be able to filter by tags (there is site level django-taggit integration)

Missing templates

There appears to be no base template examples, such as the ones referenced in views.py :
biblion/blog_list.html
biblion/blog_section_list.html

NoReverseMatch hitting feed

After a recent upgrade, I'm getting:

NoReverseMatch: Reverse for '('pinax_blog:blog_feed',)' with arguments '()' and keyword arguments '{'section': 'all', 'feed_type': u'atom'}' not found. 0 pattern(s) tried: []

hitting the feed.

The problem seems to be line 171 in views.py:

 feed_url = "http://%s%s" % (current_site.domain, reverse(url_name, kwargs=kwargs)) 

Installing with easy_install

I couldn't install biblion using easy_install with:

easy_install biblion

But I've figured it could be done this way instead:

easy_install https://github.com/eldarion/biblion/tarball/master#egg=0.1.dev10.1

Perhaps this should be added to the docs

get working with Python 3

The problem seems to be the creole library which hasn't been updated in 5 years! I'm happy to deprecate its use but perhaps as a start we should not require it.

improve feed updated calculation

At the moment we calculate the feed's "updated" as the "published" of the top post but I'm wondering if it should instead be the latest "updated" of any published post. We should make sure the whole feed is sorted by "updated" anyway and use the latest updated for the feed's "updated".

See https://github.com/pinax/pinax-blog/blob/master/pinax/blog/views.py#L166

Fix migration for unique slugs

the PINAX_BLOG_SLUG_UNIQUE setting when set to True, causes a migration to be generated after install. the migrations that ship with pinax-blog were created with the default settings which is False.

perhaps the migration should be edited to be dynamic based on that setting. that doesn't handle the case where you might want to switch after you have installed but could handle the case where you know what you want from the start.

Hardcoded description in RSS Feed

Hi,
I was just perusing the code and noticed a hardcoded value in the RSS feed
https://github.com/pinax/biblion/blob/master/biblion/templates/biblion/rss_feed.xml#L8

settings.AUTH_USER_MODEL

I am getting an error regarding the user model used:
blog.Post.author: (fields.E301) Field defines a relation with the model 'auth.User', which has been swapped out.
HINT: Update the relation to point at 'settings.AUTH_USER_MODEL'.
blog.Revision.author: (fields.E301) Field defines a relation with the model 'auth.User', which has been swapped out.
HINT: Update the relation to point at 'settings.AUTH_USER_MODEL'.

This setting defaults to django's default user model, but is preferred to support custom users: https://docs.djangoproject.com/en/1.8/topics/auth/customizing/#substituting-a-custom-user-model

Add the ability to unpublish a post

Unlock pytz version dependency pytz>=2015.7?

Greetings,

As of now pytz is at 2016.6.1 but pinax-blog seems to require pytz==2015.7. Would it be okay to have pytz>=2015.7?

Regards,

SN

need add pinax.images as dependence in INSTALLED_APPS (write it to document,pls)

otherwise when run ./manage.py migrate this error happen

RuntimeError: Model class pinax.images.models.ImageSet doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS.

Improve markdown image support

• add sample markup for markdown in the help text of each image inline (currently just defaults to creole sample)
• make sure that normally linked images work as well so that external images can be used in the markdown

Make sure HTTP_IF_MODIFIED_SINCE on feeds is honoured

Document the use of custom editors in the admin at the project level

I find it much easier to use CK Editor when building a blog. Would be great if you added that.

I'm also running into a lot of errors when using this so going to give it some time and come back!

Add the ability to leave review comments on a post

Provide help for title and description

It's ideal to have titles no longer than 60 characters and meta descriptions no longer than 150 characters.

We should at least provide that help text in the admin, but ideally we should provide a character counter that decrements as you type.

NoReverseMatch at /admin/blog/post/

Hi,

I have installed the last version of Pinax and I'm getting an error in the admin page. If I try to access /admin/blog/post/ I get aNoReverseMatch u'pinax_blog' is not a registered namespace. I only get this error in the /post/ sections, the rest are working fine.

I have the following code:
At settings.py

INSTALLED_APPS = (
    ...
    'pinax.blog',
...
)

at urls.py
url(r"^blog/", include("pinax.blog.urls")),
I have also done a python manage.py migrate.

Any idea of whats going on? The rest of the sections work perfectly.
Cheers

travis-ci test fails because of unsupported django-python versions

django master test with py3.3 fails with

ImportError: cannot import name find_spec

because find_spec introduced in py3.4

Broken dependencies?

Hello people,

i'm having this problem with creole.

I've installed the dependencies, but can't import creole.Parser.

What's going on? Has the library changed?

Got error when install - blog.Post.image_set: (fields.E300) Field defines a relation with model 'ImageSet'

ERRORS:
blog.Post.image_set: (fields.E300) Field defines a relation with model 'ImageSet', which is either not installed, or is abstract.

Any idea?
thanks

Add states of a post instead of binary published or not

This helps with #34 as well.

Make date based urls or slug only urls and either/or option

We shouldn't support having both urls render the same content.

Perhaps, if we have PINAX_BLOG_SLUG_UNIQUE = True, then the url for SlugUniquePostDetailView is added otherwise the url for DateBasedPostDetailView is added.

Implement an API compatible with the documented Wordpress API

By having an API that is compatible with http://wp-api.org we should be able to use all the different desktop and mobile apps for managing blogs and writing posts.

What is the best way to enable per-user blogs?

Can't run app

I keep getting a
RuntimeError: Model class django.contrib.sites.models.Site doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS. whenever I tried to run the app.

I followed the exact instructions on the docs, installed deps and did not install creole since I'm using py3.

Any ideas?

Django 1.9.2
Py 3.4.3

Make the primary image selection easier

Currently it's a dropdown with image pks. It should at least have the image file names, but even better would be some type of AJAX image browser in the admin that you could just select the thumbnail.

Add biblion to pinax-blog migration

either in docs or somehow as something runnable via management command:

https://gist.github.com/paltman/73cf67290df3e92790c29934fa8a56e5

once published, the obscure URL for a post should redirect to the real URL

Add image support to frontend editing

Image Support

• images: display image set thumbnails
• images: select the one that is primary
• images: use react image set frontend widget

Replace the images and image management with pinax-images

Add docs

Do we really need a Revision model?

@jtauber do we ever use this in all the instances we use this software?

Does anyone else?

Support front-end creation and editing of posts

as is done for pinax-pages, would be nice to support in pinax-blog

RuntimeErorr on the very first migration

When running the first migration after installing, this error was thrown:

RuntimeError: Model class django.contrib.sites.models.Site doesn't declare an explicit app_label and isn't in a
n application in INSTALLED_APPS.

I had to add django.contrib.sites to the INSTALLED_APPS and set SITE_ID = 1 in settings.py.

Is this related to #69?

Make sections something that is modeled rather than a setting

A model like:

class Section(models.Model):
    name = models.CharField(max_length=150)
    slug = models.SlugField(unique=True)

That the Post model would have a FK to instead of just storing integers that are calculated from the position of a section in the list, would make it a lot easier to add a section to the blog in run time.

I realize that this isn't something that happens frequently, but it just seems cleaner.

Add webhook receiver for Draft

https://draftin.com/documents/69898?token=5fjKKlZ0-AeBzqj_RAftAGdzRzl9VBfBHj5wpSWm_gU

Add obscure preview urls that don't require auth to view unpublished post

is there a context variable to get section list in templates

how to get list of sections in templates blog_list, blog_post?

Add RSS feed

Some forms of integration only support RSS. We should offer both feed types, not just ATOM.

Add tests