zed-industries/zed · error

zed-html output defined

Error message

zed-html output defined

What it means

Panics in handle_postprocessing when the `zed-html` backend entry is missing from the mdbook output config, even though the output table exists. This renderer only runs when zed-html is the configured backend, so its absence indicates a mismatched or stale configuration.

Source

Thrown at crates/docs_preprocessor/src/main.rs:692

            );
            ActionManifest {
                actions: Vec::new(),
                schema_definitions: serde_json::Map::new(),
            }
        }
    }
}

fn handle_postprocessing() -> Result<()> {
    let logger = zlog::scoped!("render");
    let mut ctx = mdbook::renderer::RenderContext::from_json(io::stdin())?;
    let output = ctx
        .config
        .get_mut("output")
        .expect("has output")
        .as_table_mut()
        .expect("output is table");
    let zed_html = output.remove("zed-html").expect("zed-html output defined");
    let redirects = zed_html
        .get("redirect")
        .and_then(|redirects| redirects.as_table())
        .map(|redirects| {
            redirects
                .iter()
                .filter_map(|(source, destination)| {
                    destination
                        .as_str()
                        .map(|destination| (source.clone(), destination.to_string()))
                })
                .collect::<Vec<_>>()
        });
    let default_description = zed_html
        .get("default-description")
        .expect("Default description not found")
        .as_str()
        .expect("Default description not a string")

View on GitHub (pinned to f4178619ac)

Solutions

  1. Add `[output.zed-html]` to book.toml
  2. Confirm the preprocessor is wired to the zed-html backend, not another output
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at crates/docs_preprocessor/src/main.rs:692 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of zed-industries/zed@f4178619ac (2026-08-20). Data as JSON: /api/errors/da1385c26c4e5193. Report an issue: GitHub.