Graymill is a minimal, responsive theme for the Pelican static site generator. It is based on the Milligram CSS framework.
See the theme in action at muchBits
- Syntax highlighting for code blocks
- Easy to install
- Minimal/No Javascript (JS is only used in case Google Analytics is enabled).
- Google Analytics Support
- Responsive (Mobile Friendly Test on Google)
- Clone the repository:
git clone https://github.com/rn4ir/graymill.git
- Create a
THEME
variable in yourpelicanconf.py
file and set its value to the location of graymill theme, like so:
THEME = 'path/to/graymill'
(Please refer to the sample pelicanconf.py contained in this repo for examples)
The Graymill theme use the following settings in the pelicanconf.py
:
SOCIAL = (('linkedin', 'https://www.linkedin.com/in/username'),
('github', 'https://github.com/username'),
('twitter', 'https://twitter.com/username'),
('facebook', 'https://facebook.com/userid'),
)
DEFAULT_PAGINATION = 8
SITEDESCRIPTION = 'your-site's-tagline'
DISPLAY_SUMMARY = True
DISPLAY_PAGES_ON_MENU = True
FAVICON = 'images/favicon.png'
STATIC_PATHS = ['images', 'extras']
EXTRA_PATH_METADATA = {
'extras/.htaccess': {'path': '.htaccess'},
'extras/robots.txt': {'path': 'robots.txt'},
SITEURL = 'https://localhost:8000'
When you are ready to publish your site add the following settings to publishconf.py
file
SITEURL = 'https://domain-name.tld'
FEED_ALL_ATOM = 'feeds/all.atom.xml'
CATEGORY_FEED_ATOM = 'feeds/%s.atom.xml'
GOOGLE_ANALYTICS = ""
For more information on publishing your site, please read the Pelican publishing docs