Documentation is hosted at https://ntinikola_chameleon.readthedocs.io/
Nikola uses a custom mechanism
to find plugins instead of using the usual
That makes it incredibly difficult to install plugins; it’s not enough
pip install a package from PyPI. Instead, you must also
.plugin file to a particular location on disk. This can be:
pluginsdirectory of your Nikola site.
Beside that ‘.plugin’ file there must also be a ‘.py’ file of the same name that the plugin lists as a module (yes, even though the plugin file specifically requests a Python module, yapsy requires that it be a file or directory beside the plugin file—so not really a module).
It’s ridiculous to require everyone to copy plugins into their plugin
folder (they’re not even correctly on
sys.path, meaning that
zope.configuration and many other tools won’t work) and we don’t plan
to let Nikola do that automatically (we’re not on the Nikola plugin
index and won’t be until they let us do standard installs), so the
best we can do is attempt to workaround yapsy’s limitations.
Into your site’s plugin directory, place the following .py file:
# nti_nikola_chameleon.py from nti.nikola_chameleon import *
Beside that, you’ll need a
# -*- mode: conf; -*- [Core] Name = nti.nikola_chameleon Module = nti_nikola_chameleon [Documentation] Author = NextThought Version = 1.0 Website = https://github.com/NextThought/nti.nikola_chameleon Description = Support for Chameleon ZPT templates. [Nikola] PluginCategory = Template
This documentation is a work in progress.
- Getting Started
- Creating a Theme
- An Introduction to the Zope Component Architecture
- Leveraging the Component Architecture
- Using Macros
- Using Viewlets
- Theme Inheritance
- Path Helpers
- API Reference
nti.nikola_chameleon is hosted at GitHub: