aboutsummaryrefslogtreecommitdiffstats
path: root/graymill/README.md
diff options
context:
space:
mode:
authorRahul Nair <rn@rahul-nair.com>2017-08-04 07:47:36 +0530
committerJustin Mayer <entroP@gmail.com>2017-08-03 19:17:36 -0700
commit3f9ddddab6f49eb2d2df35d47de78c0dddea3088 (patch)
tree65be5b1919d6f2feff3f94a5f7f8e6cbc575253d /graymill/README.md
parent2a00d3cbf6ed7745ae3cd2f6a557bad31d4a3990 (diff)
downloadpelican-themes-3f9ddddab6f49eb2d2df35d47de78c0dddea3088.tar.gz
Add Graymill theme
Diffstat (limited to 'graymill/README.md')
-rw-r--r--graymill/README.md85
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)