Struct parsoid::Template

pub struct Template { /* fields omitted */ }

Represents a MediaWiki template ({{foo}})

How to access values from an existing template:

let code = client.transform_to_html("{{1x|test}}").await?;
// Get the `Template` instance
let template = code.filter_templates()?[0].clone();
assert_eq!(template.name(), "Template:1x".to_string());
assert_eq!(template.raw_name(), "./Template:1x".to_string());
assert_eq!(template.name_in_wikitext(), "1x".to_string());
assert_eq!(template.get_param("1"), Some("test".to_string()));

How to create and insert a new template:

let mut params = map::IndexMap::new();
params.insert("1".to_string(), "test".to_string());
let template = Template::new("1x", &params)?;
let code = Wikicode::new("");
template.append_on(&code);
let wikitext = client.transform_to_wikitext(&code).await?;
assert_eq!(wikitext, "{{1x|test}}".to_string());

You can also use Template::new_simple() if there are no parameters to pass.

Implementations

impl Template

pub fn new_simple(name: &str) -> Self

Create a new template with no parameters

pub fn new(name: &str, params: &IndexMap<String, String>) -> Result<Self>

Create a new template

pub fn as_nodes(&self) -> Vec<&NodeRef>

pub fn detach(&self)

Remove this template from the document

pub fn prepend_on(&self, code: &NodeRef)

Prepend this template into a node. Effectively calling node.prepend(template)

pub fn append_on(&self, code: &NodeRef)

Append this template into a node. Effectively calling node.append(template)

pub fn insert_after_on(&self, code: &NodeRef)

Insert this template after the node Effectively calling node.insert_after(template)

pub fn insert_before_on(&self, code: &NodeRef)

Insert this template before the node Effectively calling node.insert_before(template)

pub fn remove_param(&self, name: &str) -> Result<()>

pub fn set_param(&self, name: &str, wikitext: &str) -> Result<()>

pub fn name_in_wikitext(&self) -> String

Get the name of the template as it appears in wikitext

pub fn raw_name(&self) -> String

Get the full name of the template, e.g. ./Template:Foo_bar or the parser function, e.g. ifeq.

pub fn name(&self) -> String

Get a pretty normalized name of a template, e.g. Template:Foo bar or the parser function, e.g. ifeq

pub fn get_params(&self) -> IndexMap<String, String>

Get a map of all parameters, named and unnamed

pub fn get_param(&self, name: &str) -> Option<String>

Get the wikitext value of a specific parameter if it exists

pub fn get_param_in_wikitext(&self, name: &str) -> Option<String>

Get the name of the parameter as it appears in the wikitext. For example given {{1x|param<!--comment-->name=value}} looking up paramname would return Some("param<!--comment->name").

pub fn is_template(&self) -> bool

Whether it's a template (as opposed to a parser function)

pub fn is_parser_function(&self) -> bool

Whether it's a parser function (as opposed to a template)

Trait Implementations

impl Clone for Template

fn clone(&self) -> Template

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Template

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Template

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.