Ich verwende Jekyll, um eine Dokumentationssite zu erstellen, auf der ich versuche, Code zu dokumentieren, der eine Lenker-ähnliche Syntax enthält. Zum Beispiel {{foo}}
. Das Problem ist, dass Jekyll flüssige Tags verwendet und egal was ich mache, meine doppelten Locken werden vom flüssigen Prozessor herausgerissen.
Übrigens verwende ich kramdown als Markdown-Prozessor.
Folgendes habe ich versucht:
{% highlight html linenos %}
Hello, my name is {{name}}.
{% endhighlight %}
Dieser entfernt den Abschnitt {{name}} vollständig, da er einen Verweis auf eine flüssige Variable darstellt.
Ich habe es auch versucht:
{% highlight html linenos %}
Hello, my name is \{\{name\}\}.
{% endhighlight %}
In diesem Fall versuche ich, den geschweiften Klammern zu entkommen, aber das Ergebnis ist, dass die Schrägstriche auf der Seite gerendert werden.
Ich habe es sogar versucht:
{% highlight html linenos %}
Hello, my name is <span>{</span>{name}}.
{% endhighlight %}
Zugegeben, dieser war ziemlich dumm. In diesem Fall wird das span-Tag auf der Seite gerendert, da ich die Syntax als HTML angegeben habe (was es sein muss).
Wie in aller Welt kann ich das lösen?
{% raw %} {{...}} {% endraw %}
wie man ihn in einem Blog-Beitrag findet , der genau dieses Thema behandelt?Sie können verwenden,
{% raw %}
um sicherzustellen, dass der Inhalt von Jekyll nicht geändert wird:Beachten Sie jedoch, dass dies kein Codeblock ist . Sie benötigen eine zusätzliche Code-Formatierung, damit Ihre Inhalte als Code gerendert werden:
quelle
{% raw %}{{ foo }}{% endraw %}
Am Ende habe ich für jedes Ereignis etwas Hässlicheres getan, also werde ich mir ansehen, was Sie hier getan haben.Mit Jekyll lautet der Code:
quelle
Für zukünftige Referenzen: Verwenden von plain
{% raw %}
und{% endraw %}
ist nur die zweitbeste Lösung, da diese angezeigt werden, wenn Sie den Markdown auf normalem github.com nachschlagen.Der beste Weg ist , zu setzen
{% raw %}
und{% endraw %}
in HTML - Kommentaren:Aufgrund der HTML-Kommentare wird es von Github als Kommentar angesehen. Auf Github-Seiten verhindern die unformatierten Tags das Parsen der geschweiften Klammern zwischen den Tags.
quelle
Dies funktioniert in Jekyll :
quelle