Esbonio

Enhancements

- When clicking on internal links of a previewed page, the corresponding source file will be automatically opened in the editor ([704](https://github.com/swyddfa/esbonio/issues/704))
- The language server should now also work with an incomplete Python environment. If one or more Sphinx extensions are missing, esbonio will still be able to run a build and report the missing extensions as a diagnostic ([913](https://github.com/swyddfa/esbonio/issues/913))
- When asking for a `html_theme` that is not available in the current environment, the server will now fallback to Sphinx's `alabaster` theme and report the error as a diagnostic ([916](https://github.com/swyddfa/esbonio/issues/916))

Fixes

- The `esbonio.preview.showLineMarkers` option should now work again.

When clicking on internal links of a previewed page, the websocket connection to the language server is now preserved. ([906](https://github.com/swyddfa/esbonio/issues/906))
- Esbonio should once again be able to parse `sphinx-build` command line arguments for versions of Sphinx `>=8.1` ([912](https://github.com/swyddfa/esbonio/issues/912))

esbonio-language-server-v0.16.5
<h1 class="title">v0.16.5 - 2024-09-23</h1>

> [!Important]
>
> The `0.16.x` version of the language server is no longer in active development, all new users are encouraged to start with the `1.0bx` version.
>
> Existing users are also encouraged to [migrate](https://docs.esbon.io/en/latest/lsp/howto/migrate-to-v1.html), unless you are relying on a feature not yet provided by the `1.0bx` version.
> (See [this issue](https://github.com/swyddfa/esbonio/issues/901) for the latest status)
>
> The `1.0` version of the language server will be released once the remaining features from `0.16.x` have been ported across.

<div class="section" id="fixes">
<h1>Fixes</h1>
<ul class="simple">
<li>Changed the preview server to use a Thread instead of a Process to prevent deadlocks on certain systems by &64;Nitorac (<a class="reference external" href="https://github.com/swyddfa/esbonio/issues/790">#790</a>)</li>
</ul>
</div>
<div class="section" id="misc">
<h1>Misc</h1>
<ul class="simple">
<li>Pin pygls <tt class="docutils literal">&lt;2</tt> (<a class="reference external" href="https://github.com/swyddfa/esbonio/issues/898">#898</a>)</li>
</ul>
</div>


esbonio-extensions-v0.2.3

Enhancements

- Re-implemented the `esbonio.sphinx.configOverrides` option ([785](https://github.com/swyddfa/esbonio/issues/785))

Fixes

- Esbonio's preview generation should no longer conflict with extensions like `ablog` which call methods like `replac_self()` on custom doctree nodes. ([874](https://github.com/swyddfa/esbonio/issues/874))

Misc

- Drop support for Python 3.8 ([858](https://github.com/swyddfa/esbonio/issues/858))
- Add support for Python 3.13 ([859](https://github.com/swyddfa/esbonio/issues/859))
- Drop Sphinx `5.x` support, add Sphinx `8.x` support ([866](https://github.com/swyddfa/esbonio/issues/866))
- Migrate to pygls v2 ([882](https://github.com/swyddfa/esbonio/issues/882))

esbonio-vscode-extension-v0.95.1

Features

- The language server now generates completions for `:external:` roles and their corresponding targets ([464](https://github.com/swyddfa/esbonio/issues/464))
- Add a `esbonio.sphinx.restart` command which, as the name suggests, allows a client to restart one or more Sphinx processes managed by the server ([854](https://github.com/swyddfa/esbonio/issues/854))

Enhancements

- Synchronised scrolling now works with files that have been `.. included::`, as well as autodoc docstrings ([784](https://github.com/swyddfa/esbonio/issues/784))
- The resolution of sync scrolling has been improved with the webview also better handling the case where the requested line does not exactly match a known source location ([786](https://github.com/swyddfa/esbonio/issues/786))

Fixes

- `esbonio.sphinx.buildCommand` settings provided in a `pyproject.toml` file are now resolved relative to the file's location ([711](https://github.com/swyddfa/esbonio/issues/711))
- The sphinx agent should no longer crash when encountering unexpected config values ([843](https://github.com/swyddfa/esbonio/issues/843))

esbonio-vscode-extension-v0.94.2

Misc

- Fix release pipeline ([831](https://github.com/swyddfa/esbonio/issues/831))

Features

- Implement role target completions for MyST syntax ([823](https://github.com/swyddfa/esbonio/issues/823))

Enhancements

- The server now includes the `eval-rst` directive in its completion suggestions for MyST files ([799](https://github.com/swyddfa/esbonio/issues/799))

API Changes

- In the server's context `LanguageFeatures` can now define a `CompletionTrigger` which among other things, allows them to declare trigger characters ([413](https://github.com/swyddfa/esbonio/issues/413))
- In the Sphinx process, it is now possible for extensions to declare a role target provider through the `app.esbonio.create_role_target_provider` and `app.esbonio.add_role` methods.
**Note:** This does require an associated implementation of the target provider on the server side. ([823](https://github.com/swyddfa/esbonio/issues/823))

Fixes

- The language server should now launch the correct version of the sphinx agent, even if an installation of `esbonio` exists in the target environment ([782](https://github.com/swyddfa/esbonio/issues/782))
- The server no longer raises `ValueErrors` when typing `:` characters in markdown files. ([800](https://github.com/swyddfa/esbonio/issues/800))
- The server should no longer throw path mount errors when used across partitions on Windows ([810](https://github.com/swyddfa/esbonio/issues/810))

esbonio-vscode-extension-v0.94.0

Features

- Add support for role completions in MyST documents ([775](https://github.com/swyddfa/esbonio/issues/775))

Enhancements

- If the client supports it, the server will now send `window/showDocument` requests when previewing a file.

The server will automatically react to changes to ``esbonio.preview.*`` configuration options. ([793](https://github.com/swyddfa/esbonio/issues/793))

Fixes

- The server should once again, correctly guess a reasonable basic `sphinx-build` build command for projects located in a sub-folder of the workspace ([779](https://github.com/swyddfa/esbonio/issues/779))
- The server should once again automatically trigger a build when previewing a file, when necessary ([783](https://github.com/swyddfa/esbonio/issues/783))

esbonio-vscode-extension-v0.93.2