Skip to content

fubell:0.1.0#4227

Merged
elegaanz merged 10 commits intotypst:mainfrom
confusedkernel:fubell-0.1.0
Mar 5, 2026
Merged

fubell:0.1.0#4227
elegaanz merged 10 commits intotypst:mainfrom
confusedkernel:fubell-0.1.0

Conversation

@confusedkernel
Copy link
Contributor

@confusedkernel confusedkernel commented Feb 28, 2026

I am submitting

  • a new package
  • an update for a package

Description: Fubell - An unofficial Typst thesis template for National Taiwan University, designed to comply with the university’s official thesis guidelines.

I have read and followed the submission guidelines and, in particular, I

  • selected a name that isn't the most obvious or canonical name for what the package does
  • added a typst.toml file with all required keys
  • added a README.md with documentation for my package
  • have chosen a license and added a LICENSE file or linked one in my README.md
  • tested my package locally on my system and it worked
  • excluded PDFs or README images, if any, but not the LICENSE
  • ensured that my package is licensed such that users can use and distribute the contents of its template directory without restriction, after modifying them through normal use.

@confusedkernel confusedkernel changed the title Add fubell 0.1.0 fubell:0.1.0 Feb 28, 2026
@typst-package-check typst-package-check bot added the new A new package submission. label Feb 28, 2026
@elegaanz elegaanz self-assigned this Mar 3, 2026
Copy link
Member

@elegaanz elegaanz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two little things, but overall looks good to me! Thank you for building this template.

Issues and pull requests are welcome! If you spot a formatting bug, have a feature idea, or want to pick up something from the [roadmap](ROADMAP.md) — please go for it :)
Contributions that implement new features are especially appreciated.

## License
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please check that you have the right to distribute the university logo/watermark and if yes, specify under which terms it can be used?

Copy link
Contributor Author

@confusedkernel confusedkernel Mar 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

While the watermark is publicly available on the school's website, I couldn't find anything on its distribution or license. I've removed the watermark from assets and use watermark: none as default. Users can download the watermark from the school website and add it to project instead! Thanks


Inspired by the [ntu-thesis](https://github.com/tzhuan/ntu-thesis) LaTeX template and follows the official formatting guidelines. The project is named after the iconic Fu Bell on campus.

## Quick Start
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As a suggestion, adding a note about using the template in the web app may be useful too.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a section about using the template in the web app, thanks for the suggestion :)

If you want to add the NTU watermark:

1. Download it from the official source: <https://www.lib.ntu.edu.tw/doc/CL/watermark.pdf>
2. Convert it to PNG and place it in your project, for example `assets/watermark.png`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For info, since Typst 0.14, PDF files can be used as images directly. If you already tried that and the rendering is suboptimal, asking people to convert to manually PNG is a good idea.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would also require to change compiler in your typst.toml to "0.14", and wanting to keep compatibility with previous versions is also a good reason to ask for to convert to PNG first.


1. Download it from the official source: <https://www.lib.ntu.edu.tw/doc/CL/watermark.pdf>
2. Convert it to PNG and place it in your project, for example `assets/watermark.png`
3. Set `watermark: "assets/watermark.png"` in `#show: thesis.with(...)`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The path would have to be wrapped in an image(...) call, [as explained here][https://github.com/typst/packages/blob/main/docs/resources.md#paths-are-package-scoped).

acknowledgement-en: include "content/acknowledgement-en.typ", // optional

bibliography-file: bibliography("refs.bib"),
watermark: none, // optional: e.g. "assets/watermark.png" (user-provided)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The comment here should be updated as well.

acknowledgement-en: include "sections/acknowledgement-en.typ",

bibliography-file: bibliography("bibliography/refs.bib"),
watermark: none, // optional: set to "assets/watermark.png" after adding it locally
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And here too, to use image(...) in the comment.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All mentions of "assets/watermark.png" are updated now

@elegaanz
Copy link
Member

elegaanz commented Mar 5, 2026

Thank you!

@elegaanz elegaanz merged commit 7f1cec1 into typst:main Mar 5, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new A new package submission.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants