create-jant 0.3.22 → 0.3.24

package/dist/index.js

@@ -9,7 +9,7 @@ import path from "path";
 import { fileURLToPath } from "url";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = path.dirname(__filename);
-var CORE_VERSION = "0.3.22";
+var CORE_VERSION = "0.3.24";
 var TEMPLATE_DIR = fs.existsSync(path.resolve(__dirname, "../template")) ? path.resolve(__dirname, "../template") : path.resolve(__dirname, "../../../templates/jant-site");
 function isValidProjectName(name) {
   return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(name);
@@ -40,6 +40,9 @@ function detectPackageManager() {
 function formatRunCmd(pm, script) {
   return pm === "npm" ? `npm run ${script}` : `${pm} ${script}`;
 }
+function formatAddCmd(pm, pkg) {
+  return pm === "npm" ? `npm install ${pkg}` : `${pm} add ${pkg}`;
+}
 function runCommand(cmd, cwd) {
   try {
     execSync(cmd, { stdio: "ignore", cwd });
@@ -174,6 +177,21 @@ S3_SECRET_ACCESS_KEY=
     content = processMarkers(content, {});
     await fs.writeFile(viteConfigPath, content, "utf-8");
   }
+  const readmePath = path.join(targetDir, "README.md");
+  if (packageManager !== "npm" && await fs.pathExists(readmePath)) {
+    let readme = await fs.readFile(readmePath, "utf-8");
+    readme = readme.replace(
+      /npm install (\S+)/g,
+      (_, pkg) => formatAddCmd(packageManager, pkg)
+    );
+    readme = readme.replace(/npm install/g, `${packageManager} install`);
+    readme = readme.replace(
+      /npm run (\S+)/g,
+      (_, script) => formatRunCmd(packageManager, script)
+    );
+    readme = readme.replace(/npm create/g, `${packageManager} create`);
+    await fs.writeFile(readmePath, readme, "utf-8");
+  }
   if (packageManager === "pnpm") {
     const wsSource = path.join(TEMPLATE_DIR, "pnpm-workspace.yaml");
     if (await fs.pathExists(wsSource)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-jant",
-  "version": "0.3.22",
+  "version": "0.3.24",
   "description": "Create a new Jant project",
   "type": "module",
   "bin": {

package/template/scripts/export-demo.mjs

@@ -1,5 +1,5 @@
 import { execSync } from "child_process";
-import { writeFileSync } from "fs";
+import { readFileSync, writeFileSync } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 
@@ -53,20 +53,27 @@ function dumpTable(name, query) {
 
 const header = `-- =============================================================================
 -- Demo seed data for Jant (demo.jant.me)
--- Exported from remote demo D1 database via: mise run demo-backup
+-- Exported from remote demo D1 database via: mise run demo-export
 -- Usage: mise run demo-reset
 -- =============================================================================
 `;
 
+// Read reset-demo.sql and include it at the top
+const resetSql = readFileSync(resolve(__dirname, "reset-demo.sql"), "utf-8");
+
 const tables = [
   // settings, user, account are preserved by reset-demo.sql — don't export
   ["posts", "SELECT * FROM posts WHERE deleted_at IS NULL"],
+  ["pages"],
   ["collections"],
-  ["post_collections"],
+  ["nav_items"],
   ["media"],
 ];
 
 let sql = header;
+sql += "\n-- Reset (clear existing content)\n";
+sql += resetSql.replace(/^--.*\n/gm, "").trim() + "\n";
+
 for (const [name, query] of tables) {
   const data = dumpTable(name, query);
   if (data) sql += `\n-- ${name}\n${data}\n`;

package/template/scripts/export-seed.mjs

@@ -1,11 +1,12 @@
 import { createRequire } from "module";
-import { readdirSync, writeFileSync } from "fs";
+import { readFileSync, readdirSync, writeFileSync } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 
 // Parse flags
 const args = process.argv.slice(2);
 const noMedia = args.includes("--no-media");
+const noAuth = args.includes("--no-auth");
 const outputIndex = args.indexOf("--output");
 const outputFile =
   outputIndex !== -1 ? args[outputIndex + 1] : "seed-local.sql";
@@ -53,17 +54,14 @@ const header = `-- =============================================================
 `;
 
 const tables = [
-  ["settings"],
-  ["user"],
-  ["account"],
+  ...(!noAuth ? [["settings"], ["user"], ["account"]] : []),
   [
     "posts",
-    noMedia
-      ? "SELECT * FROM posts WHERE deleted_at IS NULL AND type != 'image'"
-      : "SELECT * FROM posts WHERE deleted_at IS NULL",
+    "SELECT * FROM posts WHERE deleted_at IS NULL",
   ],
+  ["pages"],
   ["collections"],
-  ["post_collections"],
+  ["nav_items"],
 ];
 
 // Include media table only when --no-media is not set
@@ -72,6 +70,14 @@ if (!noMedia) {
 }
 
 let sql = header;
+
+// When --no-auth, embed reset statements so everything runs in a single D1 import
+if (noAuth) {
+  const resetSql = readFileSync(resolve(__dirname, "reset-demo.sql"), "utf-8");
+  sql += "\n-- Reset (clear existing content)\n";
+  sql += resetSql.replace(/^--.*\n/gm, "").trim() + "\n";
+}
+
 for (const [name, query] of tables) {
   const data = dumpTable(name, query);
   if (data) sql += `\n-- ${name}\n${data}\n`;

package/template/scripts/reset-demo.sql

@@ -1,24 +1,20 @@
--- Reset script for Jant demo site (demo.jant.me)
--- Clears all user-created data while preserving users/schema
+-- Reset script for Jant demo site (demo.jant.me) (v2 schema)
+-- Clears content data while preserving users/settings/schema
 -- Usage: mise run demo-reset (runs this then seed-demo.sql)
 
--- Clear FTS index first (to avoid foreign key issues)
+-- Clear FTS index first (to avoid trigger issues)
 DELETE FROM posts_fts;
 
--- Clear join tables
-DELETE FROM post_collections;
-
--- Clear main tables
+-- Clear main tables (order matters for FK constraints)
+DELETE FROM nav_items;
 DELETE FROM media;
 DELETE FROM posts;
+DELETE FROM pages;
 DELETE FROM collections;
 DELETE FROM redirects;
 
 -- Sessions, users, accounts, and settings are preserved
--- (only content data is reset)
+-- (seed-demo.sql only contains content data)
 
 -- Reset auto-increment counters
-DELETE FROM sqlite_sequence WHERE name IN ('posts', 'media', 'collections', 'redirects');
-
--- Note: Settings and users are preserved
--- Seed data will be re-inserted by seed-demo.sql
+DELETE FROM sqlite_sequence WHERE name IN ('posts', 'pages', 'collections', 'nav_items', 'redirects');

package/template/scripts/reset-local.sql

@@ -1,27 +1,25 @@
--- =============================================================================
--- Reset script for local development
--- Clears ALL data (including users) to prepare for re-seeding
+-- Reset script for Jant local development (v2 schema)
+-- Clears all data so seed-local.sql can re-insert everything
 -- Usage: mise run db-seed (runs this then seed-local.sql)
--- =============================================================================
 
--- Clear FTS index first
+-- Clear FTS index first (to avoid trigger issues)
 DELETE FROM posts_fts;
 
--- Clear join tables
-DELETE FROM post_collections;
-
--- Clear main tables
+-- Clear main tables (order matters for FK constraints)
+DELETE FROM nav_items;
 DELETE FROM media;
 DELETE FROM posts;
+DELETE FROM pages;
 DELETE FROM collections;
 DELETE FROM redirects;
-DELETE FROM settings;
 
--- Clear auth tables
+-- Clear auth tables (order matters: session → account → user)
 DELETE FROM session;
-DELETE FROM verification;
 DELETE FROM account;
 DELETE FROM user;
 
+-- Clear settings
+DELETE FROM settings;
+
 -- Reset auto-increment counters
-DELETE FROM sqlite_sequence;
+DELETE FROM sqlite_sequence WHERE name IN ('posts', 'pages', 'collections', 'nav_items', 'redirects');

package/template/scripts/seed-demo.sql

@@ -1,195 +1,182 @@
 -- =============================================================================
 -- Demo seed data for Jant (demo.jant.me)
--- Exported from remote demo D1 database via: mise run demo-backup
+-- Exported from remote demo D1 database via: mise run demo-export
 -- Usage: mise run demo-reset
 -- =============================================================================
 
--- posts
-INSERT INTO posts VALUES(1,'article','featured','Welcome to Jant',NULL,'# Welcome to Jant Demo
-
-Jant is a modern microblog platform built for Cloudflare Workers. This demo site resets daily at 00:00 UTC.
-
-## Features
-
-- **Multiple post types**: Notes, articles, links, quotes, images, and pages
-- **Collections**: Organize posts into collections
-- **Full-text search**: Search across all your content
-- **Internationalization**: Built-in i18n support
-- **Fast**: Edge-deployed on Cloudflare Workers
-
-## Getting Started
-
-```bash
-pnpm create jant my-blog
-cd my-blog
-pnpm install
-pnpm dev
-```
-
-Visit the [dashboard](/dash) to create your own posts!','<h1>Welcome to Jant Demo</h1>
-<p>Jant is a modern microblog platform built for Cloudflare Workers. This demo site resets daily at 00:00 UTC.</p>
-<h2>Features</h2>
-<ul>
-<li><strong>Multiple post types</strong>: Notes, articles, links, quotes, images, and pages</li>
-<li><strong>Collections</strong>: Organize posts into collections</li>
-<li><strong>Full-text search</strong>: Search across all your content</li>
-<li><strong>Internationalization</strong>: Built-in i18n support</li>
-<li><strong>Fast</strong>: Edge-deployed on Cloudflare Workers</li>
-</ul>
-<h2>Getting Started</h2>
-<pre><code class="language-bash">pnpm create jant my-blog
-cd my-blog
-pnpm install
-pnpm dev
-</code></pre>
-<p>Visit the <a href="/dash">dashboard</a> to create your own posts!</p>',NULL,NULL,NULL,NULL,NULL,NULL,1770689095,1770689095,1770689095);
-INSERT INTO posts VALUES(2,'note','quiet',NULL,NULL,'This is a demo note. Notes are short posts without titles, perfect for quick thoughts and updates.','<p>This is a demo note. Notes are short posts without titles, perfect for quick thoughts and updates.</p>',NULL,NULL,NULL,NULL,NULL,NULL,1770685495,1770685495,1770685495);
-INSERT INTO posts VALUES(3,'link','quiet','Jant on GitHub',NULL,'Check out the source code and documentation for Jant.','<p>Check out the source code and documentation for Jant.</p>','https://github.com/jant-me/jant','GitHub','github.com',NULL,NULL,NULL,1770681895,1770681895,1770681895);
-INSERT INTO posts VALUES(4,'quote','quiet',NULL,NULL,'The best way to predict the future is to invent it.','<p>The best way to predict the future is to invent it.</p>',NULL,'Alan Kay',NULL,NULL,NULL,NULL,1770678295,1770678295,1770678295);
-INSERT INTO posts VALUES(5,'image','quiet',NULL,NULL,'Image 1','<p>Image 1</p>
-',NULL,NULL,NULL,NULL,NULL,NULL,1770758516,1770758516,1770758516);
-INSERT INTO posts VALUES(6,'image','quiet',NULL,NULL,'Image 2','<p>Image 2</p>
-',NULL,NULL,NULL,NULL,NULL,NULL,1770758537,1770758537,1770759299);
-INSERT INTO posts VALUES(7,'page','unlisted','About','about','> **Work in Progress**: This project is still under active development and not yet ready for use. See the latest build at [demo.jant.me](https://demo.jant.me).
->
-> Demo login: `demo@jant.me` / `demodemo` — Dashboard: [demo.jant.me/dash](https://demo.jant.me/dash)
-
-A personal microblogging system as smooth as <https://threads.com>.
-
-> **Jant** = Jantelagen (Law of Jante)
-> Low-key, de-socialized personal expression.
-
-## What is Jant?
-
-Jant is a single-author microblog for people who want to share thoughts without the noise of social media. No followers, no likes, no retweets—just your words.
-
-**Features**:
-
-- Multiple content types: notes, articles, links, quotes, images
-- Thread support for longer thoughts
-- Collections for curated topics
-- Beautiful, themeable design
-- Deploys to Cloudflare Workers in minutes
-
-## Quick Start
+-- Reset (clear existing content)
+DELETE FROM posts_fts;
 
-```bash
-# Create a new Jant site
-pnpm create jant my-blog
+DELETE FROM post_collections;
 
-# Start development
-cd my-blog
-pnpm dev
+DELETE FROM media;
+DELETE FROM posts;
+DELETE FROM collections;
+DELETE FROM redirects;
 
-# Deploy to Cloudflare
-pnpm run deploy
-```
 
-## Documentation
+DELETE FROM sqlite_sequence WHERE name IN ('posts', 'media', 'collections', 'redirects');
 
-- [Getting Started](docs/getting-started.md)
-- [Deployment](docs/deployment.md)
-- [Configuration](docs/configuration.md)
-- [Theming](docs/theming.md)
-- [API Reference](docs/API.md)
-
-## Development
-
-Requires [mise](https://mise.jdx.dev/) — it manages Node.js and pnpm automatically.
-
-```bash
-# Install mise (macOS/Linux)
-curl https://mise.run | sh
-
-# Clone and setup
-git clone https://github.com/jant-me/jant.git
-cd jant
-mise install   # installs Node.js and pnpm
-pnpm install   # installs dependencies
-
-# Start development server (http://localhost:9019)
-mise run dev
-```
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for code style, PR process, and release workflow.
-
-## Philosophy
-
-Jant is built on the idea that not everything needs to be optimized for engagement. Write for yourself. Share if you want. No metrics, no pressure.
-
-## License
-
-AGPL-3.0
-','<blockquote>
-<p><strong>Work in Progress</strong>: This project is still under active development and not yet ready for use. See the latest build at <a href="https://demo.jant.me">demo.jant.me</a>.</p>
-<p>Demo login: <code>demo@jant.me</code> / <code>demodemo</code> — Dashboard: <a href="https://demo.jant.me/dash">demo.jant.me/dash</a></p>
-</blockquote>
-<p>A personal microblogging system as smooth as <a href="https://threads.com">https://threads.com</a>.</p>
+-- posts
+INSERT INTO posts VALUES(4,'note','quiet',NULL,NULL,'没有人真的想交付自己都看不上的东西。我们天然就想把事情做得更对一点、更好一点。','<p>没有人真的想交付自己都看不上的东西。我们天然就想把事情做得更对一点、更好一点。</p>
+',NULL,NULL,NULL,NULL,NULL,NULL,1771114861,1771114861,1771114861);
+INSERT INTO posts VALUES(5,'note','quiet',NULL,NULL,'新荣记的老板会给出预算，让店长和主厨每两周可以自己订一家餐厅去体验，而且预算没有上限。从到东京筹备开店至今，他们已经吃了日本十几家不同的餐厅。很多餐厅的服务员从没吃过自家餐厅的招牌菜，而新荣记不但安排自己的厨师和服务人员吃自己家的菜，还会提供费用，让这些年轻人去他们向往的餐厅，体验别人家的优点。"。我想，对我们网上冲浪的启发就是我们也要多体验别人做的好东西，从中提高审美和获得灵感。','<p>新荣记的老板会给出预算，让店长和主厨每两周可以自己订一家餐厅去体验，而且预算没有上限。从到东京筹备开店至今，他们已经吃了日本十几家不同的餐厅。很多餐厅的服务员从没吃过自家餐厅的招牌菜，而新荣记不但安排自己的厨师和服务人员吃自己家的菜，还会提供费用，让这些年轻人去他们向往的餐厅，体验别人家的优点。&quot;。我想，对我们网上冲浪的启发就是我们也要多体验别人做的好东西，从中提高审美和获得灵感。</p>
+',NULL,NULL,NULL,NULL,NULL,NULL,1771114906,1771114906,1771114906);
+INSERT INTO posts VALUES(6,'link','quiet','Forty News',NULL,'40年前今日的新闻...','<p>40年前今日的新闻...</p>
+','https://forty.news/',NULL,'forty.news',NULL,NULL,NULL,1771114955,1771114955,1771114955);
+INSERT INTO posts VALUES(7,'article','quiet','我从 Hacker News 中学到了什么？',NULL,'昨天看到 Hacker News 的创始人 Paul Graham 在 2009
+年写的一篇文章[《我从 Hacker News 中学到了什么》](http://www.paulgraham.com/hackernews.html),
+作者提到：
+
+> 随着 Hacker News 变得越来越大，占用的时间比我预期的要多，但我并不后悔，因为我从工作中学到了很多东西。
+
+就挺感慨的，一方面是我亲自做了一遍 HN 的中文翻译，在整个过程中学到了很多，另一方面也让我回想起大学期间做的一个社区，对我的之后的种种影响。
+
+如果有机会的话，我觉得每个人都应该尽可能的去亲自参与创造某个能有其他人一起创造信息的社区，比如成立一个小组，一个论坛，一个社群等等，线下的可能更好。和人交流，能碰撞出我更多的想法，以及让我知道更大的世界，更多元的价值观。
+
+[hacker news 的中文翻译](https://hn.buzzing.cc)是一个非常普通的想法，每年可能都有人声称自己做了一个 HN 的中文版。因为
+HN 上不仅文章质量普遍优质，而且最重要的是： HN 的 API 是业界最友好的，所有人都可以用来练手，做一个 HN 的 XX
+版，比如各种平台的客户端，各种语言的实现，rss 服务，email 订阅，评论通知，大数据分析，newsletter
+等等，不胜枚举。由于我的英文水平并不能像母语一样让我能快速找到感兴趣的东西（后来发现其实不少看起来英文很好的人，也有类似的体验），所以如果我想阅读 HN
+的话，我可能有 2 个选择：
+
+1. 抱着锻炼自己英语的想法逼迫自己不太流利的浏览 HN
+2. 使用浏览器自带的翻译功能，浏览 HN
+
+这两个阶段我都经历过。我希望你不要经历，因为每个阶段都可能使你错过 HN，错过一个很优质的信息源。
+
+第一个阶段，我只能坚持几天，然后就会本能的优先去看其他中文信息，慢慢的其实就没在看 HN 了。这在我的推特账号上尤其明显，我注册了 2
+个推特号，一个是英文号[@TheOwenYoung](https://twitter.com/TheOwenYoung),一个是中文号[@OwenYoungZh](https://twitter.com/OwenYoungZh)，本来是先开英文号的，专门关注的都是些英文博主，但是后面实在受不了了，说那就再开个中文号，尽量少关注人，只发一些东西。后来的故事就是，英文号上的很少，主力变成了中文号。唉，人就是离不开舒适圈，所以我们最好不要给自己创造舒适圈，比如在浏览器上设置很多社交网络的快捷书签；新
+tab 页放很多快捷入口；手机上下载很多好用的应用；如果想克制自己，就最好只下必要应用，优先用网页版，或者像我现在做的，把 iPhone13
+当成测试机，用一台好几年前的 Pixel 3a，又卡，掉电还快，但是用起来其实完全没问题，然后我又重新开始用
+Kindle，只能一个操作，就是下一页，这样就能节省很多时间来看书了。
+
+第二个阶段，我发现浏览器自带的翻译功能并不是太好用（去年我开始做 hn
+中文版的时候更不好用，现在其实好了很多），比如有一些网页它会失败，要么就是要重试，然后排版也不太好看，我更希望的是有些区域不要翻译，只翻译标题之类的，但是浏览器会全部翻译，就不太好浏览。而作为一个要长期阅读的地方，体验还是挺重要的。
+
+正好去年那会儿，刚做完[Actionsflow](https://github.com/actionsflow/actionsflow), 想利用
+Actionsflow 做点什么，所以说那就做一个 HN
+的中文翻译吧，这很适合工作流去处理，处理完之后生成一个静态网页，就算没人用，我自己也可以天天用，做好之后也不用维护，就一直在那。于是就开干，没想到做到后面发现还可以顺便做点别的我感兴趣的英文内容翻译，比如[Reddit 的美股讨论](https://reddit.buzzing.cc)，[国外的权威媒体报道](https://news.buzzing.cc)，[ProductHunt](https://ph.buzzing.cc)等等，最后就汇总成了一个[Buzzing](https://www.buzzing.cc)
+
+Buzzing
+运行了一年之后，发现之前的设计有不少欠考虑的地方，[Actionsflow](https://github.com/actionsflow/actionsflow)也有点太重了，尤其是看了一年
+HN 的帖子后，觉得 Actionsflow
+的设计简直就是一坨屎，又臭又长。这个时候[才发现 Deno 是最适合做工作流的运行时](https://twitter.com/OwenYoungZh/status/1478928692781137925)，Deno
+的依赖只需要
+URL，天生适合脚本。这样就可以和`package.json`,`package-lock.json`,`node_modules`地狱说拜拜了，而且我的工作流也不用再依赖
+Docker 和[act](https://github.com/nektos/act)了，于是过了 10 多天之后，我开始着手做了一个史上最快兑现的
+「如果我有时间，我一定要做 XXX
+」的项目：[Denoflow](https://twitter.com/OwenYoungZh/status/1485381401327267840),用来做我的低代码
+IFTTT 或者说 Zapier，用流行一点的话说，这是配置即代码服务(Configure as Code)。
+
+这一次，产生了一些变化，在泡了一年自己做的 HN 中文版之后：
+
+1. 首先我没有像 Actionsflow 一样设计一个浮夸的[Landing 页](https://actionsflow.github.io/).
+2. 其次我没有用自己蹩脚的英语凑成一个看起来功能很丰富，维护人员很多，很正规的[一个文档网站](https://actionsflow.github.io/docs/reference/)。我只在项目的[Readme 文件](https://github.com/denoflow/denoflow)里写了一个我自认为很诚恳的说明，在一页的文本里说清楚这个项目的用途，和看一个示例就能明白的使用方法，没有多余的营销话语，把时间真正花在工具本身，利用省下的时间做了一个[在线 PlayGround](https://playground.owenyoung.com/)，运行在我的廉价
+   VPS 上。
+3. 没考虑买一个域名，尽管`denoflow.com`域名还在。直接放在我的个人子域`playground.owenyoung.com`.
+4. 版本号的克制，对于刚推出的项目，我使用`0.0.x`，而不是像 Actionsflow
+   一样，一上来就是`1.0.0`。而后来的证明，`0.0.x`是最适合这个项目的，因为在后来的使用中，发现了不少的致命 bug
+5. 在文档的显眼处声明：`项目仍处于非常早期的阶段，谨慎使用!`
+6. 仔细思考了项目的 License,选择了 Apache2.0
+
+做完之后，又花了 2 个小时，用 Denoflow
+做了[Show HN](https://showhn.buzzing.cc/),[Ask HN](https://askhn.buzzing.cc/),[HN 首页](https://hackernews.buzzing.cc/),[Best HN](https://besthn.buzzing.cc)，这里可以和之前的[HN 热门](https://hn.buzzing.cc)对比下，没有追踪，没有
+JS
+代码，只是使用一个舒服的背景色，使用[class less 原则](https://github.com/dbohdan/classless-css)，同时生成一个
+RSS。没有使用任何框架，就几句简单的 deno
+代码即可生成。和之前的[HN 热门](https://hn.buzzing.cc)相比，[HN 热门](https://hn.buzzing.cc)在一个屏幕里只能显示出
+2 篇文章，而现在[HN 首页](https://hackernews.buzzing.cc/)可以放 20 多篇，效率直接提升 10 倍啊有木有。
+
+很快，我发现按照这样布局的话，阅读效率高了太多了，已有的这些时间流，已经不够我看了，所以索性单独为我自己生成一个[HN 时间流](https://myfeed.owenyoung.com/)，里面包含了
+hn 上前 100 位用户提交的任何帖子。
+
+几天之后我就发现，之前只看 HN 的热门帖子损失有多大，HN
+上有太多优秀的内容没有被顶上去了。热门真的很随机，所以我们也要万分警惕大公司的算法机制。基于此，我又做了一个变化，直接抓取 HN 上最新的提交（我去掉了 Ask
+HN 的内容，因为 Ask HN
+的质量相对较差，并且我还有专门的[Ask HN](https://ask.buzzing.cc)可以回头再看）。那么现在专属于我的[HN 时间流](https://myfeed.owenyoung.com/)就包括了
+HN 上所有最新的文章了。即使是全部文章，由于是母语阅读，我还是能快速读完这些标题，找到感兴趣的内容，还可能留下我的 2 cents.
+把之前关注了很久的不少优质英文 RSS
+源，也利于[Denoflow](https://github.com/denoflow/denoflow)生成了一个专属于我的[RSS 翻译流](https://myrss.owenyoung.com/).
+这样下来我的空余时间就可以住要花在阅读长文章，而不是刷推特这样更短的文章。我们都知道推特其实无法代替长文章，就像长文章也无法代替读书一样。
+
+如果有人看到这里的话，那你一定会觉得 HN 有毒，而我已经上瘾了。其实没错，目前阶段是这样。
+
+好在 HN 上的人也经常推荐图书，比如以下两个链接就是 HN 的用户制作的 HN 评论大数据最推荐的书（HN 的评论比图书网站，或者第三方网站更可信）：
+
+- [汇总了 hacker news 上评论里提到的书籍的排名](https://hacker-recommended-books.vercel.app/)
+- [又一个 hacker news 提到的图书周报](https://hackernewsbooks.com/top-books-on-hacker-news)
+
+比如我读了上面推荐的[《深度工作》](https://d.buzzing.cc/post/1)，作者提到：
+
+> “如果在你全部的清醒时间，都能给自己的大脑找到有意义的事情去做，而不是放任自己在迷糊的状态下漫无目的地浏览几个小时网页，那么在一天结束时，你会觉得更加充实，第二天开始时更加轻松。
+> – 卡尔·纽波特《深度工作》
+
+从我沉迷 HN
+的例子里就能看出，网络已经剥夺了我保持专注和沉思的能力，但是真正值得探索和学习的知识都需要我拥有这种能力。如果我没有在某一个特定时段给自己安排任务，那么这些网站总是会更有诱惑力。所以如果我想抵御社交网络对我时间和精力的诱惑，那么必须要给大脑找一些高质量的替代活动，所以我基于开源
+[Lemmy](https://lemmy.ml/) 搭建了一个类似 Reddit
+的社区，叫[**如何度过每一天**](https://d.buzzing.cc/),希望能在社区里分享有意义的事，不虚度光阴的事，可以是阅读某本书，学习某项技能，看某部纪录片等等等等。社区有投票的功能，某项活动被投票的次数越多，说明认为这项活动有意义的更多。
+
+目前其实就只有少数几个用户在用，网站依然是部署在我的一个 廉价 VPS 上，没有盈利的打算，目前加载也有点慢，但是够用。
+
+以上是我在 Hacker News 上学到的一些东西。
+','<p>昨天看到 Hacker News 的创始人 Paul Graham 在 2009<br>年写的一篇文章<a href="http://www.paulgraham.com/hackernews.html">《我从 Hacker News 中学到了什么》</a>,<br>作者提到：</p>
 <blockquote>
-<p><strong>Jant</strong> = Jantelagen (Law of Jante)<br>Low-key, de-socialized personal expression.</p>
+<p>随着 Hacker News 变得越来越大，占用的时间比我预期的要多，但我并不后悔，因为我从工作中学到了很多东西。</p>
 </blockquote>
-<h2>What is Jant?</h2>
-<p>Jant is a single-author microblog for people who want to share thoughts without the noise of social media. No followers, no likes, no retweets—just your words.</p>
-<p><strong>Features</strong>:</p>
+<p>就挺感慨的，一方面是我亲自做了一遍 HN 的中文翻译，在整个过程中学到了很多，另一方面也让我回想起大学期间做的一个社区，对我的之后的种种影响。</p>
+<p>如果有机会的话，我觉得每个人都应该尽可能的去亲自参与创造某个能有其他人一起创造信息的社区，比如成立一个小组，一个论坛，一个社群等等，线下的可能更好。和人交流，能碰撞出我更多的想法，以及让我知道更大的世界，更多元的价值观。</p>
+<p><a href="https://hn.buzzing.cc">hacker news 的中文翻译</a>是一个非常普通的想法，每年可能都有人声称自己做了一个 HN 的中文版。因为<br>HN 上不仅文章质量普遍优质，而且最重要的是： HN 的 API 是业界最友好的，所有人都可以用来练手，做一个 HN 的 XX<br>版，比如各种平台的客户端，各种语言的实现，rss 服务，email 订阅，评论通知，大数据分析，newsletter<br>等等，不胜枚举。由于我的英文水平并不能像母语一样让我能快速找到感兴趣的东西（后来发现其实不少看起来英文很好的人，也有类似的体验），所以如果我想阅读 HN<br>的话，我可能有 2 个选择：</p>
+<ol>
+<li>抱着锻炼自己英语的想法逼迫自己不太流利的浏览 HN</li>
+<li>使用浏览器自带的翻译功能，浏览 HN</li>
+</ol>
+<p>这两个阶段我都经历过。我希望你不要经历，因为每个阶段都可能使你错过 HN，错过一个很优质的信息源。</p>
+<p>第一个阶段，我只能坚持几天，然后就会本能的优先去看其他中文信息，慢慢的其实就没在看 HN 了。这在我的推特账号上尤其明显，我注册了 2<br>个推特号，一个是英文号<a href="https://twitter.com/TheOwenYoung">@TheOwenYoung</a>,一个是中文号<a href="https://twitter.com/OwenYoungZh">@OwenYoungZh</a>，本来是先开英文号的，专门关注的都是些英文博主，但是后面实在受不了了，说那就再开个中文号，尽量少关注人，只发一些东西。后来的故事就是，英文号上的很少，主力变成了中文号。唉，人就是离不开舒适圈，所以我们最好不要给自己创造舒适圈，比如在浏览器上设置很多社交网络的快捷书签；新<br>tab 页放很多快捷入口；手机上下载很多好用的应用；如果想克制自己，就最好只下必要应用，优先用网页版，或者像我现在做的，把 iPhone13<br>当成测试机，用一台好几年前的 Pixel 3a，又卡，掉电还快，但是用起来其实完全没问题，然后我又重新开始用<br>Kindle，只能一个操作，就是下一页，这样就能节省很多时间来看书了。</p>
+<p>第二个阶段，我发现浏览器自带的翻译功能并不是太好用（去年我开始做 hn<br>中文版的时候更不好用，现在其实好了很多），比如有一些网页它会失败，要么就是要重试，然后排版也不太好看，我更希望的是有些区域不要翻译，只翻译标题之类的，但是浏览器会全部翻译，就不太好浏览。而作为一个要长期阅读的地方，体验还是挺重要的。</p>
+<p>正好去年那会儿，刚做完<a href="https://github.com/actionsflow/actionsflow">Actionsflow</a>, 想利用<br>Actionsflow 做点什么，所以说那就做一个 HN<br>的中文翻译吧，这很适合工作流去处理，处理完之后生成一个静态网页，就算没人用，我自己也可以天天用，做好之后也不用维护，就一直在那。于是就开干，没想到做到后面发现还可以顺便做点别的我感兴趣的英文内容翻译，比如<a href="https://reddit.buzzing.cc">Reddit 的美股讨论</a>，<a href="https://news.buzzing.cc">国外的权威媒体报道</a>，<a href="https://ph.buzzing.cc">ProductHunt</a>等等，最后就汇总成了一个<a href="https://www.buzzing.cc">Buzzing</a></p>
+<p>Buzzing<br>运行了一年之后，发现之前的设计有不少欠考虑的地方，<a href="https://github.com/actionsflow/actionsflow">Actionsflow</a>也有点太重了，尤其是看了一年<br>HN 的帖子后，觉得 Actionsflow<br>的设计简直就是一坨屎，又臭又长。这个时候<a href="https://twitter.com/OwenYoungZh/status/1478928692781137925">才发现 Deno 是最适合做工作流的运行时</a>，Deno<br>的依赖只需要<br>URL，天生适合脚本。这样就可以和<code>package.json</code>,<code>package-lock.json</code>,<code>node_modules</code>地狱说拜拜了，而且我的工作流也不用再依赖<br>Docker 和<a href="https://github.com/nektos/act">act</a>了，于是过了 10 多天之后，我开始着手做了一个史上最快兑现的<br>「如果我有时间，我一定要做 XXX<br>」的项目：<a href="https://twitter.com/OwenYoungZh/status/1485381401327267840">Denoflow</a>,用来做我的低代码<br>IFTTT 或者说 Zapier，用流行一点的话说，这是配置即代码服务(Configure as Code)。</p>
+<p>这一次，产生了一些变化，在泡了一年自己做的 HN 中文版之后：</p>
+<ol>
+<li>首先我没有像 Actionsflow 一样设计一个浮夸的<a href="https://actionsflow.github.io/">Landing 页</a>.</li>
+<li>其次我没有用自己蹩脚的英语凑成一个看起来功能很丰富，维护人员很多，很正规的<a href="https://actionsflow.github.io/docs/reference/">一个文档网站</a>。我只在项目的<a href="https://github.com/denoflow/denoflow">Readme 文件</a>里写了一个我自认为很诚恳的说明，在一页的文本里说清楚这个项目的用途，和看一个示例就能明白的使用方法，没有多余的营销话语，把时间真正花在工具本身，利用省下的时间做了一个<a href="https://playground.owenyoung.com/">在线 PlayGround</a>，运行在我的廉价<br>VPS 上。</li>
+<li>没考虑买一个域名，尽管<code>denoflow.com</code>域名还在。直接放在我的个人子域<code>playground.owenyoung.com</code>.</li>
+<li>版本号的克制，对于刚推出的项目，我使用<code>0.0.x</code>，而不是像 Actionsflow<br>一样，一上来就是<code>1.0.0</code>。而后来的证明，<code>0.0.x</code>是最适合这个项目的，因为在后来的使用中，发现了不少的致命 bug</li>
+<li>在文档的显眼处声明：<code>项目仍处于非常早期的阶段，谨慎使用!</code></li>
+<li>仔细思考了项目的 License,选择了 Apache2.0</li>
+</ol>
+<p>做完之后，又花了 2 个小时，用 Denoflow<br>做了<a href="https://showhn.buzzing.cc/">Show HN</a>,<a href="https://askhn.buzzing.cc/">Ask HN</a>,<a href="https://hackernews.buzzing.cc/">HN 首页</a>,<a href="https://besthn.buzzing.cc">Best HN</a>，这里可以和之前的<a href="https://hn.buzzing.cc">HN 热门</a>对比下，没有追踪，没有<br>JS<br>代码，只是使用一个舒服的背景色，使用<a href="https://github.com/dbohdan/classless-css">class less 原则</a>，同时生成一个<br>RSS。没有使用任何框架，就几句简单的 deno<br>代码即可生成。和之前的<a href="https://hn.buzzing.cc">HN 热门</a>相比，<a href="https://hn.buzzing.cc">HN 热门</a>在一个屏幕里只能显示出<br>2 篇文章，而现在<a href="https://hackernews.buzzing.cc/">HN 首页</a>可以放 20 多篇，效率直接提升 10 倍啊有木有。</p>
+<p>很快，我发现按照这样布局的话，阅读效率高了太多了，已有的这些时间流，已经不够我看了，所以索性单独为我自己生成一个<a href="https://myfeed.owenyoung.com/">HN 时间流</a>，里面包含了<br>hn 上前 100 位用户提交的任何帖子。</p>
+<p>几天之后我就发现，之前只看 HN 的热门帖子损失有多大，HN<br>上有太多优秀的内容没有被顶上去了。热门真的很随机，所以我们也要万分警惕大公司的算法机制。基于此，我又做了一个变化，直接抓取 HN 上最新的提交（我去掉了 Ask<br>HN 的内容，因为 Ask HN<br>的质量相对较差，并且我还有专门的<a href="https://ask.buzzing.cc">Ask HN</a>可以回头再看）。那么现在专属于我的<a href="https://myfeed.owenyoung.com/">HN 时间流</a>就包括了<br>HN 上所有最新的文章了。即使是全部文章，由于是母语阅读，我还是能快速读完这些标题，找到感兴趣的内容，还可能留下我的 2 cents.<br>把之前关注了很久的不少优质英文 RSS<br>源，也利于<a href="https://github.com/denoflow/denoflow">Denoflow</a>生成了一个专属于我的<a href="https://myrss.owenyoung.com/">RSS 翻译流</a>.<br>这样下来我的空余时间就可以住要花在阅读长文章，而不是刷推特这样更短的文章。我们都知道推特其实无法代替长文章，就像长文章也无法代替读书一样。</p>
+<p>如果有人看到这里的话，那你一定会觉得 HN 有毒，而我已经上瘾了。其实没错，目前阶段是这样。</p>
+<p>好在 HN 上的人也经常推荐图书，比如以下两个链接就是 HN 的用户制作的 HN 评论大数据最推荐的书（HN 的评论比图书网站，或者第三方网站更可信）：</p>
 <ul>
-<li>Multiple content types: notes, articles, links, quotes, images</li>
-<li>Thread support for longer thoughts</li>
-<li>Collections for curated topics</li>
-<li>Beautiful, themeable design</li>
-<li>Deploys to Cloudflare Workers in minutes</li>
+<li><a href="https://hacker-recommended-books.vercel.app/">汇总了 hacker news 上评论里提到的书籍的排名</a></li>
+<li><a href="https://hackernewsbooks.com/top-books-on-hacker-news">又一个 hacker news 提到的图书周报</a></li>
 </ul>
-<h2>Quick Start</h2>
-<pre><code class="language-bash"># Create a new Jant site
-pnpm create jant my-blog
-
-# Start development
-cd my-blog
-pnpm dev
-
-# Deploy to Cloudflare
-pnpm run deploy
-</code></pre>
-<h2>Documentation</h2>
-<ul>
-<li><a href="docs/getting-started.md">Getting Started</a></li>
-<li><a href="docs/deployment.md">Deployment</a></li>
-<li><a href="docs/configuration.md">Configuration</a></li>
-<li><a href="docs/theming.md">Theming</a></li>
-<li><a href="docs/API.md">API Reference</a></li>
-</ul>
-<h2>Development</h2>
-<p>Requires <a href="https://mise.jdx.dev/">mise</a> — it manages Node.js and pnpm automatically.</p>
-<pre><code class="language-bash"># Install mise (macOS/Linux)
-curl https://mise.run | sh
-
-# Clone and setup
-git clone https://github.com/jant-me/jant.git
-cd jant
-mise install   # installs Node.js and pnpm
-pnpm install   # installs dependencies
-
-# Start development server (http://localhost:9019)
-mise run dev
-</code></pre>
-<p>See <a href="CONTRIBUTING.md">CONTRIBUTING.md</a> for code style, PR process, and release workflow.</p>
-<h2>Philosophy</h2>
-<p>Jant is built on the idea that not everything needs to be optimized for engagement. Write for yourself. Share if you want. No metrics, no pressure.</p>
-<h2>License</h2>
-<p>AGPL-3.0</p>
-',NULL,NULL,NULL,NULL,NULL,NULL,1770759271,1770759271,1770759271);
-
--- collections
-INSERT INTO collections VALUES(1,'getting-started','Getting Started','Resources for getting started with Jant',1770689095,1770689095);
-INSERT INTO collections VALUES(2,'inspires','Inspires',NULL,1770758555,1770758555);
-
--- post_collections
-INSERT INTO post_collections VALUES(1,1,1770689095);
-INSERT INTO post_collections VALUES(6,2,1770758568);
+<p>比如我读了上面推荐的<a href="https://d.buzzing.cc/post/1">《深度工作》</a>，作者提到：</p>
+<blockquote>
+<p>“如果在你全部的清醒时间，都能给自己的大脑找到有意义的事情去做，而不是放任自己在迷糊的状态下漫无目的地浏览几个小时网页，那么在一天结束时，你会觉得更加充实，第二天开始时更加轻松。<br>– 卡尔·纽波特《深度工作》</p>
+</blockquote>
+<p>从我沉迷 HN<br>的例子里就能看出，网络已经剥夺了我保持专注和沉思的能力，但是真正值得探索和学习的知识都需要我拥有这种能力。如果我没有在某一个特定时段给自己安排任务，那么这些网站总是会更有诱惑力。所以如果我想抵御社交网络对我时间和精力的诱惑，那么必须要给大脑找一些高质量的替代活动，所以我基于开源<br><a href="https://lemmy.ml/">Lemmy</a> 搭建了一个类似 Reddit<br>的社区，叫<a href="https://d.buzzing.cc/"><strong>如何度过每一天</strong></a>,希望能在社区里分享有意义的事，不虚度光阴的事，可以是阅读某本书，学习某项技能，看某部纪录片等等等等。社区有投票的功能，某项活动被投票的次数越多，说明认为这项活动有意义的更多。</p>
+<p>目前其实就只有少数几个用户在用，网站依然是部署在我的一个 廉价 VPS 上，没有盈利的打算，目前加载也有点慢，但是够用。</p>
+<p>以上是我在 Hacker News 上学到的一些东西。</p>
+',NULL,NULL,NULL,NULL,NULL,NULL,1771115051,1771115051,1771115051);
+INSERT INTO posts VALUES(8,'quote','quiet',NULL,NULL,'拥有五万个从不打开邮件的订阅者名单，其价值远不及五百个逐字阅读并偶尔给予深度回复的读者。后者会购买你的著作，向朋友推荐你，并长久陪伴你。前者不过是你在那些无聊的数字炫耀派对上能拿出来吹嘘的数字而已。','<p>拥有五万个从不打开邮件的订阅者名单，其价值远不及五百个逐字阅读并偶尔给予深度回复的读者。后者会购买你的著作，向朋友推荐你，并长久陪伴你。前者不过是你在那些无聊的数字炫耀派对上能拿出来吹嘘的数字而已。</p>
+','https://www.joanwestenberg.com/why-my-newsletter-costs-2-50/',NULL,'www.joanwestenberg.com',NULL,NULL,NULL,1771115103,1771115103,1771115103);
+INSERT INTO posts VALUES(9,'quote','featured',NULL,NULL,'弗吉尼亚·伍尔夫曾论述拥有独立空间的重要性：那是供人进行创作的物理场所，不受干扰与控制。博客便是网络世界中的独立空间。在这里，你自主决定书写内容与表达方式，无需屈从于平台算法的任性摆布——那些平台只顾榨取你的参与度，却不关心这种参与究竟是否让你或他人变得更聪明。
+
+我们不会通过等待平台减少剥削来获得更好的互联网。我们需要亲手构建它——维护自己的空间，相互链接，打造独立网站的互联网络，让博客圈重现昔日的辉煌。','<p>弗吉尼亚·伍尔夫曾论述拥有独立空间的重要性：那是供人进行创作的物理场所，不受干扰与控制。博客便是网络世界中的独立空间。在这里，你自主决定书写内容与表达方式，无需屈从于平台算法的任性摆布——那些平台只顾榨取你的参与度，却不关心这种参与究竟是否让你或他人变得更聪明。</p>
+<p>我们不会通过等待平台减少剥削来获得更好的互联网。我们需要亲手构建它——维护自己的空间，相互链接，打造独立网站的互联网络，让博客圈重现昔日的辉煌。</p>
+','https://www.joanwestenberg.com/the-case-for-blogging-in-the-ruins/','JA Westenberg','www.joanwestenberg.com',NULL,NULL,NULL,1771115159,1771115159,1771115177);
+INSERT INTO posts VALUES(10,'link','quiet','Some pics',NULL,'一个干净的图片流网站
+','<p>一个干净的图片流网站</p>
+','https://some.pics/',NULL,'some.pics',NULL,NULL,NULL,1771115271,1771115271,1771115271);
+INSERT INTO posts VALUES(11,'image','quiet',NULL,NULL,'From upsplash','<p>From upsplash</p>
+',NULL,NULL,NULL,NULL,NULL,NULL,1771123457,1771123457,1771123457);
 
 -- media
-INSERT INTO media VALUES('019c496c-46bd-7954-bd6a-77b1b8f1d451',NULL,'019c496c-46bd-7954-bd6a-77b1b8f1d451.webp','tegan-conway-KaFfNTw8OYQ-unsplash.webp','image/webp',715364,'media/2026/02/019c496c-46bd-7954-bd6a-77b1b8f1d451.webp',NULL,NULL,NULL,1770758358,0,NULL,'r2');
-INSERT INTO media VALUES('019c496c-5e44-70d2-ac8a-c0c0bdaab65c',6,'019c496c-5e44-70d2-ac8a-c0c0bdaab65c.webp','land-o-lakes-inc-9w6Qb-dqBwE-unsplash.webp','image/webp',306042,'media/2026/02/019c496c-5e44-70d2-ac8a-c0c0bdaab65c.webp',NULL,NULL,NULL,1770758364,3,NULL,'r2');
-INSERT INTO media VALUES('019c496d-5011-7981-89a0-b4373a695d78',6,'019c496d-5011-7981-89a0-b4373a695d78.webp','land-o-lakes-inc-k71TQkbVIgI-unsplash.webp','image/webp',597680,'media/2026/02/019c496d-5011-7981-89a0-b4373a695d78.webp',NULL,NULL,NULL,1770758426,2,NULL,'r2');
-INSERT INTO media VALUES('019c496d-630c-70b4-9004-51a194746566',6,'019c496d-630c-70b4-9004-51a194746566.webp','thingsneverchange-CgHNmQ0c2w4-unsplash.webp','image/webp',358320,'media/2026/02/019c496d-630c-70b4-9004-51a194746566.webp',NULL,NULL,NULL,1770758431,1,NULL,'r2');
-INSERT INTO media VALUES('019c496d-720f-70d2-98b8-3779457de73c',6,'019c496d-720f-70d2-98b8-3779457de73c.webp','willian-justen-de-vasconcellos-7jg7Y_Mlf2Q-unsplash.webp','image/webp',478956,'media/2026/02/019c496d-720f-70d2-98b8-3779457de73c.webp',NULL,NULL,NULL,1770758435,0,NULL,'r2');
-INSERT INTO media VALUES('019c496e-6904-7f61-b14f-080035ffe23f',5,'019c496e-6904-7f61-b14f-080035ffe23f.webp','richard-stachmann-Es--yoQocSM-unsplash.webp','image/webp',381534,'media/2026/02/019c496e-6904-7f61-b14f-080035ffe23f.webp',NULL,NULL,NULL,1770758498,0,NULL,'r2');
+INSERT INTO media VALUES('019c5f2e-6d5f-74f3-a521-d4fbac0b4ac3',NULL,'019c5f2e-6d5f-74f3-a521-d4fbac0b4ac3.webp','brianna-parks-frXRtKYPqXk-unsplash.webp','image/webp',264554,'media/2026/02/019c5f2e-6d5f-74f3-a521-d4fbac0b4ac3.webp',NULL,NULL,NULL,1771123404,0,NULL,'r2');
+INSERT INTO media VALUES('019c5f2e-7dea-729c-a260-6c006faf3384',11,'019c5f2e-7dea-729c-a260-6c006faf3384.webp','land-o-lakes-inc-peEOQ4_dqOo-unsplash.webp','image/webp',470774,'media/2026/02/019c5f2e-7dea-729c-a260-6c006faf3384.webp',NULL,NULL,NULL,1771123408,1,NULL,'r2');
+INSERT INTO media VALUES('019c5f2e-8a17-77dc-a91c-2d51f14a622c',NULL,'019c5f2e-8a17-77dc-a91c-2d51f14a622c.webp','museum-of-new-zealand-te-papa-tongarewa-1C7oRRwUkgU-unsplash.webp','image/webp',322656,'media/2026/02/019c5f2e-8a17-77dc-a91c-2d51f14a622c.webp',NULL,NULL,NULL,1771123411,0,NULL,'r2');
+INSERT INTO media VALUES('019c5f2e-96d2-7e56-801a-6073bd6183f6',11,'019c5f2e-96d2-7e56-801a-6073bd6183f6.webp','takashi-sakamoto-J9nW9Tc1HVc-unsplash.webp','image/webp',505172,'media/2026/02/019c5f2e-96d2-7e56-801a-6073bd6183f6.webp',NULL,NULL,NULL,1771123415,0,NULL,'r2');