Files
gitea-pages/siteinfo.md
2019-06-19 11:25:18 +02:00

50 lines
2.4 KiB
Markdown

---
title: "Testing Jekyll environment"
sidebar: home_sidebar
permalink: siteinfo.html
---
## Site
- site.port: {{site.port}}
- site.host: {{site.host}}
- site.url: {{site.url}}
- site.baseurl: {{site.baseurl}}
{% comment %}
## Full dump
<pre>{{site|inspect}}</pre>
{% endcomment %}
## Testing links
Link processing in Jekyll
Code | Result |
---- | ------ |
`{%raw%}[Normal link to source]{%endraw%}{%raw%}(/pages/merlin6/introduction.md){%endraw%}` | [Normal link to source](/pages/merlin6/introduction.md)
`{%raw%}[Normal link to result](/merlin6/introduction.html){%endraw%}` | [Normal link to result](/merlin6/introduction.html)
`{%raw%}[Invalid Escaped link to source]({{"/pages/merlin6/introduction.md"}}){%endraw%}` | [Invalid Escaped link to source]({{"/pages/merlin6/troduction.md"}})
`{%raw%}[Escaped link to result]({{"/merlin6/introduction.html"}}){%endraw%}` | [Escaped link to result]({{"/merlin6/introduction.html"}})
`{%raw%}[Reference link to source](srcRef){%endraw%}` | [Reference link to source][srcRef]
`{%raw%}[Reference link to result](dstRef){%endraw%}` | [Reference link to result][dstRef]
`{%raw%}[Liquid Link]({% link pages/merlin6/introduction.md %}){%endraw%}` | [Liquid Link]({% link pages/merlin6/introduction.md %})
`{%raw%}![PSI Logo](/images/psi-logo.png){%endraw%}` | ![PSI Logo](/images/psi-logo.png)
`{%raw%}![Escaped PSI Logo]({{ "/images/psi-logo.png" }}){%endraw%}` | ![PSI Logo from liquid]({{ "/images/psi-logo.png" }})
`{%raw%}Reference to source: (/pages/merlin6/introduction.md){%endraw%}` | Reference to source: (/pages/merlin6/introduction.md)
`{%raw%}{{ "/pages/merlin6/introduction.md" | relative_url }}{%endraw%}` | {{ "/pages/merlin6/introduction.md" | relative_url }}
`{%raw%}{{ "/merlin6/introduction.html" | relative_url }}{%endraw%}` | {{ "/merlin6/introduction.html" | relative_url }}
[srcRef]: /pages/merlin6/introduction.md
[dstRef]: /merlin6/introduction.html
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