@guzhongren/sha 0.1.1 → 0.1.2

package/README.md

@@ -2,16 +2,28 @@
 
 Config-driven Astro blog theme for technical writing. The theme is consumed as an Astro integration and injects default pages, layouts, and styling.
 
-## Install
+## Quick Start
+
+Scaffold a new blog in one command:
 
 ```sh
-pnpm add @guzhongren/sha astro @astrojs/mdx tailwindcss @tailwindcss/vite
+pnpm dlx @guzhongren/sha my-blog
+cd my-blog && pnpm dev
 ```
 
-## Configure
+This creates a complete project with `astro.config.mjs`, content collections bridge, and a sample post.
+
+## Manual Setup
+
+If you prefer to set up manually or add the theme to an existing Astro project:
+
+```sh
+pnpm add @guzhongren/sha astro @astrojs/mdx @astrojs/markdown-remark tailwindcss @tailwindcss/vite
+```
+
+### astro.config.mjs
 
 ```js
-// astro.config.mjs
 import { defineConfig } from "astro/config";
 import mdx from "@astrojs/mdx";
 import tailwindcss from "@tailwindcss/vite";
@@ -22,21 +34,13 @@ export default defineConfig({
   integrations: [
     blogTheme({
       site: {
-        name: "谷中的博客",
-        description: "全栈开发者的技术写作与知识沉淀",
-        lang: "zh-CN",
+        name: "My Blog",
+        title: "My Blog",
+        description: "A blog powered by @guzhongren/sha",
+        lang: "en",
       },
       author: {
-        name: "谷中",
-        headline: "全栈开发者 / 技术顾问",
-        bio: "写工程实践、架构思考、开源与日常观察。",
-        avatar: "/avatar.svg",
-      },
-      diagrams: {
-        mermaid: true,
-        plantuml: {
-          serverUrl: "https://www.plantuml.com/plantuml/svg",
-        },
+        name: "Author",
       },
     }),
     mdx(),
@@ -49,9 +53,7 @@ export default defineConfig({
 
 Register `blogTheme(...)` before `mdx()` when using theme shortcodes such as ECharts. The theme pre-processes content before MDX parses it.
 
-## Content collections
-
-Astro requires the app to export content collections:
+### Content collections bridge
 
 ```ts
 // src/content.config.ts

package/create.mjs

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+
+const name = process.argv[2];
+if (!name) {
+  console.error("Usage: pnpm dlx @guzhongren/sha <project-dir>");
+  console.error("       node create.mjs <project-dir>");
+  process.exit(1);
+}
+
+const root = join(process.cwd(), name);
+
+// Dir tree
+mkdirSync(join(root, "src", "content", "posts"), { recursive: true });
+
+// package.json
+writeFileSync(
+  join(root, "package.json"),
+  JSON.stringify(
+    {
+      name: name,
+      version: "0.0.1",
+      type: "module",
+      private: true,
+      scripts: {
+        dev: "astro dev",
+        sync: "astro sync",
+        build: "astro build",
+        preview: "astro preview",
+      },
+      dependencies: {
+        "@astrojs/markdown-remark": "^7.0.0",
+        "@astrojs/mdx": "^7.0.5",
+        "@guzhongren/sha": "^0.1.1",
+        "@tailwindcss/vite": "^4.3.3",
+        astro: "^7.1.6",
+        tailwindcss: "^4.3.3",
+      },
+    },
+    null,
+    2,
+  ) + "\n",
+);
+
+// astro.config.mjs
+writeFileSync(
+  join(root, "astro.config.mjs"),
+  `import { defineConfig } from "astro/config";
+import mdx from "@astrojs/mdx";
+import tailwindcss from "@tailwindcss/vite";
+import blogTheme from "@guzhongren/sha";
+
+export default defineConfig({
+  site: "https://example.com",
+  integrations: [
+    blogTheme({
+      site: {
+        name: "My Blog",
+        title: "My Blog",
+        description: "A blog powered by @guzhongren/sha",
+        lang: "en",
+      },
+      author: {
+        name: "Author",
+      },
+    }),
+    mdx(),
+  ],
+  vite: {
+    plugins: [tailwindcss()],
+  },
+});
+`,
+);
+
+// src/content.config.ts
+writeFileSync(
+  join(root, "src", "content.config.ts"),
+  `export { collections } from "@guzhongren/sha/content";\n`,
+);
+
+// hello-world post
+writeFileSync(
+  join(root, "src", "content", "posts", "hello-world.md"),
+  `---
+title: "Hello World"
+description: "My first blog post"
+publishDate: ${new Date().toISOString().slice(0, 10)}
+category: "Uncategorized"
+tags: ["hello"]
+---
+
+Welcome to my blog! 🎉
+`,
+);
+
+// tsconfig.json
+writeFileSync(
+  join(root, "tsconfig.json"),
+  `{
+  "extends": "astro/tsconfigs/strict"
+}
+`,
+);
+
+// .gitignore
+writeFileSync(join(root, ".gitignore"), "node_modules/\n.astro/\ndist/\n");
+
+// pnpm-workspace.yaml (minimumReleaseAgeExclude for fresh packages)
+writeFileSync(
+  join(root, "pnpm-workspace.yaml"),
+  `allowBuilds:
+  esbuild: true
+minimumReleaseAgeExclude:
+  - "@guzhongren/sha"
+`,
+);
+
+// Install deps
+console.log(`\n✓ Scaffolded "${name}"`);
+console.log("Installing dependencies...\n");
+execSync("pnpm install", { cwd: root, stdio: "inherit" });
+
+console.log(`\n✓ Done! Start the dev server:\n`);
+console.log(`  cd ${name} && pnpm dev\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guzhongren/sha",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "个人 Astro 博客主题 — 开箱即用的内容驱动博客",
   "license": "MIT",
@@ -15,9 +15,13 @@
   ],
   "files": [
     "src/",
+    "create.mjs",
     "README.md",
     "LICENSE"
   ],
+  "bin": {
+    "create-sha-blog": "./create.mjs"
+  },
   "exports": {
     ".": "./src/index.ts",
     "./content": "./src/content.ts",