Feature</th>	Supported</th>	Notes</th></tr></thead>
Tables</td>	Yes</td>	Pipes and dashes</td></tr>
Alignment</td>	Yes</td>	Colons define it</td></tr>
Complexity</td>	Low</td>	Keep it simple</td></tr> </tbody></table> Math Formulas (LaTeX)</h2> Markdown renders math using LaTeX syntax. Refer to the configuration post</a> for how to use it.</p> Inline:</strong> The mass-energy equivalence is `$e=mc^2$</code>.</p>` `Block (Display):</strong></p>` $$$ f(x)=\int_{-\infty}^\infty \hat f(\xi)e^{2\pi i\xi x}d\xi $$</div> Blockquotes</h2> "Code is like humor. When you have to explain it, it’s bad." — Cory House</em></p> </blockquote> GitHub-Style Alerts</h2> This is a note useful for the reader.</p> </blockquote> Here is a helpful tip to improve your workflow.</p> </blockquote> This information is crucial for correct functionality.</p> </blockquote> Be careful! This action might have side effects.</p> </blockquote> This action causes data loss. Proceed with extreme care.</p> </blockquote> Footnotes</h2> Here is a sentence with a footnote reference1</a></sup>.</p> Horizontal Rules</h2> (The line above is a horizontal rule)</p> This is the actual footnote content at the bottom of the page. ↩</a></p> </li> </ol> </section> Shortcodes Unknown — Tue, 01 Jan 1980 00:00:00 +0000 Nivis provides various shortcodes for you to use in your posts.</p> Images</h2> To place an image in your post with alt text and message.</p> Template:</p> {{ image(src="img src", alt="alt text", caption="caption text") }}</span></span></code></pre> Example:</p> caption text</figcaption> </figure> Collapse</h2> To place a collapse box in your post. Folded up by default, set unfold</code> to true to unfold it by default.</p> Template:</p> {% collapse(summary="Summary") %}</span></span> Content hidden by default.</span></span> {% end %}</span></span> </span> {% collapse(summary="Summary", unfold=true) %}</span></span> Content shown by default.</span></span> {% end %}</span></span></code></pre> Example:</p> Summary</span> </span> </summary> Content hidden by default.</p> </div> </details> Special Pages Unknown — Tue, 01 Jan 1980 00:00:00 +0000 Nivis theme provides About page, Archives page, Categories page and Links page to help you fully customize your site.</p> Enable/Disable Sections</h2> By default, all 5 sections (posts, archives, tags, about, links) are enabled in theme.toml</code>. They appear in the navigation bar automatically. If you want to disable a specific section, set it to false</code> in your config.toml</code>:</p> [</span>extra</span>.</span>sections</span>]</span></span> links</span> =</span> false</span></span></code></pre> You don't need to declare sections you want to keep enabled — only override the ones you want to hide.</p> About Page</h2> Nivis provides an about page to introduce yourself. Create content/about/index.md</code>:</p> +++</span></span> title = "About Me"</span></span> template = "about.html"</span></span> +++</span></span>$

Naszt

Configuration

Unknown — Tue, 01 Jan 1980 00:00:00 +0000

Social Links</h2>

Nivis enables you to display some of your social links . Add your social links in config.toml</code> according to the following example:</p>

[</span>extra</span>]</span></span>
social_links</span> =</span> [</span></span>
    {</span> name</span> =</span> "</span>github</span>"</span>,</span> url</span> =</span> "</span>https://github.com/username</span>"</span> }</span>,</span></span>
    {</span> name</span> =</span> "</span>email</span>"</span>,</span> url</span> =</span> "</span>mailto:your@email.com</span>"</span> }</span>,</span></span>
    {</span> name</span> =</span> "</span>twitter</span>"</span>,</span> url</span> =</span> "</span>https://twitter.com/username</span>"</span> }</span>,</span></span>
    {</span> name</span> =</span> "</span>rss</span>"</span>,</span> url</span> =</span> "</span>/atom.xml</span>"</span> }</span>,</span></span>
]</span></span></code></pre>
Supported icons include most brands (e.g., github</code>, twitter</code>, bilibili</code>) and generic names like email</code>, rss</code>, link</code>, globe</code>.</p>
Pinned Posts</h2>
Nivis allows you to pin special posts so that they are placed at the frontmost of the post list. To pin posts, add the following to the front matter of your posts/_index.md</code>:</p>
[</span>extra</span>]</span></span>
pinned_posts</span> =</span> [</span></span>
    "</span>posts/pinned_post1.md</span>"</span>,</span></span>
    "</span>posts/pinned_post2.md</span>"</span></span>
]</span></span></code></pre>Math display</h2>
Nivis theme supports MathJax for rendering math contents. Add this to your config.toml</code> to enable math rendering:</p>
[</span>extra</span>]</span></span>
math_display</span> =</span> "</span>mathjax</span>"</span></span></code></pre>
Due to Zola's markdown escaping, some math content (especially <</code>, ></code>, *</code> in LaTeX) may not render correctly. To handle this, run the provided script after adding or editing posts:</p>
python</span> themes/nivis/scripts/wrap_math.py</span></span></code></pre>
The script processes all markdown files in content/</code> and:</p>

Wraps inline math $...$</code> in backticks ( </code>$...$ </code>)</li>
Wraps display math $$...$$</code> in HTML <div class="math-display"></code> tags</li>
HTML-escapes special characters (<</code>, ></code>, &</code>) inside display math</li>
Can be safely re-run (idempotent)</li>
</ul>
After processing, your math content will look like:</p>
This is an inline math example: </span>`</span>$e^{\pi i}=-1$</span>`</span>.</span></span>
</span>
And this is a display math example:</span></span>
</span>
$$</span></span>
\sum_{i=1}^n i^3=\frac{n^2(n+1)^2}{4}</span></span>
$$</span></span></code></pre>
If you prefer to process math manually, ensure that <</code>, ></code>, and &</code> in LaTeX are HTML-escaped (&lt;</code>, &gt;</code>, &amp;</code>) when using HTML wrappers.</p>
Special Pages</h2>
Nivis theme provides About page, Archives page, Categories page and Links page to help you fully customize your site. Move on to Special Pages</a> for more information.</p>



Getting Started
Unknown — Tue, 01 Jan 1980 00:00:00 +0000
Installation</h2>
Use git submodule</code> to add the theme to your site:</p>
git</span> submodule</span> add</span> -</span>b</span> master</span> -</span>-depth=1</span> https://github.com/Resorie/zola-theme-nivis.git</span> themes/nivis/</span></span>
git</span> submodule</span> update</span> -</span>-init</span> -</span>-recursive</span></span></code></pre>
Then, change your theme config in config.toml</code>:</p>
theme</span> =</span> "</span>nivis</span>"</span></span></code></pre>
Start your site by copying the example content and data into your site folder:</p>
cp</span> -</span>r</span> themes/nivis/content</span> content</span></span>
cp</span> -</span>r</span> themes/nivis/data</span> data</span></span></code></pre>
If you want to update the nivis theme, run the following command:</p>
git</span> submodule</span> update</span> -</span>-remote</span> -</span>-merge</span></span></code></pre>Basic Configs</h2>
The following is a basic template for your config.toml</code>:</p>
base_url</span> =</span> "</span>https://yours.site</span>"</span></span>
</span>
title</span> =</span> "</span>Your Title</span>"</span></span>
description</span> =</span> "</span>Your blog</span>"</span></span>
</span>
theme</span> =</span> "</span>nivis</span>"</span></span>
</span>
generate_feeds</span> =</span> true</span></span>
feed_filenames</span> =</span> [</span>"</span>rss.xml</span>"</span>,</span> "</span>atom.xml</span>"</span>]</span></span>
</span>
compile_sass</span> =</span> true</span></span>
</span>
taxonomies</span> =</span> [</span>{</span> name</span> =</span> "</span>tags</span>"</span>,</span> paginate_by</span> =</span> 5</span> }</span>]</span></span>
</span>
[</span>markdown</span>]</span></span>
render_emoji</span> =</span> true</span></span>
github_alerts</span> =</span> true</span></span>
bottom_footnotes</span> =</span> true</span></span>
</span>
[</span>markdown</span>.</span>highlighting</span>]</span></span>
style</span> =</span> "</span>class</span>"</span></span>
light_theme</span> =</span> "</span>one-light</span>"</span></span>
dark_theme</span> =</span> "</span>one-dark-pro</span>"</span></span>
</span>
[</span>extra</span>]</span></span>
main_section</span> =</span> "</span>posts</span>"</span></span>
avatar</span> =</span> "</span>images/avatar.jpeg</span>"</span> #</span> In static/ folder</span></span>
</span>
#</span> Social links</span></span>
social_links</span> =</span> [</span></span>
    {</span> name</span> =</span> "</span>github</span>"</span>,</span> url</span> =</span> "</span>https://github.com/your_username</span>"</span> }</span>,</span></span>
]</span></span></code></pre>
Move on to Configuration</a> for advanced configurations.</p>

If you like this theme, please give it a star on github</a>. 😘</p>


Markdown Example
Unknown — Tue, 01 Jan 1980 00:00:00 +0000
Generated by Gemini3 😄</p>
Text Basics</h2>
You can make text bold</strong> or italic</em>.
You can also use strikethrough</del> or highlight inline code</code> variables.</p>
Headings</h2>
Acknowledge that we recommend using h1</code> (in markdown, single #</code>) only for the title (that is, the title</code> attribute in front matter). The titles in post content should start with h2</code>.</p>
h3</h3>
h4</h4>
h5</code> and h6</code> are not recommended to use. (Actually I didn't implement a style for them lol) Try use lists to replace them.</p>
Lists & Checkboxes</h2>
Unordered List:</strong></p>

Apple</li>
Banana

Cavendish</li>
Plantain</li>
</ul>
</li>
Cherry</li>
</ul>
Ordered List:</strong></p>

Initialize repo</li>
Stage files</li>
Commit</li>
</ol>
Task List:</strong></p>


Draft content</li>

Review for typos</li>

Publish</li>
</ul>
Links & Images</h2>
Click here for Google</a></p>
</p>
Code Blocks</h2>
Python:</strong></p>
def</span> greet</span>(</span>name</span>)</span>:</span></span>
    return</span> f</span>"</span>Hello, </span>{</span>name</span>}</span>!</span>"</span></span></code></pre>
JavaScript:</strong></p>
const</span> numbers</span> =</span> [</span>1</span>,</span> 2</span>,</span> 3</span>]</span>;</span></span>
numbers</span>.</span>forEach</span>(</span>num</span> =></span> console</span>.</span>log</span>(</span>num</span>)</span>)</span>;</span></span></code></pre>Tables</h2>
Feature</th> Supported</th> Notes</th></tr></thead>

Tables</td> Yes</td> Pipes and dashes</td></tr>
Alignment</td> Yes</td> Colons define it</td></tr>
Complexity</td> Low</td> Keep it simple</td></tr>
</tbody></table>
Math Formulas (LaTeX)</h2>
Markdown renders math using LaTeX syntax. Refer to the configuration post</a> for how to use it.</p>
Inline:</strong> The mass-energy equivalence is $e=mc^2$</code>.</p>
Block (Display):</strong></p>
 $$$ f(x)=\int_{-\infty}^\infty \hat f(\xi)e^{2\pi i\xi x}d\xi $$</div> Blockquotes</h2> "Code is like humor. When you have to explain it, it’s bad." — Cory House</em></p> </blockquote> GitHub-Style Alerts</h2> This is a note useful for the reader.</p> </blockquote> Here is a helpful tip to improve your workflow.</p> </blockquote> This information is crucial for correct functionality.</p> </blockquote> Be careful! This action might have side effects.</p> </blockquote> This action causes data loss. Proceed with extreme care.</p> </blockquote> Footnotes</h2> Here is a sentence with a footnote reference1</a></sup>.</p> Horizontal Rules</h2> (The line above is a horizontal rule)</p> This is the actual footnote content at the bottom of the page. ↩</a></p> </li> </ol> </section> Shortcodes Unknown — Tue, 01 Jan 1980 00:00:00 +0000 Nivis provides various shortcodes for you to use in your posts.</p> Images</h2> To place an image in your post with alt text and message.</p> Template:</p> {{ image(src="img src", alt="alt text", caption="caption text") }}</span></span></code></pre> Example:</p> caption text</figcaption> </figure> Collapse</h2> To place a collapse box in your post. Folded up by default, set unfold</code> to true to unfold it by default.</p> Template:</p> {% collapse(summary="Summary") %}</span></span> Content hidden by default.</span></span> {% end %}</span></span> </span> {% collapse(summary="Summary", unfold=true) %}</span></span> Content shown by default.</span></span> {% end %}</span></span></code></pre> Example:</p> Summary</span> </span> </summary> Content hidden by default.</p> </div> </details> Special Pages Unknown — Tue, 01 Jan 1980 00:00:00 +0000 Nivis theme provides About page, Archives page, Categories page and Links page to help you fully customize your site.</p> Enable/Disable Sections</h2> By default, all 5 sections (posts, archives, tags, about, links) are enabled in theme.toml</code>. They appear in the navigation bar automatically. If you want to disable a specific section, set it to false</code> in your config.toml</code>:</p> [</span>extra</span>.</span>sections</span>]</span></span> links</span> =</span> false</span></span></code></pre> You don't need to declare sections you want to keep enabled — only override the ones you want to hide.</p> About Page</h2> Nivis provides an about page to introduce yourself. Create content/about/index.md</code>:</p> +++</span></span> title = "About Me"</span></span> template = "about.html"</span></span> +++</span></span>$

h4</h4>
`h5</code> and h6</code> are not recommended to use. (Actually I didn't implement a style for them lol) Try use lists to replace them.</p>`

Links & Images</h2>
Click here for Google</a></p>
</p>

Footnotes</h2>
Here is a sentence with a footnote reference^{1</a></sup>.</p>}

Shortcodes

Special Pages

Naszt

Configuration

`Special Pages</h2> Nivis theme provides About page, Archives page, Categories page and Links page to help you fully customize your site. Move on to Special Pages</a> for more information.</p>`

Getting Started

Markdown Example

Text Basics</h2>
You can make text bold</strong> or italic</em>. You can also use strikethrough</del> or highlight `inline code</code> variables.</p>`

Naszt

Configuration

Special Pages</h2> Nivis theme provides About page, Archives page, Categories page and Links page to help you fully customize your site. Move on to Special Pages</a> for more information.</p>

Getting Started

Installation</h2> Use git submodule</code> to add the theme to your site:</p>

Basic Configs</h2> The following is a basic template for your config.toml</code>:</p>

Markdown Example

Text Basics</h2> You can make text bold</strong> or italic</em>. You can also use strikethrough</del> or highlight inline code</code> variables.</p>

h3</h3> h4</h4> h5</code> and h6</code> are not recommended to use. (Actually I didn't implement a style for them lol) Try use lists to replace them.</p> Lists & Checkboxes</h2> Unordered List:</strong></p> Apple</li> Banana Cavendish</li> Plantain</li> </ul> </li>

h4</h4> h5</code> and h6</code> are not recommended to use. (Actually I didn't implement a style for them lol) Try use lists to replace them.</p>

Lists & Checkboxes</h2> Unordered List:</strong></p> Apple</li> Banana Cavendish</li> Plantain</li> </ul> </li>

Links & Images</h2> Click here for Google</a></p> </p>

Blockquotes</h2> "Code is like humor. When you have to explain it, it’s bad." — Cory House</em></p> </blockquote>

GitHub-Style Alerts</h2> This is a note useful for the reader.</p> </blockquote>

Footnotes</h2> Here is a sentence with a footnote reference1</a></sup>.</p>

Shortcodes

Special Pages

`Special Pages</h2> Nivis theme provides About page, Archives page, Categories page and Links page to help you fully customize your site. Move on to Special Pages</a> for more information.</p>`

Text Basics</h2>
You can make text bold</strong> or italic</em>. You can also use strikethrough</del> or highlight `inline code</code> variables.</p>`

h4</h4>
`h5</code> and h6</code> are not recommended to use. (Actually I didn't implement a style for them lol) Try use lists to replace them.</p>`

Links & Images</h2>
Click here for Google</a></p>
</p>

Footnotes</h2>
Here is a sentence with a footnote reference^{1</a></sup>.</p>}