Expand description
Rendering: solar AST -> vocs MDX.
Structsยง
- Comment
Data ๐ - Ctx ๐
- Description ๐
Enumsยง
- Desc
Kind ๐
Functionsยง
- collect_
comments ๐ - Collect natspec from doc comments, applying inline link replacement.
- contract_
kind_ ๐str - dedent ๐
- Strip common leading whitespace from all non-empty lines.
- escape_
table_ ๐cell - Escape a value so it is safe inside a markdown (GFM) table cell:
- find_
contract_ ๐id - Find the HIR
ContractIdfor a contract by name, requiring the contract to live in the source file currently being rendered (compared via absolute path) so contracts that share a file stem acrosssrc/andlib/cannot collide. - first_
notice ๐ - function_
heading ๐ - function_
signature_ ๐anchor - inheritdoc_
base ๐ - Returns the base contract name from
@inheritdoc Base, orNone. - is_
known_ ๐custom_ tag - Returns true if
taglooks like a generally-recognised natspec custom tag. - italicize_
dev ๐ - Italicize a
@devblock by wrapping it in<i>...</i>HTML tags. Surrounding blank lines around the tags ensure MDX/CommonMark parses the inner content as block-level markdown (lists, code fences, multiple paragraphs all work). - render_
constants ๐ - render_
contract ๐ - render_
enum ๐ - render_
error ๐ - render_
event ๐ - render_
free_ ๐functions - render_
function_ ๐section - render_
struct ๐ - render_
udvt ๐ - return_
description ๐ - source
- Render a single Solidity source file as a list of
(relative_output_path, mdx_content)pairs. - split_
first_ ๐word - strip_
one_ ๐ws - write_
code_ ๐block - write_
comment_ ๐block - write_
deployments_ ๐table - Write the Deployments table for a contract page.
- write_
enum_ ๐variants_ table - write_
frontmatter ๐ - write_
git_ ๐source - Write link if
git_urlis set. - write_
param_ ๐table - write_
struct_ ๐properties_ table - yaml_
escape_ ๐double_ quoted - Escape a string for use as a YAML double-quoted scalar.