Struct parsoid::Wikicode

pub struct Wikicode { /* fields omitted */ }

Container for HTML, usually represents the entire page

Implementations

impl Wikicode

pub fn new(body: &str) -> Self

Create a new Wikicode instance from raw Parsoid HTML.

pub fn new_node(tag: &str) -> Self

Create a new HTML node with the given tag

let node = Wikicode::new_node("b");
// Append your list items
node.append(&Wikicode::new_text("bolded text"));
assert_eq!(&node.to_string(), "<b>bolded text</b>")

pub fn new_text(text: &str) -> Self

Create a text node with the given contents

let node = Wikicode::new_text("foo bar");
assert_eq!(&node.to_string(), "foo bar");
// Tags will be escaped
let weird_node = Wikicode::new_text("foo <bar>");
assert_eq!(&weird_node.to_string(), "foo &lt;bar&gt;");

pub fn set_etag(&mut self, etag: &str)

Set the etag that came with this request. This allows Parsoid to preserve formatting and avoid dirty diffs when converting modified HTML back to wikitext.

pub fn get_etag(&self) -> Option<&str>

Get the etag that was set on this Wikicode instance.

pub fn revision_id(&self) -> Option<u32>

Get the revision id associated with the Parsoid HTML, if it has one.

pub fn title(&self) -> Option<String>

Get the title associated with the Parsoid HTML, if it has one.

pub fn get_redirect(&self) -> Option<Redirect>

pub fn text_contents(&self) -> String

Get a plain text representation of the Parsoid HTML with all markup stripped.

pub fn filter_comments(&self) -> Vec<Comment>

Get a list of all comments (<!-- example -->)

Methods from Deref<Target = NodeRef>

pub fn inclusive_ancestors(&self) -> Ancestors

Return an iterator of references to this node and its ancestors.

pub fn ancestors(&self) -> Ancestors

Return an iterator of references to this node’s ancestors.

pub fn inclusive_preceding_siblings(&self) -> Rev<Siblings>

Return an iterator of references to this node and the siblings before it.

pub fn preceding_siblings(&self) -> Rev<Siblings>

Return an iterator of references to this node’s siblings before it.

pub fn inclusive_following_siblings(&self) -> Siblings

Return an iterator of references to this node and the siblings after it.

pub fn following_siblings(&self) -> Siblings

Return an iterator of references to this node’s siblings after it.

pub fn children(&self) -> Siblings

Return an iterator of references to this node’s children.

pub fn inclusive_descendants(&self) -> Descendants

Return an iterator of references to this node and its descendants, in tree order.

Parent nodes appear before the descendants.

Note: this is the NodeEdge::Start items from traverse().

pub fn descendants(&self) -> Descendants

Return an iterator of references to this node’s descendants, in tree order.

Parent nodes appear before the descendants.

Note: this is the NodeEdge::Start items from traverse().

pub fn traverse_inclusive(&self) -> Traverse

Return an iterator of the start and end edges of this node and its descendants, in tree order.

pub fn traverse(&self) -> Traverse

Return an iterator of the start and end edges of this node’s descendants, in tree order.

pub fn select(
    &self,
    selectors: &str
) -> Result<Select<Elements<Descendants>, Selectors>, ()>

Return an iterator of the inclusive descendants element that match the given selector list.

pub fn select_first(
    &self,
    selectors: &str
) -> Result<NodeDataRef<ElementData>, ()>

Return the first inclusive descendants element that match the given selector list.

pub fn serialize<W>(&self, writer: &mut W) -> Result<(), Error> where
    W: Write, 

Serialize this node and its descendants in HTML syntax to the given stream.

pub fn serialize_to_file<P>(&self, path: P) -> Result<(), Error> where
    P: AsRef<Path>, 

Serialize this node and its descendants in HTML syntax to a new file at the given path.

pub fn text_contents(&self) -> String

Return the concatenation of all text nodes in this subtree.

pub fn append(&self, new_child: NodeRef)

Append a new child to this node, after existing children.

The new child is detached from its previous position.

pub fn prepend(&self, new_child: NodeRef)

Prepend a new child to this node, before existing children.

The new child is detached from its previous position.

pub fn insert_after(&self, new_sibling: NodeRef)

Insert a new sibling after this node.

The new sibling is detached from its previous position.

pub fn insert_before(&self, new_sibling: NodeRef)

Insert a new sibling before this node.

The new sibling is detached from its previous position.

Trait Implementations

impl Clone for Wikicode

fn clone(&self) -> Wikicode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Wikicode

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

Formats the value using the given formatter.

impl Deref for Wikicode

type Target = NodeRef

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl From<Wikinode> for Wikicode

fn from(node: Wikinode) -> Self

Performs the conversion.

impl PartialEq<Wikicode> for Wikicode

fn eq(&self, other: &Wikicode) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Wikicode) -> bool

This method tests for !=.

impl WikinodeIterator for Wikicode

fn as_node(&self) -> &NodeRef

fn append(&self, code: &NodeRef)

Append a node as a child

fn prepend(&self, code: &NodeRef)

Prepend a node as a child

fn insert_after(&self, code: &NodeRef)

Insert a node after the current node, as a sibling

fn insert_before(&self, code: &NodeRef)

Insert a node before the current node, as a sibling

fn select(&self, selector: &str) -> Vec<Wikinode>

Select some wiki nodes

fn select_first(&self, selector: &str) -> Option<Wikinode>

Get the first element that matches the selector, if possible

fn filter_links(&self) -> Vec<WikiLink>

Get a list of all wikilinks ([[Foo|bar]])

fn filter_external_links(&self) -> Vec<ExtLink>

Get a list of all external links ([https://example.org/ Example])

fn filter_categories(&self) -> Vec<Category>

Get a list of all categories

fn filter_templates(&self) -> Result<Vec<Template>>

Get a list of templates

fn filter_parser_functions(&self) -> Result<Vec<Template>>

Get a list of parser functions.

fn iter_sections(&self) -> Vec<Section>

fn inclusive_ancestors(&self) -> WikinodeMap<Ancestors>

Return an iterator of references to this node and its ancestors.

fn ancestors(&self) -> WikinodeMap<Ancestors>

Return an iterator of references to this node’s ancestors.

fn inclusive_preceding_siblings(&self) -> WikinodeMap<Rev<Siblings>>

Return an iterator of references to this node and the siblings before it.

fn preceding_simblings(&self) -> WikinodeMap<Rev<Siblings>>

Return an iterator of references to this node’s siblings before it.

fn inclusive_following_siblings(&self) -> WikinodeMap<Siblings>

Return an iterator of references to this node and the siblings after it.

fn following_siblings(&self) -> WikinodeMap<Siblings>

Return an iterator of references to this node’s siblings after it.

fn children(&self) -> WikinodeMap<Siblings>

Return an iterator of references to this node’s children.

fn inclusive_descendants(&self) -> WikinodeMap<Descendants>

Return an iterator of references to this node and its descendants, in tree order. Parent nodes appear before the descendants.

fn descendants(&self) -> WikinodeMap<Descendants>

Return an iterator of references to this node’s descendants, in tree order. Parent nodes appear before the descendants.

impl Eq for Wikicode

impl StructuralEq for Wikicode

impl StructuralPartialEq for Wikicode