Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jseabold/pelican-fresh

Fresh is a responsive Pelican theme. This theme uses HTML5 and its layout is responsive -- thanks to Smashing HTML5 and Twitter Bootstrap.
https://github.com/jseabold/pelican-fresh

Last synced: 3 months ago
JSON representation

Fresh is a responsive Pelican theme. This theme uses HTML5 and its layout is responsive -- thanks to Smashing HTML5 and Twitter Bootstrap.

Lists

README

        

# Fresh: a responsive Pelican theme that uses HTML5

Fresh is a responsive [Pelican](http://getpelican.com) theme.
This theme uses HTML5 and its layout is responsive -- thanks to [Smashing HTML5](http://coding.smashingmagazine.com/2009/08/04/designing-a-html-5-layout-from-scratch/) and [Twitter Bootstrap](http://twitter.github.com/bootstrap/).

You can watch a live demo for the Fresh theme [here](http://jsliang.com/pelican-fresh-demo/blog/).

## Features

* Google Analytics
* DISQUS comment system
* Custom link lists
* Social widgets
* "Fork me on GitHub" ribbon
* **Google Custom Search Engine** -- use this as your search bar!
* **Hide categories from menu**
* Syntax highlighting for code blocks

## Settings

The Fresh theme supports most built-in global variables of Pelican. There are also theme-specific global variables that allow you to add a search bar or to hide categories from menu.

### Built-in Global Variables

The theme supports most Pelican built-in global variables, and some of them are listed below.

* `GOOGLE_ANALYTICS`
* `DISQUS_SITENAME`
* `LINKS = (('name1', 'url1'), ('name2', 'url2'))`
* `SOCIAL = (('name1', 'url1'), ('name2', 'url2'))`
* `GITHUB_URL`

Refer to [Pelican's documentation of settings](http://docs.getpelican.com/en/latest/settings.html) for description of these global variables.

### Theme-specific Global Variables

The theme also provides these global variables:

* `GOOGLE_CUSTOM_SEARCH = 'your search engine unique ID'`

The Fresh theme allows you to use [Google Custom Search Engine](http://www.google.com/cse/) as the search engine for your static website.

Find the **search engine unique ID** of your customized search engine in Google Custom Search Engine's [control panel](http://www.google.com/cse/manage/all).
Assign this ID to the `GOOGLE_CUSTOM_SEARCH` variable in your configuration, and a Google custom search bar will appear in the navigation bar.

* `HIDE_CATEGORIES_FROM_MENU = True`

If you want to hide categories from menu, you can do so by setting `HIDE_CATEGORIES_FROM_MENU` to `True` in your configuration.

## License

Copyright (c) 2013, Jui-Shan Liang <[email protected]>

All rights reserved.

Licensed under GPL v2.