growilabs/growi-docs

GROWI独自形式のページリンクの説明をわかりやすくしてほしい

Closed this issue · 2 comments

以下部分がよくわからなかったので、わかりやすく書いてほしい。
https://github.com/weseek/growi-docs/blob/49d81f6ef89eb5f27493da3941d1063fcdd42a37/docs/ja/guide/tips/page_linker.md?plain=1#L21-L31

具体的に良くわからなかったのは、[ ]を使うリンクの書き方と、 < > を使うリンクの書き方の2パターンあるという事なのか、それともすべての説明で一つの書き方になっているのか、二行の関係性が良くわからないこと。

また一行目は「パス」という用語を、二行目は「配下ページ」を使っており、その意味の違いもよくわからなかった。
https://github.com/weseek/growi/blob/v5.0.10/packages/app/src/client/util/PreProcessor/Linker.js を読む限り、どちらも絶対パスが必要で、二行目は / が二つ以上必要というのが違いのようだが、それが読み取れなかった。

また合わせて、 https://github.com/weseek/growi-docs/pull/116/files#r417594067 に書かれているように、plugin-pukiwiki-like-linker によるリンクの書き方も書いてあると良い。

https://github.com/weseek/growi-docs/blob/master/docs/ja/guide/features/page_linker.md

master では、「GROWI 独自方式」の記述が消えている状態ですが、そもそも独自形式がなくなったのでしょうか? > 開発者の皆様