zola/themes/nasm-theme/index.html
2024-12-10 12:16:49 +00:00

140 lines
8.5 KiB
HTML

<!DOCTYPE html>
<html lang="en-gb">
<head>
<meta charset="UTF-8">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Everything you need to make a static site engine in one binary.">
<meta name="author" content="Vincent Prouillet">
<title>nasm-theme | Zola </title>
<link rel="stylesheet" href="https://www.getzola.org/site.css">
<link rel="icon" href="https://www.getzola.org/favicon.ico">
</head>
<body>
<header>
<a class="header__logo white" href="https:&#x2F;&#x2F;www.getzola.org&#x2F;">Zola</a>
<nav>
<ul>
<li><a class="white" href="https://www.getzola.org/documentation/" class="nav-link">Docs</a></li>
<li><a class="white" href="https://www.getzola.org/themes/" class="nav-link">Themes</a></li>
<li><a class="white" href="https://zola.discourse.group/" class="nav-link">Forum</a></li>
<li><a class="white" href="https://github.com/getzola/zola" class="nav-link">GitHub</a></li>
</ul>
<div class="search-container">
<input id="search" type="search" placeholder="🔎 Search the docs">
<div class="search-results">
<div class="search-results__items"></div>
</div>
</div>
</nav>
</header>
<div class="content content--reversed">
<div class="themes-container">
<div class="theme-info">
<img src="https:&#x2F;&#x2F;www.getzola.org&#x2F;themes&#x2F;nasm-theme&#x2F;screenshot.png" class="thumb">
<div class="metadata">
<h1>nasm-theme</h1>
<p>A robust, elegant blue theme</p>
<p><b>Author:</b> Francisco Lucas</p>
<p><b>License:</b> MIT</p>
<p><b>Homepage:</b> <a href="https:&#x2F;&#x2F;github.com&#x2F;lucasnasm&#x2F;nasm-theme">https:&#x2F;&#x2F;github.com&#x2F;lucasnasm&#x2F;nasm-theme</a></p>
<p><b>Live Demo:</b> <a href="https:&#x2F;&#x2F;lucasnasm.github.io">https:&#x2F;&#x2F;lucasnasm.github.io</a></p>
<p><b>Last updated:</b> 2024-12-02T05:58:20Z</p>
</div>
</div>
<hr>
<h1 id="nasm-theme">nasm-theme</h1>
<h2 id="web">Web</h2>
<p><img src="https://www.getzola.org/themes/nasm-theme/screenshot.png" alt="nasm-theme web" /></p>
<h2 id="mobile">Mobile</h2>
<p><img src="https://github.com/lucasnasm/nasm-theme/blob/master/screenshot-mobile.png?raw=true" alt="nasm-theme mobile" /></p>
<h2 id="contents">Contents</h2>
<ul>
<li>nasm-theme
<ul>
<li>Web</li>
<li>Mobile</li>
<li>Contents</li>
<li>Fonts</li>
<li>Installation</li>
<li>Options
<ul>
<li>Disqus</li>
<li>Top-menu</li>
<li>Title</li>
</ul>
</li>
<li>Original</li>
</ul>
</li>
</ul>
<h2 id="fonts">Fonts</h2>
<p>Font Awesome for icons<br />
Nunito Font</p>
<h2 id="installation">Installation</h2>
<p>First download this theme to your <code>themes</code> directory:</p>
<pre data-lang="bash" style="background-color:#383838;color:#e6e1dc;" class="language-bash "><code class="language-bash" data-lang="bash"><span>$ git submodule add git@github.com:lucasnasm/nasm-theme.git themes/nasm-theme
</span></code></pre>
<p>and then enable it in your <code>config.toml</code>:</p>
<pre data-lang="toml" style="background-color:#383838;color:#e6e1dc;" class="language-toml "><code class="language-toml" data-lang="toml"><span style="color:#e8bf6a;">theme </span><span>= </span><span style="color:#c1be91;">&quot;nasm-theme&quot;
</span></code></pre>
<p>This theme requires your index section (<code>content/_index.md</code>) to be paginated to work:</p>
<pre data-lang="toml" style="background-color:#383838;color:#e6e1dc;" class="language-toml "><code class="language-toml" data-lang="toml"><span style="color:#e8bf6a;">paginate_by </span><span>= </span><span style="color:#a5c261;">5
</span></code></pre>
<p>The posts should therefore be in directly under the <code>content</code> folder.</p>
<p>The theme requires tags and categories taxonomies to be enabled in your <code>config.toml</code>:</p>
<pre data-lang="toml" style="background-color:#383838;color:#e6e1dc;" class="language-toml "><code class="language-toml" data-lang="toml"><span style="color:#e8bf6a;">taxonomies </span><span>= [
</span><span> </span><span style="color:#95815e;"># You can enable/disable RSS
</span><span> {</span><span style="color:#e8bf6a;">name </span><span>= </span><span style="color:#c1be91;">&quot;categories&quot;</span><span>, </span><span style="color:#e8bf6a;">rss </span><span>= </span><span style="color:#6e9cbe;">true</span><span>},
</span><span> {</span><span style="color:#e8bf6a;">name </span><span>= </span><span style="color:#c1be91;">&quot;tags&quot;</span><span>, </span><span style="color:#e8bf6a;">rss </span><span>= </span><span style="color:#6e9cbe;">true</span><span>},
</span><span>]
</span></code></pre>
<p>If you want to paginate taxonomies pages, you will need to overwrite the templates
as it only works for non-paginated taxonomies by default.</p>
<h2 id="options">Options</h2>
<h3 id="disqus">Disqus</h3>
<p>set a field <code>extra</code> with key of <code>disqus_username</code>:</p>
<pre data-lang="toml" style="background-color:#383838;color:#e6e1dc;" class="language-toml "><code class="language-toml" data-lang="toml"><span style="color:#e8bf6a;">disqus_username </span><span>= </span><span style="color:#a5c261;">&#39;username&#39;
</span></code></pre>
<h3 id="top-menu">Top-menu</h3>
<p>Set a field in <code>extra</code> with a key of <code>nasm-theme</code>:<br />
Font Awesome default icons</p>
<pre data-lang="toml" style="background-color:#383838;color:#e6e1dc;" class="language-toml "><code class="language-toml" data-lang="toml"><span style="color:#e8bf6a;">nasm_menu </span><span>= [
</span><span> {</span><span style="color:#e8bf6a;">url </span><span>= </span><span style="color:#c1be91;">&quot;$BASE_URL&quot;</span><span>, </span><span style="color:#e8bf6a;">name </span><span>= </span><span style="color:#c1be91;">&quot;Home&quot;</span><span>, </span><span style="color:#e8bf6a;">fawesome </span><span>= </span><span style="color:#c1be91;">&quot;fas fa-home&quot;</span><span>},
</span><span> {</span><span style="color:#e8bf6a;">url </span><span>= </span><span style="color:#c1be91;">&quot;$BASE_URL/categories&quot;</span><span>, </span><span style="color:#e8bf6a;">name </span><span>= </span><span style="color:#c1be91;">&quot;Categories&quot;</span><span>, </span><span style="color:#e8bf6a;">fawesome </span><span>= </span><span style="color:#c1be91;">&quot;fas fa-folder-open&quot;</span><span>},
</span><span> {</span><span style="color:#e8bf6a;">url </span><span>= </span><span style="color:#c1be91;">&quot;$BASE_URL/tags&quot;</span><span>, </span><span style="color:#e8bf6a;">name </span><span>= </span><span style="color:#c1be91;">&quot;Tags&quot;</span><span>, </span><span style="color:#e8bf6a;">fawesome </span><span>= </span><span style="color:#c1be91;">&quot;fas fa-tag&quot; </span><span>},
</span><span> {</span><span style="color:#e8bf6a;">url </span><span>= </span><span style="color:#c1be91;">&quot;$BASE_URL/about&quot;</span><span>, </span><span style="color:#e8bf6a;">name </span><span>= </span><span style="color:#c1be91;">&quot;About&quot;</span><span>, </span><span style="color:#e8bf6a;">fawesome </span><span>= </span><span style="color:#c1be91;">&quot;fas fa-user-alt&quot; </span><span>},
</span><span>
</span><span>]
</span></code></pre>
<p>If you put <code>$BASE_URL</code> in a url, it will automatically be replaced by the actual
site URL.</p>
<h3 id="title">Title</h3>
<p>The site title is shown on the homepage. As it might be different from the <code>&lt;title&gt;</code>
element that the <code>title</code> field in the config represents, you can set the <code>nasm_theme_title</code>
instead.</p>
<h2 id="original">Original</h2>
<p>This template is based on the Zola template https://github.com/getzola/after-dark<br />
Thanks</p>
</div>
</div>
<footer>
©2017-2024 — <a class="white" href="https://www.vincentprouillet.com">Vincent Prouillet</a> and <a class="white" href="https://github.com/getzola/zola/graphs/contributors">contributors</a>
</footer>
<script type="text/javascript" src="https://www.getzola.org/elasticlunr.min.js"></script>
<script type="text/javascript" src="https://www.getzola.org/search.js"></script>
</body>
</html>