Releases: tfachada/thesist
v1.0.0
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 inputpagebreak(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 variablepic-mode
now no longer hides the committee, with the variablehide-committee
doing it instead. (thanks in part @samuelbarata) -
⚠️ Breaking: Removedhide-glossary
, as it is now unneeded. The PIC settinghide-abstract
has been split intohide-abstract-en
andhide-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, thein-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 yoursubfigure-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.
v0.2.0
-
Now compliant with Typst 0.12. This solves the warnings about deprecated features and fixes page numbering, which was broken by this Typst release. 0.12 is now also the minimum version accepted by this template. This is potentially breaking. If you aren't able to compile, please update your compiler.
-
The implementation of the Glossary has been overhauled, owing in part to the upstream updates of the
glossarium
package, which is now also 0.12-compliant. Since the Glossary is not part of the package portion of ThesIST, but rather a part of the user-modifiable part, user action is required if you created your thesis document before this update: please make sure that yourGlossary.typ
now follows the structure shown here*, and update all yourglossarium
import statements to 0.5.0 at least.
*- Edit: Now linking the v1.0.0 glossary instead, due to typo corrections and general improvements.
-
Per general style recommendations, figure captions are now positioned on top for non-image figures.
-
PIC2 reports are now supported!
-
Improved Quick Guide.