Skip to content

show_src ¤

Copies delimitted stanzas within arbitrary files (usually source code) into your docs.

Also creates links to those files on the repo server.

Format within the source file: :docs:matchstring (no space after the colon)

Parameters¤

  • delim: "matchstring" in the example above (without the ":docs:" prefix).
  • dir: Start directly, relative to repo root dir or absolute path
  • hide: Optional. True or String: will result in collapsed block

The plugin uses ripgrep (rg) to find matches.

Example¤

show_src¤

We included this sentence and the header between match strings....

LP Source:

 ```python lp mode=show_src delim=this_example hide="This Example" addsrc dir=src/lcdoc/mkdocs/lp/plugs eval=always
 ```

Result:

This Example
### show_src

We included this sentence and the header between match strings....