Build fails when code contains Django template language (liquid tags)

[stefanbschneider]

Required Prerequisites for filing a bug

You must follow ALL the steps in the troubleshooting guide. Not doing so may result in automatic closure of the issue.

Required information

1. Steps to reproduce the problem

I'm using the latest version of fastpages to run my new blog.
On the blog, I want to write (among other stuff) about Django. Django's templates use syntax that is likely confused by Jekyll and that leads to build failures when using it in code snippets.

For example, including the following code snippet in a blog post leads to a build failure:

<form action="{% url 'helloworld:index' %}" method="post">
    {% csrf_token %}
    <button type="submit" name="hello-world-button">Greet the world!</button>
</form>

The action leads to the following error: Liquid Exception: Liquid syntax error (line 105): Unknown tag 'url' in /github/workspace/_posts/2021-01-29-django-db.md (see failed action).

When removing the code snippet from the blog post, it works fine.

This seems to be related to this issue, which is closed but apparently didn't solve the problem for me: #66

2. A link to the notebook or markdown file where the error is occurring

• The markdown post without the code snippet, which works: https://github.com/stefanbschneider/blog/blob/bc9166eafcf1616357cf16ee3a07de3bb6dbb2d2/_posts/2021-01-29-django-db.md
• Previous version with the code snippet, which broke the build: https://github.com/stefanbschneider/blog/blob/5a7591ac4c41eb584cc2247bf88dbd6295f459b5/_posts/2021-01-29-django-db.md

3. If the error is happening in GitHub Actions, a link to the specific error along with how you are able to reproduce this error. You must provide this in addition to the link to the notebook or markdown file.

Using the post with the Django code snippet, the action fails, eg, here.

Is there any recommendation how to deal with this other than just removing the snippet? I read something about {% raw %} tags around the snippet?

[github-actions]

Thank you for opening an issue. If this issue is related to a bug, please follow the steps and provide the information outlined in the Troubleshooting Guide. Failure to follow these instructions may result in automatic closing of this issue.

[stefanbschneider]

A workaround could be to embed the code snippet as HTML using https://emgithub.com/ , but this isn't really handy for many code snippets.

[hamelsmu]

You have to escape liquid tags

https://stackoverflow.com/questions/3426182/how-to-escape-liquid-template-tags

[stefanbschneider]

Thanks, putting {% raw %} and {% endraw %} around the code snippet solves the problem.

Just out of curiosity: Couldn't fastpages escape code blocks automatically?

[hamelsmu]

We escape notebook code but not markdown. Since markdown is the native Jekyll interface I don’t want to introduce magic that might confuse people

…

On Mon, Feb 1, 2021 at 11:31 PM Stefan Schneider ***@***.***> wrote: Thanks, putting {% raw %} and {% endraw %} around the code snippet solves the problem. Just out of curiosity: Couldn't fastpages escape code blocks automatically? — You are receiving this because you modified the open/close state. Reply to this email directly, view it on GitHub <#498 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AALKJEW6UR3WJ7WWPI4M5UTS46S5RANCNFSM4W5BKEGA> .