docs(src/assets/): update pixi official documentation

Author: KemingHe

src/assets/pixi/_metadata.json

@@ -1,6 +1,6 @@
 {
   "source_repo": "prefix-dev/pixi",
   "docs_path": "docs",
-  "updated_at": "2025-12-09T22:06:22Z",
-  "commit_sha": "4fab35080f6422c4c278f9eb593f41cf9321bd92"
+  "updated_at": "2025-12-16T22:06:02Z",
+  "commit_sha": "5121397ef41fdee7aa62326f85029826d6263310"
 }

src/assets/pixi/index.md

@@ -2,51 +2,39 @@
 title: Home
 template: home.html
 ---
+# Pixi
 
-![pixi logo](assets/banner.svg)
+Pixi is a **fast, modern, and reproducible** package management tool for developers of all backgrounds.
 
-## Why Pixi?
+=== "Linux & macOS"
+    ```shell
+    curl -fsSL https://pixi.sh/install.sh | sh
+    ```
+=== "Windows"
+    ```powershell
+    powershell -ExecutionPolicy Bypass -c "irm -useb https://pixi.sh/install.ps1 | iex"
+    ```
+More installation options can be found [here](installation.md).
 
-Pixi is a **fast, modern, and reproducible** package management tool for developers of all backgrounds.
+## Highlights
 
-<div class="feature-grid">
-    <a href="workspace/lockfile">
-      <div class="feature-card">
-              <strong>🔄 Reproducibility</strong>
-              <p>Isolated, easily recreated environments with lockfiles built-in</p>
-      </div>
-    </a>
-    <a href="workspace/advanced_tasks/">
-      <div class="feature-card">
-          <strong>🛠️ Tasks</strong>
-          <p>Manage complex pipelines effortlessly.</p>
-      </div>
-    </a>
-    <a href="workspace/multi_platform_configuration/">
-      <div class="feature-card">
-          <strong>🌐 Multi Platform</strong>
-          <p>Works on Linux, macOS, Windows, and more.</p>
-      </div>
-    </a>
-    <a href="workspace/multi_environment/">
-      <div class="feature-card">
-          <strong>🧩 Multi Environment</strong>
-          <p>Compose multiple environments in one manifest.</p>
-      </div>
-    </a>
-    <a href="python/tutorial/">
-      <div class="feature-card">
-          <strong>🐍 Python</strong>
-          <p>Support for <code>pyproject.toml</code> and PyPI through uv.</p>
-      </div>
-    </a>
-    <a href="global_tools/introduction/">
-      <div class="feature-card">
-          <strong>🌍 Global Tools</strong>
-          <p>Install global tools, safely isolated. Replacing <code>apt</code>, <code>homebrew</code>, <code>winget</code></p>
-      </div>
-    </a>
-</div>
+- [🔄 **Reproducibility**](workspace/lockfile.md)  
+  Isolated, easily recreated environments with lockfiles built-in
+
+- [🛠️ **Tasks**](workspace/advanced_tasks.md)  
+  Manage complex pipelines effortlessly.
+
+- [🌐 **Multi Platform**](workspace/multi_platform_configuration.md)  
+  Works on Linux, macOS, Windows, and more.
+
+- [🧩 **Multi Environment**](workspace/multi_environment.md)  
+  Compose multiple environments in one manifest.
+
+- [🐍 **Python**](python/tutorial.md)  
+  Support for `pyproject.toml` and PyPI through uv.
+
+- [🌍 **Global Tools**](global_tools/introduction.md)  
+  Install global tools, safely isolated. Replacing `apt`, `homebrew`, `winget`.
 
 ---
 
@@ -75,7 +63,7 @@ pixi global install gh nvim ipython btop ripgrep
 
 ---
 
-## What is the difference with Pixi?
+## How Tools Compare to Pixi
 
 | Builtin Core Features       | Pixi | Conda | Pip | Poetry | uv |
 |-----------------------------|------|-------|-----|--------|----|

src/assets/pixi/reference/cli/pixi.md

@@ -1,5 +1,8 @@
+---
+title: pixi
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>pixi</code>
+# pixi
 
 --8<-- "docs/reference/cli/pixi_extender:description"
 
@@ -13,7 +16,7 @@ pixi [OPTIONS] [COMMAND]
 |---------|-------------|
 | [`add`](pixi/add.md) | Adds dependencies to the workspace |
 | [`auth`](pixi/auth.md) | Login to prefix.dev or anaconda.org servers to access private channels |
-| [`build`](pixi/build.md) | Lock file and installation configuration with --as-is support Used by shell, shell-hook, and run commands |
+| [`build`](pixi/build.md) | Build a conda package from a Pixi package. |
 | [`clean`](pixi/clean.md) | Cleanup the environments |
 | [`completion`](pixi/completion.md) | Generates a completion script for a shell |
 | [`config`](pixi/config.md) | Configuration management |

src/assets/pixi/reference/cli/pixi/add.md

@@ -1,7 +1,9 @@
+---
+title: pixi add
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>[pixi](../pixi.md) add</code>
+# [pixi](../pixi.md) add
 
-## About
 Adds dependencies to the workspace
 
 --8<-- "docs/reference/cli/pixi/add_extender:description"
@@ -75,7 +77,7 @@ pixi add [OPTIONS] <SPEC>...
 <br>**env**: `PIXI_LOCKED`
 
 ## Global Options
-- <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
+- <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
 ## Description

src/assets/pixi/reference/cli/pixi/auth.md

@@ -1,7 +1,9 @@
+---
+title: pixi auth
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>[pixi](../pixi.md) auth</code>
+# [pixi](../pixi.md) auth
 
-## About
 Login to prefix.dev or anaconda.org servers to access private channels
 
 --8<-- "docs/reference/cli/pixi/auth_extender:description"

src/assets/pixi/reference/cli/pixi/auth/login.md

@@ -1,7 +1,9 @@
+---
+title: pixi auth login
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>[pixi](../../pixi.md) [auth](../auth.md) login</code>
+# [pixi](../../pixi.md) [auth](../auth.md) login
 
-## About
 Store authentication information for a given host
 
 --8<-- "docs/reference/cli/pixi/auth/login_extender:description"

src/assets/pixi/reference/cli/pixi/auth/logout.md

@@ -1,7 +1,9 @@
+---
+title: pixi auth logout
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>[pixi](../../pixi.md) [auth](../auth.md) logout</code>
+# [pixi](../../pixi.md) [auth](../auth.md) logout
 
-## About
 Remove authentication information for a given host
 
 --8<-- "docs/reference/cli/pixi/auth/logout_extender:description"

src/assets/pixi/reference/cli/pixi/build.md

@@ -1,8 +1,10 @@
+---
+title: pixi build
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>[pixi](../pixi.md) build</code>
+# [pixi](../pixi.md) build
 
-## About
-Lock file and installation configuration with --as-is support Used by shell, shell-hook, and run commands
+Build a conda package from a Pixi package.
 
 --8<-- "docs/reference/cli/pixi/build_extender:description"
 

src/assets/pixi/reference/cli/pixi/clean.md

@@ -1,7 +1,9 @@
+---
+title: pixi clean
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>[pixi](../pixi.md) clean</code>
+# [pixi](../pixi.md) clean
 
-## About
 Cleanup the environments
 
 --8<-- "docs/reference/cli/pixi/clean_extender:description"
@@ -26,7 +28,7 @@ pixi clean [OPTIONS] [COMMAND]
 :  Only remove the pixi-build cache
 
 ## Global Options
-- <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
+- <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
 ## Description

src/assets/pixi/reference/cli/pixi/clean/cache.md

@@ -1,7 +1,9 @@
+---
+title: pixi clean cache
+---
 <!--- This file is autogenerated. Do not edit manually! -->
-# <code>[pixi](../../pixi.md) [clean](../clean.md) cache</code>
+# [pixi](../../pixi.md) [clean](../clean.md) cache
 
-## About
 Clean the cache of your system which are touched by pixi
 
 --8<-- "docs/reference/cli/pixi/clean/cache_extender:description"