Struct readme_sync::CMarkDocs [−][src]
pub struct CMarkDocs<P, M> { /* fields omitted */ }
Expand description
Parsed documentation Markdown with optionally specified package path and package manifest.
Implementations
pub fn from_package_with_default_config(
package: &'a Package
) -> Result<Self, CMarkDocsFromPackageError>
pub fn from_package_with_default_config(
package: &'a Package
) -> Result<Self, CMarkDocsFromPackageError>
Creates docs from package and default config.
First it reads docs file by path specified in the package manifest. Then it parses it with default configuration.
pub fn from_package_and_config(
package: &'a Package,
config: &Config<'_>
) -> Result<Self, CMarkDocsFromPackageError>
pub fn from_package_and_config(
package: &'a Package,
config: &Config<'_>
) -> Result<Self, CMarkDocsFromPackageError>
Creates docs from package and the specified config.
First it reads docs file by path specified in the package manifest. Then it parses it with the specified configuration.
pub fn from_file_and_config(
file: Arc<File>,
config: &Config<'_>
) -> Result<Self, FileDocsFromFileError>
pub fn from_file_and_config(
file: Arc<File>,
config: &Config<'_>
) -> Result<Self, FileDocsFromFileError>
Creates docs from file and the specified config.
The method parses a file with the specified configuration.
Adding the specified package path to the docs.
Adding the specified manifest to the docs.
pub fn from_file_and_config_and_package_path_and_manifest(
file: Arc<File>,
config: &Config<'_>,
package_path: P,
manifest: M
) -> Result<Self, FileDocsFromFileError>
pub fn from_file_and_config_and_package_path_and_manifest(
file: Arc<File>,
config: &Config<'_>,
package_path: P,
manifest: M
) -> Result<Self, FileDocsFromFileError>
Creates docs from file, config, package path and manifest.
pub fn from_file_docs_and_package_path_and_manifest(
file_docs: Arc<FileDocs>,
package_path: P,
manifest: M
) -> Self
pub fn from_file_docs_and_package_path_and_manifest(
file_docs: Arc<FileDocs>,
package_path: P,
manifest: M
) -> Self
Creates docs from file docs content, package path and manifest.
pub fn from_data_chunks_package_pach_and_manifest(
data: CMarkData,
package_path: P,
manifest: M
) -> Self
pub fn from_data_chunks_package_pach_and_manifest(
data: CMarkData,
package_path: P,
manifest: M
) -> Self
Creates docs from CMark items, package path and manifest.
Returns the package path.
Iterate over CMarkItem
s.
Iterate over pulldown-cmark events.
Concatenate adjacent text events.
Use this transformation if you deleted some nodes manually and want to merge the neighboring text nodes.
This transformation is always applied right after readme and docs parsing, because some text events remain ununited. For example Rust attribute parser generate seperate text events for every line of source code, and pulldown_cmark generate seperate text events for character entity reference.
Increment levels of all headings.
In readme, the first level heading is usually used only for the project title. The second level header is usually used in for text section headings in readme. Rustdoc automatically adds the header of a crate name and the first level headers are used for text sections.
So it is necessary to increase the level of all headings in the documentation in order to synchronize the headings.
Add a first level heading with the specified text.
This function could be useful after heading level incremented.
Remove section with the specified heading text and level and its subsections.
Remove the specified fenced code block tag.
Remove the specified fenced code block tags.
Remove fenced code block tags that are used by cargo test
.
See https://doc.rust-lang.org/rustdoc/documentation-tests.html for more details.
Use the specified codeblock tag, if they are not specified
Use rust fenced codeblock highlight as default.
Remove hidden rust code from rust fenced codeblocks.
See https://doc.rust-lang.org/rustdoc/documentation-tests.html#hiding-portions-of-the-example for more details.
pub fn disallow_absolute_docs_links(
self,
package_name: &str,
documentation_url: &str
) -> Result<CMarkDocs<P, M>, DisallowUrlsWithPrefixError>
pub fn disallow_absolute_docs_links(
self,
package_name: &str,
documentation_url: &str
) -> Result<CMarkDocs<P, M>, DisallowUrlsWithPrefixError>
Returns self if absolute docs links to the specified repository not found, otherwise returns an error.
pub fn use_absolute_docs_urls(
self,
package_name: &str,
documentation_url: &str
) -> CMarkDocs<P, M>
pub fn use_absolute_docs_urls(
self,
package_name: &str,
documentation_url: &str
) -> CMarkDocs<P, M>
Convert all relative links into absolute ones using the specified package documentation url as the root address.
Add a first level heading with the manifest package name.
This function could be useful after heading level incremented.
pub fn disallow_absolute_package_docs_links(
self
) -> Result<CMarkDocs<P, &'a Manifest>, DisallowAbsolutePackageDocsLinksError>
pub fn disallow_absolute_package_docs_links(
self
) -> Result<CMarkDocs<P, &'a Manifest>, DisallowAbsolutePackageDocsLinksError>
Returns self if absolute docs links to the manifest repository not found, otherwise returns an error.
pub fn use_absolute_package_docs_urls(
self
) -> Result<CMarkDocs<P, &'a Manifest>, UseAbsolutePackageDocsUrlsError>
pub fn use_absolute_package_docs_urls(
self
) -> Result<CMarkDocs<P, &'a Manifest>, UseAbsolutePackageDocsUrlsError>
Convert all relative links into absolute ones using the manifest package documentation url as the root address.
Trait Implementations
Auto Trait Implementations
impl<P, M> RefUnwindSafe for CMarkDocs<P, M> where
M: RefUnwindSafe,
P: RefUnwindSafe,
impl<P, M> UnwindSafe for CMarkDocs<P, M> where
M: UnwindSafe,
P: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more