zola/docs/content/documentation/getting-started/directory-structure.md
photong 5ba4d47538 Docs next (#858)
* Update installation.md

* Update cli-usage.md

* Update installation.md

* Update directory-structure.md

* Update configuration.md

* Update overview.md

* Update section.md

* Update page.md

* Update section.md

* Update configuration.md

* Update page.md

* Update section.md

* Update page.md

* Update shortcodes.md

* Update linking.md

* Update table-of-contents.md

* Update syntax-highlighting.md

* Update taxonomies.md

* Update search.md

* Update sass.md

* Update index.md

* Update multilingual.md

* Update overview.md

* Update pages-sections.md

* Update pagination.md

* Update taxonomies.md

* Update rss.md

* Update sitemap.md

* Update robots.md

* Update 404.md

* Update archive.md

* Update overview.md

* Update installing-and-using-themes.md

* Update creating-a-theme.md

* Update netlify.md

* Update github-pages.md

* Update gitlab-pages.md

* Updates.

* Skip link checking for URL with prefix in config (#846)

* Fix some doc changes

* Section extra -> SitemapEntry (#850)

* Update deps

* Remove tutorial link.

* Update overview.md

* Update page.md

* Update section.md

* Update netlify.md

* Update overview.md

* Change some wording.

* Update overview.md

Co-authored-by: Tjeu Kayim <15987676+TjeuKayim@users.noreply.github.com>
Co-authored-by: Vincent Prouillet <balthek@gmail.com>
Co-authored-by: Stan Rozenraukh <stan@stanistan.com>
2020-02-02 17:48:43 -08:00

2 KiB

+++ title = "Directory structure" weight = 30 +++

After running zola init, you should see the following structure in your directory:

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

5 directories, 1 file

Here's a high-level overview of each of these directories and config.toml.

config.toml

A mandatory Zola configuration file in TOML format. This file is explained in detail in the configuration documentation.

content

Contains all your markup content (mostly .md files). Each child directory of the content directory represents a section that contains pages (your .md files).

To learn more, read the content overview page.

sass

Contains the Sass files to be compiled. Non-Sass files will be ignored. The directory structure of the sass folder will be preserved when copying over the compiled files; for example, a file at sass/something/site.scss will be compiled to public/something/site.css.

static

Contains any kind of file. All the files/directories in the static directory will be copied as-is to the output directory. If your static files are large, you can configure Zola to hard link them instead of copying them by setting hard_link_static = true in the config file.

templates

Contains all the Tera templates that will be used to render your site. Have a look at the templates documentation to learn more about default templates and available variables.

themes

Contains themes that can be used for your site. If you are not planning to use themes, leave this directory empty. If you want to learn about themes, see the themes documentation.