D.2 | Block Tags

[1] Block Tag Summary

Run Format blocks of text or scripts

API Scope	Block Tag	Description
rv.R	_[[PYTHON]] label	[7] Python
rv.R,I	_[[MARKUP]] type	[9] Markup block
rv.I	_[[BOX]] label	[6] Box
rv.I	_[[TOPIC]] topic	[5] Topic
rv.I,V	_[[TABLE]] label	[4] Table Block
rv.V	_[[ARGS]] arg dict name	[8] Argument block
rv.T	_[[WRITE]] var name	[7] Write Block
rv.T	_[[SHELL]] os, wait;nowait	[9] Shell script
rv.D	_[[METADATA]] label	[10] Metadata
all	_[[END]]	[11] End block

[9] Markup block

_[[MARKUP]] type

Inserts formatted text into doc.

• literal

• html

• reST

• python

• endnote

• center

• bold

• italic

• mermaid (node and mermaid-cli must be installed)

• latex (texlive must be installed)

Syntax:
    _[[MARKUP]]
    markup
    ...
    _[[END]]

Example:
    _[[MARKUP]] rst
    This is **bold** and
    this is *italic* in
    reStructuredtext
    ...
    _[[END]]

API Scope	Run
Doc Types	text, PDF, HTML

---

[7] Python

_[[PYTHON]]

Executes Python script in the rivt namespace or a user specified namespace. File paths in the script are relative to the rivt file folder.

Syntax:
    _[[Python]] topic title
    code
    ...
    _[[END]]

Example:
    _[[PYTHON]] *rvspace*; user namespace
    b = 1*inch + 2.2*ft
    print(b)
    _[[END]]

API Scope	Value, Run
Doc Types	text, PDF, HTML

---

[3] String

_[[STRING]] var name

Formats a Python fstring with

Syntax:
    _[[ENDNOTES]] label
    Endnote 1.

    Endnote 2.
    ...
    _[[END]]

Example:
    _[[ENDNOTES]] ACI citations
    This endnote is assigned to the first endnote tag (_[#]) in order of
    of processing.

    This second endnote is separated by a blank line and assigned
    to the second

    This is a third endnote.
    _[[END]]

API Scope	Insert
Doc Types	text, PDF, HTML

---

[4] Table Block

_[[TABLE]]

Reads and formats restructured text table and writes contents to csv file in the _stored/Vals folder. .. code-block:: text

Syntax:

_[[TABLE]] label reST table … _[[END]]

Example:

_[[TABLE]] my_table ===== ====== Name Age ===== ====== John 25 Jane 30 ===== ===== _[[END]]

API Scope	Insert
Doc Types	text, PDF, HTML

---

[5] Topic

_[[TOPIC]]

Formats a topic block.

Syntax:
    _[[TOPIC]] topic title
    text
    ...
    _[[END]]

Example:
    _[[TOPIC]] topic title
    Text related to the topic.
    _[[END]]

API Scope	Insert
Doc Types	text, PDF, HTML

---

[6] Box

_[[BOX]] label

Draws a box around the block of text.

Syntax:
    _[[BOX]] optional label
    text
    ...
    _[[END]]

Example:
    _[[BOX]] box1
    This is a sentence.
    A second sentence.
    A box is drawn around the sentences.
    _[[END]]

API Scope	Insert
Doc Types	text, PDF, HTML

---

[7] Write Block

_[[WRITE]] rel file path

Updates variables in templates and writes file to report folder.

Syntax:
    _[[WRITE]] relative file path
    text or script
    ...
    _[[END]]

Example:
    _[[WRITE]] rvsrc/script.py
    for i in range(2):
        print(f"{vars}",i)
    _[[END]]

API Scope	Tools
Doc Types	text, PDF, HTML

---

[8] Argument block

_[[ARG]] arg_name

Organizes function arguments into a dictionary that may be passed to the FUNCTION command.

Syntax:
    _[[ARGS]] arg_dictionary_name | list of units
    arg1 = A # label
    arg2 = B # label
    ...
    _[[END]]

Example:
    _[[ARGS]] beam1 | units: inch, pounds
    ln_1 = 10*12 # beam length
    P_1 = 1.1*1000 # beam load
    ...
    _[[END]]

API Scope	Values
Doc Types	text, PDF, HTML

---

[9] Shell script

Runs shell scripts that run external programs. The shell parameters include specifying the operating system, process control and terminal window control. The os parameter specifies the terminal type. The wait parameter specifies whether rivt file processing waits for the script to complete before continuing. The open parameter specifies whether to keep the shell window open after execution.

_[[SHELL]]

Syntax:
    _[[SHELL]] win;mac;linux,wait; nowait,open; close
    shell command
    ...
    _[[END]]


Example:
    _[[SHELL]] win,nowait,open
    dir
    path
    _[[END]]

API Scope	Tools
Doc Types	text, PDF, HTML

---

[10] Metadata

_[[METADATA]]

Metadata is written to the rvAnn-apilog.py file and is converted internally to a Python dictionary rvmetaD with key name taken from the label e.g. docnameS or authorsD.

Synatax - defaults:
    _[[METADATA]] optional label
    docname = ""
    authors = ""
    version = 0.0.0
    email = ""
    repo = ""
    license = https://opensource.org/license/mit
    fork1 = author, version, email, repo
    fork2 = author, version, email, repo
    _[[END]]

Example:
    _[[METADATA]]
    docname = Bearing Pressures
    authors = rholland, rward
    version = 0.1.1
    email = rholland@email.com
    repo = https://github.com/rivt-info/rivt-simple-doc
    license = https://opensource.org/license/mit
    _[[END]]

API Scope	Docs
Doc Types	text, PDF, HTML

---

[11] End block

_[[END]]

Terminates a block tag.

Syntax:
    _[[NEWPAGE]] optional label

Example:
    _[[END]]

API Scope	All
Doc Types	text, PDF, HTML