share-pages 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# share-pages
+
+Share Pages 的命令行客户端，用于发布和管理 HTML、目录、Markdown、LaTeX、EPUB 与 CSV 内容。
+
+## 安装
+
+需要 Node.js 22 或更高版本。
+
+```sh
+npm install --global share-pages
+```
+
+## 登录
+
+在 Share Pages 后台创建发布 Token，然后保存实例配置：
+
+```sh
+share-pages login --server https://pages.example.com
+```
+
+自动化环境可通过 stdin 提供 Token：
+
+```sh
+printf '%s' "$SHARE_PAGES_TOKEN" | share-pages login \
+  --server "$SHARE_PAGES_SERVER" \
+  --token-stdin \
+  --no-interactive
+```
+
+## 发布
+
+```sh
+share-pages publish ./site --id docs
+share-pages publish ./README.md --id readme --access public
+share-pages publish ./report.csv --id report --title "Report"
+```
+
+发布前只做本地转换和校验：
+
+```sh
+share-pages publish ./site --dry-run --json
+```
+
+查看全部命令：
+
+```sh
+share-pages --help
+share-pages publish --help
+```