tl;dr Markdown、相対リンク、Jekyll、および Github ページをうまく連携させたいと思っています。
Github および Jekyll を使用した Github ページで、動作するバニラ マークダウン スタイルの相対リンク(つまり)を含むファイルを表示できるようにしたいと考えています。[a relative link](other_file.md)
これまでのところ、Github が相対リンクのサポートを追加したため、Githubで上記のファイルを表示することで機能します。
ただし、これは Jekyll ではそのままでは機能しません{{ site.baseurl }}{{ post.url }}。
「安全でない」プラグインを使用せずに、バニラの Markdown スタイルの相対リンクを Jekyll で動作させるために使用できるプリプロセッサまたはその他の方法はありますか?
Jekyll のデフォルトの Markdown パーサーはKramdownです。これにより、ファイル (page.md または page.markdown) および変数にマークダウンを書き込むことができます。
変数にマークダウンがある場合は、 {{ variable | で解析できます。マークダウンする}}
リンクの例 ( [a relative link](other_file.md)) は、ページから other_file.md 兄弟ページへの完全な相対リンクをレンダリングします。
この構文は自由に使用できます。
{{ site.baseurl }}と{{ post.url }}変数これらの変数は Jekyll では必須ではありません。
{{ post.url }}多くの場合、for ループで検出され、次のようなリンクが生成され[{{ post.title }}]({{ post.url }})ます。これは自動化のみです。また、自動化を使用する義務はありません。
{{ site.baseurl }}(これは とは異なります{{ site.url }}) は、サイト ルートに関連するリンクを作成するための非常に便利な変数です。
のようなリンク[a relative link](/other_file.md)は、のように変換されるため、サイトがドメインのルートにある場合にのみ機能します/other_file.html。あなたのサイトが でホストされている場合domain.tld.blog、このリンクは対象外です。
ファイルに設定baseurl: /blogした場合。_config.ymlを追加[a relative link]({{ site.baseurl }}/other_file.md)すると、 root : への完全な相対リンクが得られます/blog/other_file.html。
ページがロードされた後にJavaScriptを使用して相対リンクを操作するCory Gross docsyncメソッドを使用しています。これにより、バニラ スタイルのリンクが可能になります。