Metadata-Version: 2.1
Name: djcms-blog
Version: 0.2.4
Summary: Simple Django Blog app using Markdown
Home-page: https://github.com/carlosmart626/djcms_blog
Author: Carlos Martinez
Author-email: me@carlosmart.co
License: MIT license
Keywords: djcms_blog
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: django-simplemde (==0.1.2)
Requires-Dist: dj-markdown (==0.1.2)
Requires-Dist: Pillow (==5.4.1)
Requires-Dist: django


# Simple Django Blog

Simple Django Blog app using Markdown

* Free software: MIT license
* Documentation: https://djcms-blog.readthedocs.io.


## Features

* Works on pure Django
* Markdown blog post format
* Built-in template
* Multiple languages support
* SEO tags supported to customize

## Usage

### Install
Add the following apps to your INSTALLED_APPS in `settings.py`
```
INSTALLED_APPS += [
    'django.contrib.sitemaps',
    'dj_markdown',
    'simplemde',
    'django.contrib.humanize',
    'djcms_blog',
]
```
Add `django.middleware.locale.LocaleMiddleware` to MIDDLEWARE
```
MIDDLEWARE += [
    'django.middleware.locale.LocaleMiddleware',
]
```
Define default language and supported languages.
```
LANGUAGE_CODE = 'en'

LANGUAGES = [
    ('es', 'ES'),
    ('en', 'EN'),
]
```
Update your `urls.py` adding blog urls.
```
from django.conf.urls.i18n import i18n_patterns
from django.contrib.sitemaps.views import sitemap
from djcms_blog.sitemaps import PostsSitemap

sitemaps = {
    'blog': PostsSitemap,
}

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^sitemap\.xml$', sitemap, {'sitemaps': sitemaps}, name='sitemap'),
]

urlpatterns += i18n_patterns(
    url(r'^', include('djcms_blog.urls')),
)
```

## Configuration
You can define the following blog settings in your settings.

**DEFAULT_BLOG_ID** Define the default blog id to be used in the urls and links.

**DEFAULT_URL** URL to open the blog

**BLOG_TITLE** HTML title

**ROOT_TITLE** Title for links

**DJCMS_BLOG_CACHE_TIME** Cache time used in public views.

**MARKDOWN_CODE_CSS_THEME** Code theme for markdown code in the blog.

**DEFAULT_COVER_IMAGE** Cover image used in blog

**DEFAULT_NAVBAR_IMAGE** Image used as icon in navigation

### Example
In `settings.py`
```
# Blog config
DJCMS_BLOG_CACHE_TIME = 0
DEFAULT_BLOG_ID = 1
```

## Contributing
Install dev dependencies
```
pip install -r requirements_dev.txt
```
Run tests
```
pytest . --cov=. --cov-report=term-missing
```
Static Analysis
```
flake8 .
```

## Credits

This package was created with **Cookiecutter** and the `audreyr/cookiecutter-pypackage` project template.


# History


0.1.0 (2018-06-05)
------------------

* First release on PyPI.

0.2.4 (2019-03-03)
------------------

* Fix issue at blogs with slugs eg."test-blog".
* Added support to custom nav image.


