Add theme settings page

This commit is contained in:
Raymond Wanyoike 2016-11-29 15:59:36 +03:00
commit 64c76f7806

109
content/pages/settings.md Normal file
View file

@ -0,0 +1,109 @@
Title: Settings
Unless otherwise specified, settings that refer to paths can be either absolute or relative to the configuration file.
#### SITESUBTITLE
Subtitle that appears in the header:
SITESUBTITLE = 'A magical \u2728 Pelican theme'
#### SITEIMAGE
Image that appears in the header:
SITEIMAGE = '/images/profile.png'
You can also force the image size:
SITEIMAGE = '/images/profile.svg width=200 height=200'
#### DESCRIPTION
Index `<meta name="description" content="...">`:
DESCRIPTION = 'A functional, clean, responsive theme for Pelican. Heavily ' \
'inspired by crowsfoot and clean-blog, powered by Bootstrap.'
#### LINKS
A list of tuples (Title, URL) for menu links:
LINKS = (
('Pelican', 'http://getpelican.com/'),
('Python.org', 'http://python.org/'),
('Jinja2', 'http://jinja.pocoo.org/'),
)
#### ICONS
A list of tuples (Icon, URL) for icon links:
ICONS = (
('feed', '/feeds/all.atom.xml'),
('github', 'https://github.com/nairobilug/pelican-alchemy'),
)
A [Font Awesome icon](http://fontawesome.io/icons/) without the `fa-` prefix.
#### PYGMENTS_STYLE
You can choose one of the built-in Pygments styles for syntax highlighting.
By default the `default` style is used:
PYGMENTS_STYLE = 'default'
The following styles are available:
- algol
- algol_nu
- autumn
- borland
- bw
- colorful
- default
- emacs
- friendly
- fruity
- igor
- lovelace
- manni
- monokai
- murphy
- native
- paraiso-dark
- paraiso-light
- pastie
- perldoc
- rrt
- tango
- trac
- vim
- vs
- xcode
For a demo of the different styles, click [here](http://pygments.org/demo/).
#### HIDE_AUTHORS
Hide the author(s) of an article - useful for single author sites:
HIDE_AUTHORS = True
#### NEW_FAVICONS
Use a [realfavicongenerator](https://realfavicongenerator.net/blog/new-favicon-package-less-is-more/) favicon package:
NEW_FAVICONS = True
#### Other Settings
DISQUS_SITENAME = '...'
GAUGES = '...'
GOOGLE_ANALYTICS = '...'
PIWIK_URL = '...'
PIWIK_SITE_ID = '...'
An RSS icon will also appear on header if `FEED_ALL_ATOM` is set.