{ "info": { "author": "Eric Williams", "author_email": "eric@ehw.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Web Environment", "Framework :: Django :: 1.8", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "# django-xblog\nBlogging application for your Django site\n\n## Build Status\n\n[](https://travis-ci.org/rubeon/django-xblog) [](https://badge.fury.io/py/django-xblog)\n\n## Installation\n\nFrom github:\n\n```bash\n\n pip install https://github.com/rubeon/django-xblog/archive/master.zip\n\n```\n\nUsing git:\n\n```bash\n\n mkdir blog_project\n cd blog_project\n virtualenv .\n . bin/activate\n git clone git@github.com:rubeon/django-xblog.git\n cd django-xblog\n python setup install\n\n```\n\n\nThis will install xblog and its requirements.\n\n## Creating a Site\n\nAfter the above, go through the usual process:\n\n```bash\n\ndjango-admin startproject mysite\nvi mysite/settings\n\n```\nAdd the dependencies to `INSTALLED_APPS`:\n```python\n\n INSTALLED_APPS = [\n ...\n # following are for xblog\n 'django.contrib.sites',\n 'bootstrap3',\n 'markdown_deux',\n 'xblog',\n ]\n # Define a site, if not done already!\n SITE_ID=1\n\n```\n\n## URL Setup\n\nAdd a place to your site's root `urls.py` reach your blog, and don't forget to\nadd the `xblog` namespace:\n\n```python\n import xblog.urls\n\n urlpatterns = [\n url(r'^admin/', admin.site.urls),\n url(r'^blog/', include(xblog.urls, namespace=\"xblog\"),\n ]\n```\n\n## Creating users\n\nXBlog uses the Django authentication framework to keep track of users. `Users`\nare linked to `Authors`, which can serve as the User profile model.\n\nAuthor profiles are created automatically in the `User` model's `post_save`\nsignal. See `xblog/models.py:create_profile` for reference.\n\n## Adding to your templates\n\nXBlog defines the following content blocks:\n\n* `maincontent` - the main Blog content with archives, posts, etc.\n\n* `rightnav` - Blog roll, archive links, etc.\n\n* `leftnav` - navigation block including ...(FIXME: whut?)\n\n* `extrahead` - adds meta tags depending on the content being shown:\n\n```html\n