Nikola Documentation

Those are the docs for the current GitHub master. It might be incompatible with the stable release. The docs for the stable release are available on the Nikola website.

Please note that some examples of Nikola-specific reST syntax might not be visible in this version of Nikola docs.

• The Nikola Handbook
  • All You Need to Know
  • What’s Nikola and what can you do with it?
  • Getting Help
  • Why Static?
  • Components
  • Getting Started
  • Creating a Blog Post
    • Metadata fields
      • Basic
      • Extra
    • Metadata formats
      • reST-style comments
      • Two-file format
      • Jupyter Notebook metadata
      • YAML metadata
      • TOML metadata
      • reST docinfo
      • Markdown metadata
      • HTML meta tags
      • Mapping metadata from other formats
    • Multilingual posts
    • How does Nikola decide where posts should go?
    • The new_post command
    • Teasers
    • Drafts
    • Private Posts
    • Queuing Posts
    • Post Types
    • Indexes
      • Settings
      • Static indexes
    • Post taxonomy
      • Tags
      • Categories
      • Sections
      • Configuring tags, categories and sections
    • What if I don’t want a blog?
  • Creating a Page
  • Supported input formats
    • Configuring other input formats
      • Markdown
      • Jupyter Notebook
      • HTML
      • PHP
      • Pandoc
  • Shortcodes
    • Using a shortcode
    • Built-in shortcodes
    • Community shortcodes
    • Template-based shortcodes
  • The Global Context and Data files
  • Redirections
  • Configuration
  • Customizing Your Site
  • Fancy Dates
  • Adding Files
  • Custom Themes
  • Getting Extra Themes
  • Deployment
    • Deploying to GitHub
    • Automated rebuilds with Travis CI
    • Automated rebuilds with GitLab
  • Comments
  • Images and Galleries
    • Embedding Images
  • Handling EXIF Data
    • Strip all EXIF data
    • Preserve all EXIF data
    • Preserve some EXIF data
  • Handling ICC Profiles
  • Post Processing Filters
  • Optimizing Your Website
  • Math
    • Configuration
    • Inline usage
    • Display usage
  • reStructuredText Extensions
    • Includes
    • Media
    • YouTube
    • Vimeo
    • Soundcloud
    • Code
    • Listing
    • Gist
    • Thumbnails
    • Chart
    • Doc
    • Post List
  • Importing your WordPress site into Nikola
    • Importing to a custom location or into an existing site
  • Using Twitter Cards
  • Custom Plugins
  • Getting Extra Plugins
  • Advanced Features
    • Debugging
    • Shell Tab Completion
  • License
• Creating a Site (Not a Blog) with Nikola
• Creating a Theme
  • Checking It Out
  • Starting From Somewhere
  • Basic CSS
  • Page Layout
  • Typography
  • Customization
  • Bundles
  • The End
• Theming Nikola
  • The Structure
  • Theme meta files
  • Templates
  • Built-in templates
  • Variables available in templates
  • Customizing themes to user color preference and section colors
  • Identifying and customizing different kinds of pages with a shared template
  • Messages and Translations
  • LESS and Sass
• Global variables
• Per-page local variables
• Variables available in post pages (post.tmpl, page.tmpl etc.)
• Variables available in post lists
• Variables available in indexes
• Variables available in taxonomies
  • Templates and settings used by taxonomies
  • Classification overviews
  • Classification pages (lists)
  • Subclassification page
  • Hierarchical lists
• Variables available in archives
• Variables available in author pages
• Variables available in category pages
• Variables available in galleries
• Variables available in listings
• Variables available in sections
• Variables available in tag pages
• Variables available in the “Tags and categories” page (tags.tmpl)
• Variables available in shortcodes
• Variables available in post lists
• Extending Nikola
  • Command Plugins
  • TemplateSystem Plugins
  • Task Plugins
  • PageCompiler Plugins
  • MetadataExtractor Plugins
  • RestExtension Plugins
  • MarkdownExtension Plugins
  • SignalHandler Plugins
  • ConfigPlugin Plugins
  • PostScanner Plugins
• Plugin Index
• Path/Link Resolution Mechanism
• Template Hooks
• Shortcodes
  • Template-based Shortcodes
• State and Cache
• Nikola Internals
  • The Build Command
  • Posts and Pages
• Nikola Architecture
• Using Alternative Social Buttons with Nikola
  • The Default
  • ShareNice
  • SocialSharePrivacy
    • The Hard Way
    • The Easy Way
• Code Documentation
  • nikola package
    • Subpackages
      • nikola.packages package
        • Subpackages
        • Module contents
      • nikola.plugins package
        • Subpackages
        • Submodules
        • nikola.plugins.basic_import module
        • Module contents
    • Submodules
    • nikola.filters module
    • nikola.image_processing module
    • nikola.nikola module
    • nikola.plugin_categories module
    • nikola.post module
    • nikola.rc4 module
    • nikola.shortcodes module
    • nikola.state module
    • nikola.utils module
    • nikola.winutils module
    • Module contents