TL;DR
- GROWIで相対リンクを記述する際はPukiwiki like linkerを使おう
リンクは[[こちら>./link_to_page]]
経緯
社内のマニュアル等の共有にGROWIを利用している。日本語の全文検索ができ、Markdownの記述ができるので過去のGitBook形式からの移行が容易というのがポイントだった。
が、文書間の相対リンクがうまくいかない。例えば、/manuals/topページにて/manuals/top/system-Aへのリンクを張りたい場合、自分のパスも含めて以下のように記載する必要がある。
[System-Aのマニュアル](./top/system-A)
いまいちだなぁと思いつつ、仕様とあきらめて利用していた。ところが、最新バージョン5.0がリリースされ、これまでパス形式のリンクが既定のところがID形式に変更された。
この結果、/manuals/topにアクセスした際にブラウザに表示されるURLが、バージョンアップ前は
https://docs.example.com/manuals/top
と表示されているところが
https://docs.example.com/62b3acabcd2f9c94de9c3b20f
のようなID表示となってしまった。すると上記の相対リンクは
https://docs.example.com/top/system-A
へのリンクと解釈され、文書が存在しないと表示されてしまう…
で、本家のLinkの貼り方に関する説明を確認し、方法は3種類あり、Pukiwiki like linkerがもっとも柔軟性があるとのことだったので試したところ、特に何もインストールせずに利用でき、自分のパスを含めずに相対パスを作成することができた
[[System-Aのマニュアル>./system-A]]
ただ、当然GitBookとの互換性はなくなる。
今回は互換性よりも相対パスを記載できないことによる文書構造の硬直化がイヤだったのでPukiwiki like linkerを採用した。
Markdown標準方式でも同様の記述ができるようになるとよいのだが。
[2022.8.16追記]
Slackにて不具合委報告したところ、5.1.1より修正されました。