diff --git a/CHANGELOG.md b/CHANGELOG.md
index 03396394..03bc09cd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
# Changelog
-### 0.5 Migration Guide
+## 0.5 Migration Guide
During the pre-release phase of the 0.5 release, the documentation may be found at .
@@ -10,7 +10,7 @@ If you have overridden any of the theme files, you will likely need to update th
The following is a summary of the changes that may require your attention when updating to 0.5:
-#### Config changes
+### Config changes
- Unknown fields in config are now an error.
[#2787](https://github.com/rust-lang/mdBook/pull/2787)
@@ -35,14 +35,14 @@ The following is a summary of the changes that may require your attention when u
- Removed the very old legacy config support. Warnings have been displayed in previous versions on how to migrate.
[#2783](https://github.com/rust-lang/mdBook/pull/2783)
-#### Theme changes
+### Theme changes
- Replaced the `{{#previous}}` and `{{#next}}` handlebars helpers with simple objects that contain the previous and next values.
[#2794](https://github.com/rust-lang/mdBook/pull/2794)
- Removed the `{{theme_option}}` handlebars helper. It has not been used for a while.
[#2795](https://github.com/rust-lang/mdBook/pull/2795)
-#### Rendering changes
+### Rendering changes
- Updated to a newer version of `pulldown-cmark`. This brings a large number of fixes to markdown processing.
[#2401](https://github.com/rust-lang/mdBook/pull/2401)
@@ -59,14 +59,14 @@ The following is a summary of the changes that may require your attention when u
- Added support for admonitions. These are enabled by default, with the option `output.html.admonitions` to disable it.
[#2851](https://github.com/rust-lang/mdBook/pull/2851)
-#### CLI changes
+### CLI changes
- Removed the `--dest-dir` option to `mdbook test`. It was unused since `mdbook test` does not generate output.
[#2805](https://github.com/rust-lang/mdBook/pull/2805)
- Changed CLI `--dest-dir` to be relative to the current directory, not the book root.
[#2806](https://github.com/rust-lang/mdBook/pull/2806)
-#### Rust API
+### Rust API
- The Rust API has been split into several crates ([#2766](https://github.com/rust-lang/mdBook/pull/2766)). In summary, the different crates are:
- `mdbook` — The CLI binary.
@@ -102,6 +102,29 @@ The following is a summary of the changes that may require your attention when u
- Various functions in the `utils::fs` module have been removed, renamed, or reworked.
- Most of the functions in the `utils` module have been moved, removed, or made private.
+## mdBook 0.5.0-beta.1
+[v0.5.0-alpha.1...v0.5.0-beta.1](https://github.com/rust-lang/mdBook/compare/v0.5.0-alpha.1...v0.5.0-beta.1)
+
+### Changed
+
+- Reworked the look of the header navigation.
+ [#2898](https://github.com/rust-lang/mdBook/pull/2898)
+- Update cargo dependencies.
+ [#2896](https://github.com/rust-lang/mdBook/pull/2896)
+- Improved the heading nav debug.
+ [#2892](https://github.com/rust-lang/mdBook/pull/2892)
+
+### Fixed
+
+- Fixed error message for config.get deserialization error.
+ [#2902](https://github.com/rust-lang/mdBook/pull/2902)
+- Filter `` tags from sidebar heading nav.
+ [#2899](https://github.com/rust-lang/mdBook/pull/2899)
+- Avoid divide-by-zero in heading nav computation
+ [#2891](https://github.com/rust-lang/mdBook/pull/2891)
+- Fixed heading nav with folded chapters.
+ [#2893](https://github.com/rust-lang/mdBook/pull/2893)
+
## mdBook 0.5.0-alpha.1
[v0.4.52...v0.5.0-alpha.1](https://github.com/rust-lang/mdBook/compare/v0.4.52...v0.5.0-alpha.1)
diff --git a/Cargo.lock b/Cargo.lock
index 49ef4859..c8aa0d3c 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -956,7 +956,7 @@ checksum = "47e1ffaa40ddd1f3ed91f717a33c8c0ee23fff369e3aa8772b9605cc1d22f4c3"
[[package]]
name = "mdbook"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"anyhow",
"axum",
@@ -996,7 +996,7 @@ version = "0.0.0"
[[package]]
name = "mdbook-core"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"anyhow",
"regex",
@@ -1009,7 +1009,7 @@ dependencies = [
[[package]]
name = "mdbook-driver"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"anyhow",
"indexmap",
@@ -1031,7 +1031,7 @@ dependencies = [
[[package]]
name = "mdbook-html"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"anyhow",
"ego-tree",
@@ -1056,7 +1056,7 @@ dependencies = [
[[package]]
name = "mdbook-markdown"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"pulldown-cmark",
"regex",
@@ -1065,7 +1065,7 @@ dependencies = [
[[package]]
name = "mdbook-preprocessor"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"anyhow",
"mdbook-core",
@@ -1085,7 +1085,7 @@ dependencies = [
[[package]]
name = "mdbook-renderer"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"anyhow",
"mdbook-core",
@@ -1095,7 +1095,7 @@ dependencies = [
[[package]]
name = "mdbook-summary"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
dependencies = [
"anyhow",
"mdbook-core",
diff --git a/Cargo.toml b/Cargo.toml
index 3eaf327a..68565951 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -39,13 +39,13 @@ hex = "0.4.3"
html5ever = "0.35.0"
indexmap = "2.12.0"
ignore = "0.4.24"
-mdbook-core = { path = "crates/mdbook-core", version = "0.5.0-alpha.1" }
-mdbook-driver = { path = "crates/mdbook-driver", version = "0.5.0-alpha.1" }
-mdbook-html = { path = "crates/mdbook-html", version = "0.5.0-alpha.1" }
-mdbook-markdown = { path = "crates/mdbook-markdown", version = "0.5.0-alpha.1" }
-mdbook-preprocessor = { path = "crates/mdbook-preprocessor", version = "0.5.0-alpha.1" }
-mdbook-renderer = { path = "crates/mdbook-renderer", version = "0.5.0-alpha.1" }
-mdbook-summary = { path = "crates/mdbook-summary", version = "0.5.0-alpha.1" }
+mdbook-core = { path = "crates/mdbook-core", version = "0.5.0-beta.1" }
+mdbook-driver = { path = "crates/mdbook-driver", version = "0.5.0-beta.1" }
+mdbook-html = { path = "crates/mdbook-html", version = "0.5.0-beta.1" }
+mdbook-markdown = { path = "crates/mdbook-markdown", version = "0.5.0-beta.1" }
+mdbook-preprocessor = { path = "crates/mdbook-preprocessor", version = "0.5.0-beta.1" }
+mdbook-renderer = { path = "crates/mdbook-renderer", version = "0.5.0-beta.1" }
+mdbook-summary = { path = "crates/mdbook-summary", version = "0.5.0-beta.1" }
memchr = "2.7.6"
notify = "8.2.0"
notify-debouncer-mini = "0.7.0"
@@ -71,7 +71,7 @@ walkdir = "2.5.0"
[package]
name = "mdbook"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
authors = [
"Mathieu David ",
"Michael-F-Bryan ",
diff --git a/crates/mdbook-core/Cargo.toml b/crates/mdbook-core/Cargo.toml
index a964b72a..2e9465e7 100644
--- a/crates/mdbook-core/Cargo.toml
+++ b/crates/mdbook-core/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "mdbook-core"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
description = "The base support library for mdbook, intended for internal use only"
edition.workspace = true
license.workspace = true
diff --git a/crates/mdbook-driver/Cargo.toml b/crates/mdbook-driver/Cargo.toml
index 9c6281e8..70b030a4 100644
--- a/crates/mdbook-driver/Cargo.toml
+++ b/crates/mdbook-driver/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "mdbook-driver"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
description = "High-level library for running mdBook"
edition.workspace = true
license.workspace = true
diff --git a/crates/mdbook-html/Cargo.toml b/crates/mdbook-html/Cargo.toml
index fef26bbf..e30cf07e 100644
--- a/crates/mdbook-html/Cargo.toml
+++ b/crates/mdbook-html/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "mdbook-html"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
description = "mdBook HTML renderer"
edition.workspace = true
license.workspace = true
diff --git a/crates/mdbook-markdown/Cargo.toml b/crates/mdbook-markdown/Cargo.toml
index f6414074..a6664843 100644
--- a/crates/mdbook-markdown/Cargo.toml
+++ b/crates/mdbook-markdown/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "mdbook-markdown"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
description = "Markdown processing used in mdBook"
edition.workspace = true
license.workspace = true
diff --git a/crates/mdbook-preprocessor/Cargo.toml b/crates/mdbook-preprocessor/Cargo.toml
index c4ad0fc1..370669b7 100644
--- a/crates/mdbook-preprocessor/Cargo.toml
+++ b/crates/mdbook-preprocessor/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "mdbook-preprocessor"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
description = "Library to assist implementing an mdBook preprocessor"
edition.workspace = true
license.workspace = true
diff --git a/crates/mdbook-renderer/Cargo.toml b/crates/mdbook-renderer/Cargo.toml
index 38869282..69d5c8c0 100644
--- a/crates/mdbook-renderer/Cargo.toml
+++ b/crates/mdbook-renderer/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "mdbook-renderer"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
description = "Library to assist implementing an mdBook renderer"
edition.workspace = true
license.workspace = true
diff --git a/crates/mdbook-summary/Cargo.toml b/crates/mdbook-summary/Cargo.toml
index d6b8e4a2..d06b75af 100644
--- a/crates/mdbook-summary/Cargo.toml
+++ b/crates/mdbook-summary/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "mdbook-summary"
-version = "0.5.0-alpha.1"
+version = "0.5.0-beta.1"
description = "Summary parser for mdBook"
edition.workspace = true
license.workspace = true