https://github.com/jaybosamiya/latex-paper-template
:book: A template to get quickly started with any LaTeX project. Features a very convenient build system, using latexrun.
https://github.com/jaybosamiya/latex-paper-template
Last synced: about 1 year ago
JSON representation
:book: A template to get quickly started with any LaTeX project. Features a very convenient build system, using latexrun.
- Host: GitHub
- URL: https://github.com/jaybosamiya/latex-paper-template
- Owner: jaybosamiya
- Created: 2019-05-03T22:15:38.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2025-01-24T23:44:20.000Z (over 1 year ago)
- Last Synced: 2025-03-30T14:22:11.406Z (over 1 year ago)
- Language: Python
- Homepage:
- Size: 81.1 KB
- Stars: 9
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: changebarmodified.sty
Awesome Lists containing this project
README
# LaTeX Paper Template
This repository is a template to have a good point to start from for
writing a paper/report/homework/assignments using LaTeX.
It uses a nice build system
([latexrun](https://github.com/aclements/latexrun)) which makes it
much easier to notice build-errors etc. All necessary components are
kept within this repository, and all you should need is a proper LaTeX
installation, `make` and `python3`.
## How to Use
Run `make` to build, and `make clean` to clean up.
This should automatically do the right thing to build your PDFs. If
`make` is unable to make a decision, it will ask you to configure the
`Makefile` by giving you the right instructions. In particular,
irrespective of how many `.tex` files are in the current directory, it
will try to figure out the best course of action based on the files,
and if it cannot, then it will recommend setting up a configuration
variable to guide it.
## Setting up a listener to auto-recompile whenever you save
Make sure you have [fswatch](https://github.com/emcrisostomo/fswatch)
installed, and then run `make watch`. This will set up a watcher
that will automatically call `make` for you. To stop the watcher,
simply press Ctrl-C.
## How to make pretty PDF diffs
If you are in `MAIN_TARGET` mode, then the `make diff-*` set of
commands are unlocked. They can be used to get a diff against any git
commit, easily. For example `make diff-abcde` will create a new PDF
file with a diff against the commit `abcde`.
To make it more convenient to do such diffs, however, you can set up
the `DIFF_REVISIONS` variable, which will automatically unlock the
`make diff` command which will perform a diff against all the
revisions specified.
Requires `latexdiff` to be installed on your system. Can be installed
via `sudo apt install latexdiff` or similar command based on your
package manager.
## How to make pretty standalone HTML
If you set up `HTML_GENERATION` variable to a non-empty value, after
installing
[`pdf2htmlEX`](https://coolwanglu.github.io/pdf2htmlEX/). This should
generate a (standalone) HTML file beside each PDF generated.
## Updating to the latest Makefile
Run `make update-makefile` to update to the latest version of the
Makefile.