# First step failed

**URL:** <https://zola.discourse.group/t/first-step-failed/794>\
**Category:** Support\
**Created:** [February 17, 2021, 1:01pm UTC](https://zola.discourse.group/t/first-step-failed/794 "2021-02-17T13:01:29Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![Otroson](https://avatars.discourse-cdn.com/v4/letter/o/e480ec/32.png) [@Otroson](https://zola.discourse.group/u/Otroson)\
**Post date:** [February 17, 2021, 1:01pm UTC](https://zola.discourse.group/t/first-step-failed/794/1 "2021-02-17T13:01:29Z")

</div>

Hello. I am newbie with Zola. And the first steps go wrong. So, please, show me somebody the light.

I use Windows 10. zola.exe version 0.13.0  
First part:  
Lets build already done blog example…

I have dowloaded theme:  
`git clone ...blabla/zola-clean-blog.git "D:\Dev\Zola\"`

`zola.exe -r "D:\Dev\Zola\zola-clean-blog\" build`  
…  
It does nothing - after 10 min trying and failing - the last backslash is wrong! WTF?  
New try:

`zola.exe -r "D:\Dev\Zola\zola-clean-blog" build`

`Building site... 'highlight_code' has been moved to a [markdown] section. Top level 'highlight_code' and 'highlight_theme' will stop working in 0.14. -> Creating 13 pages (0 orphan), 2 sections, and processing 0 images Failed to build the site Error: Failed to render page '//?/D:/Dev/Zola/zola-clean-blog/content/pages\about.md' Reason: Tried to render `about.html` but the template wasn't found`

I don’t get it. What is wrong? It is example from official site… Backslash again in front of about.md? Because my friend did the same stuff on Linux and success - he is lucky with princess now…

Second part:  
Lets say, that first part is clear and I am able to build example…  
What steps I have todo, if I want my own functional blog with this theme?  
My goal is to have the same content but first page will be “Hello František” (not Start bootstrap)

`zola.exe init "D:\Dev\Zola\blog"` creates dir structure.

`git clone https://github.com/dave-tucker/zola-clean-blog.git "D:\Dev\Zola\blog\themes"`

I have changed config.toml - this is my version

> #The URL the site will be built for  
> base\_url = “[https://example.com](https://example.com)”
> 
> theme = “zola-clean-blog”
> 
> taxonomies = [  
> {name = “categories”, rss = true, paginate\_by=5},  
> {name = “tags”, rss = true, paginate\_by=5},  
> ]
> 
> #Whether to automatically compile all Sass files in the sass directory  
> compile\_sass = true
> 
> #Whether to build a search index to be used later on by a JavaScript library  
> build\_search\_index = true
> 
> [markdown]  
> #Whether to do syntax highlighting  
> #Theme can be customised by setting the ‘highlight\_theme’ variable to a theme supported by Zola  
> highlight\_code = true
> 
> [extra]  
> #Put all your custom variables here

Now, if I want similar content like exists in theme, I have to copy MD files from theme to my structure and modify it?  
Then run this and I am done?  
`zola.exe -r "D:\Dev\Zola\blog" build`

Because it doesn’t work.  
Thx

---

<div class="post-metadata">

**Author:** ![southerntofu](https://yyz2.discourse-cdn.com/free1/user_avatar/zola.discourse.group/southerntofu/32/189_2.png) [@southerntofu](https://zola.discourse.group/u/southerntofu)\
**Post date:** [February 17, 2021, 1:54pm UTC](https://zola.discourse.group/t/first-step-failed/794/2 "2021-02-17T13:54:56Z")

</div>

Hello, cloning and building/serving [GitHub - dave-tucker/zola-clean-blog: A port of the StartBootsrap Clean Blog theme for Zola](https://github.com/dave-tucker/zola-clean-blog) works fine on my end but i’m not using Windows.

Could you maybe try from the site’s folder to just run `zola build` or `zola serve` and paste here (in a codeblock) the entire output? This may be a bug related to how `-r` flag is handled (because windows paths are weird and maybe they’re not treated correctly in this part of the code).

---

<div class="post-metadata">

**Author:** ![Otroson](https://avatars.discourse-cdn.com/v4/letter/o/e480ec/32.png) [@Otroson](https://zola.discourse.group/u/Otroson)\
**Post date:** [February 18, 2021, 10:30am UTC](https://zola.discourse.group/t/first-step-failed/794/3 "2021-02-18T10:30:37Z")

</div>

Hello.  
Thanks for answer.

You are right. Flag -r must be broken.  
I have built zola-clean-blog directly from directory (`D:\Dev\Zola\zola-clean-blog`) - and everything works like a charm.  
There are missing twitter icons, but it is not critical and I still haven’t investigated this problem… So…

Thank you again.

---

<div class="post-metadata">

**Author:** ![southerntofu](https://yyz2.discourse-cdn.com/free1/user_avatar/zola.discourse.group/southerntofu/32/189_2.png) [@southerntofu](https://zola.discourse.group/u/southerntofu)\
**Post date:** [February 18, 2021, 11:51am UTC](https://zola.discourse.group/t/first-step-failed/794/4 "2021-02-18T11:51:24Z")

</div>

> [@Otroson](#):
>
> You are right. Flag -r must be broken.

Too bad! Two questions:

1. Could you try using `-r` with a relative link (i don’t know how these work on windows but on a free system i’d do something like `-r myfolder/mysite`) and see if that works?
2. Do you feel comfortable programming in Rust? If so would you like to try and fix this issue? Even if you don’t have experience in Rust, it should not be a hard problem as long as you have a little programming experience

[Here](https://github.com/getzola/zola/issues/1361) is the issue on the bugtracker

---

<div class="post-metadata">

**Author:** ![southerntofu](https://yyz2.discourse-cdn.com/free1/user_avatar/zola.discourse.group/southerntofu/32/189_2.png) [@southerntofu](https://zola.discourse.group/u/southerntofu)\
**Post date:** [February 18, 2021, 11:52am UTC](https://zola.discourse.group/t/first-step-failed/794/5 "2021-02-18T11:52:15Z")

</div>

> [@Otroson](#):
>
> There are missing twitter icons

I don’t know what you are talking about (i don’t use this theme), but if something is not working on a theme recommended by Zola then it’s definitely a bug so feel free to point it out more specifically 🙂

---

<div class="post-metadata">

**Author:** ![Otroson](https://avatars.discourse-cdn.com/v4/letter/o/e480ec/32.png) [@Otroson](https://zola.discourse.group/u/Otroson)\
**Post date:** [February 20, 2021, 5:48pm UTC](https://zola.discourse.group/t/first-step-failed/794/6 "2021-02-20T17:48:25Z")

</div>

Hello again.

1.) I have tried relative path

```
zola -r "./zola-clean-blog" build

```

But it failed too

```
Building site...
'highlight_code' has been moved to a [markdown] section. Top level 'highlight_code' and 'highlight_theme' will stop working in 0.14.
-> Creating 13 pages (0 orphan), 2 sections, and processing 0 images
Failed to build the site
Error: Failed to render page '//?/D:/Dev/Zola/blog/themes/zola-clean-blog/content/pages\contact-us.md'
Reason: Tried to render `contact.html` but the template wasn't found

```

2.) RUST - I just know that it is programming language - maybe similar to c++. I am a programmer. But free time is a problem…

---

<div class="post-metadata">

**Author:** ![Otroson](https://avatars.discourse-cdn.com/v4/letter/o/e480ec/32.png) [@Otroson](https://zola.discourse.group/u/Otroson)\
**Post date:** [February 20, 2021, 7:11pm UTC](https://zola.discourse.group/t/first-step-failed/794/7 "2021-02-20T19:11:19Z")

</div>

Hi. Sorry:

> There are missing RSS content when I click on RSS icon

is right note…

When I run `zola serve` in _zola-clean-blog_ it shows **404 Not Found**.  
And original config contains

> generate\_rss = true

---

<div class="post-metadata">

**Author:** ![keats](https://avatars.discourse-cdn.com/v4/letter/k/34f0e0/32.png) [@keats](https://zola.discourse.group/u/keats)\
**Post date:** [February 21, 2021, 7:02am UTC](https://zola.discourse.group/t/first-step-failed/794/8 "2021-02-21T07:02:24Z")

</div>

Can you zip and upload your project here? I’m guessing there is a small misconfiguration or Windows issue, it looks like it’s not finding the theme.

---

<div class="post-metadata">

**Author:** ![Otroson](https://avatars.discourse-cdn.com/v4/letter/o/e480ec/32.png) [@Otroson](https://zola.discourse.group/u/Otroson)\
**Post date:** [February 21, 2021, 2:49pm UTC](https://zola.discourse.group/t/first-step-failed/794/9 "2021-02-21T14:49:55Z")

</div>

[windows build of zola-clean-blog](https://uloz.to/file/DDeiPs387KaX/zola-clean-blog-zip)

---

<div class="post-metadata">

**Author:** ![keats](https://avatars.discourse-cdn.com/v4/letter/k/34f0e0/32.png) [@keats](https://zola.discourse.group/u/keats)\
**Post date:** [February 21, 2021, 5:46pm UTC](https://zola.discourse.group/t/first-step-failed/794/10 "2021-02-21T17:46:48Z")

</div>

Ah those options have been renamed!

Try

```auto
# The URL the site will be built for
base_url = "https://zola-clean-blog.netlify.com"
generate_feed = true
compile_sass = true

title = "Start Bootstrap"
description = "A blog theme by Start Bootstrap"
highlight_code = true

taxonomies = [
    {name = "categories", feed = true, paginate_by=5},
    {name = "tags", feed = true, paginate_by=5},
]

[extra]
author = "Dave"
clean_blog_menu = [
    {url = "$BASE_URL", name = "Home"},
    {url = "$BASE_URL/about", name = "About"},
    {url = "$BASE_URL/contact", name = "Contact"}
]
clean_blog_social = [
    {url = "https://twitter.com", icon="fab fa-twitter"},
    {url = "$BASE_URL/rss.xml", icon="fas fa-rss"}
]

```

in the config.toml

---

<div class="post-metadata">

**Author:** ![dertuxmalwieder](https://yyz2.discourse-cdn.com/free1/user_avatar/zola.discourse.group/dertuxmalwieder/32/336_2.png) [@dertuxmalwieder](https://zola.discourse.group/u/dertuxmalwieder)\
**Post date:** [February 21, 2021, 7:01pm UTC](https://zola.discourse.group/t/first-step-failed/794/11 "2021-02-21T19:01:29Z")

</div>

Heh, I get an error 451 on that site. What _is_ this?
