Nikola

Under Construction

Setting up Nikola.

In Pelican and Nikola regular markdown syntax to insert an image is:

![Under Construction](/images/under_construction.jpg)

I always keep my images in a folder called images I want this folder to be copied verbatim to the output folder (which I call output)

The source of the images folder is:

-->Files

---->images

------>under_construction.jpg

which means under_construction.jpg will be copied to

-->output

---->images

------>under_construction.jpg

From how-to-insert-pictures-into-posts-in-nikola

If you want Nikola to recognise markdown and ipynb posts then conf.py must contain a reference to .md and .ipynb

e.g. for Markdown ==> ("posts/*.md", "posts", "post.tmpl"), has to be in the POSTS or PAGES

POSTS = (
    ("posts/*.rst", "posts", "post.tmpl"),
    ("posts/*.md", "posts", "post.tmpl"),
    ("posts/*.ipynb", "posts", "post.tmpl"),
    ("posts/*.txt", "posts", "post.tmpl"),
    ("posts/*.html", "posts", "post.tmpl"),
)
PAGES = (
    ("stories/*.rst", "stories", "story.tmpl"),
    ("posts/*.md", "posts", "post.tmpl"),
    ("posts/*.ipynb", "posts", "post.tmpl"),
    ("stories/*.txt", "stories", "story.tmpl"),
    ("stories/*.html", "stories", "story.tmpl"),
)

Ref: Nikola Handbook

Misc Nikola commands

nikola plugin --list-installed

Lists all installed plugins

nikola  new_post -f markdown

creates a new post in markdown rather then the default RST

[stephen@macbook.local] Thu Jun 09 ~/sites/website/output
[15] 14:09:30--> nikola check -f --clean-files
Scanning posts..........done!
[2016-06-09T04:09:43Z] WARNING: check: Files from unknown origins (orphans):
[2016-06-09T04:09:43Z] WARNING: check: output/test.txt

Checks if the output folder can be generated by the posts (and Pages?) folder, the -f --clean-files removes any file such as test.txt that can't be gerneated by the input folders (Pages, Posts) In this case I manually created test.txt