add hugo docs into this repo

Author: Vonng

.gitignore

@@ -11,4 +11,6 @@ tmp/
 dist/
 pig
 .DS_Store
-CLAUDE.md
+CLAUDE.md
+.hugo_build.lock
+public/

Makefile

@@ -55,17 +55,9 @@ c: clean
 clean:
 	rm -rf pig
 d:
-	bin/dist
-dd:
-	bin/dist2
-t: tb tt
-tb:
-	CGO_ENABLED=0 GOOS=linux  GOARCH=arm64 go build -a -ldflags '-extldflags "-static"' -o pig
-	scp pig meta:/tmp/pig
-tt:
-	ssh sv "/tmp/pig status"
-
-
+	hugo serve
+b:
+	hugo --minify
 
 
 .PHONY: run build clean build-linux-amd64 build-linux-arm64 release release-linux linux-amd64 linux-arm64

docs/_index.md

@@ -0,0 +1,61 @@
+---
+title: PIG CLI
+description: The Missing Package Manager for PostgreSQL Extensions
+icon: PiggyBank
+full: true
+cascade:
+  type: docs
+breadcrumbs: false
+comments: false
+---
+
+
+—— ***Postgres Install Genius, the missing extension package manager for PostgreSQL ecosystem***
+
+{{< cards >}}
+{{< card link="/intro"   title="Introduction" subtitle="Why we need a package manager" icon="sparkles" >}}
+{{< card link="/start"   title="Get Started"  subtitle="Tutorial and examples"         icon="play" >}}
+{{< card link="/install" title="Installation" subtitle="Install in different ways" icon="save" >}}
+{{< /cards >}}
+
+
+
+## Quick Start
+
+[Install](/install) `pig` with a single command
+
+```bash tab="Global"
+curl -fsSL https://repo.pigsty.io/pig | bash
+```
+
+
+Then it’s ready to use, assume you want to install the [**`pg_duckdb`**](/e/pg_duckdb/) extension:
+
+```bash
+$ pig repo add pigsty pgdg -u  # add pgdg & pigsty repo, then update repo cache
+$ pig ext install pg17         # install PostgreSQL 17 kernels with native PGDG packages
+$ pig ext install pg_duckdb    # install the pg_duckdb extension (for current pg17)
+```
+
+
+## CLI Usage
+
+Check sub-commands [documentation](/cmd) with `pig help <command>`
+
+{{< cards cols="5"  >}}
+{{< card link="/cmd/repo"  title="pig repo"  subtitle="Manage software repositories" icon="library" >}}
+{{< card link="/cmd/ext"   title="pig ext"   subtitle="Manage postgres extensions"   icon="cube" >}}
+{{< card link="/cmd/build" title="pig build" subtitle="Build extension from source"  icon="view-grid" >}}
+{{< card link="/cmd/sty"   title="pig sty"   subtitle="Manage pigsty installation"   icon="cloud-download" >}}
+{{< /cards >}}
+
+
+
+## Source
+
+The `pig` CLI is developed by [Vonng](https://blog.vonng.com/en/), and open-sourced under the [Apache License 2.0](https://github.com/pgsty/pig/?tab=Apache-2.0-1-ov-file#readme).
+
+You can also check the [pigsty](https://pgsty.com) project, which makes it even smoother to deliver all these [extensions](/usage) in an IaC way:
+
+- https://github.com/pgsty/pigsty
+- https://github.com/pgsty/pig

docs/_index.zh.md

@@ -0,0 +1,86 @@
+---
+title: PIG CLI
+description: PostgreSQL 与扩展生态包管理器
+icon: PiggyBank
+full: true
+cascade:
+  type: docs
+breadcrumbs: false
+comments: false
+---
+
+—— **Postgres Install Genius，PostgreSQL 生态中缺失的扩展包管理器**
+
+{{< cards >}}
+{{< card link="/intro"   title="Introduction" subtitle="为什么我们需要一个PG专用包管理器？" icon="sparkles" >}}
+{{< card link="/start"   title="Get Started"  subtitle="快速上手与样例"  icon="play" >}}
+{{< card link="/install" title="Installation" subtitle="下载、安装、更新 pig" icon="save" >}}
+{{< /cards >}}
+
+## 快速上手
+
+使用以下命令即可[快速上手](/zh/pig/start) PIG 包管理器：
+
+```bash tab="default"
+curl -fsSL https://repo.pigsty.io/pig | bash
+```
+```bash tab="mirror"
+curl -fsSL https://repo.pigsty.cc/pig | bash
+```
+
+安装完成后，即可使用。例如，若需安装 [**`pg_duckdb`**](/zh/e/pg_duckdb/) 扩展：
+
+```bash
+$ pig repo add pigsty pgdg -u  # 添加 pgdg 与 pigsty 源，并更新仓库缓存
+$ pig ext install pg17         # 安装 PostgreSQL 17 内核（原生 PGDG 包）
+$ pig ext install pg_duckdb    # 安装 pg_duckdb 扩展（针对当前 pg17）
+```
+
+--------
+
+<Cards>
+    <Card icon={<Zap className="text-green-500"/>} title='快速上手' href={"/zh/pig/start"}>
+        PIG CLI 快速上手
+    </Card>
+    <Card icon={<Download className="text-blue-600"/>} title='安装' href={"/zh/pig/install"}>
+        安装 PostgreSQL 扩展
+    </Card>
+    <Card icon={<HelpCircle className="text-purple-600"/>} title='特性' href={"/zh/pig/why"}>
+        为什么需要 PostgreSQL 包管理器？
+    </Card>
+    <Card icon={<Rocket className="text-orange-500"/>} title='发布说明' href={"/zh/pig/release"}>
+        PIG 命令行工具发布说明
+    </Card>
+</Cards>
+
+--------
+
+## 命令
+
+你可以执行 `pig help <command>` 获取子命令的详细帮助。
+
+<Cards>
+    <Card icon={<Terminal className="text-slate-600"/>} title='pig' href={"/zh/pig/pig"}>
+        主命令行接口
+    </Card>
+    <Card icon={<Package className="text-indigo-600"/>} title='pig repo' href={"/zh/pig/repo"}>
+        管理 Linux 发行版的软件仓库
+    </Card>
+    <Card icon={<Puzzle className="text-emerald-600"/>} title='pig ext' href={"/zh/pig/ext"}>
+        安装、移除、搜索、扫描 PostgreSQL 扩展
+    </Card>
+    <Card icon={<Hammer className="text-amber-600"/>} title='pig build' href={"/zh/pig/build"}>
+        配置扩展构建环境并编译扩展
+    </Card>
+</Cards>
+
+--------
+
+## 源代码
+
+`pig` 命令行工具由 [Vonng](https://vonng.com/en/)（冯若航 [email protected]）开发，并以 [Apache 2.0](https://github.com/pgsty/pig/?tab=Apache-2.0-1-ov-file#readme) 许可证开源。
+
+更多信息请参见 [pigsty](https://pgsty.com) 项目，可一键高效交付所有扩展：
+
+- https://github.com/pgsty/pig
+- https://github.com/pgsty/pigsty

docs/cmd/_index.md

@@ -0,0 +1,112 @@
+---
+title: "CLI Usage"
+description: Overview of the pig cli tool
+icon: SquareTerminal
+weight: 600
+---
+
+## Overview
+
+```bash
+pig - the Linux Package Manager for PostgreSQL and CLI tool for Pigsty
+
+Usage:
+  pig [command]
+
+Examples:
+
+  # get started: check https://github.com/pgsty/pig for details
+  pig repo add -ru        # overwrite existing repo & update cache
+  pig ext  add pg17       # install optional postgresql 17 package
+  pig ext  add pg_duckdb  # install certain postgresql extension
+
+  pig repo : add rm update list info status create boot cache
+  pig ext  : add rm update list info status import link build
+  pig sty  : init boot conf install get list
+
+
+PostgreSQL Extension Manager
+  ext         Manage PostgreSQL Extensions (pgext)
+  repo        Manage Linux Software Repo (apt/dnf)
+
+Pigsty Management Commands
+  sty         Manage Pigsty Installation
+
+Additional Commands:
+  build       Build Postgres Extension
+  completion  Generate the autocompletion script for the specified shell
+  help        Help about any command
+  status      Show Environment Status
+  update      Upgrade pig itself
+  version     Show pig version info
+
+Flags:
+      --debug              enable debug mode
+  -h, --help               help for pig
+  -i, --inventory string   config inventory path
+      --log-level string   log level: debug, info, warn, error, fatal, panic (default "info")
+      --log-path string    log file path, terminal by default
+  -t, --toggle             Help message for toggle
+
+Use "pig [command] --help" for more information about a command.
+```
+
+------
+
+## Examples
+
+### Environment Status
+
+```bash
+pig status                    # show os & pg & pig status
+pig repo status               # show upstream repo status
+pig ext  status               # show pg extensions status 
+```
+
+### Extension Management
+
+Check [`pig ext`](/cmd/ext/) for details.
+
+```bash
+pig ext list    [query]       # list & search extension      
+pig ext info    [ext...]      # get information of a specific extension
+pig ext status  [-v]          # show installed extension and pg status
+pig ext add     [ext...]      # install extension for current pg version
+pig ext rm      [ext...]      # remove extension for current pg version
+pig ext update  [ext...]      # update extension to the latest version
+pig ext import  [ext...]      # download extension to local repo
+pig ext link    [ext...]      # link postgres installation to path
+pig ext upgrade               # fetch the latest extension catalog
+```
+
+### Repo Management
+
+Check [`pig repo`](/cmd/repo/) for details.
+
+```bash
+pig repo list                    # available repo list
+pig repo info   [repo|module...] # show repo info
+pig repo status                  # show current repo status
+pig repo add    [repo|module...] # add repo and modules
+pig repo rm     [repo|module...] # remove repo & modules
+pig repo update                  # update repo pkg cache
+pig repo create                  # create repo on current system
+pig repo boot                    # boot repo from offline package
+pig repo cache                   # cache repo as offline package
+```
+
+### Pigsty Management
+
+Check [`pig sty`](/cmd/sty/) for details.
+
+The pig can also be used as a cli tool for Pigsty — the battery-include free PostgreSQL RDS.
+Which brings HA, PITR, Monitoring, IaC, and all the extensions to your PostgreSQL cluster.
+
+```bash
+pig sty init     # install pigsty to ~/pigsty 
+pig sty boot     # install ansible and other pre-deps 
+pig sty conf     # auto-generate pigsty.yml config file
+pig sty install  # run the install.yml playbook
+```
+
+You can use the `pig sty` subcommand to bootstrap pigsty on current node.