schtobia/flex
1
0
Fork 0
Code Issues Pull requests Activity
flex/README.md
Alexandre Vicenzi f0b522d804 Better code examples.
2015-07-18 21:43:25 -03:00

2.7 KiB
Raw Blame History

Flex

A minimalist Pelican theme.

Features

  • Mobile First
  • Responsive
  • Semantic
  • SEO Best Practices

Integrations

  • Disqus
  • Google Analytics
  • Google Tag Manager
  • StatusCake

Custom settings

See what you can customize.

Maybe some Pelican settings not work properly.

Name What does it do?
AUTHOR_SHORT_DESC Short description to show below author name.
AUTHOR_IMG_URL Profile picture to show above author name.
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.
DISQUS_SITENAME Disqus website's shortname to activate Disqus.
GOOGLE_ANALYTICS Activate Google Analytics.
GOOGLE_TAG_MANAGER Activate Google Tag Manager.
STATUSCAKE Show StatusCake Uptime badge on footer.

Example

AUTHOR_SHORT_DESC = 'Web Developer
AUTHOR_IMG_URL = '/static/img/me.png'
COPYRIGHT_YEAR = 2015
CC_LICENSE = { 'name': 'Creative Commons Attribution-ShareAlike', 'version':'4.0', 'slug': 'by-sa') }
MAIN_MENU = True
DISQUS_SITENAME = 'yoursite'
GOOGLE_ANALYTICS = 'UA-1234-5678'
GOOGLE_TAG_MANAGER = GTM-ABCDEF
STATUSCAKE = { 'trackid': 'your-id', 'days': 7 }

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 above:

  • email
  • facebook
  • github
  • github-alt
  • google
  • linkedin
  • pinterest
  • rss
  • 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?
Summarise Enable Home summary

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 Summarise: True metadata, the default article summary is shown.

Live example

You can find a demo here.

Screenshot

License

MIT