mantys

MANuals for TYpSt

Template for documenting typst packages and templates.

Usage

Just import the package at the beginning of your manual:

#import "@preview/mantys:0.1.4": *

Mantys supports Typst 0.11.0 and newer.

Writing basics

A basic template for a manual could look like this:

#import "@local/mantys:0.1.4": *

#import "your-package.typ"

#show: mantys.with(
	name:		"your-package-name",
	title: 		[A title for the manual],
	subtitle: 	[A subtitle for the manual],
	info:		[A short descriptive text for the package.],
	authors:	"Your Name",
	url:		"https://github.com/repository/url",
	version:	"0.0.1",
	date:		"date-of-release",
	abstract: 	[
		A few paragraphs of text to describe the package.
	],

	example-imports: (your-package: your-package)
)

// end of preamble

# About
#lorem(50)

# Usage
#lorem(50)

# Available commands
#lorem(50)

Use #command(name, ..args)[description] to describe commands and #argument(name, ...)[description] for arguments:

#command("headline", arg[color], arg(size:1.8em), sarg[other-args], barg[body])[
	Renders a prominent headline using #doc("meta/heading").

	#argument("color", type:"color")[
    The color of the headline will be used as the background of a #doc("layout/block") element containing the headline.
  ]
  #argument("size", default:1.8em)[
    The text size for the headline.
  ]
  #argument("sarg", is-sink:true)[
    Other options will get passed directly to #doc("meta/heading").
  ]
  #argument("body", type:"content")[
    The text for the headline.
  ]

  The headline is shown as a prominent colored block to highlight important news articles in the newsletter:

  #example[```
  #headline(blue, size: 2em, level: 3)[
    #lorem(8)
  ]
  ```]
]

The result might look something like this:

For a full reference of available commands read the manual.

Changelog

Version 0.1.4

• Fix missing links in outline (@tingerrr).
• Fixed problem when evaluating default values with Tidy.

Version 0.1.3

• Fix for some datatypes not being displayed properly (thanks to @tingerrr).
• Fix for imbalanced outline columns (thanks again to @tingerrr).

Version 0.1.2

• Added hydra for better detection of headings in page headers (thanks to @tingerrr for the suggestion).
• Fixed problem with multiple quotes around default string values in tidy docs.
• Fixed datatypes linking to wrong documentation urls.

Version 0.1.1

• Added template files for submission to Typst Universe.

Version 0.1.0

• Refactorings and some style changes
• Updated manual.
• Restructuring of package repository.

Version 0.0.4

• Added integration with tidy.
• Fixed issue with types in argument boxes.
• #lambda now uses #dtype

Breaking changes

• Adapted scope argument for eval in examples.
  • #example(), #side-by-side() and #shortex() now support the scope and mode argument.
  • The option example-imports was replaced by examples-scope.

Version 0.0.3

• It is now possible to load a packages’ typst.toml file directly into #mantys:

  #show: mantys.with( ..toml("typst.toml") )
  

• Added some dependencies:
  • jneug/typst-tools4typst for some common utilities,
  • jneug/typst-codelst for rendering examples and source code,
  • Pablo-Gonzalez-Calderon/showybox-package for adding frames to different areas of a manual (like examples).
• Redesign of some elements:
  • Argument display in command descriptions,
  • Alert boxes.
• Added #version(since:(), until:()) command to add version markers to commands.
• Styles moved to a separate theme.typ file to allow easy customization of colors and styles.
• Added #func(), #lambda() and #symbol() commands, to handle special cases for values.
• Fixes and code improvements.

Version 0.0.2

• Some major updates to the core commands and styles.

Version 0.0.1

• Initial release.