# rstast

Dark Mode

- Manual
- Standard library
- Index
- devel, stable

Search:
Group by:

This module implements an AST for the reStructuredText parser.

Note: Import `packages/docutils/rstast` to use this module

# Types

    RstNodeKind = enum
      rnInner, rnHeadline, rnOverline, rnTransition, rnParagraph, rnBulletList,
      rnBulletItem, rnEnumList, rnEnumItem, rnDefList, rnDefItem, rnDefName,
      rnDefBody, rnFieldList, rnField, rnFieldName, rnFieldBody, rnOptionList,
      rnOptionListItem, rnOptionGroup, rnOption, rnOptionString, rnOptionArgument,
      rnDescription, rnLiteralBlock, rnQuotedLiteralBlock, rnLineBlock,
      rnLineBlockItem, rnBlockQuote, rnTable, rnGridTable, rnTableRow,
      rnTableHeaderCell, rnTableDataCell, rnLabel, rnFootnote, rnCitation,
      rnStandaloneHyperlink, rnHyperlink, rnRef, rnDirective, rnDirArg, rnRaw,
      rnTitle, rnContents, rnImage, rnFigure, rnCodeBlock, rnRawHtml, rnRawLatex,
      rnContainer, rnIndex, rnSubstitutionDef, rnGeneralRole, rnSub, rnSup, rnIdx,
      rnEmphasis, rnStrongEmphasis, rnTripleEmphasis, rnInterpretedText,
      rnInlineLiteral, rnSubstitutionReferences, rnSmiley, rnLeaf

  the possible node kinds of an PRstNode Source Edit

    PRstNode = ref RstNode

  an RST node Source Edit

    RstNodeSeq = seq[PRstNode]

  Source Edit

    RstNode {...}{.acyclic, final.} = object
      kind*: RstNodeKind         ## the node's kind
      text*: string              ## valid for leafs in the AST; and the title of
                                 ## the document or the section
      level*: int                ## valid for some node kinds
      sons*: RstNodeSeq          ## the node's sons

  an RST node's description Source Edit

# Procs

    proc len(n: PRstNode): int {...}{.raises: [], tags: [].}

  Source Edit

    proc newRstNode(kind: RstNodeKind): PRstNode {...}{.raises: [], tags: [].}

  Source Edit

    proc newRstNode(kind: RstNodeKind; s: string): PRstNode {...}{.raises: [], tags: [].}

  Source Edit

    proc lastSon(n: PRstNode): PRstNode {...}{.raises: [], tags: [].}

  Source Edit

    proc add(father, son: PRstNode) {...}{.raises: [], tags: [].}

  Source Edit

    proc add(father: PRstNode; s: string) {...}{.raises: [], tags: [].}

  Source Edit

    proc addIfNotNil(father, son: PRstNode) {...}{.raises: [], tags: [].}

  Source Edit

    proc renderRstToRst(n: PRstNode; result: var string) {...}{.raises: [Exception],
        tags: [RootEffect].}

  renders `n` into its string representation and appends to `result`. Source Edit

    proc renderRstToJson(node: PRstNode): string {...}{.raises: [], tags: [].}

  Writes the given RST node as JSON that is in the form

      {
        "kind":string node.kind,
        "text":optional string node.text,
        "level":optional int node.level,
        "sons":optional node array
      }

  Source Edit