semvec/pypi-packages huggingface dataset:
djcms-blog 0.2.4
Simple Django Blog app using Markdown
License: MIT license
Keywords: djcms_blog

# 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.
djcms-blog-plugin 0.1.3
DjangoCMS Blog plugin
License: MIT license
Keywords: djcms_blog_plugin

# DjangoCMS Blog plugin


![image](https://img.shields.io/pypi/v/djangocms_blog_plugin.svg%0A%20%20%20%20%20:target:%20https://pypi.python.org/pypi/djangocms_blog_plugin)

![image](https://img.shields.io/travis/carlosmart626/djangocms_blog_plugin.svg%0A%20%20%20%20%20:target:%20https://travis-ci.org/carlosmart626/djangocms_blog_plugin)

![image](https://readthedocs.org/projects/djangocms-blog-plugin/badge/?version=latest%0A%20%20%20%20%20:target:%20https://djangocms-blog-plugin.readthedocs.io/en/latest/?badge=latest%0A%20%20%20%20%20:alt:%20Documentation%20Status)

![image](https://pyup.io/repos/github/carlosmart626/djangocms_blog_plugin/shield.svg%0A%20%20:target:%20https://pyup.io/repos/github/carlosmart626/djangocms_blog_plugin/%0A%20%20:alt:%20Updates)

DjangoCMS Blog plugin is a plugin enabled for DjangoCMS to add a feed of your posts created in [djcms_blog](https://github.com/CarlosMart626/djcms_blog) in any page.

-   Free software: MIT license
-   Documentation: <https://djangocms-blog-plugin.readthedocs.io>.


## Features
* Support DjangoCMS
* Can define a Blog to display
* Can define how many entries to display

## Installation

Install using pip
```
pip install djcms_blog_plugin
```

Add to installed apps:
```
INSTALLED_APPS = (`
    # Your django apps
    'cms', # required django cms
    
    'djcms_blog', # required djcms_blog
    'djcms_blog_plugin',
```

## Settings

```
DJCMS_BLOG_ID = 1 # Defines the Main blog id
DJCMS_BLOG_ENTRIES_NUMBER # Define the number of entries to display in the widget
```

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

# virtualenv
python -m pytest . --cov=. --cov-report=term-missing
```


=======
History
=======

0.1.0 (2018-09-08)
------------------

* First release on PyPI.

0.1.3 (2019-03-03)
------------------

* Update author image updated in djcms_blog.