gitea-pages/siteinfo.md
2021-05-21 18:39:38 +02:00

3.4 KiB

title, sidebar, permalink
title sidebar permalink
Testing Jekyll environment home_sidebar siteinfo.html

Site

Some information about this jekyll site (for debugging):

  • site.port: {{site.port}}
  • site.host: {{site.host}}
  • site.url: {{site.url}}
  • site.baseurl: {{site.baseurl}}

{% comment %}

Full dump

{{site|inspect}}

{% endcomment %}

Link processing in Jekyll

Code Result Baseurl
{%raw%}[Normal link to source]{%endraw%}{%raw%}(/pages/merlin6/01-Quick-Start-Guide/introduction.md){%endraw%} Normal link to source
{%raw%}[Normal link to result](/merlin6/introduction.html){%endraw%} Normal link to result
{%raw%}[Invalid Escaped link to source]({{"/pages/merlin6/01-Quick-Start-Guide/introduction.md"}}){%endraw%} Invalid Escaped link to source
{%raw%}[Escaped link to result]({{"/merlin6/introduction.html"}}){%endraw%} Escaped link to result
{%raw%}[Reference link to source](srcRef){%endraw%} Reference link to source
{%raw%}[Reference link to result](dstRef){%endraw%} Reference link to result
{%raw%}[Liquid Link]({% link pages/merlin6/01-Quick-Start-Guide/introduction.md %}){%endraw%} [Liquid Link]({% link pages/merlin6/01-Quick-Start-Guide/introduction.md %})
{%raw%}![PSI Logo](/images/psi-logo.png){%endraw%} PSI Logo
{%raw%}![Escaped PSI Logo]({{ "/images/psi-logo.png" }}){%endraw%} ![PSI Logo from liquid]({{ "/images/psi-logo.png" }})
{%raw%}{% include inline_image.html file="psi-logo.png" alt="Included PSI Logo" %}{%endraw%} {% include inline_image.html file="psi-logo.png" alt="Included PSI Logo" -%}
`{%raw%}{{ "/pages/merlin6/01-Quick-Start-Guide/introduction.md" relative_url }}{%endraw%}` {{ "/pages/merlin6/01-Quick-Start-Guide/introduction.md"
`{%raw%}{{ "/merlin6/introduction.html" relative_url }}{%endraw%}` {{ "/merlin6/introduction.html"
{%raw%}{% link pages/merlin6/01-Quick-Start-Guide/introduction.md %}{%endraw%} {% link pages/merlin6/01-Quick-Start-Guide/introduction.md %}

Key:

  • Baseurl gets prepended to the URL
  • No baseurl in URL
  • Source not expected to be converted to the result URL

Conclusions:

  • Markdown links that refer to source files are replaced by the baseurl + permalink
  • This happens for both normal links and images
  • Workarounds
    • Link to permalink directly (for pages/posts)
    • Can use {%raw%}{{"path"}}{%endraw%} pattern to disable expansion