diff options
author | Rahul Nair <rn@rahul-nair.com> | 2017-08-04 07:47:36 +0530 |
---|---|---|
committer | Justin Mayer <entroP@gmail.com> | 2017-08-03 19:17:36 -0700 |
commit | 3f9ddddab6f49eb2d2df35d47de78c0dddea3088 (patch) | |
tree | 65be5b1919d6f2feff3f94a5f7f8e6cbc575253d /graymill/README.md | |
parent | 2a00d3cbf6ed7745ae3cd2f6a557bad31d4a3990 (diff) | |
download | pelican-themes-3f9ddddab6f49eb2d2df35d47de78c0dddea3088.tar.gz |
Add Graymill theme
Diffstat (limited to 'graymill/README.md')
-rw-r--r-- | graymill/README.md | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/graymill/README.md b/graymill/README.md new file mode 100644 index 0000000..0385813 --- /dev/null +++ b/graymill/README.md @@ -0,0 +1,85 @@ +## Graymill - A minimal Pelican theme. + +Graymill is a minimal, responsive theme for the [Pelican](http://blog.getpelican.com/) static site generator. It is based on the [Milligram CSS framework](http://milligram.io/). + +### Demo + +See the theme in action at [muchBits](https://muchbits.com) + +### Features + +* 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](https://search.google.com/test/mobile-friendly?utm_source=mft&utm_medium=redirect&utm_campaign=mft-redirect&id=TT7gCU77TVUWMMbu4pmHsg)) + +## Installation + +* Clone the repository: +```python +git clone https://github.com/rn4ir/graymill.git +``` +* Create a `THEME` variable in your `pelicanconf.py` file and set its value to the location of ***graymill*** theme, like so: +```python +THEME = 'path/to/graymill' +``` + +## Custom Variables + +(*Please refer to the sample pelicanconf.py contained in this repo for examples*) + +The ***Graymill*** theme use the following settings in the `pelicanconf.py`: + +### pelicanconf.py + +#### Social Icons: +```python +SOCIAL = (('linkedin', 'https://www.linkedin.com/in/username'), + ('github', 'https://github.com/username'), + ('twitter', 'https://twitter.com/username'), + ('facebook', 'https://facebook.com/userid'), + ) +``` + +#### Pagination: +```python +DEFAULT_PAGINATION = 8 +``` + +#### Home page parameters: + +```python +SITEDESCRIPTION = 'your-site's-tagline' +DISPLAY_SUMMARY = True +DISPLAY_PAGES_ON_MENU = True +``` + +#### Other Settings +```python +FAVICON = 'images/favicon.png' +STATIC_PATHS = ['images', 'extras'] +EXTRA_PATH_METADATA = { + 'extras/.htaccess': {'path': '.htaccess'}, + 'extras/robots.txt': {'path': 'robots.txt'}, +``` + +#### For local development: +``` +SITEURL = 'http://localhost:8000' +``` + +### publishconf.py + +When you are ready to publish your site add the following settings to `publishconf.py` file + +```python +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](http://docs.getpelican.com/en/3.6.3/publish.html) |