Home

Custom settings

See what you can customize.

Maybe some Pelican settings not work properly.

Name	What does it do?
SITETITLE	Site title to show in sidebar.
SITESUBTITLE	Short description to show below subtitle.
SITELOGO	Profile picture to show above author name (absolute url).
SITEDESCRIPTION	Site description to use in meta tags.
OG_LOCALE	language_TERRITORY for Open Graph. Default is en_US.
COPYRIGHT_YEAR	Copyright year to display on footer.
CC_LICENSE	Creative Commons License to show on footer.
MENUITEMS	A list of tuples (Title, URL) for additional menu items to appear on main menu.
LINKS	A list of tuples (Title, URL) for links to appear on the sidebar menu.
SOCIAL	A list of tuples (name, URL) to appear in the "social" section.
MAIN_MENU	Show main menu.
ROBOTS	Robots meta tag value.
CUSTOM_CSS	Path to a CSS file.
ADD_THIS_ID	AddThis public id.
DISQUS_SITENAME	Disqus website's shortname to activate Disqus.
GOOGLE_ANALYTICS	Activate Google Analytics.
GUAGES	Activate Guag.es analytics.
GOOGLE_TAG_MANAGER	Activate Google Tag Manager.
STATUSCAKE	Show StatusCake Uptime badge on footer.
PIWIK_ID	ID for the monitored website. You can find the ID in the Piwik admin interface > Settings > Websites.
PIWIK_URL	URL to your Piwik server - without ‘http://‘ at the beginning.

Example

AUTHOR = 'Foo Bar'
SITEURL = 'http://yoursite.com'
SITENAME = 'Foo Bar\'s Blog'
SITETITLE = 'Foo Bar'
SITESUBTITLE = 'Web Developer'
SITEDESCRIPTION = 'Foo Bar\'s Thoughts and Writings'
SITELOGO = 'http://yoursite.com/img/profile.png'

FAVICON = SITEURL + '/images/favicon.ico'
ROBOTS = 'index, follow'

COPYRIGHT_YEAR = 2015
CC_LICENSE = { 'name': 'Creative Commons Attribution-ShareAlike', 'version':'4.0', 'slug': 'by-sa' }

EXTRA_PATH_METADATA = {
    'extra/custom.css': {'path': 'static/custom.css'},
}
CUSTOM_CSS = 'static/custom.css'

MAIN_MENU = True

ADD_THIS_ID = 'ra-77hh6723hhjd'
DISQUS_SITENAME = 'yoursite'
GOOGLE_ANALYTICS = 'UA-1234-5678'
GOOGLE_TAG_MANAGER = 'GTM-ABCDEF'
STATUSCAKE = { 'trackid': 'your-id', 'days': 7 }

If you want a full working example take a look here.

How main menu works?

If MAIN_MENU = True, the order is: Home, MENUITEMS, Atom and RSS if available.

How sidebar menu works?

The order is Pages and LINKS. LINKS are shown in a new page.

How social menu works?

All icons are provided by Font Awesome.

A set of icons have custom background, for this you must follow the names below:

• envelope-o (for email)
• facebook
• github
• github-alt
• google
• linkedin
• pinterest
• rss
• stack-overflow
• twitter
• youtube

Example:

SOCIAL = (('linkedin', 'https://br.linkedin.com/in/alexandrevicenzi/en'),
          ('github', 'https://github.com/alexandrevicenzi'),)

If you need more icons, you will need to add a custom background to keep all icons similar.

Custom File Metadata

Name	What does it do?
Summarize	Enable Home summary.
Cover	Cover image for social sharing (absolute url).
og_locale	Open graph locale for article.

By default, all article content is shown on Home. If the article has a custom Summary, the custom summary is shown. If the article has Summarize: True metadata, the default article summary is shown.

Code Highlight

If you want to replace Pygments theme (default is GitHub) take a look at Pygments Docs and replace pygments.min.css.