Grav-page-linking
Grav-ページのリンク
この章では、Gravでページをリンクする方法を理解します。 1つのページを別のページに簡単な方法でリンクでき、リモートページでさえページリンクでリンクできます。 Gravには、多くのレスポンシブリンクオプションがあります。 以前に HTML を使用してファイルをリンクしたことがある場合、Gravでのページリンクは非常に簡単に理解できます。
以下は、GravサイトのPagesディレクトリの基本的な例です。 画像に示すように、例として次のディレクトリを使用します。
以下に、Gravリンクのいくつかの一般的なコンポーネントを示します。
[Linked Content](../path/slug/page)
- [] -リンクされるテキストまたは代替コンテンツを書き込むことを指定します。 HTMLでは、<a href="">および</a>を使用してコンテンツを配置します。
- ()-URLはこのブラケットに配置され、角括弧の直後に配置されます。
- ../ -1つ上のディレクトリに移動することを示します。
以下にリストされているように、コンテンツで使用されるリンクの4種類があります-
- スラッグ相対
- ディレクトリ相対
- 絶対の
- リモート
スラッグ相対
内部リンクは、ファイル/ディレクトリ構造内の一部の名前に限定されません。 スラッグはヘッダーとフォールバックの両方のディレクトリ名から取得できます。特定のファイル名を覚える必要はないが、関連するスラッグを覚えることができるので、後でリンクを簡単に作成できます。 Gravのテンプレートエンジンは、ファイルの名前を使用して、適用するテンプレートを認識します。
[link](../dog)
上記のコードは、次の結果を取得します-
上記の例では、ディレクトリを上に移動し、 pages/01.home/02.nature/item.md ディレクトリにあるデフォルトページを pages/01.home/02.dog/itemからロードする必要があります。 .md 。 ファイルitem.mdにはスラッグが割り当てられていないため、Gravはディレクトリ名を使用します。
次に、 pages/01.home/01.dog/item.md から pages/02.black/01.fish/item.md にリンクしているが、item.mdをロードするときの同様の例を見つけます。ファイルの場合、スラッグは 01.fish のファイルに割り当てられます。
[link](../../black/fish)
上記のコードはあなたに次の結果を与えます-
item.mdのヘッダーで、デフォルトのスラッグフォルダー名が black スラッグに置き換えられることがわかります。
ディレクトリ相対
相対設定された宛先は、現在のページをリンクするために使用されます。現在のページは、必要に応じて画像ファイルまたはその他のファイルにすることができます。 ファイルの場所は、宛先の場所と同じくらい重要です。 パスの変更中にファイルを移動すると、リンクが壊れる可能性があります。 ファイルの一貫性が保たれている限り、ローカル開発サーバーと異なるドメイン名のライブサーバーを簡単に切り替えることができます。 リンクは問題なく機能するはずです。
ファイルのリンクは、ディレクトリやスラッグではなく、名前で直接指定します。 pages/01.home/01.dog/item.mdからpages/02.black/01.fish/item.md へのリンクを作成するには、以下に示すコマンドを使用します。
[link](../../02.black/01.fish/item.md)
上記のコードはあなたに次の結果を与えます-
*../../* で示されるように、両方のフォルダーが上に移動し、下部の2つのフォルダーで、 *item.md* ファイルを直接ポイントします。
絶対リンク
Gravの /user/pages/ ディレクトリに基づいた相対リンクに似ています。 さらに、これは2つの方法で実行できます。
- スラッグ相対スタイル
- ディレクトリ相対スタイル
ナメクジ相対スタイル
スラッグ相対タイプと同様に行うことができます。 パス内のディレクトリ名を使用します。 リンクを破壊することで、注文や変更のエラーを排除します。 リンクの切断につながる開始時にフォルダー名の番号を変更します。
以下に絶対リンクの例を示します。リンクは/で開きます。 絶対リンクがSlugスタイルの pages/01.home/01.dog/item.md で作成されることを指定します。
[link](/home/nature)
上記のコードはあなたに次の結果を与えます-
ディレクトリ相対スタイル*は、GitHubなどのサービスで使用するとより一貫性があります。 Gravの柔軟性の利点はありません。 以下に、ディレクトリ相対スタイルを使用して *pages/01.home/01.dog/item.md に作成された絶対リンクの例を示します。
[link](/01.home/01.dog)
リモート
リモートリンクを使用すると、URLを介して任意のファイルまたはドキュメントに直接リンクできます。 独自のサイトのコンテンツを含める必要はありません。
次の例は、 finddevguides ページにリンクする方法を示しています。
[link](http://www.finddevguides.com)
上記のコードはあなたに次の結果を与えます-
セキュリティで保護されたHTTPSリンクを含む、任意のURLに直接リンクできます。