Function speak

src/navigate.rs:502–527

(rules_with_context: &'r mut SpeechRulesWithContext<'c,'s,'m>, mathml: Element<'c>, nav_node_id: String, full_read: bool)

}

fn speak<'r, 'c, 's:'c, 'm:'c>(rules_with_context: &'r mut SpeechRulesWithContext<'c,'s,'m>, mathml: Element<'c>, nav_node_id: String, full_read: bool) -> Result<String> {
    if full_read {
        let intent = crate::speech::intent_from_mathml(mathml, rules_with_context.get_document())?;
        debug!("intent: {}", mml_to_string(&intent));

        // In something like x^3, we might be looking for the '3', but it will be "cubed", so we don't find it.
        // Or we might be on a "(" surrounding a matrix and that isn't part of the intent
        // We are probably safer in terms of getting the same speech if we retry intent starting at the nav node,
        //  but the node to speech is almost certainly trivial.
        // By speaking the non-intent tree, we are certain to speech on the next try
        if get_node_by_id(intent, &nav_node_id).is_some() {
            match crate::speech::speak_mathml(intent, &nav_node_id) {
                Ok(speech) => return Ok(speech),
                Err(e) => {
                    if e.to_string() != crate::speech::NAV_NODE_SPEECH_NOT_FOUND {
                        return Err(e);
                    }
                    // else could be something like '3' in 'x^3' ("cubed")
                },
            }
        }
        return crate::speech::speak_mathml(mathml, &nav_node_id);
    } else {
        return crate::speech::overview_mathml(mathml, &nav_node_id);
    }
}


// MathPlayer's interface mentions these, so we keep them.