aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoraleylara <ingirtere@gmail.com>2021-02-25 17:10:51 +1100
committeraleylara <ingirtere@gmail.com>2021-02-25 17:10:51 +1100
commit7e039d6d647c23b8532f20aea92992b8e9338750 (patch)
tree8edc9110359ea0300fb9bbab4c0f32e7f097c05d
parentedcc3440dde15e05f71d494798d8c0a45b9f7427 (diff)
downloadpelican-themes-7e039d6d647c23b8532f20aea92992b8e9338750.tar.gz
Update README.md
-rw-r--r--Peli-Kiera/README.md74
1 files changed, 49 insertions, 25 deletions
diff --git a/Peli-Kiera/README.md b/Peli-Kiera/README.md
index 1a9b6b2..1a734a1 100644
--- a/Peli-Kiera/README.md
+++ b/Peli-Kiera/README.md
@@ -24,14 +24,29 @@ In order to get read times and links between articles, the theme requires [pelic
```bash
cd project-dir/
+# Please note the plugins repo is quite large and you only need the two.
git clone https://github.com/getpelican/pelican-plugins
# Add path to your plugins directory in pelicanconf.py
PLUGIN_PATHS = ['pelican-plugins']
PLUGINS = ['readtime', 'neighbors']
+```
+A sample article header.
+```html
+Title: Simple is better than complex
+Date: 2018-11-14
+Tags: python, jupyter, library
+Description:
+Category:
-# Go ahead create few articles and populate output
-pelican ./content
+### Introduction
+
+This is a standard paragraph. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
+```
+Go ahead and create few articles in respective directories.
+```bash
+# Generate articles and populate output
+pelican content -o output -s pelicanconf.py
# start the local server on http://localhost:8000/
pelican --autoreload --listen
```
@@ -40,31 +55,39 @@ Final project directory structure should look similiar to this.
```bash
(Pelican) ➜ project-dir tree
-│
-├── content
-│   ├── images
-│   │   ├── camera-2008479_640.png
-│   │   ├── camera-wide.png
-│   │   └── wide-wide.png
-│   ├── pages
-│   │   └── about.md
-│   └── Posts
-│   ├── article-one.md
-│   └── article-two.md
+│
├── Makefile
-├── output    
+├── content/
+│ ├── Blog Posts/
+│ │ ├── article-one.md
+│ │ ├── article-two.md
+│ │ └── article-three.md
+│ ├── Research/
+│ │ ├── article-one.md
+│ │ ├── article-two.md
+│ │ └── article-three.md
+│ ├── images/
+│ │ ├── camera-2008479_640.png
+│ │ ├── camera-wide.png
+│ │ └── wide-wide.png
+│ └── pages/
+│ └── about.md
+├── output/
+│
├── pelicanconf.py
-├── pelican-plugins
+├── pelican-plugins/
│   ├── neighbors
-│   │  
+│   │   ├── Readme.rst
+│   │   ├── __init__.py
+│   │   └── neighbors.py
│   └── readtime
-│  
+│   ├── README.md
+│   ├── __init__.py
+│   └── readtime.py
├── publishconf.py
-├── __pycache__
-│  
├── tasks.py
└── themes
- └── Peli-Kiera
+ └── Peli-Kiera/
```
### Settings
@@ -78,17 +101,18 @@ from __future__ import unicode_literals
AUTHOR = 'Author'
COPYRIGHT = '2019'
SITENAME = 'Site-Name'
-SITEURL = ''
-SITESUBTITLE = Site Subtitle'
+SITEURL = 'https://my-pelican-blog-address.io'
+SITESUBTITLE = 'Site Subtitle'
PATH = 'content'
TIMEZONE = 'America/New_York'
DEFAULT_LANG = 'en'
THEME = 'themes/Peli-Kiera'
-PLUGIN_PATHS = ['plugins']
+PLUGIN_PATHS = ['pelican-plugins']
PLUGINS = ['readtime', 'neighbors']
STATIC_PATHS = ['images']
-SUMMARY_MAX_LENGTH = 60
+# Article summary length on main index page
+SUMMARY_MAX_LENGTH = 100
DEFAULT_PAGINATION = 10
GITHUB_URL = 'https://github.com/'
@@ -133,7 +157,7 @@ The pagination is presented with the current page and 3 neighboring pages on eit
Images can be moved on page by adding the tag `#float-right`, `#float-left`, `#mid` and `#full` in your markdown.
-```markdown
+```bash
![Title]({static}/images/my_image-600x400.png#float-right "")
```