tytanic-new(1)

📦 version 0.4.1, in nixpkgs unstable

💖 tytanic-new(1) 💖

okay so this is the tytanic-new page from the General Commands Manual, section 1. Bestie, it’s literally the “make a new test” command, and it’s giving fresh test energy. ✨

🌸 NAME 🌸

tytanic-new — create a new test. That’s the whole assignment, no cap. 💅

🦋 SYNOPSIS 🦋

tt new [-k|--type] [-P|--persistent] [-E|--ephemeral]
[-C|--compile-only] [--template] [--no-template] [--timestamp]
[-r|--root] [--warnings] [--diagnostic-format] [-j|--jobs] [--dir]
[--vcs] [--ppi] [--use-embedded-fonts] [--no-use-embedded-fonts]
[--render-bleed] [--export-ephemeral] [--use-system-fonts]
[--no-export-ephemeral] [--no-use-system-fonts] [--font-path]
[--optimize-refs] [--no-optimize-refs] [--package-path]
[--package-cache-path] [--certificate] [--color] [-v|--verbose]...
[-h|--help] <NAME>

✨ DESCRIPTION ✨

Create a new test. Literally that’s the vibe: new test, brand-new test, test creation moment. 🫶

👑 OPTIONS 👑

  • -k, --type <KIND> [default: persistent] — picks what kind of test you’re making. Possible values:
    • persistent — create a persistent test
    • ephemeral — create an ephemeral test
    • compile-only — create a compile-only test
  • -P, --persistent — shorthand for --type=persistent. easy mode ✨
  • -E, --ephemeral — shorthand for --type=ephemeral. 🌀
  • -C, --compile-only — shorthand for --type=compile-only. 🔥
  • --template — use the template (this is the default). 🎀
  • --no-template — don’t use the template. 🙅
  • --timestamp <now|<UNIX_TIMESTAMP>> [default: 0] — the timestamp used for compilation. for more information, see https://reproducible-builds.org/specs/source-date-epoch/. may also be specified with the SOURCE_DATE_EPOCH environment variable. 🕰️
  • -r, --root <ROOT> — the project root directory. if none is given, then the first ancestor with a typst.toml is used. may also be specified with the TYPST_ROOT environment variable. 🌱
  • --warnings <WHAT> [default: emit] — how to handle warnings. Possible values:
    • ignore — ignore warnings
    • emit — emit warnings
    • promote — promote warnings to errors
  • --diagnostic-format <FORMAT> [default: human] — the diagnostic format to use. Possible values:
    • human — display richly formatted messages showing the source code and context
    • short — display short single-line diagnostics
  • -j, --jobs <JOBS> — the number of threads to use for compilation. ⚡
  • --dir <DIR> — the document direction. this is used to correctly align images with different dimensions when generating diff images. defaults to ltr, and can be configured in the manifest. Possible values:
    • ltr — the document is read left-to-right
    • rtl — the document is read right-to-left
  • --vcs <VCS> [default: auto] — the version control system to use. Possible values:
    • auto — auto detect the VCS from the current directory
    • git — Git
    • sapling — a git-compatible VCS developed at Meta
    • jujutsu — a git-compatible VCS
  • --ppi <PPI> — the pixel-per-inch value to use for export. defaults to 144.0, and can be configured in the manifest. 🎨
  • --render-bleed <RENDER_BLEED> — whether the rendered export should have its bleed regions rendered. defaults to false, and can be configured in the manifest. Possible values:
    • true
    • false
  • --export-ephemeral — export ephemeral documents (this is the default). ephemeral documents are those which are created for each test run, i.e. non-persistent ones. 🌀
  • --no-export-ephemeral — don’t export temporaries. 🙅
  • --optimize-refs — optimize persistent references (this is the default). ✨
  • --no-optimize-refs — don’t optimize persistent references. 🚫
  • -h, --help — print help (see a summary with -h). 🆘
  • <NAME> — the name of the new test. this is the star of the show, bestie. 🌟

🎀 FONT OPTIONS 🎀

  • --use-embedded-fonts — use embedded fonts (this is the default). 💖
  • --no-use-embedded-fonts — don’t use embedded fonts.
  • --use-system-fonts — use system fonts. 🖥️
  • --no-use-system-fonts — don’t use system fonts (this is the default).
  • --font-path <DIR> — add a directory to read fonts from (can be repeated). may also be specified with the TYPST_FONT_PATHS environment variable. 🌈

📦 PACKAGE OPTIONS 📦

  • --package-path <DIR> — custom path to local packages, defaults to system-dependent location. may also be specified with the TYPST_PACKAGE_PATH environment variable. 🧚
  • --package-cache-path <DIR> — custom path to package cache, defaults to system-dependent location. may also be specified with the TYPST_PACKAGE_CACHE_PATH environment variable. 🍓
  • --certificate <CERTIFICATE> — path to a custom CA certificate to use when making network requests. may also be specified with the TYPST_CERT environment variable. 🔐

🌈 OUTPUT OPTIONS 🌈

  • --color[=<WHEN>] [default: auto] — when to use colorful output. if set to auto, color will only be enabled if a capable terminal is detected. Possible values:
    • auto
    • always
    • never
  • -v, --verbose — produce more logging output [-v ... -vvvvv]. logs are written to stderr, and the increasing number of verbose flags corresponds to the log levels ERROR, WARN, INFO, DEBUG, TRACE. 🗣️

💖 cute sign-off: footer deets are source/version new, manual tytanic-new(1), and no date was listed on the original footer — so I’m not inventing one, bestie. mwah! 💖

📦 where this page comes from