@riebeckite/plugin-breadcrumbs 0.0.32 → 0.0.33
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/README_ja.md +8 -4
- package/dist/index.d.ts +0 -2
- package/dist/index.js +0 -2
- package/dist/src/breadcrumbs.d.ts +2 -1
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -9,6 +9,10 @@ No client-side JavaScript is required.
|
|
|
9
9
|
|
|
10
10
|
[日本語](./README_ja.md)
|
|
11
11
|
|
|
12
|
+
## Live example
|
|
13
|
+
|
|
14
|
+
The breadcrumb trail above the article — **Riebeckite / Docs / Plugins / Breadcrumbs** — is this plugin's output. It is built from the page's folder and title, and the same trail is emitted as `BreadcrumbList` JSON-LD.
|
|
15
|
+
|
|
12
16
|
## Overview
|
|
13
17
|
|
|
14
18
|
`breadcrumbs()` reads the entry's slug, splits it into segments, and produces a
|
|
@@ -85,7 +89,7 @@ import "@riebeckite/plugin-breadcrumbs/style.css";
|
|
|
85
89
|
## Exports
|
|
86
90
|
|
|
87
91
|
- `breadcrumbs(options?)` — plugin factory
|
|
88
|
-
- `
|
|
92
|
+
- `breadcrumbs` — alias of `breadcrumbs`
|
|
89
93
|
- `resolveBreadcrumbsOptions(options?)` — apply option defaults
|
|
90
94
|
- `buildBreadcrumbItems({ manifest, entry, config, homeLabel })` — build the trail
|
|
91
95
|
- `renderBreadcrumbNav(items, options)` — render the navigation HTML
|
package/README_ja.md
CHANGED
|
@@ -9,6 +9,10 @@ JavaScript は不要です。
|
|
|
9
9
|
|
|
10
10
|
[English](./README.md)
|
|
11
11
|
|
|
12
|
+
## 実行例
|
|
13
|
+
|
|
14
|
+
記事の上に表示されている **Riebeckite / Docs / Plugins / Breadcrumbs** が、このプラグインの出力です。ページのフォルダとタイトルから組み立てられ、同じ内容が `BreadcrumbList` の JSON-LD としても出力されます。
|
|
15
|
+
|
|
12
16
|
## 仕組み
|
|
13
17
|
|
|
14
18
|
`breadcrumbs()` はエントリのスラッグを「/」で区切り、必ずサイトのホームから
|
|
@@ -19,7 +23,7 @@ JavaScript は不要です。
|
|
|
19
23
|
|
|
20
24
|
途中のフォルダはマニフェストと突き合わせて解決します。フォルダ自身に
|
|
21
25
|
インデックスノート(フォルダと同名のスラッグを持つノート)があればその
|
|
22
|
-
|
|
26
|
+
タイトルを使い、なければセグメントをタイトルケース(先頭を大文字にする)にして
|
|
23
27
|
代用します。最後のパンくずはそのノート自身で、パーマリンクへリンクします。
|
|
24
28
|
|
|
25
29
|
マニフェストエントリの HTML にナビゲーションを挿入します。Core がその HTML を
|
|
@@ -29,7 +33,7 @@ JavaScript は不要です。
|
|
|
29
33
|
## JSON-LD
|
|
30
34
|
|
|
31
35
|
`breadcrumbs()` は階層的な BreadcrumbList を `entry.headTags` の
|
|
32
|
-
`<script type="application/ld+json">`
|
|
36
|
+
`<script type="application/ld+json">` として提供します。サイトシェルがこれを
|
|
33
37
|
文書の `<head>` に描画します(リファレンスアプリの `_renderer.tsx` は
|
|
34
38
|
`entry.headTags` を描画します)。アイテムの URL は設定の `baseUrl` に基づき
|
|
35
39
|
絶対 URL に変換されます。
|
|
@@ -37,7 +41,7 @@ JavaScript は不要です。
|
|
|
37
41
|
`seo` プラグインも有効な場合、seo 側は独自の 2 階層の BreadcrumbList
|
|
38
42
|
(`ホーム / ノート`)を記事 JSON-LD に含めようとします。ページの `headTags`
|
|
39
43
|
を seo 拡張へ渡すと、本プラグインが提供した BreadcrumbList を検出して seo 側の
|
|
40
|
-
|
|
44
|
+
暫定版を省略するため、サイト側で調整しなくても BreadcrumbList は 1 つだけに
|
|
41
45
|
なります。本プラグインからの出力自体を止めたい場合は `jsonLd: false` を使います。
|
|
42
46
|
|
|
43
47
|
## 使い方
|
|
@@ -84,7 +88,7 @@ import "@riebeckite/plugin-breadcrumbs/style.css";
|
|
|
84
88
|
## エクスポート
|
|
85
89
|
|
|
86
90
|
- `breadcrumbs(options?)`:プラグインファクトリ
|
|
87
|
-
- `
|
|
91
|
+
- `breadcrumbs`:`breadcrumbs` のエイリアス
|
|
88
92
|
- `resolveBreadcrumbsOptions(options?)`:オプションの既定値を適用する
|
|
89
93
|
- `buildBreadcrumbItems({ manifest, entry, config, homeLabel })`:パンくず列を組み立てる
|
|
90
94
|
- `renderBreadcrumbNav(items, options)`:ナビゲーション HTML を生成する
|
package/dist/index.d.ts
CHANGED
|
@@ -16,5 +16,3 @@ export declare const BREADCRUMBS_PLUGIN_NAME = "breadcrumbs";
|
|
|
16
16
|
* `<head>`. No client runtime is required.
|
|
17
17
|
*/
|
|
18
18
|
export declare function breadcrumbs(options?: BreadcrumbsOptions): import("@riebeckite/core").RiebeckitePlugin<BreadcrumbsOptions>;
|
|
19
|
-
/** Alias matching the `*Plugin` suffix used by other plugin factories. */
|
|
20
|
-
export declare const breadcrumbsPlugin: typeof breadcrumbs;
|
package/dist/index.js
CHANGED
|
@@ -223,7 +223,6 @@ function breadcrumbs(options = {}) {
|
|
|
223
223
|
]
|
|
224
224
|
});
|
|
225
225
|
}
|
|
226
|
-
var breadcrumbsPlugin = breadcrumbs;
|
|
227
226
|
function breadcrumbOutputDependencies(entry, manifest) {
|
|
228
227
|
const segments = entry.publicLocation.permalink.split("/").filter(Boolean);
|
|
229
228
|
const dependencies = [];
|
|
@@ -266,7 +265,6 @@ export {
|
|
|
266
265
|
BREADCRUMBS_PLUGIN_NAME,
|
|
267
266
|
breadcrumbs_default as Breadcrumbs,
|
|
268
267
|
breadcrumbs,
|
|
269
|
-
breadcrumbsPlugin,
|
|
270
268
|
buildBreadcrumbHeadTag,
|
|
271
269
|
buildBreadcrumbItems,
|
|
272
270
|
buildBreadcrumbJsonLd,
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { ContentManifest, PluginDataHelper, PublicContentEntry, PublicContentView, ResolvedRiebeckiteConfig } from "@riebeckite/core";
|
|
2
2
|
import type { BreadcrumbItem } from "./types.js";
|
|
3
|
-
|
|
3
|
+
type BuildBreadcrumbItemsArgs = {
|
|
4
4
|
manifest: ContentManifest;
|
|
5
5
|
entry: {
|
|
6
6
|
slug: string;
|
|
@@ -18,3 +18,4 @@ export declare const getBreadcrumbs: PluginDataHelper<{
|
|
|
18
18
|
entry: PublicContentEntry;
|
|
19
19
|
homeLabel?: string;
|
|
20
20
|
}, readonly BreadcrumbItem[]>;
|
|
21
|
+
export {};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@riebeckite/plugin-breadcrumbs",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.33",
|
|
4
4
|
"license": "Apache-2.0",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -21,13 +21,13 @@
|
|
|
21
21
|
"./style.css": "./style.css"
|
|
22
22
|
},
|
|
23
23
|
"dependencies": {
|
|
24
|
-
"
|
|
25
|
-
"@riebeckite/
|
|
26
|
-
"
|
|
24
|
+
"@riebeckite/core": "0.0.33",
|
|
25
|
+
"@riebeckite/ui": "0.0.33",
|
|
26
|
+
"hono": "^4.12.25"
|
|
27
27
|
},
|
|
28
28
|
"devDependencies": {
|
|
29
|
-
"
|
|
30
|
-
"
|
|
29
|
+
"@riebeckite/test": "0.0.33",
|
|
30
|
+
"tsx": "^4.22.4"
|
|
31
31
|
},
|
|
32
32
|
"publishConfig": {
|
|
33
33
|
"access": "public"
|