finchie/new_manual - Change BSJYWOYSJRERQ45AD7RN3364RYQ5P3IM76S67262VLFZPFO3B5JQC

Implement MVP Typst embedding

This is a halfway-done implementation at best, my plan from here is to convert Typst to Xilem (Rust) code, which will hopefully be much neater. Then I have to find a way to parameterize the Typst text based on the Xilem state, so when someone changes a number in their input, the documentation changes to match.

Created by finchie on October 24, 2023

BSJYWOYSJRERQ45AD7RN3364RYQ5P3IM76S67262VLFZPFO3B5JQC

Dependencies

In channels

main

Change contents

Insertion in src/main.rs at line 79 [5.49]

[3.1766]

[4.371]

}
fn content(state: &AppState) -> impl View<AppState> + ViewMarker {
    el::div(include_str!("../dist/.stage/docs/test.html"))

Replacement in src/main.rs at line 95 [5.49]

B:BD[2.114] → [2.114:161]

            el::div(()).attr("id", "content"),

[2.114]

[2.161]

            el::div(content(&state)).attr("id", "content"),

File addition: docs (d--x------)
[6.1]
File addition: test.typ (----------)
[0.207]
```
= Hello
Hello from typst!
```

File addition: build.rs (----------)

[6.1]

use std::{ffi::OsStr, path::PathBuf, process::Command};
use walkdir::WalkDir;
const TRUNK_STAGING_DIRECTORY: &str = "dist/.stage";
const DOCS_SOURCE: &str = "docs";
// TODO: avoid re-building docs every time
fn main() {
    // Recursively find all .typ (typst) files within `docs/`
    let typst_files = WalkDir::new(DOCS_SOURCE)
        .into_iter()
        // Remove inaccessible directories
        .filter_map(|possible_entry| possible_entry.ok())
        // Only find files
        .filter(|entry| entry.path().is_file())
        // Only find typst (.typ) files
        .filter(|entry| entry.path().extension() == Some(OsStr::new("typ")));
    // Set up the staging directory
    std::fs::create_dir_all(TRUNK_STAGING_DIRECTORY).unwrap();
    // Build all the files
    let prefix = PathBuf::from(DOCS_SOURCE);
    let staging_dir = PathBuf::from(TRUNK_STAGING_DIRECTORY).join(DOCS_SOURCE);
    for file in typst_files {
        let parent = file.path().parent().unwrap();
        // Handle nested directories correctly
        let remainder = if parent != prefix {
            assert!(parent.starts_with(&prefix));
            parent.strip_prefix(&prefix).unwrap().to_path_buf()
        } else {
            PathBuf::new()
        };
        // Create the appropriate directory layout
        let mut output_path = staging_dir
            .join(remainder)
            .join(file.path().file_name().unwrap());
        // Our input is .typ, but output is .html
        output_path.set_extension("html");
        std::fs::create_dir_all(output_path.parent().unwrap()).unwrap();
        Command::new("pandoc")
            .args([
                file.path().to_str().unwrap(),
                "-o",
                output_path.to_str().unwrap(),
            ])
            .status()
            .expect("Error running pandoc. Check if it's installed");
    }
}

Insertion in Cargo.toml at line 15 [5.1280]
[5.1474]
```
[build-dependencies]
walkdir = "2.4.0"
```
Insertion in Cargo.lock at line 209 [5.1510]
[3.2363]
[5.4315]
```
 "walkdir",
```

Insertion in Cargo.lock at line 252 [5.1510]

[5.5214]

name = "same-file"
version = "1.0.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "93fc1dc3aaa9bfed95e02e6eadabb4baf7e3078b0bd1b4d7b6b0b68378900502"
dependencies = [
 "winapi-util",
]
[[package]]

Insertion in Cargo.lock at line 391 [5.1510]

[7.3866]


[[package]]
name = "walkdir"
version = "2.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d71d857dc86794ca4c280d616f7da00d2dbfd8cd788846559a6813e6aa4b54ee"
dependencies = [
 "same-file",
 "winapi-util",
]

Insertion in Cargo.lock at line 467 [5.1510]

[5.7968]

[7.3880]

name = "winapi"
version = "0.3.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
dependencies = [
 "winapi-i686-pc-windows-gnu",
 "winapi-x86_64-pc-windows-gnu",
]
[[package]]
name = "winapi-i686-pc-windows-gnu"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
[[package]]
name = "winapi-util"
version = "0.1.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f29e6f9198ba0d26b4c9f07dbe6f9ed633e1f3d5b8b414090084349e46a52596"
dependencies = [
 "winapi",
]
[[package]]
name = "winapi-x86_64-pc-windows-gnu"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
[[package]]