A.2 Terms#
<t>
[1] rivt Terms#
- API header#
- API headers#
The first line of a rivt string. It includes a section title, followed by comma separated parameters.
- api-history#
API excecution history written to log folder as the file rvDss-api.rst. For the complete execution history see the rivt log file rvDss-log.txt.
- block tag#
A block tag formats a block of text that begins with _[[TAG]] and terminates with _[[Q]].
- command#
- commands#
rivt commands read and write external files and assign values to variables. They start in the initial columns with a vertical bar ( | ) followed by the file path, name and parameters. The path is relative to the rivt report root folder. If the metadata variable rv_localB is set to true resources will be read from and written to the local rivt file folder.
| COMMAND | relative path | parameters
- division#
A group of related rivt files organized in a report and labeled in the rivt file name. Optionally organized in a division folder.
- doc#
- docs#
A formatted document file output using the rivtlib package. A doc is a text, PDF or HTML file with the default name of the rivt file and file type suffix.
- doc number#
Prefix of a rivt and doc file name and used to organize a report. It has the form rvDss-filename.py where D is a capital alphanumeric division number and ss is the subdivision number.
- header#
- headers#
The first line of a rivt string. It includes a section title, followed by comma separated parameters.
- line tag#
A line tag has the form _[TAG] and formats a line of text.
- report#
- reports#
A group of compiled docs organized by rivt file number.
- report folder#
- report folders#
The folder structure for producing a report is described here.
- report script#
A Python script that assembles docs into a report.
- rivt#
An open source Python project that includes rivtlib and approximately two dozen Python packages. When rivt is installed docs and reports may be edited and published using a text editor.
- rivt doc#
- rivt docs#
A formatted document file output from a rivt file using the rivtlib package. A doc is a text, PDF or HTML file with the default name of the rivt file and file type suffix.
- rivt file#
- rivt files#
A Python file that imports rivtlib and includes rivt markup.
- rivt file number#
Prefix of rivt file name used to organize a report (rvDss-). It has the form rvDss-filename.py where D is a capital alphanumeric division number and ss is the subdivision number.
- rivt folder#
A folder containing a rivt file and all of its resources in the same folder. Generally used
- rivt framework#
The recommended rivt-framework includes the following programs, installed separately:
- rivt log file#
rivt file execution log written to the log folder as rvDss-log.txt.
- rivt markup#
A light weight markup that wraps restructuredText and outputs reports in text, PDF and HTML. Markup is included in string arguments to rivt API functions.
- rivt report folder#
A folder containing multiple rivt files to be organized in a report and resources organized in subfolders
- rivt string#
Triple quoted string argument to an API function.
- rivtlib#
Open source Python package that generates docs and reports from a rivt file
- rv-namespace#
- rv-space#
rivt alias name for the global rivt file namespace. Other user namespaces may be specified
- rv_authD#
Metadata that specifies the author, version, email, repository and license information and lists any forks.
- rv_forknD#
Metadata that specifies author information for the fork.
- rv_localB#
Metadata that overrides the default report structure and specifies that all rivt file resources are read from written to the rivt file folder.
- section parameter#
- section parameters#
Comma separated parameters in a header that specify the section processing.
- section text#
The content of a rivt string minus the header.
- single doc#
- single docs#
A document that is not part of a report. It may be published using the local folder rather than the src subfolder. In this case command files and docs are read and written to the rivt file folder.
- stand-alone doc#
A single document that is not part of a report. It uses the local rivt file folder for reading and writing files. doc styling control is limited compared to a report.
<t>
[2] Python Terms#
- docutils#
A Python package that processes restructured text files into HTML, LaTeX, and other formats.
- namespace#
Provides scope for functions and variables.
- Python#
A language
- restructuredtext#
- restructuredtext markup#
A lightweight markup language designed to be processed by document software including docutils, Sphinx and rivt.
<t>
[3] GitHub Terms#
- fork#
duplicate of a software project’s code to create a new, independent version
- repository#
a storage location for software packages
<t>
[4] VSCode Terms#
- profile#
Allows users to customize their VS Code environment for different workflows, projects, or tasks. This feature provides a way to manage distinct configurations of settings, extensions, keyboard shortcuts, snippets, and tasks.