Liquid Exception: Liquid syntax error (line 42): Unknown tag 'toc' in /_layouts/post.html

[rodrigor]

Acknowledge the following

Describe the bug
the theme doesn't build into GitHub pages.

The error:
Liquid Exception: Liquid syntax error (line 42): Unknown tag 'toc' in /_layouts/post.html

Screenshots

Additional context

[ZahraBenslimane]

I have the same issue :/

[d-kozak]

I am experiencing it as well.

[ZahraBenslimane]

I had this error the first time I forked the template. I was able to deploy the page by just changing the branch in settings >pages >Build and deployment

[edwinabot]

@ZahraBenslimane, I was able to replicate what you did, thanks. There is one caveat, though. It was possible only after running the deploy pipeline that I had the gh-pages branch working.

So you must first run the deploy pipeline for your desired branch

And later on, you'll see the pages-build-deployment pipeline passing

I don't know much about the different actions used here, but there's a link between the two pipelines... maybe a build cache @rodrigor ???

[gubazoltan]

@edwinabot, could you please explain what do you mean by deploy pipeline? I could not find such a workflow.

[george-gca]

@gubazoltan he meant the deploy action, which is defined here and used by Github pipelines to build your website.

[rishikeshF]

I am facing the same issue, has anyone found a solution to this ? @edwinabot mentioned about running 'deploy pipeline' and @george-gca referenced to the deploy action page script, but it is just a script and it is already present as it is in my repo as well. Has anyone resolved this ? or could someone clarify what needs to be done in simple steps, am not able to deploy my site.

[george-gca]

Does the error occur when running locally? Tomorrow I will try to replicate the error, or at least understand it better.

[tjvitchutripop]

I also ran into this error but was able to get my website deployed by switching my Build and Deployment source from "Deploy from a branch" to "GitHub Actions," and then performing the configuration for Jekyll (there should be a button that pops up below once you switch to GitHub Actions that will create the jekyll.yml for you).

[gubazoltan]

I managed to get around this problem without changing anything in the GemFile (as far as I remember).
What I did was that I used GitHub Pages and used the "Deploy Jekyll site to Pages" action to build the site.

[rishikeshF]

@tjvitchutripop your method didn't work for me. The build just failed.
@gubazoltan where did you find the 'Deploy Jekyll site to Pages' option ?

[rishikeshF]

Does the error occur when running locally? Tomorrow I will try to replicate the error, or at least understand it better.

@george-gca No, it works fine on local. I get this error when I try to deploy it on server.

[gubazoltan]

@rishikeshF Sorry, probably I misinterpreted the name and this is why you didn't find the action I quoted. I am not sure which one is that I am actually using but on this link you can find my workflow file that I am using to build my website. I believe that if you put this file into your workflow folder then it will also show up in the Actions option of the repository.

I hope it works.

[R3gardless]

@rishikeshF You can simply add jekyll.yml from "your repository" Setting > Pages > Build and deployment Source > Github Actions > Jekyll configure