Skip to content

seanh/html5.flav

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A customizable HTML5 flavour for Pyblosxom.

Features

  • Minimal, valid HTML5.

  • Semantic HTML5 elements including <header> and <hgroup>, <nav>, <article>, <footer> and <time>.

  • rel="alternate" links to the Atom and RSS feeds.

  • A rel="author" link in the site <footer>. This uses your py["blog_author"] config.py setting and a py["author_link"] config.py setting for the href. For example:

    py["blog_author"] = "Sean Hammond"
    py["author_link"] = "http://seanh.cc/"
  • A rel="license" link in the site <footer>. Uses your py["blog_rights"] config.py setting.

  • Favicon support, add a line to your config.py file like:

    py["favicon"] = "http://static.example.com/favicon.ico"
  • Customization support, in your config.py file you can specify custom elements and attributes to be inserted into the templates. See below.

Installation

git clone or download this repo into an html5.flav directory in your flavours directory, then set:

py["default_flavour"] = "html5"

in your config.py file.

Customization

There are lots of optional config file settings that can be used to insert HTML elements and attributes into the templates, for example to insert links to CSS files or to add CSS classes.

For now, to find all the settings search the template files for $(.

For example, here are some config.py settings that include some CSS and JavaScript files from Bootstrap and add a few CSS classes, to create a simple Bootstrap theme:

py["head_elements"] = """
  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css" />
  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap-theme.min.css" />
  <link rel="stylesheet" href="http://static.seanh.cc/circa.seanh.cc.css" />
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
  <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
"""
py["body_attrs"] = 'class="page"'
py["header_attrs"] = 'class="main-header"'
py["header_nav_ul_attrs"] = 'class="list-unstyled list-inline"'
py["article_attrs"] = 'class="post"'
py["article_footer_attrs"] = 'class="text-muted post-footer"'
py["article_footer_ul_attrs"] = 'class="list-unstyled list-inline"'
py["footer_attrs"] = 'class="text-muted"'
py["footer_ul_attrs"] = 'class="list-unstyled list-inline"'

With these settings http://static.seanh.cc/circa.seanh.cc.css would be a link to a CSS file containing custom CSS rules to be applied on top of Bootstrap's, for example:

.page {
  margin-top:2em;
  margin-left:2em;
}

.main-header {
  margin-bottom:3em;
}

.post {
  margin-bottom:3em;
}

.post-footer {
  margin-top:2em;
}

About

A customizable HTML5 flavour for Pyblosxom

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published