Just the Docs のリンク生成について

Just the Docs は文書管理に特化したJekyllテーマですが、サイト内のリンク生成にabsolute_urlフィルタが使われており、Dockerを使ったテストの際などに問題が発生していました。

現在、使用しているバージョンは下記のとおりです。

absolute_urlの問題は昨年10月 ¹ GitHubに absolute_url should be changed to relative_url #237 が立てられ、約半年後 ² に Update absolute_path to relative_path #312 が出されています。

このPull requestは 0.3.0 ³ で取り込まれる予定 ⁴ でしたが、 0.3.2 で実装されましたとアナウンス ⁵ されていました。

その0.3.2 が先日リリース ⁶ されたので確認してみると、CSS, JSのリンク問題は解消されましたが #312 のすべてが実装されたわけではなく下記のファイルではリンクの生成に absolute_urlフィルタが使われています。

確かに Google Search Console ヘルプにはクローラーのために

可能な場合は、相対リンクではなく絶対リンクを使用します

と書かれていますから、できる限り絶対リンクを使おうということなのでしょう。

しかし、通常どおり文書内に下記のようにリンクを書くと

[Link to a page]({% link news/index.html %})
[Name of Link]({% post_url 2010-07-21-name-of-post %})

相対リンクが生成され、ナビ部分などテーマ側で生成されるリンクは絶対リンクになっていますから、普通に使っていると絶対リンクとして貼られるページと相対リンクとして貼られるページとが混在することになってしまいます。

絶対リンクと相対リンクの混在はGoogleのいうところの 可能な場合 の範疇という判断なのでしょうが、相対リンクに統一すれば良いのにと思ってしまいます。

ちなみにデフォルトテーマのMinimaではDisqusに渡すURLの生成だけに absolute_urlフィルタが使われ、サイト内のリンクは相対リンクに統一されています。

個人的に混在しているのは、なんだか気持ちが悪いのでテーマを上書きして使う ⁷ ことにします。