Options
Regardless of your entrypoint, the options available are going to be the same.
Include
Includes a file within a codeblock. The file path must originate from the same directory as mkdocs.yml
.
For example, let's say we have the following structure:
mkdocs.yml
docs/
index.md
src/
intro01.py
intro02.py
To include intro01.py
into a Termage block within index.md
, you could use:
```termage include=docs/src/intro01.py
print("Code from the original codeblock is retained!")
```
Info
The include
option will always "prefix" the actual codeblock's value with whatever is included.
As such, if docs/src/intro01.py
had the content:
print("Included text will always preface the real value of a codeblock")
Termage will parse the block as:
```termage <options>
print("Included text will always preface the real value of a codeblock")
print("Code from the original codeblock is retained!")
```
Hide lines
The plugin has a special bit of syntax to signify Run this line of code, but don't display it
. It is denoted by prefacing any hidden line with an ampersand (&):
```termage title=Hidden\ lines
&from pytermgui.pretty import print
print(locals())
```
print(locals())
Width and Height
Sets the terminal's dimension of the given axis. Must be given an integer, which will be taken as a character-count.
Info
If no dimensions are provided, they default to (80, 24).
Foreground & Background
Modifies the terminal's default colors. foreground
is used for all non-styled text, and background is used as both the background to the terminal's contents as well as the window that it emulates.
Info
Foreground defaults to #DDDDDD, and background defaults to #212121.
Tabs
Sets the text labels of each of the tabs.
Accepts two values, delimited by a single ,
. The first value is used for the Python code, and the second is used for the SVG output.
import pytermgui as ptg
with ptg.WindowManager() as manager:
manager.layout.add_slot()
manager.add(ptg.Window("Some window", box="EMPTY"))
import pytermgui as ptg
with ptg.WindowManager() as manager:
manager.layout.add_slot()
manager.add(ptg.Window("Some window", box="EMPTY"))
Title
Sets the title at the top of the output terminal.
Warning
When using the plugin, make sure to escape any spaces present in your title!
For example, instead of title=My title
, or title="My title"
use title=My\ Title
.