diff --git a/docs/src/general/changelog.md b/docs/src/general/changelog.md index 4d8c48677..a2b2ae9dc 100644 --- a/docs/src/general/changelog.md +++ b/docs/src/general/changelog.md @@ -6,84 +6,115 @@ description: | # Changelog ## Unreleased -- **Breaking:** When using the CLI, you now have to use subcommands: - - `typst compile file.typ` or `typst c file.typ` to create a PDF - - `typst watch file.typ` or `typst w file.typ` to compile and watch - - `typst fonts` to list all fonts -- **Breaking:** Manual counters now start at zero. Read the "How to step" - section [here]($func/counter) for more details -- **Breaking:** Renamed the `{"author-date"}` and `{"author-title"}` - [bibliography styles]($func/bibliography.style) to `{"chicago-author-date"}` - and `{"chicago-author-title"}` -- Added support for clipping in [boxes]($func/box.clip) and - [blocks]($func/block.clip) -- Added [`polygon`]($func/polygon) function for drawing polygons -- Added [`yaml`]($func/yaml) function to load data from YAML files -- The [`link`]($func/link) function now accepts [labels]($func/label) -- The [`bibliography`]($func/bibliography) now also accepts multiple - bibliography paths (as an array) -- Parsing of BibLaTeX files is now more permissive (accepts non-numeric edition, - pages, volumes, dates, and Jabref-style comments, fixed abbreviation parsing) -- Labels and references can now include `:` and `.` if not at the end -- Added basic i18n for a few more languages (IT, RU, ZH, FR, PT) -- Added numbering support for Hebrew -- Added support for [integers]($type/integer) with base 2, 8, and 16 -- Added symbols for double bracket and laplace operator -- The link syntax now allows more characters -- Improved justification of Japanese and Chinese text -- Calculation functions behave more consistently w.r.t to non-real results -- Replaced deprecated angle brackets -- Reduced maximum function call depth from 256 to 64 -- CLI now returns with non-zero status code if there is an error -- CLI now watches the root directory instead of the current one -- CLI now puts PDF file next to input file by default -- CLI now accepts more kinds of input files (e.g. `/dev/stdin`) -- CLI now has an `--open` flag to directly open the PDF -- Fixed block spacing, e.g. in `{block(above: 1cm, below: 1cm, ..)}` -- Fixed extraneous spacing in unary operators in equations -- Fixed APA bibliography ordering -- Fixed styling of text operators in math -- Fixed invalid parsing of language tag in raw block with a single backtick -- Fixed bugs with displaying counters and state -- Fixed crash related to page counter -- Fixed crash when [`symbol`]($func/symbol) function is called without arguments -- Fixed crash in bibliography generation -- Fixed access to label of certain content elements -- Fixed line number in error message for CSV parsing -- Fixed invalid autocompletion after certain markup elements +- **Breaking changes:** + - When using the CLI, you now have to use subcommands: + - `typst compile file.typ` or `typst c file.typ` to create a PDF + - `typst watch file.typ` or `typst w file.typ` to compile and watch + - `typst fonts` to list all fonts + - Manual counters now start at zero. Read the "How to step" section + [here]($func/counter) for more details + - The [bibliography styles]($func/bibliography.style) + `{"author-date"}` and `{"author-title"}` were renamed to + `{"chicago-author-date"}` and `{"chicago-author-title"}` + +- Figure improvements + - Figures now automatically detect their content and adapt their + behaviour. Figures containing tables, for instance, are automatically + prefixed with "Table X" and have a separate counter + - The figure's supplement (e.g. "Figure" or "Table") can now be customized + - In addition, figures can now be completely customized because the show rule + gives access to the automatically resolved kind, supplement, and counter + +- Bibliography improvements + - The [`bibliography`]($func/bibliography) now also accepts multiple + bibliography paths (as an array) + - Parsing of BibLaTeX files is now more permissive (accepts non-numeric + edition, pages, volumes, dates, and Jabref-style comments; fixed + abbreviation parsing) + - Labels and references can now include `:` and `.` except at the end + - Fixed APA bibliography ordering + +- Drawing additions + - Added [`polygon`]($func/polygon) function for drawing polygons + - Added support for clipping in [boxes]($func/box.clip) and + [blocks]($func/block.clip) + +- Command line interface + - Now returns with non-zero status code if there is an error + - Now watches the root directory instead of the current one + - Now puts the PDF file next to input file by default + - Now accepts more kinds of input files (e.g. `/dev/stdin`) + - Added `--open` flag to directly open the PDF + +- Miscellaneous improvements + - Added [`yaml`]($func/yaml) function to load data from YAML files + - Added basic i18n for a few more languages (IT, RU, ZH, FR, PT) + - Added numbering support for Hebrew + - Added support for [integers]($type/integer) with base 2, 8, and 16 + - Added symbols for double bracket and laplace operator + - The [`link`]($func/link) function now accepts [labels]($func/label) + - The link syntax now allows more characters + - Improved justification of Japanese and Chinese text + - Calculation functions behave more consistently w.r.t to non-real results + - Replaced deprecated angle brackets + - Reduced maximum function call depth from 256 to 64 + - Fixed [`first-line-indent`]($func/par.first-line-indent) being not applied + when a paragraph starts with styled text + - Fixed extraneous spacing in unary operators in equations + - Fixed block spacing, e.g. in `{block(above: 1cm, below: 1cm, ..)}` + - Fixed styling of text operators in math + - Fixed invalid parsing of language tag in raw block with a single backtick + - Fixed bugs with displaying counters and state + - Fixed crash related to page counter + - Fixed crash when [`symbol`]($func/symbol) function was called without + arguments + - Fixed crash in bibliography generation + - Fixed access to label of certain content elements + - Fixed line number in error message for CSV parsing + - Fixed invalid autocompletion after certain markup elements + + +Thanks to everybody who contributed to this release! ## March 28, 2023 -- **Breaking:** Enumerations now require a space after their marker, that is, - `[1.ok]` must now be written as `[1. ok]` -- **Breaking:** Changed default style for [term lists]($func/terms): Does not - include a colon anymore and has a bit more indent -- Fixed bibliography ordering in IEEE style -- Fixed parsing of decimals in math: `[$1.2/3.4$]` -- Fixed parsing of unbalanced delimiters in fractions: `[$1/(2 (x)$]` -- Fixed unexpected parsing of numbers as enumerations, e.g. in `[1.2]` -- Fixed combination of page fill and header -- Fixed compiler crash if [`repeat`]($func/repeat) is used in page with - automatic width -- Fixed [matrices]($func/mat) with explicit delimiter -- Fixed build of CLI if `git` is not installed -- Links in bibliographies are now affected by link styling -- Added support for disabling [matrix]($func/mat) and [vector]($func/vec) - delimiters. Generally with `[#set math.mat(delim: none)]` or one-off with - `[$mat(delim: #none, 1, 2; 3, 4)$]`. -- Added [`separator`]($func/terms.separator) argument to term lists -- Fixed [`indent`]($func/terms.indent) property of term lists -- Added [`round`]($func/round) function for equations -- Numberings now allow zeros. To reset a counter, you can write - `[#counter(..).update(0)]` -- Added `--font-path` argument for CLI -- Added Nix flake -- Numerous documentation fixes -- Added documentation for `{page()}` and `{position()}` methods on - [`location`]($func/locate) type -- Added symbols for double, triple, and quadruple dot accent -- Added smart quotes for Norwegian Bokmål -- Fixed hovering over comments in web app -- Embedded default fonts in CLI binary +- **Breaking changes:** + - Enumerations now require a space after their marker, that is, `[1.ok]` must + now be written as `[1. ok]` + - Changed default style for [term lists]($func/terms): Does not include a + colon anymore and has a bit more indent + +- Command line interface + - Added `--font-path` argument for CLI + - Embedded default fonts in CLI binary + - Fixed build of CLI if `git` is not installed + +- Miscellaneous improvements + - Added support for disabling [matrix]($func/mat) and [vector]($func/vec) + delimiters. Generally with `[#set math.mat(delim: none)]` or one-off with + `[$mat(delim: #none, 1, 2; 3, 4)$]`. + - Added [`separator`]($func/terms.separator) argument to term lists + - Added [`round`]($func/round) function for equations + - Numberings now allow zeros. To reset a counter, you can write + `[#counter(..).update(0)]` + - Added documentation for `{page()}` and `{position()}` methods on + [`location`]($func/locate) type + - Added symbols for double, triple, and quadruple dot accent + - Added smart quotes for Norwegian Bokmål + - Added Nix flake + - Fixed bibliography ordering in IEEE style + - Fixed parsing of decimals in math: `[$1.2/3.4$]` + - Fixed parsing of unbalanced delimiters in fractions: `[$1/(2 (x)$]` + - Fixed unexpected parsing of numbers as enumerations, e.g. in `[1.2]` + - Fixed combination of page fill and header + - Fixed compiler crash if [`repeat`]($func/repeat) is used in page with + automatic width + - Fixed [matrices]($func/mat) with explicit delimiter + - Fixed [`indent`]($func/terms.indent) property of term lists + - Numerous documentation fixes + - Links in bibliographies are now affected by link styling + - Fixed hovering over comments in web app + +Thanks to everybody who contributed to this release! ## March 21, 2023 - Reference and bibliography management