Crates.io | itex |
lib.rs | itex |
version | 1.3.5 |
source | src |
created_at | 2023-02-08 19:29:50.164684 |
updated_at | 2023-06-20 10:36:32.81908 |
description | Initialize a LaTex project inside a folder instantly |
homepage | |
repository | |
max_upload_size | |
id | 780185 |
size | 131,752 |
Initialize a latex project in the current folder
Usage:
Usage: itex <COMMAND>
Commands:
build Build ITex project (requires an itex-build.toml file, and pdflatex to be installed)
count Count the number of words in the current ITex project (requires texcount to be installed)
clean Clean auxillary build files
init Initialize LaTex project
info Get info about a template
get Get current value of a setting
list List installed templates
new-buildfile Create a new itex build file
set Set a setting
update Update installed templates
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
available templates:
The first step is to install itex, see install on windows or macos to install on your platform of choice.
To copy a template use:
itex init <template name>
To get a list of template names use:
itex list
after copying a template use:
itex build
to build the project.
If there is an error in your project use:
itex build --debug
to get debug output.
ITex gives you some options to control how the project is built. Use:
itex get
To get the full list of options.
By default only the default_filename is set.
If you changed your tex filename from main.tex to something else, you are also going to want to change this to the new name of the file.
itex set default_filename <Insert filename here (without the .tex)>
A description of all the options can be found in the wiki here: https://github.com/oneelectron/itex/wiki/ITex-settings
ITex isn't on homebrew's default taps so you need to add my tap then install ITex:
brew tap oneelectron/oneelectron
brew install itex -s
ITex doesn't have a windows installer yet, so the recommended way is to use cargo to install itex, then use itex to install it's template folder. Install rust then:
cargo install itex
itex update
Installing on linux is the same as on windows because there no package managers that have ITex on their lists. With more users and support this could change, but for now:
cargo install itex
itex update
Users can run itex build in order to build their LaTex project. Doing this requires the ITex to know which file to compile, this is specified in the itex-build.toml which looks something like this:
default_filename = "main"
tex_filename = "example.tex"
default_filename specifies the base name for any files
tex_filename specifies the name of the main tex file. If this option is not specified itex will assume the default_filename + .tex. In this example main.tex, if tex_filename were not specified
To make a new template make a folder where the name of the folder is the template name as this is what ITex uses.
An itex-info.toml is also required with a name and description:
name = "Default"
description = "The default template."
To setup the development environment: