Command Line
jtex can be used as a package as well as a command-line interface. It is most common that you will be using jtex as a component of the myst ecosystem, however, if you are contributing or building your own template locally, there are a number of tools that can help you validate and build your template.yml. To install the command line tools use:
npm install -g jtex#Rendering
To render a template, you need to have the template directory defined, as well as content.tex and a frontmatter.yml.
jtex render content.tex output/folder --frontmatter ./frontmatter.yml --template my/template/folder#Building Templates
#jtex check [folder] [--fix]
Without a folder, it will use the current directory. You can use the --fix argument to automatically add packages and known arguments to your template.yml.
jtex check arxiv_two_column
> template.yml
> [parts.0] 'parts.0' extra key ignored: chars
> template.tex
> [options] The following options were not referenced in the template: "show_date"
> [options] The template.yml does not include "watermark" but it is referenced in template.tex on line 57
> jtex found warnings or errors in validating your template.#jtex parse [file]
To see the contents of your template that are rendered.
jtex parse arxiv_two_column/template.tex
> Doc:
> title line 53
> authors lines 72, 75
> keywords lines 95, 96
>
> Options:
> watermark line 57
> link lines 116, 119
>
> Parts:
> abstract lines 89, 91
> acknowledgments lines 108, 112
>
> Packages:
> preprint line 2
> lipsum line 3
> amsthm line 19
> fontenc line 20#jtex list
List all known public templates.
jtex list
> EarthArXiv (Two Column) eartharxiv_two_column
> Description: A two column preprint template for EarthArXiv with the AGU bibstyle
> Tags: paper, two-column, geoscience, earthscience, preprint
>
> arXiv (Two Column) arxiv_two_column
> Description: A two column arXiv compatible template
> Tags: paper, two-column, preprint, arxiv, bioarxiv, eartharxivYou can also filter by --tag two-column or any comma seperated tags that will be used to filter the list.
#jtex list [template]
To find the details on a single template use:
jtex list volcanica
> Volcanica volcanica
> ID: public/volcanica
> Version: 1.0.0
> Author: Volcanica
> Description: A template for submissions to the Volcanica journal
> Tags: paper, journal, two-column, geoscience, earthscience