Migrate to rinja

Cargo.toml

@@ -26,12 +26,12 @@ clap = { version = "4.3.12", features = ["cargo", "wrap_help"] }
 clap_complete = "4.3.2"
 once_cell = "1.17.1"
 env_logger = "0.11.1"
-handlebars = "6.0"
 log = "0.4.17"
 memchr = "2.5.0"
 opener = "0.7.0"
 pulldown-cmark = { version = "0.10.0", default-features = false, features = ["html"] } # Do not update, part of the public api.
 regex = "1.8.1"
+rinja = "0.3.5"
 serde = { version = "1.0.163", features = ["derive"] }
 serde_json = "1.0.96"
 shlex = "1.3.0"

guide/src/format/theme/index-hbs.md

@@ -1,6 +1,6 @@
-# index.hbs
+# index.html
 
-`index.hbs` is the handlebars template that is used to render the book. The
+`index.html` is the jinja template that is used to render the book. The
 markdown files are processed to html and then injected in that template.
 
 If you want to change the layout or style of your book, chances are that you
@@ -11,7 +11,7 @@ will have to modify this template a little bit. Here is what you need to know.
 A lot of data is exposed to the handlebars template with the "context". In the
 handlebars template you can access this information by using
 
-```handlebars
+```jinja
 {{name_of_property}}
 ```
 

rinja.toml

@@ -0,0 +1,3 @@
+[[escaper]]
+path = "rinja::filters::Text"
+extensions = ["js"]

src/book/init.rs

@@ -122,9 +122,6 @@ impl BookBuilder {
             fs::create_dir(&themedir)?;
         }
 
-        let mut index = File::create(themedir.join("index.hbs"))?;
-        index.write_all(theme::INDEX)?;
-
         let cssdir = themedir.join("css");
         if !cssdir.exists() {
             fs::create_dir(&cssdir)?;

src/book/mod.rs

@@ -27,7 +27,7 @@ use crate::errors::*;
 use crate::preprocess::{
     CmdPreprocessor, IndexPreprocessor, LinkPreprocessor, Preprocessor, PreprocessorContext,
 };
-use crate::renderer::{CmdRenderer, HtmlHandlebars, MarkdownRenderer, RenderContext, Renderer};
+use crate::renderer::{CmdRenderer, HtmlRenderer, MarkdownRenderer, RenderContext, Renderer};
 use crate::utils;
 
 use crate::config::{Config, RustEdition};
@@ -435,7 +435,7 @@ fn determine_renderers(config: &Config) -> Vec<Box<dyn Renderer>> {
     if let Some(output_table) = config.get("output").and_then(Value::as_table) {
         renderers.extend(output_table.iter().map(|(key, table)| {
             if key == "html" {
-                Box::new(HtmlHandlebars::new()) as Box<dyn Renderer>
+                Box::new(HtmlRenderer::new()) as Box<dyn Renderer>
             } else if key == "markdown" {
                 Box::new(MarkdownRenderer::new()) as Box<dyn Renderer>
             } else {
@@ -446,7 +446,7 @@ fn determine_renderers(config: &Config) -> Vec<Box<dyn Renderer>> {
 
     // if we couldn't find anything, add the HTML renderer as a default
     if renderers.is_empty() {
-        renderers.push(Box::new(HtmlHandlebars::new()));
+        renderers.push(Box::new(HtmlRenderer::new()));
     }
 
     renderers
@@ -858,7 +858,7 @@ mod tests {
             .and_then(Value::as_str)
             .unwrap();
         assert_eq!(html, "html");
-        let html_renderer = HtmlHandlebars::default();
+        let html_renderer = HtmlRenderer::default();
         let pre = LinkPreprocessor::new();
 
         let should_run = preprocessor_should_run(&pre, &html_renderer, &cfg);
@@ -883,7 +883,7 @@ mod tests {
     #[test]
     fn preprocessor_should_run_falls_back_to_supports_renderer_method() {
         let cfg = Config::default();
-        let html = HtmlHandlebars::new();
+        let html = HtmlRenderer::new();
 
         let should_be = true;
         let got = preprocessor_should_run(&BoolPreprocessor(should_be), &html, &cfg);

src/config.rs

@@ -464,6 +464,14 @@ impl TextDirection {
             _ => TextDirection::LeftToRight,
         }
     }
+
+    /// Convert the text representation.
+    pub fn as_str(&self) -> &'static str {
+        match self {
+            Self::LeftToRight => "ltr",
+            Self::RightToLeft => "rtl",
+        }
+    }
 }
 
 /// Configuration for the build procedure.