create-riebeckite 0.0.12 → 0.0.13

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.
Files changed (5) hide show
  1. package/README.md +22 -27
  2. package/README_ja.md +19 -24
  3. package/dist/src/index.d.ts +0 -1
  4. package/dist/src/index.js +4 -11
  5. package/package.json +2 -2
package/README.md CHANGED
@@ -18,18 +18,17 @@ npm exec riebeckite build
18
18
  | Option | Description |
19
19
  | --- | --- |
20
20
  | `[directory]` | Directory to scaffold into (default: the current directory) |
21
- | `--preset <name>` | Starter composition, e.g. `rich` (default: `starter`) |
21
+ | `--preset <name>` | Starter composition, e.g. `showcase` (default: `starter`) |
22
22
  | `--force` | Scaffold even when the target directory is not empty |
23
23
  | `--list-presets` | Print the available presets and their descriptions, then exit |
24
24
  | `--github-actions` | Generate the Cloudflare deployment workflow |
25
- | `--content-repository <owner/repository>` | Check out this repository into `content/` during deployment (requires `--github-actions`) |
26
- | `--site-repository <owner/repository>` | Site repository notified by the generated content workflow |
27
- | `--notify-on-content-push` | Generate `github/notify-site.yml` for the content repository (requires Actions, content, and site repositories) |
25
+ | `--content-repository <owner/repository>` | Use this repository as the deployment content source. Requires `--github-actions` and `--site-repository`; also generates `github/notify-site.yml`. |
26
+ | `--site-repository <owner/repository>` | Site repository that the generated content workflow notifies. Required with `--content-repository`. |
28
27
 
29
- For example, scaffold with the `rich` preset:
28
+ For example, scaffold the complete feature tour:
30
29
 
31
30
  ```sh
32
- npx create-riebeckite my-site --preset rich
31
+ npx create-riebeckite my-site --preset showcase
33
32
  ```
34
33
 
35
34
  To use a separate content repository and deploy after its `main` branch is
@@ -38,8 +37,7 @@ pushed, generate the common workflow once (the preset does not affect it):
38
37
  ```sh
39
38
  npx create-riebeckite my-site --github-actions \
40
39
  --content-repository OWNER/notes \
41
- --site-repository OWNER/my-site \
42
- --notify-on-content-push
40
+ --site-repository OWNER/my-site
43
41
  ```
44
42
 
45
43
  Set `content.directory` to `"content"`, add the documented repository secrets,
@@ -47,6 +45,10 @@ then copy `github/notify-site.yml` into the content repository as
47
45
  `.github/workflows/notify-site.yml`. See the [separate-content deployment
48
46
  guide](../../templates/cloudflare/README_en.md).
49
47
 
48
+ `--content-repository` automatically configures the external checkout, the
49
+ `content-updated` repository-dispatch receiver, and `github/notify-site.yml`.
50
+ The previous notification option was removed; omit it when migrating an older command.
51
+
50
52
  ## Presets
51
53
 
52
54
  List the available presets with `--list-presets`:
@@ -55,38 +57,31 @@ List the available presets with `--list-presets`:
55
57
  npx create-riebeckite --list-presets
56
58
  ```
57
59
 
58
- Every preset is a self-contained starter description. From smallest to
59
- largest:
60
+ Every preset is a self-contained starter description:
60
61
 
61
- | Preset | Theme | Plugins | Content pages |
62
- | ------- | ------------ | ------- | ---------------------------------------------------- |
63
- | `empty` | none | none | none (static index) |
64
- | `minimal` | minimal | 1 | index |
65
- | `starter` | default | 3 | index (7 languages) |
66
- | `rich` | default | 8 | index, framework/plugins, framework/themes (7 languages) |
67
- | `full` | default | 23 | rich + guide |
68
- | `max` | default | 46 | full + examples |
69
- | `ultra` | default | 52 | max + reference/plugins, reference/themes |
62
+ | Preset | Purpose |
63
+ | --- | --- |
64
+ | `starter` | Recommended for most sites |
65
+ | `minimal` | Small Markdown site with minimal configuration |
66
+ | `showcase` | Explore Riebeckite features and plugins with rendered examples and local fixtures |
67
+ | `empty` | Blank shell for custom setups |
70
68
 
71
69
  Each preset has a one-line description, shown by `--list-presets`:
72
70
 
71
+ - `starter` — Recommended for most sites: practical Markdown publishing, search, and discovery.
72
+ - `minimal` — The smallest useful site: Obsidian Markdown, the minimal theme, and one page.
73
+ - `showcase` — The complete plugin catalog with rendered examples, local fixtures, and reference pages.
73
74
  - `empty` — A blank application shell: no plugins, theme, content, or components.
74
- - `minimal` — The smallest useful site: Obsidian Markdown, the minimal theme, one page.
75
- - `starter` — The default starter: Obsidian Markdown, color mode, seven languages, and a site header.
76
- - `rich` — Publishing and reading plugins plus guided ecosystem tour pages in seven languages.
77
- - `full` — A ready blog: discovery, media, and reading plugins plus a build guide.
78
- - `max` — Diagram and knowledge plugins on top of `full`, with showcase example pages.
79
- - `ultra` — The full plugin catalog and theme reference pages — everything the ecosystem offers.
80
75
 
81
76
  Presets are defined in `@riebeckite/honox` and can be imported into your own
82
77
  tooling:
83
78
 
84
79
  ```ts
85
- import { scaffoldRiebeckiteSite, rich } from "@riebeckite/honox";
80
+ import { scaffoldRiebeckiteSite, showcase } from "@riebeckite/honox";
86
81
 
87
82
  await scaffoldRiebeckiteSite({
88
83
  targetDirectory: "./my-site",
89
- preset: rich,
84
+ preset: showcase,
90
85
  });
91
86
  ```
92
87
 
package/README_ja.md CHANGED
@@ -23,14 +23,13 @@ npm exec riebeckite build
23
23
  | `--force` | 空でないディレクトリにも展開する |
24
24
  | `--list-presets` | 利用可能な preset と説明を一覧表示して終了する |
25
25
  | `--github-actions` | Cloudflare へのデプロイ workflow を生成する |
26
- | `--content-repository <owner/repository>` | デプロイ時にこのリポジトリを `content/` へ checkout する（`--github-actions` が必要） |
27
- | `--site-repository <owner/repository>` | 生成する記事通知 workflow が通知する site リポジトリ |
28
- | `--notify-on-content-push` | 記事リポジトリ用の `github/notify-site.yml` を生成する（Actions、記事・site リポジトリが必要） |
26
+ | `--content-repository <owner/repository>` | このリポジトリをデプロイ時の content source にする。`--github-actions` と `--site-repository` が必要で、`github/notify-site.yml` も生成する。 |
27
+ | `--site-repository <owner/repository>` | 生成した記事通知 workflow の通知先 site リポジトリ。`--content-repository` と同時に必要。 |
29
28
 
30
- たとえば、`rich` preset で生成する場合は次のようにします。
29
+ たとえば、機能を一通り確認できる `showcase` preset で生成する場合は次のとおりです。
31
30
 
32
31
  ```sh
33
- npx create-riebeckite my-site --preset rich
32
+ npx create-riebeckite my-site --preset showcase
34
33
  ```
35
34
 
36
35
  別の記事リポジトリを使い、その `main` への push でデプロイする場合は、共通の
@@ -39,8 +38,7 @@ workflow を一度だけ生成します。preset による違いはありませ
39
38
  ```sh
40
39
  npx create-riebeckite my-site --github-actions \
41
40
  --content-repository OWNER/notes \
42
- --site-repository OWNER/my-site \
43
- --notify-on-content-push
41
+ --site-repository OWNER/my-site
44
42
  ```
45
43
 
46
44
  `content.directory` は `"content"` にし、必要な repository Secret を登録した後、
@@ -48,6 +46,9 @@ npx create-riebeckite my-site --github-actions \
48
46
  `.github/workflows/notify-site.yml` にコピーします。詳細は[別記事リポジトリの
49
47
  デプロイガイド](../../templates/cloudflare/README_ja.md)を参照してください。
50
48
 
49
+ `--content-repository` を指定すると、外部 content の checkout、
50
+ `content-updated` の repository dispatch receiver、`github/notify-site.yml` がまとめて構成されます。以前の通知用オプションは廃止しました。
51
+
51
52
  ## Preset
52
53
 
53
54
  利用可能な preset は `--list-presets` で確認できます。
@@ -56,27 +57,21 @@ npx create-riebeckite my-site --github-actions \
56
57
  npx create-riebeckite --list-presets
57
58
  ```
58
59
 
59
- すべての preset は自己完結のスターターで、小さいものから順に次のとおりです。
60
+ すべての preset は自己完結のスターターです。
60
61
 
61
- | Preset | Theme | Plugins | コンテンツページ |
62
- | --- | --- | --- | --- |
63
- | `empty` | なし | なし | なし（静的インデックスのみ） |
64
- | `minimal` | minimal | 1 | index |
65
- | `starter` | default | 3 | index（7 言語） |
66
- | `rich` | default | 8 | index、framework/plugins、framework/themes（7 言語） |
67
- | `full` | default | 23 | rich + guide |
68
- | `max` | default | 46 | full + examples |
69
- | `ultra` | default | 52 | max + reference/plugins、reference/themes |
62
+ | Preset | 用途 |
63
+ | --- | --- |
64
+ | `starter` | 大半のサイトにおすすめ |
65
+ | `minimal` | 最小限の設定で作る Markdown サイト |
66
+ | `showcase` | 描画例とローカルのフィクスチャで Riebeckite の機能と Plugin を確認する構成 |
67
+ | `empty` | 独自構成のための空のシェル |
70
68
 
71
69
  各 preset の説明は次のとおりです（`--list-presets` で表示される内容と同じです）。
72
70
 
73
- - `empty` — 空のアプリケーションシェル（Plugin・Theme・コンテンツ・コンポーネントなし）
74
- - `minimal` — 最小構成のサイト（Obsidian Markdown、minimal Theme、1 ページ）
75
- - `starter` — 標準のスターター（Obsidian Markdown、カラーモード、7 言語、サイトヘッダー）
76
- - `rich` — 公開・閲覧向け Plugin と、エコシステムを紹介するページ（7 言語）
77
- - `full` — ブログ一式（検索・メディア・関連記事などの Plugin とビルドガイド）
78
- - `max` — `full` に図表・ナレッジ系 Plugin とサンプルページを追加
79
- - `ultra` — 全 Plugin カタログと Theme リファレンスページ（エコシステムの一式）
71
+ - `starter` — 大半のサイト向け。Markdown の公開、検索、記事の発見に必要な機能を含みます。
72
+ - `minimal` — Obsidian Markdown、minimal Theme、1 ページだけの最小構成です。
73
+ - `showcase` — 全 Plugin カタログ、描画例、ローカルの fixture、リファレンスページを含みます。
74
+ - `empty` — Plugin・Theme・コンテンツ・コンポーネントを含まない空のシェルです。
80
75
 
81
76
  Riebeckite は、Markdown や Obsidian 由来のノートを Web で公開するための
82
77
  拡張可能なフレームワークです。設定方法やプラグインについては
package/dist/src/index.d.ts CHANGED
@@ -7,6 +7,5 @@ export type CreateRiebeckiteOptions = {
7
7
  readonly githubActions: boolean;
8
8
  readonly contentRepository?: string;
9
9
  readonly siteRepository?: string;
10
- readonly notifyOnContentPush: boolean;
11
10
  };
12
11
  export declare function runCreateRiebeckite(arguments_: readonly string[]): Promise<void>;
package/dist/src/index.js CHANGED
@@ -29,14 +29,13 @@ async function runCreateRiebeckite(arguments_) {
29
29
  preset: options.preset,
30
30
  githubActions: options.githubActions,
31
31
  contentRepository: options.contentRepository,
32
- siteRepository: options.siteRepository,
33
- notifyOnContentPush: options.notifyOnContentPush
32
+ siteRepository: options.siteRepository
34
33
  });
35
34
  const relative = path.relative(process.cwd(), result.targetDirectory) || ".";
36
35
  console.log(`Created a ${options.preset} Riebeckite site in ${relative}`);
37
36
  console.log("");
38
37
  console.log(formatScaffoldNextSteps(relative));
39
- if (options.notifyOnContentPush) {
38
+ if (options.contentRepository !== void 0) {
40
39
  console.log("");
41
40
  console.log(
42
41
  "Copy github/notify-site.yml to the content repository as .github/workflows/notify-site.yml."
@@ -59,7 +58,6 @@ function parseArguments(arguments_) {
59
58
  let githubActions = false;
60
59
  let contentRepository;
61
60
  let siteRepository;
62
- let notifyOnContentPush = false;
63
61
  for (let index = 0; index < arguments_.length; index += 1) {
64
62
  const argument = arguments_[index];
65
63
  if (argument === "--force") {
@@ -74,10 +72,6 @@ function parseArguments(arguments_) {
74
72
  githubActions = true;
75
73
  continue;
76
74
  }
77
- if (argument === "--notify-on-content-push") {
78
- notifyOnContentPush = true;
79
- continue;
80
- }
81
75
  if (argument === "--content-repository" || argument === "--site-repository") {
82
76
  const value = arguments_[index + 1];
83
77
  if (value === void 0 || value.startsWith("-")) {
@@ -104,7 +98,7 @@ function parseArguments(arguments_) {
104
98
  }
105
99
  if (directory !== void 0) {
106
100
  throw new Error(
107
- "Usage: create-riebeckite [directory] [--preset <name>] [--github-actions] [--content-repository <owner/repository>] [--site-repository <owner/repository>] [--notify-on-content-push] [--force]"
101
+ "Usage: create-riebeckite [directory] [--preset <name>] [--github-actions] [--content-repository <owner/repository>] [--site-repository <owner/repository>] [--force]"
108
102
  );
109
103
  }
110
104
  directory = argument;
@@ -116,8 +110,7 @@ function parseArguments(arguments_) {
116
110
  listPresets,
117
111
  githubActions,
118
112
  contentRepository,
119
- siteRepository,
120
- notifyOnContentPush
113
+ siteRepository
121
114
  };
122
115
  }
123
116
  function printPresets() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-riebeckite",
3
- "version": "0.0.12",
3
+ "version": "0.0.13",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "main": "./dist/src/index.js",
@@ -27,7 +27,7 @@
27
27
  "access": "public"
28
28
  },
29
29
  "dependencies": {
30
- "@riebeckite/honox": "0.0.12"
30
+ "@riebeckite/honox": "0.0.13"
31
31
  },
32
32
  "repository": {
33
33
  "type": "git",