The Nikola Handbook | Nikola

All You Need to Know
What's Nikola and what can you do with it?
Creating a Blog Post
Jupyter Notebook metadata
Pelican/Markdown metadata
Mapping metadata from other formats
How does Nikola decide where posts should go?
The new_post command
Configuring tags and categories
What if I don’t want a blog?
Supported input formats
Configuring other input formats
Community shortcodes
Template-based shortcodes
The Global Context and Data files
Customizing Your Site
Getting Extra Themes
Automated rebuilds (GitHub Actions, GitLab)
Images and Galleries
Preserve all EXIF data
Preserve some EXIF data
Handling ICC Profiles
Post Processing Filters
Optimizing Your Website
reStructuredText Extensions
Importing your WordPress site into Nikola
Importing to a custom location or into an existing site
Getting Extra Plugins
Shell Tab Completion
After you have Nikola installed:
You can create a site with demo files in it with nikola init --demo mysite
The rest of these commands have to be executed inside the new mysite folder.
The filename should be in the output of the previous command. You can also use nikola new_post -e to open an editor automatically.
That should get you going. If you want to know more, this manual will always be here for you.
DON'T READ THIS MANUAL. IF YOU NEED TO READ IT I FAILED, JUST USE THE THING.
On the other hand, if anything about Nikola is not as obvious as it should be, by all means tell me about it :-)
Nikola is a static website and blog generator. The very short explanation is that it takes some texts you wrote, and uses them to create a folder full of HTML files. If you upload that folder to a server, you will have a rather full-featured website, done with little effort.
Its original goal is to create blogs, but it supports most kind of sites, and can be used as a CMS, as long as what you present to the user is your own content instead of something the user generates.
A software project's site (example)
Since Nikola-based sites don't run any code on the server, there is no way to process user input in forms.