esbonio を Homebrew でインストール

プロジェクトリンク

• ホームページ

コマンドとエイリアス

• esbonio

プロジェクトの歴史

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