ISC-HEI / isc-hei-report

A typst template for reports in the ISC @ HEI curricula

Home Page:https://isc.hevs.ch

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GitHub Repo stars GitHub Release

ISC report template đź“ś

This is an official template for students reports for the ISC degree programme at the School of engineering in Sion.

Using the template

In the Typst web application, start with the modern-isc-report and voilĂ  ! Using the CLI, you can initialize the project with the command :

typst init @preview/modern-isc-report:0.1.0

This template will initialize an sample report with sensible default values.

Installing fonts locally

If you are running typst locally, you might miss some of the required fonts. For your convenience, all the required fonts are included in this repos. As all the fonts are released under the SIL Open Font License, there are no file inclusion issues here.

To the install the fonts locally in a Linux environment, simply type

source install_fonts.sh

from within the fonts directory.

PDF images inclusion

Unfortunately, typst does not support PDF file types inclusion at the time of writing this documentation. As a temporary workaround, PDF files can be converted to SVG via pdf2svg.

Usage

When used locally, creating a PDF is straightforward with the command

typst compile report.typ

Even nicer, the following command compiles the report every time the file is modified.

typst watch report.typ

Another nice possibility is of course to use a VScod[e | ium] via the Typst LSP plugin which enables direct compilation.

Future changes

In the future, several things might be updated, such as :

  • Acronyms inclusion
  • Multiple languages (FR/EN)
  • Nice tables examples
  • State diagrams and UML diagrams examples
  • Appendix
  • Glossary inclusion
  • Master thesis version of this template
  • Themes for code
  • Other nice things

Questions and help

If you need any help for installing or running those tools, do not hesitate to get in touch with its maintainer pmudry.

You can of course also propose changes using PR or raise issues if something is not clear. Have fun writing reports!

About

A typst template for reports in the ISC @ HEI curricula

https://isc.hevs.ch

License:MIT License


Languages

Language:Typst 75.1%Language:TeX 22.4%Language:Shell 2.5%