pelican-clean-blog/README.md
2014-12-10 16:21:12 -02:00

115 lines
2.4 KiB
Markdown

# Pelican Clean Blog Theme
Theme based in Clean Blog layout.
![Screenshot](https://archive.org/download/6731240/6731240.png)
## Basic configuration
All configurations about this theme.
### Header Covers
To define custom header cover, set the property ``HEADER_COVER`` in ``pelicanconf.py``:
```python
HEADER_COVER = 'static/my_image.png'
```
### Social URLs
Github, Twitter and Facebook URLs set these properties:
```python
GITHUB_URL = 'http://github.com/myprofile'
TWITTER_URL = 'http://twitter.com/myprofile'
FACEBOOK_URL = 'http://facebook.com/myprofile'
```
If you have insert new links, customize ``base.html``.
### Code highlights
This theme contains this color schemes:
- Tomorrow - ``tomorrow.css``;
- Tomorrow Night - ``tomorrow_night.css``;
- Monokai - ``monokai.css``;
- Github - ``github.css``;
- Darkly (Default) - ``darkly.css``;
To customize, define ``COLOR_SCHEME_CSS`` in ``pelicanconf.py`` with css filename. Example:
```python
COLOR_SCHEME_CSS = 'monokai.css'
```
### Articles
To customize header cover to articles, insert the metadata ``header_cover``:
- To RST
```rst
My super title
##############
:date: 2010-10-03 10:20
:modified: 2010-10-04 18:40
:tags: thats, awesome
:category: yeah
:slug: my-super-post
:authors: Alexis Metaireau, Conan Doyle
:summary: Short version for index and feeds
:header_cover: /images/posts/super-title/cover.png
```
- To Markdown
```markdown
Title: My super title
Date: 2010-12-03 10:20
Modified: 2010-12-05 19:30
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Authors: Alexis Metaireau, Conan Doyle
Summary: Short version for index and feeds
Header_Cover: /images/posts/super-title/cover.png
This is the content of my super blog post.
```
Other metada was created to assign resume of article, with ``headline``:
- To RST
```rst
My super title
##############
:date: 2010-10-03 10:20
:modified: 2010-10-04 18:40
:tags: thats, awesome
:category: yeah
:slug: my-super-post
:authors: Alexis Metaireau, Conan Doyle
:summary: Short version for index and feeds
:headline: Resume of article
```
- To Markdown
```markdown
Title: My super title
Date: 2010-12-03 10:20
Modified: 2010-12-05 19:30
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Authors: Alexis Metaireau, Conan Doyle
Summary: Short version for index and feeds
Headline: Resume of article
This is the content of my super blog post.
```
Image and Layout Source: http://ironsummitmedia.github.io/startbootstrap-clean-blog/