# 使用 Homebrew 安装 esbonio

查看 esbonio 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:esbonio
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install esbonio
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:esbonio
- **软件包管理器:** Homebrew
- **版本:** 2.1.0
- **来源摘要:** Language server for working with Sphinx projects
- **主页:** <https://github.com/swyddfa/esbonio>
- **最后更新:** 2026-07-07T10:01:21Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- esbonio (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 2.1.0
## 项目历史与用法

Esbonio is a language server for Sphinx documentation projects. It provides editor features such as references, completions, diagnostics, previews, and extension points for documentation tooling.

### 项目历史

The project is hosted in the official swyddfa/esbonio repository and is organized around a Python language server, a VS Code extension, and Sphinx extensions. Its documentation describes Esbonio as tooling that reduces friction when writing Sphinx content.

The 1.0 release in October 2025 changed the server architecture by moving Sphinx builds into background processes, adding support for multi-root and multiple Sphinx projects in a workspace, and expanding configuration sources beyond initialization options.

The 2.x releases in 2026 continued the migration with Sphinx 9 support, command changes, logging changes, and a dedicated `esbonio sphinx build` command.

### 采用历史

Esbonio is packaged as a Homebrew formula and as editor-facing tooling, especially through its VS Code extension and documented integrations for editors such as Emacs and Neovim.

Its adoption follows Sphinx users who want language-server behavior while editing reStructuredText or MyST documentation, rather than treating documentation as plain text plus an external build step.

### 使用方式

Typical use is to install or launch the Esbonio language server from an editor integration and let it run Sphinx builds in the background for completion, diagnostics, references, and live preview.

Project-specific configuration is documented through `pyproject.toml` under `[tool.esbonio.sphinx]`, with settings such as build arguments, configuration overrides, Python command, environment, and working directory.

### 为什么软件包爱好者会关心

Esbonio is notable to package-manager users because it turns a documentation build system into editor infrastructure: a Homebrew-installed CLI/server can support Sphinx projects across editor clients.

It sits at the intersection of Python packaging, Sphinx documentation workflows, Language Server Protocol clients, and editor extensions.

### 时间线

- 2025-10-28: Esbonio Language Server v1.0.0 released with background Sphinx process architecture and expanded configuration.
- 2026-02-19: v1.1.0 introduced `esbonio.sphinx.buildArguments` and documented project discovery.
- 2026-04-11: v2.0.0 dropped Sphinx 6 support, changed command behavior, and added Sphinx 9 support.
- 2026-06-28: v2.1.0 added `esbonio sphinx build`.

### Related projects

- Sphinx is the documentation system Esbonio targets.
- The Language Server Protocol defines the editor integration model.
- The official repository also includes a VS Code extension and Sphinx extension packages.

### 来源

- <https://docs.esbon.io/>
- <https://docs.esbon.io/en/release/about/changelog.html>
- <https://docs.esbon.io/en/release/usage/reference/configuration.html>
- <https://github.com/swyddfa/esbonio>
- <https://github.com/swyddfa/esbonio/discussions/1041>


## 安全说明

没有找到 esbonio 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: pyproject.toml

## Combined YAML source

View the package source record on GitHub. [combined/esbonio.yml](https://github.com/mxcl/pkgdb/blob/main/combined/esbonio.yml)


## 来源

- pkg.so package database
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
