Skip to content

v1.0.0

Latest
Compare
Choose a tag to compare
@tfachada tfachada released this 10 Jan 14:51
· 3 commits to main since this release

This release includes major rewrites and as such has several breaking changes. Instructions are given at the end of this log on what to change if you are updating from 0.2.0.

Due to the resolution of key issues, ThesIST is now in the 1.x release cycle.

What's changed

Headings

  • ⚠️ Breaking: You no longer need to manually input pagebreak(to: "odd") before a new chapter, as chapter headings now take care of that. This was the original idea before the first version, but got initially scraped due to an oversight. (thanks @samuelbarata)

  • Introducing heading styles! For chapter headings, you can now choose between the short style, based on the chapter headings used by ThesIST until now, and the simple and fancy styles, based on the headings used by different IST LaTeX templates. You can pick a different heading style for chapters and appendices if you want. (thanks in part @samuelbarata)

  • Other adjustments to headings in general, with more conventional font size and spacing.

PIC settings and "hide" variables

  • ⚠️ Breaking: The PIC settings are now significantly more flexible, with added options to change more things in the cover or front matter that a supervisor might not want to see in a PIC2 report. Breaking because the variable pic-mode now no longer hides the committee, with the variable hide-committee doing it instead. (thanks in part @samuelbarata)

  • ⚠️ Breaking: Removed hide-glossary, as it is now unneeded. The PIC setting hide-abstract has been split into hide-abstract-en and hide-abstract-pt.

  • You no longer need to manually hide lists of figures/tables/etc if they're empty. They will now automatically appear/disappear based on whether there is content to index. The hide-*-list variables still exist, but are now PIC settings.

Figures

  • ⚠️ Breaking: Subfigure grids can now detect if they're in a chapter or an appendix. Due to this, the in-appendix parameter has been removed, and you no longer need to worry about specifying it.

  • Better default gaps between figures and captions.

Cover

  • Reworked cover layout. Now the spacing is a bit more even, and there is no risk of accidentally dropping things to another page.

  • New Alameda campus default cover image, and a Taguspark campus default cover image is now also included! (thanks @samuelbarata)

Others

  • You can now add an extra page before the acknowledgments if you want! This new feature is inspired by some IST LaTeX templates, and allows you to include a dedication, a quote, a brag about using Typst...

  • If you're writing the document in Portuguese, the Portuguese abstract will now show up before the English one.

  • Fixed #cite() links not having the same default color as their alternative @form.

  • Greatly improved documentation, with typo/oversight corrections and more examples.

Required user action

Upon updating from thesist:0.2.0 to thesist:1.0.0, make sure to do the following:

  • Replace all of your main.typ with the one available here, and then fill in the fields again. Erase the PIC settings in it if you're writing a thesis. Don't re-add pagebreaks!

  • Erase the in-appendix specifications in all of your subfigure-grid calls.

  • Re-check any #v() spacers you have added to figure/subfigure captions. You probably no longer need them.

Optionally, you can also get the new Quick guide, available here, for some improved explanations. Note that the example image is now example.jpg and that some example glossary calls are changed.