fix: docs spelling and workflow check (#336)

This commit is contained in:
ykiko
2026-01-01 00:48:14 +08:00
committed by GitHub
parent 4d16cf7b0a
commit dee5e136b7
5 changed files with 16 additions and 15 deletions

View File

@@ -1,12 +1,12 @@
# Build from Source
clice depends on C++23 features and requires a modern C++ toolchain. We also need to link against LLVM/Clang to parse ASTs. To speed up builds, the default configuration downloads our published [clice-llvm](https://github.com/clice-io/clice-llvm) prebuilt package. This assumes your local environment matches the prebuild environment closely (especially when enabling Address Sanitizer or LTO).
clice depends on C++23 features and requires a modern C++ toolchain. We also need to link against LLVM/Clang to parse ASTs. To speed up builds, the default configuration downloads our published [clice-llvm](https://github.com/clice-io/clice-llvm) prebuilt package. This assumes your local environment matches the prebuilt environment closely (especially when enabling Address Sanitizer or LTO).
To simplify setup and keep builds reproducible, we **strongly recommend** [pixi](https://pixi.prefix.dev/latest) to manage the development environment. Dependency versions are pinned in `pixi.toml`.
If you prefer not to use pixi, see [Manual Build](#manual-build) below.
## 🚀 Quick Start
## Quick Start
Install pixi following the [official guide](https://pixi.prefix.dev/latest/installation).
@@ -44,7 +44,7 @@ pixi run xmake
pixi run xmake-test
```
## 🛠️ Manual Build
## Manual Build
If you plan to build manually, first ensure your toolchain matches the versions defined in `pixi.toml`.
@@ -87,9 +87,9 @@ Optional build options:
| --enable_test | false | Build clice unit tests |
| --ci | false | Enable `CLICE_CI_ENVIRONMENT` |
## 📦 About LLVM
## About LLVM
clice calls Clang APIs to parse C++ code, so it must link LLVM/Clang. Because clice uses Clang private headers (usually absent from distro packages), the system LLVM package cannot be used directly.
clice calls Clang APIs to parse C++ code, so it must link against LLVM/Clang. Because clice uses Clang's private headers (usually absent from distro packages), the system LLVM package cannot be used directly.
Two ways to satisfy this dependency:

View File

@@ -2,7 +2,7 @@
This section covers development and release workflows for the editor extensions (VSCode / Neovim / Zed).
## 🌐 VSCode
## VSCode
The VSCode extension uses the Node/PNPM/VSCE toolchain. Work inside the pixi `node` environment for consistent versions.
@@ -46,7 +46,7 @@ pnpm install
pnpm run package
```
## 🧩 Neovim
## Neovim
The Neovim extension lives in `editors/nvim` and is written in Lua. It is still evolving.
@@ -56,7 +56,7 @@ The Neovim extension lives in `editors/nvim` and is written in Lua. It is still
Dev tips: the codebase is small—load it directly in Neovim and watch `:messages`/LSP logs; format with `stylua` (config included).
## 🪶 Zed
## Zed
The Zed extension lives in `editors/zed` and uses Rust plus `zed_extension_api`.