mirror of
https://github.com/getzola/zola
synced 2025-01-22 00:25:03 +00:00
307 lines
16 KiB
HTML
307 lines
16 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>Sass | 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://www.getzola.org/">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="documentation">
|
|
<aside class="documentation__sidebar">
|
|
<ul>
|
|
|
|
|
|
<li>
|
|
<span class="documentation__sidebar__title">Getting Started</span>
|
|
<ul>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/getting-started/overview/">Overview</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/getting-started/installation/">Installation</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/getting-started/cli-usage/">CLI usage</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/getting-started/directory-structure/">Directory structure</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/getting-started/configuration/">Configuration</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
<li>
|
|
<span class="documentation__sidebar__title">Content</span>
|
|
<ul>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/overview/">Overview</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/section/">Section</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/page/">Page</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/shortcodes/">Shortcodes</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/linking/">Internal links & deep linking</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/table-of-contents/">Table of Contents</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/syntax-highlighting/">Syntax Highlighting</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/taxonomies/">Taxonomies</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/search/">Search</a>
|
|
</li>
|
|
|
|
<li class="active">
|
|
<a href="https://www.getzola.org/documentation/content/sass/">Sass</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/image-processing/">Image processing</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/content/multilingual/">Multilingual sites</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
<li>
|
|
<span class="documentation__sidebar__title">Templates</span>
|
|
<ul>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/overview/">Overview</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/pages-sections/">Sections and Pages</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/pagination/">Pagination</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/taxonomies/">Taxonomies</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/feeds/">Feeds</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/sitemap/">Sitemap</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/robots/">Robots.txt</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/404/">404 error page</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/templates/archive/">Archive</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
<li>
|
|
<span class="documentation__sidebar__title">Themes</span>
|
|
<ul>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/themes/overview/">Overview</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/themes/installing-and-using-themes/">Installing & using themes</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/themes/creating-a-theme/">Creating a theme</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/themes/extending-a-theme/">Customizing a theme</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
<li>
|
|
<span class="documentation__sidebar__title">Deployment</span>
|
|
<ul>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/overview/">Overview</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/sourcehut/">Sourcehut Pages</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/netlify/">Netlify</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/github-pages/">GitHub Pages</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/gitlab-pages/">GitLab Pages</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/codeberg-pages/">Codeberg Pages</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/edgio/">Edgio</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/vercel/">Vercel</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/zeabur/">Zeabur</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/cloudflare-pages/">Cloudflare Pages</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/flyio/">Fly.io</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/aws-s3/">AWS S3 Bucket</a>
|
|
</li>
|
|
|
|
<li class="">
|
|
<a href="https://www.getzola.org/documentation/deployment/docker-image/">Docker image</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
</ul>
|
|
</aside>
|
|
<div class="documentation__content">
|
|
|
|
<h1>Sass</h1>
|
|
<p>Sass is a popular CSS preprocessor that adds special features (e.g., variables, nested rules) to facilitate the
|
|
maintenance of large sets of CSS rules. If you're curious about what Sass
|
|
is and why it might be useful for styling your static site, the following links
|
|
may be of interest:</p>
|
|
<ul>
|
|
<li>The <a href="https://sass-lang.com/">official Sass website</a></li>
|
|
<li><a href="https://alistapart.com/article/why-sass">Why Sass?</a>, by Dan Cederholm</li>
|
|
</ul>
|
|
<p>It currently uses <a href="https://github.com/connorskees/grass">grass</a>, a Rust implementation of Sass roughly equivalent
|
|
with dart-sass.</p>
|
|
<h2 id="using-sass-in-zola"><a class="zola-anchor" href="#using-sass-in-zola" aria-label="Anchor link for: using-sass-in-zola">🔗</a>Using Sass in Zola</h2>
|
|
<p>Zola always compiles Sass files in theme directories.
|
|
However, for Zola to process files in the <code>sass</code> folder, you need to set <code>compile_sass = true</code> in your <code>config.toml</code>.</p>
|
|
<p>Zola processes any files with the <code>sass</code> or <code>scss</code> extension in the <code>sass</code>
|
|
folder, and places the processed output into a <code>css</code> file with the same folder
|
|
structure and base name into the <code>public</code> folder:</p>
|
|
<pre data-lang="bash" style="background-color:#383838;color:#e6e1dc;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#da4939;">.
|
|
</span><span>└── sass
|
|
</span><span> ├── style.scss // -</span><span style="color:#cc7833;">></span><span> ./public/style.css
|
|
</span><span> ├── indented_style.sass // -</span><span style="color:#cc7833;">></span><span> ./public/indented_style.css
|
|
</span><span> ├── _include.scss </span><span style="font-style:italic;color:#7c7865;"># This file won't get put into the `public` folder, but other files can @import it.
|
|
</span><span> ├── assets
|
|
</span><span> │ ├── fancy.scss // -</span><span style="color:#cc7833;">></span><span> ./public/assets/fancy.css
|
|
</span><span> │ ├── same_name.scss // -</span><span style="color:#cc7833;">></span><span> ./public/assets/same_name.css
|
|
</span><span> │ ├── same_name.sass </span><span style="font-style:italic;color:#7c7865;"># CONFLICT! This has the same base name as the file above, so Zola will return an error.
|
|
</span><span> │ └── _common_mixins.scss </span><span style="font-style:italic;color:#7c7865;"># This file won't get put into the `public` folder, but other files can @import it.
|
|
</span><span> └── secret-side-project
|
|
</span><span> └── style.scss // -</span><span style="color:#cc7833;">></span><span> ./public/secret-side-project/style.css
|
|
</span></code></pre>
|
|
<p>Files with a leading underscore in the name are not placed into the <code>public</code>
|
|
folder, but can still be used as <code>@import</code> dependencies. For more information, see the "Partials" section of
|
|
<a href="https://sass-lang.com/guide">Sass Basics</a>.</p>
|
|
<p>Files with the <code>scss</code> extension use "Sassy CSS" syntax,
|
|
while files with the <code>sass</code> extension use the "indented" syntax: <a href="https://sass-lang.com/documentation/syntax">https://sass-lang.com/documentation/syntax</a>.
|
|
Zola will return an error if <code>scss</code> and <code>sass</code> files with the same
|
|
base name exist in the same folder to avoid confusion -- see the example above.</p>
|
|
|
|
|
|
</div>
|
|
</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>
|