Zola Static Site Generator

Zola is a fast static site generator distributed as a single binary with all necessary features built-in. It uses the Tera template engine.

Key features include:

• Content & Styling: Syntax highlighting, Sass compilation, image processing, and automatic table of contents generation with header anchors.
• Site Structure: Multilingual support, custom taxonomies, pagination, aliases, and shortcodes.
• Linking & Assets: Internal links, external link checking, and assets co-location.
• Developer Experience: Live reload via a local server, built-in search (no third-party servers required), and easy deployment to platforms like Netlify, Vercel, and Cloudflare Pages.

Xuan is a modern Zola blog theme based on Duckquill. It focuses on a clean visual style and optimized reading experience.

Key Features

• Visual Style: Modified divider styles and removed legacy "mods" styles for a cleaner look.
• UI Adjustments:
  • Removed tag filtering from the blog list page.
  • Replaced top mobile buttons with floating action buttons in the bottom right (e.g., Back to Top, Home).
  • Removed alert and vimeo shortcodes.
• New Pages: Includes an Archive page (timeline view) and a Friends/Links page.
• Enhanced Search: Uses Pagefind for static indexing. This provides faster search speeds, supports Chinese word segmentation, and reduces frontend JavaScript overhead compared to the original search implementation.

After running zola init, a standard Zola project follows a specific directory structure. Understanding these directories is essential for organizing your content, styles, and templates.

• zola.toml: The mandatory configuration file.
• content/: Where your markup files (e.g., .md) reside.
• sass/: Contains Sass files for compilation.
• static/: Contains assets to be copied directly to the output.
• templates/: Contains Tera templates for rendering.
• themes/: Contains theme files (can be left empty).
• public/: (Generated) Contains the site output from zola build or static assets from zola serve.

.
├── zola.toml
├── content
├── sass
├── static
├── templates
└── themes

5 directories, 1 file

The zluinav theme is an accessibility-focused theme with the following capabilities:

• Accessibility: Designed for visually impaired users using ARIA tags and accessible patterns.
• SEO & Multilingual: Built-in support for SEO and multiple languages.
• Blog & Documentation: Includes pagination for blogs and specialized subsection templates for documentation sites.
• Search: Built-in search support with various formats.
• Customization: Supports custom menus, taxonomies, and extensive configuration via extra variables or frontmatter.
• Content Tools: Includes macros, shortcodes, variable replacement in page content, and local date display.
• Code Blocks: Supports copyable code blocks with language detection via JavaScript.

The halve-z theme is a retro two-column theme for Zola that includes the following features:

• Search: Built-in search capabilities.
• Taxonomies: Support for categorizing content.
• PWA: Progressive Web App support with dynamic cache and offline mode.
• UI/UX: Notifications, auto color schemes, Table of Contents (ToC), and pagination.
• Content Organization: Support for series and media shortcodes.
• SEO & Security: SEO optimization and Content Security Policy (CSP) support.
• Components: Project cards, read time estimation, and comments (supporting Mastodon or Giscus).

Papaya is a clean Zola theme designed for blogging and projects. Key features include:

• Content Types: Support for blog posts and project pages.
• UI/UX: Automatic light/dark mode and 100% Google Lighthouse score.
• Organization: Support for categories, tags, and customizable sections/navigation menu links.
• Media: Featured images for posts/pages and a smart image embedding shortcode {{/* img() */}}.
• Integrations: GitHub repository star/fork counts, Open Graph Protocol tags, and Utterances support.
• Localization: Optional multilingual support.

The zola-theme-jiaxiang.wang theme provides several built-in features for Zola sites, including:

• Comments: Supports Twikoo (Artalk and Waline are planned).
• Search: Supports Algolia (MeiliSearch is planned).
• Content Rendering: Markdown support, KaTeX for math, and Prism for code highlighting.
• Navigation & UI: Random article access, right-click menu, Pjax for smooth transitions, and dynamic table of contents.
• Media: AVIF image format support and image compression.
• Special Pages: Personal gear (equipment), friend links (友链), subscriptions, 'About Me', and music.
• Organization: Support for multiple collection types and folder navigation within collections.
• Article Features: Category/tagging, related articles, and article summaries (via local description extraction).

The Apollo theme is a modern, minimalistic blog theme that includes the following features:

• Layouts: Pagination, Custom homepage, Configurable cards layout, Projects page, Table of Contents.
• Visuals: Themes (light, dark, auto), MathJax Rendering, Mermaid diagram support.
• Site Tools: Search, RSS feeds, Taxonomies, Meta Tags for individual pages.
• Integrations: Analytics (GoatCounter, Umami, Google Analytics), Social Links, Comments.

Portio-Zola is a minimal, flexible theme powered by Bootstrap 5. Key features include:

• Responsive design: Optimized for all devices.
• Content types: Built-in support for Blogs and Portfolios.
• Multilingual support: Ready for multi-language sites.
• Integrations: Support for Formspree.io and Google Analytics.
• Customization: Designed for easy modification of components.

Zola Futu is a responsive theme for the Zola Static Site Generator that includes the following features:

• Navigation & Layout: Responsive design, customized navigation, and table of contents.
• Content Support: GitHub-style footnotes and MathJax support.
• Social & SEO: Twitter cards, OpenGraph Protocol, Giscus integration, and Mastodon integration.
• Analytics: Support for Google Analytics and Microsoft Clarity.
• Feeds: Follow.app feed claim support.