Add a new highlighter that skips lines starting with $
#3306
Labels
type: discussion
Requires active participation to reach a conclusion.
website: eng-doc
DEPRECATED JS engine for /doc
Our intention is to add some automation to document generation. Currently, for a set of commands below, we run the command and add the output by copy/paste. I think it's possible to add semi-automated command blocks.
An example workflow is like:
dvc-doc-runner.py
that takes the source blocks indvcoutput
format, get commands from the lines starting with$
, run them and update the block by commands and outputs. Note that, as we run the script manually, there is no need for site generator (Gatsby) to run these scripts everytime. We only run them when we need.$
. Hence not the commands, but the outputs will be shown.For example, for two command blocks like:
The lines with
$
indvc
will be shown, but the lines with$
indvctableoutput
won't be shown in the HTML output. Only the remaining part with table<<<colored table>>>
(or output) will be shown. This will enable to automate the outputs in the UG and GS on demand, quickly. Also it won't add DVC as a dependency to the site generation.It can have two flavors, one derived from
dvc
that shows the command output as is, one fromdvctable
that shows the colored tables.Originally posted by @iesahin in #2770 (comment)
The text was updated successfully, but these errors were encountered: