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....