id          = "presenterm"
name        = "presenterm"
homepage    = "https://github.com/mfontanini/presenterm"
description = "A markdown terminal slideshow tool."
executables      = ["presenterm"]

[dotfiles]
paths       = ["~/.config/presenterm/config.yaml", "~/.config/presenterm/themes/"]

secret      = []

# Presenterm's official changelog and documentation name this config file and
# the themes directory under ~/.config/presenterm.
# https://github.com/mfontanini/presenterm/blob/master/CHANGELOG.md
# https://mfontanini.github.io/presenterm/features/custom-themes/


[commands]
format = 1
label = "Present slides"
description = "Open a Markdown file as a terminal slideshow, pick a built-in theme, or export it. Speaker-note publishing and listening are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "docs"
kind = "manual"
url = "https://github.com/mfontanini/presenterm/tree/master/docs/src"
revision = "2026-10-27"
evidence = """
presenterm examples/demo.md
Unless you run in presentation mode by passing in the `--present` parameter, _presenterm_ will automatically reload your
Passing in the `--theme` parameter when running _presenterm_ to select one of the built-in themes.
presenterm --list-themes
presenterm --export-pdf examples/demo.md
presenterm --export-html examples/demo.md
"""

[[commands.field]]
id = "file"
label = "Markdown file"
type = "path"
position = 0
path = { kind = "file", role = "input" }
sources = ["docs"]

[[commands.field]]
id = "present"
label = "Presentation mode"
description = "Disable automatic reload of the file."
type = "boolean"
option = ["--present"]
sources = ["docs"]

[[commands.field]]
id = "theme"
label = "Theme"
description = "Name of a built-in theme; run with --list-themes to see them."
type = "string"
option = ["--theme"]
sources = ["docs"]

[[commands.field]]
id = "export_pdf"
label = "Export to PDF"
type = "boolean"
option = ["--export-pdf"]
effect = "overwrite"
sources = ["docs"]

[[commands.field]]
id = "export_html"
label = "Export to HTML"
type = "boolean"
option = ["--export-html"]
effect = "overwrite"
sources = ["docs"]

[[commands.field]]
id = "list_themes"
label = "List built-in themes"
type = "boolean"
option = ["--list-themes"]
sources = ["docs"]

[[commands.task]]
id = "present"
label = "Present a file"
set = { present = [true] }
fields = ["file", "present", "theme"]
required = ["file"]

[[commands.task]]
id = "export-pdf"
label = "Export to PDF"
set = { export_pdf = [true] }
lock = ["export_pdf"]
fields = ["file", "export_pdf"]
required = ["file"]

[[commands.task]]
id = "themes"
label = "List themes"
set = { list_themes = [true] }
lock = ["list_themes"]
fields = ["list_themes"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["file", "present", "theme"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["export_pdf", "export_html", "list_themes"]