diff options
author | molivier <olivier.matthieu@gmail.com> | 2015-02-19 14:36:06 +0100 |
---|---|---|
committer | molivier <olivier.matthieu@gmail.com> | 2015-02-19 14:36:06 +0100 |
commit | 6e549e7debf00e3bc347b7dc577f5758807a87d9 (patch) | |
tree | 77512bbd241a9e90cc413aa551996e4ed14432a2 /README.md |
Added template files
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 141 |
1 files changed, 141 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..2c5b215 --- /dev/null +++ b/README.md @@ -0,0 +1,141 @@ +# Nest + +Nest is a theme for [Pelican](http://getpelican.com) 3.5, a static site generator written in Python. + +I initially created this theme for [my blog](http://www.molivier.com), but now the theme is supposed to be generic enough to have its own repository. + +## Screenshots + +### Homepage + +![Nest Index View](homepage.png) + +### Homepage with background + +![Nest Article View](homepage-background.png) + +Add a background image by configuring `NEST_HEADER_IMAGES` parameter in your pelican.conf. Image should be located in `content/images` directory. + +### Article + +![Nest Index View](article.png) + +### Article with background + +![Nest Article View](article-background.png) + +Add a background image by adding `Illustration` custom parameter in your markdown article. Image should be located in `content/images` directory. + + Title: Ubuntu Install + Date: 2015-02-18 16:00 + Category: server + Tags: ubuntu, kernel + Slug: ubuntu-install + Author: Matthieu OLIVIER + Illustration: background.jpg + + +## Features + +* Featured site header image +* Featured article header image +* **Pygments** syntax highlighting +* **Disqus** support for comments +* **Google Analytics** support +* RSS and Atom feeds + +## Settings + +Nest template can be customized by adding parameters to your `pelicanconf.py` file. Template specifics parameters are prefixed with template name. + +### Pelican.conf example + + :::python + # NEST Template + THEME = 'nest' + SITESUBTITLE = u'My Awesome Blog' + # Minified CSS + NEST_CSS_MINIFY = True + # Add items to top menu before pages + MENUITEMS = [('Homepage', '/'),('Categories','/categories.html')] + # Add header background image from content/images : 'background.jpg' + NEST_HEADER_IMAGES = '' + # Footer + NEST_SITEMAP_COLUMN_TITLE = u'Sitemap' + NEST_SITEMAP_MENU = [('Archives', '/archives.html'),('Tags','/tags.html'), ('Authors','/authors.html')] + NEST_SITEMAP_ATOM_LINK = u'Atom Feed' + NEST_SITEMAP_RSS_LINK = u'RSS Feed' + NEST_SOCIAL_COLUMN_TITLE = u'Social' + NEST_LINKS_COLUMN_TITLE = u'Links' + NEST_COPYRIGHT = u'© blogname 2015' + # index.html + NEST_INDEX_HEAD_TITLE = Homepage' + NEST_INDEX_HEADER_TITLE = u'My Awesome Blog' + NEST_INDEX_HEADER_SUBTITLE = u'Smashing The Stack For Fun And Profit' + NEST_INDEX_CONTENT_TITLE = u'Last Posts' + # archives.html + NEST_ARCHIVES_HEAD_TITLE = u'Archives' + NEST_ARCHIVES_HEAD_DESCRIPTION = u'Posts Archives' + NEST_ARCHIVES_HEADER_TITLE = u'Archives' + NEST_ARCHIVES_HEADER_SUBTITLE = u'Archives for all posts' + NEST_ARCHIVES_CONTENT_TITLE = u'Archives' + # article.html + NEST_ARTICLE_HEADER_BY = u'By' + NEST_ARTICLE_HEADER_MODIFIED = u'modified' + NEST_ARTICLE_HEADER_IN = u'in category' + # author.html + NEST_AUTHOR_HEAD_TITLE = u'Posts by' + NEST_AUTHOR_HEAD_DESCRIPTION = u'Posts by' + NEST_AUTHOR_HEADER_SUBTITLE = u'Posts archives' + NEST_AUTHOR_CONTENT_TITLE = u'Posts' + # authors.html + NEST_AUTHORS_HEAD_TITLE = u'Author list' + NEST_AUTHORS_HEAD_DESCRIPTION = u'Author list' + NEST_AUTHORS_HEADER_TITLE = u'Author list' + NEST_AUTHORS_HEADER_SUBTITLE = u'Archives listed by author' + # categories.html + NEST_CATEGORIES_HEAD_TITLE = u'Categories' + NEST_CATEGORIES_HEAD_DESCRIPTION = u'Archives listed by category' + NEST_CATEGORIES_HEADER_TITLE = u'Categories' + NEST_CATEGORIES_HEADER_SUBTITLE = u'Archives listed by category' + # category.html + NEST_CATEGORY_HEAD_TITLE = u'Category Archive' + NEST_CATEGORY_HEAD_DESCRIPTION = u'Category Archive' + NEST_CATEGORY_HEADER_TITLE = u'Category' + NEST_CATEGORY_HEADER_SUBTITLE = u'Category Archive' + # pagination.html + NEST_PAGINATION_PREVIOUS = u'Previous' + NEST_PAGINATION_NEXT = u'Next' + # period_archives.html + NEST_PERIOD_ARCHIVES_HEAD_TITLE = u'Archives for' + NEST_PERIOD_ARCHIVES_HEAD_DESCRIPTION = u'Archives for' + NEST_PERIOD_ARCHIVES_HEADER_TITLE = u'Archives' + NEST_PERIOD_ARCHIVES_HEADER_SUBTITLE = u'Archives for' + NEST_PERIOD_ARCHIVES_CONTENT_TITLE = u'Archives for' + # tag.html + NEST_TAG_HEAD_TITLE = u'Tag archives' + NEST_TAG_HEAD_DESCRIPTION = u'Tag archives' + NEST_TAG_HEADER_TITLE = u'Tag' + NEST_TAG_HEADER_SUBTITLE = u'Tag archives' + # tags.html + NEST_TAGS_HEAD_TITLE = u'Tags' + NEST_TAGS_HEAD_DESCRIPTION = u'Tags List' + NEST_TAGS_HEADER_TITLE = u'Tags' + NEST_TAGS_HEADER_SUBTITLE = u'Tags List' + NEST_TAGS_CONTENT_TITLE = u'Tags List' + NEST_TAGS_CONTENT_LIST = u'tagged' + # Static files + STATIC_PATHS = ['images', 'extra/robots.txt', 'extra/favicon.ico', 'extra/logo.svg'] + EXTRA_PATH_METADATA = { + 'extra/robots.txt': {'path': 'robots.txt'}, + 'extra/favicon.ico': {'path': 'favicon.ico'}, + 'extra/logo.svg': {'path': 'logo.svg'} + } + + +## Third-party assets + +The theme uses external softwares, scripts, libraries and artworks: + +* [Bootstrap](http://getbootstrap.com/) 3.x.x +* [Open Sans Font](http://www.google.com/fonts/specimen/Open+Sans) |