Merge pull request #3918 from rust-lang/trpl-listing

Add a `<Listing>` preprocessor

Author: chriskrycho

.github/workflows/main.yml

@@ -60,6 +60,8 @@ jobs:
         echo "$(pwd)/bin" >> ${GITHUB_PATH}
     - name: Install mdbook-trpl-note
       run: cargo install --path packages/mdbook-trpl-note
+    - name: Install mdbook-trpl-listing
+      run: cargo install --path packages/mdbook-trpl-listing
     - name: Install aspell
       run: sudo apt-get install aspell
     - name: Install shellcheck

Cargo.lock

@@ -8,10 +8,15 @@ exclude = [
 ]
 
 [workspace.dependencies]
+assert_cmd = "2.0.14"
 walkdir = "2.3.1"
+clap = { version = "4.5.4", features = ["derive"] }
 docopt = "1.1.0"
 mdbook = "0.4.37"
+pulldown-cmark = { version = "0.10.3", features = ["simd"] }
+pulldown-cmark-to-cmark = "13.0.0"
 serde = "1.0"
+serde_json = "1.0"
 regex = "1.3.3"
 lazy_static = "1.4.0"
 flate2 = "1.0.13"

Cargo.toml

@@ -6,9 +6,12 @@ title = "The Rust Programming Language"
 authors = ["Steve Klabnik", "Carol Nichols", "Contributions from the Rust Community"]
 
 [output.html]
-additional-css = ["ferris.css", "theme/2018-edition.css", "theme/semantic-notes.css"]
+additional-css = ["ferris.css", "theme/2018-edition.css", "theme/semantic-notes.css", "theme/listing.css"]
 additional-js = ["ferris.js"]
 git-repository-url = "https://github.com/rust-lang/book"
 
 # Do not sync this preprocessor; it is for the HTML renderer only.
 [preprocessor.trpl-note]
+
+[preprocessor.trpl-listing]
+output-mode = "default"

book.toml

@@ -9,4 +9,7 @@ additional-js = ["../ferris.js"]
 git-repository-url = "https://github.com/rust-lang/book"
 
 [build]
-build-dir = "../tmp"
+build-dir = "../tmp"
+
+[preprocessor.trpl-listing]
+output-mode = "simple"

nostarch/book.toml

@@ -0,0 +1,19 @@
+[package]
+name = "mdbook-trpl-listing"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+clap = { workspace = true }
+mdbook = { workspace = true }
+pulldown-cmark = { workspace = true }
+pulldown-cmark-to-cmark = { workspace = true }
+serde_json = { workspace = true }
+thiserror = "1.0.60"
+toml = "0.8.12"
+xmlparser = "0.13.6"
+
+[dev-dependencies]
+assert_cmd = { workspace = true }