feat(book): ✨ added versions for book

Actions workflow not yet ready.

Author: arctic-hen7

bonnie.toml

@@ -28,11 +28,35 @@ build = "cargo build"
 test = "cargo watch -x \"test\""
 check = "cargo check && cargo fmt -- --check && cargo clippy && cargo test" # This will be run on CI as well
 # Hosts the book locally
-doc.cmd = [
-	"cd docs",
+docs.cmd = [
+	"cd docs/next",
 	"mdbook serve"
 ]
-doc.desc = "hosts the book locally at http://localhost:3000"
+docs.desc = "hosts the latest version of the book locally at http://localhost:3000"
+docs.subcommands.version.cmd = [
+    "cd docs/%version",
+    "mdbook serve"
+]
+docs.subcommands.version.args = [ "version" ]
+docs.subcommands.version.desc = "hosts the given version of the book locally at http://localhost:3000"
+docs.subcommands.deprecate.cmd = [
+    "cd docs/%version",
+    "mkdir theme",
+    "ln -s ../../common/index.hbs theme/index.hbs",
+    "ln -s ../../common/header_old.hbs theme/header.hbs"
+]
+docs.subcommands.deprecate.args = [ "version" ]
+docs.subcommands.deprecate.desc = "marks the given version of the docs as old and links to the latest"
+docs.subcommands.create.cmd = [
+    "mkdir docs/%version",
+    "cd docs/%version",
+    "ln -s ../common/book.toml book.toml",
+    "cp -r ../next/src src",
+    "cd ../",
+    "sed -i -E 's/perseus\\/(.+)\"/perseus\\/0.2.x\"/' stable.html"
+]
+docs.subcommands.create.args = [ "version" ]
+docs.subcommands.create.desc = "creates documentation for a new version from `next` and marks it as stable (doesn't deprecate old versions though)"
 
 # Releases the project (maintainers only)
 # We commit all staged files so we can manually bump the Cargo version

docs/0.1.x/book.toml

@@ -0,0 +1 @@
+../common/book.toml

docs/src/SUMMARY.md renamed to docs/0.1.x/src/SUMMARY.md

@@ -6,4 +6,4 @@ src = "src"
 title = "Perseus Book"
 
 [rust]
-edition = "2018"
+edition = "2018"

docs/src/arch.md renamed to docs/0.1.x/src/arch.md

@@ -0,0 +1,42 @@
+<style>
+    header.warning {
+        background-color: rgb(242, 222, 222);
+        border-bottom-color: rgb(238, 211, 215);
+        border-bottom-left-radius: 4px;
+        border-bottom-right-radius: 4px;
+        border-bottom-style: solid;
+        border-bottom-width: 0.666667px;
+        border-image-outset: 0 0 0 0;
+        border-image-repeat: stretch stretch;
+        border-image-slice: 100% 100% 100% 100%;
+        border-image-source: none;
+        border-image-width: 1 1 1 1;
+        border-left-color: rgb(238, 211, 215);
+        border-left-style: solid;
+        border-left-width: 0.666667px;
+        border-right-color: rgb(238, 211, 215);
+        border-right-style: solid;
+        border-right-width: 0.666667px;
+        border-top-color: rgb(238, 211, 215);
+        border-top-left-radius: 4px;
+        border-top-right-radius: 4px;
+        border-top-style: solid;
+        border-top-width: 0.666667px;
+        color: rgb(185, 74, 72);
+        padding-bottom: 8px;
+        padding-left: 14px;
+        padding-right: 35px;
+        padding-top: 8px;
+        text-align: center;
+        margin-bottom: 0px;
+        margin-left: 0px;
+        margin-right: 0px;
+        margin-top: 30px;
+    }
+</style>
+<header class="warning">
+    This documentation is for an <strong>outdated</strong> version of Perseus.
+    <br>
+    You can find the documentation for the latest version
+    <a href="https://arctic-hen7.github.io/perseus/stable.html">here</a>.
+</header>