Struct rustdoc::html::render::Context

pub(crate) struct Context {
    pub(crate) current: Vec<String>,
    pub(crate) dst: PathBuf,
    pub(crate) render_redirect_pages: bool,
    id_map: Rc<RefCell<IdMap>>,
    pub(crate) shared: Arc<SharedContext>,
    all: Rc<RefCell<AllTypes>>,
    pub(crate) errors: Rc<Receiver<String>>,
}

Major driving force in all rustdoc rendering. This contains information about where in the tree-like hierarchy rendering is occurring and controls how the current page is being rendered.

It is intended that this context is a lightweight object which can be fairly easily cloned because it is cloned per work-job (about once per item in the rustdoc tree).

Fields

current: Vec<String>

Current hierarchy of components leading down to what's currently being rendered

dst: PathBuf

The current destination folder of where HTML artifacts should be placed. This changes as the context descends into the module hierarchy.

render_redirect_pages: bool

A flag, which when true, will render pages which redirect to the real location of an item. This is used to allow external links to publicly reused items to redirect to the right location.

id_map: Rc<RefCell<IdMap>>

The map used to ensure all generated 'id=' attributes are unique.

shared: Arc<SharedContext>

all: Rc<RefCell<AllTypes>>

errors: Rc<Receiver<String>>

Storage for the errors produced while generating documentation so they can be printed together at the end.

Implementations

impl Context

pub(in html::render) fn path(
    &self,
    filename: &str
) -> PathBuf

impl Context

pub(in html::render) fn derive_id(
    &self,
    id: String
) -> String

pub(in html::render) fn root_path(
    &self
) -> String

String representation of how to get back to the root path of the 'doc/' folder in terms of a relative URL.

pub(in html::render) fn render_item(
    &self,
    it: &Item,
    pushname: bool,
    cache: &Cache
) -> String

pub(in html::render) fn build_sidebar_items(
    &self,
    m: &Module
) -> BTreeMap<String, Vec<(String, Option<String>)>>

Construct a map of items shown in the sidebar to a plain-text summary of their docs.

pub(in html::render) fn src_href(
    &self,
    item: &Item,
    cache: &Cache
) -> Option<String>

Generates a url appropriate for an href attribute back to the source of this item.

The url generated, when clicked, will redirect the browser back to the original source code.

If None is returned, then a source link couldn't be generated. This may happen, for example, with externally inlined items where the source of their crate documentation isn't known.

Trait Implementations

impl Clone for Context

pub fn clone(&self) -> Context

Returns a copy of the value.

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

Performs copy-assignment from source.

impl FormatRenderer for Context

Generates the documentation for crate into the directory dst

pub(crate) fn init(
    krate: Crate,
    options: RenderOptions,
    _render_info: RenderInfo,
    edition: Edition,
    cache: &mut Cache
) -> Result<(Context, Crate), Error>

Sets up any state required for the renderer. When this is called the cache has already been populated.

pub(crate) fn after_run(&mut self, diag: &Handler) -> Result<(), Error>

Called after everything else to write out errors.

pub(crate) fn after_krate(
    &mut self,
    krate: &Crate,
    cache: &Cache
) -> Result<(), Error>

Post processing hook for cleanup and dumping output to files.

pub(crate) fn mod_item_in(
    &mut self,
    item: &Item,
    item_name: &str,
    cache: &Cache
) -> Result<(), Error>

Renders a module (should not handle recursing into children).

pub(crate) fn mod_item_out(&mut self, _item_name: &str) -> Result<(), Error>

Runs after recursively rendering all sub-items of a module.

pub(crate) fn item(&mut self, item: Item, cache: &Cache) -> Result<(), Error>

Renders a single non-module item. This means no recursive sub-item rendering is required.