stevengogogo / ReportTex

A LaTeX template for reports. Supported by Tectonic/Github CI/makefile

ReportTeX: A LaTeX template supporting both English and Traditional Chinese

ReportTeX is a LaTeX pipeline for generating reports and manuscripts. This template uses tectonic engine to avoid cumbersome installation of MacTex (just try brew install tectonic :) ), and this is an big life-saver !

This pipeline also supports Chinese characters, which are difficult to render with the TeX engine. Fourtunely, tectonic is based on XeTeX which supports UTF8 characters. The sample below is the output of a mixture of English and Manderin words:

Besides, this CI provides early bug detection and helps you to fix tex file during composition. To my knowlege, this is the easist pipeline to work on Latex with Manderin article. Enjoy😄.

How to build main.tex?

In the terminal simply type

make

or

make build

or if you don't have make

tectonic main.tex

How is this repo organized?

FileName	Description
main.tex	Write your article here
setup.tex	Layout setting. You can customize your setting here, or put template permeable
library.bib	Reference collection
fig/	Image folder
makefile	Script for generating PDF output. Type make in terminal
.github	Continuous Integration with tectonic, a modern LaTeX compiler written in Rust
fonts.txt	URLs of additional fonts. If you want more, please visit the noto font website and append the url(s) to it.

Notice that Manderin fonts is usually cumbersome to setup. This process is largely redueced by @sosiristseng

How to work on the TeX file(s) locally

Linux

1. Install tectonic
2. Install addtional fonts if needed, for example, sudo apt install in Ubuntu-based systems.
3. tectonic main.tex and profit!

Also see the Gihub CI config file

MacOS

• Install fonts

  • Download Noto Font：
  • Put .otf into FontBook (A build-in software in MacOS for organizing fonts)

• Install tectonic

  brew install tectonic

• 🎉 Complete installation: The PDF can be built by typing

  make
  

  in terminal. The automation is supported by the makefile. Change it if you need customization.

Features

• Tectonic
  • Easy installing
  • Auto downloading sty files
  • Light and fast
• Self-hosted
  • No need to limit to Overleaf's IDE
  • Allow to use Git branches for precise version control
• Github CI
  • Allow testing before merging to your final results
  • Detect errors / bugs early.