Add book.toml generation (#1461)

commit-id:b5f6227b

---

**Stack**:
- #1464
- #1463
- #1462
- #1461 ⬅


⚠️ *Part of a stack created by [spr](https://github.com/ejoffe/spr). Do
not merge manually using the UI - doing so may have unexpected results.*

extensions/scarb-doc/Cargo.toml

@@ -22,6 +22,7 @@ cairo-lang-starknet.workspace = true
 cairo-lang-syntax.workspace = true
 cairo-lang-utils.workspace = true
 expect-test.workspace = true
+indoc.workspace = true
 itertools.workspace = true
 scarb-metadata = { path = "../../scarb-metadata" }
 scarb-ui = { path = "../../utils/scarb-ui" }
@@ -32,5 +33,4 @@ smol_str.workspace = true
 
 [dev-dependencies]
 assert_fs.workspace = true
-indoc.workspace = true
 scarb-test-support = { path = "../../utils/scarb-test-support" }

extensions/scarb-doc/src/docs_generation.rs

@@ -0,0 +1 @@
+mod markdown;

extensions/scarb-doc/src/docs_generation/markdown.rs

@@ -0,0 +1 @@
+mod book_toml;

extensions/scarb-doc/src/docs_generation/markdown/book_toml.rs

@@ -0,0 +1,29 @@
+use indoc::formatdoc;
+
+use crate::AdditionalMetadata;
+
+#[allow(dead_code)]
+pub fn generate_book_toml_content(package_metadata: &AdditionalMetadata) -> String {
+    formatdoc! {
+        r#"
+            [book]
+            authors = {:?}
+            language = "en"
+            multilingual = false
+            src = "src"
+            title = "{} - Cairo"
+
+            [output.html]
+            no-section-label = true
+
+            [output.html.playground]
+            runnable = false
+
+            [output.html.fold]
+            enable = true
+            level = 0
+        "#,
+        package_metadata.authors.clone().unwrap_or_else(|| vec!["<unknown>".to_string()]),
+        package_metadata.name
+    }
+}

extensions/scarb-doc/src/lib.rs

@@ -9,6 +9,7 @@ use crate::metadata::compilation::get_project_config;
 use types::Crate;
 
 pub mod db;
+pub mod docs_generation;
 pub mod metadata;
 pub mod types;
 pub mod versioned_json_output;