{"id":13523651,"url":"https://github.com/ls1intum/thesis-template-typst","last_synced_at":"2025-10-24T01:32:50.189Z","repository":{"id":178756023,"uuid":"656213313","full_name":"ls1intum/thesis-template-typst","owner":"ls1intum","description":"TUM ASE thesis typst template ","archived":false,"fork":false,"pushed_at":"2025-04-19T07:35:28.000Z","size":28446,"stargazers_count":95,"open_issues_count":9,"forks_count":28,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-28T15:19:21.740Z","etag":null,"topics":["education","thesis","thesis-template","typst","typst-template"],"latest_commit_sha":null,"homepage":"","language":"Typst","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ls1intum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-20T13:32:56.000Z","updated_at":"2025-04-24T21:44:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"7271952a-73d8-4a33-96b9-5b2ccd232cba","html_url":"https://github.com/ls1intum/thesis-template-typst","commit_stats":null,"previous_names":["ls1intum/thesis-template-typst"],"tags_count":55,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fthesis-template-typst","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fthesis-template-typst/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fthesis-template-typst/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fthesis-template-typst/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ls1intum","download_url":"https://codeload.github.com/ls1intum/thesis-template-typst/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251336400,"owners_count":21573189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["education","thesis","thesis-template","typst","typst-template"],"created_at":"2024-08-01T06:01:02.276Z","updated_at":"2025-10-24T01:32:50.178Z","avatar_url":"https://github.com/ls1intum.png","language":"Typst","funding_links":[],"categories":["Templates \u0026 Libraries","Popular \u0026 New Non-LaTeX Templates"],"sub_categories":["General","Thesis/Dissertation"],"readme":"# thesis-template-typst\nThis repository provides a comprehensive Typst template for writing your Bachelor's or Master's thesis at the CIT School of TUM (Technical University of Munich). It includes two types of documents: a proposal template and a thesis template, both specifically designed for students in the field of Informatics. For more information about writing a thesis at the CIT School, please visit the [official CIT website](https://www.cit.tum.de/en/cit/studies/students/thesis-completing-your-studies/informatics/).\n\n\u003e [!IMPORTANT]\n\u003e This is only a template. You have to adapt the template to your thesis and discuss the structure of your thesis with your supervisor!\n\n\n## Guidelines \n\u003e [!TIP]\n\u003e __Please thorougly read our guidelines and hints on [confluence](https://confluence.ase.in.tum.de/display/EduResStud/How+to+thesis)!__ (TUM Login Required) \n\n\n## Installation\nFor detailed installation instructions, please refer to the [official installation guide](https://github.com/typst/typst). Here, we provide basic steps for installing Typst's CLI:\n\n- You can get sources and pre-built binaries from the [releases page](https://github.com/typst/typst/releases).\n- Use package managers like `brew` or `pacman` to install Typst. Be aware that the versions in the package managers might lag behind the latest release.\n- If you have a [Rust](https://rustup.rs/) toolchain installed, you can also install the latest development version.\n\nNix and Docker users, please refer to the official installation guide for detailed instructions.\n\n\u003e [!NOTE]\n\u003e [Git LFS](https://git-lfs.com/) is required in this repository to handle large files, such as figures. Make sure to install it before cloning the repository.\n\n## Usage\n\n### Use this repository as a template\nYou can use this repository as a template for your thesis. To do this, follow these steps:\n1. Click on the green \"Use this template\" button at the top right of this page.\n2. Select \"Create a new repository\" and fill in the required information.\n3. Clone the new repository to your local machine using `git clone \u003crepository-url\u003e`.\n4. Install the fonts from `/fonts` on your local machine\n\n### Set thesis metadata \nFill in your thesis details in the [`metadata.typ`](/metadata.typ) file: \n* Degree (Bachelor or Master)\n* Your study program\n* English and German title\n* Supervisor and examiner\n* Your name (without e-mail address or matriculation number)\n* The start and submission date\n\n### Choose Reference Format\nThe template supports two reference formats:\n\n1. **YAML** (`thesis.yml`):\n      - Recommended for precise control over reference formatting and styling\n\n2. **BibTeX** (`thesis.bib`):\n      - This is the default export format of Zotero's BibTeX plugin\n      - If you choose this format, you need to update all occurrences of `thesis.yml` to `thesis.bib` in the template files\n      - You can also convert BibTeX to YAML using the [Hayagriva CLI tool](https://github.com/typst/hayagriva):\n      ```bash \n      hayagriva thesis.bib \u003e thesis.yml\n      ```\n\n### Write your thesis\nFor the actual content of your thesis, there is a dedicated folder named [`/content`](/content) which includes all the chapters and sections of your thesis. This applies for the proposal as well as the thesis (see [`/content/proposal`](/content/proposal) for proposal content). \nYou can add or remove chapters as needed (adapt the [`thesis.typ`](/thesis.typ) with the `#include(...)` accordingly).\nIf you need to customize the layout of the template, you can do so by modifying the corresponding file in the [`layout`](/layout) directory.\n\n\n\n### Build PDFs locally \nOnce you have installed Typst, you can use it like this:\n```sh\n# Creates `thesis.pdf` in working directory.\ntypst compile thesis.typ\n\n# Creates `proposal.pdf` in working directory.\ntypst compile proposal.typ\n\n# Creates PDF file at the desired path.\ntypst compile thesis.typ path/to/output.pdf\n```\n\nYou can also watch source files and automatically recompile on changes. This is\nfaster than compiling from scratch each time because Typst has incremental\ncompilation.\n```sh\n# Watches source files and recompiles on changes.\ntypst watch thesis.typ\n```\n\n### Updating Your Repository to the Latest Template Version\nIf you have created your thesis repository using the Typst Thesis Template, you might want to update your repository to incorporate the latest changes from the template. Follow these steps to sync your repository with the latest version of the template.\n\n**Steps to Update:**\n1. Add the Template Repository as a Remote \nFirst, navigate to your repository in the terminal and add the original template repository as a new remote:\n```sh\ngit remote add template https://github.com/ls1intum/thesis-template-typst.git\n```\n\n2. Fetch the latest updates from the template repository:\n```sh\ngit fetch template\n```\n\n3. Merge the Changes into Your Repository\nMerge the changes from the template's main branch into your current branch. This might require resolving merge conflicts if there are any differences between your customizations and the template's updates:\n```sh\ngit merge template/main --allow-unrelated-histories\n```\n\n4. Resolve Merge Conflicts\nIf there are any merge conflicts, git will notify you. Open the conflicting files, resolve the conflicts, and then add the resolved files:\n```sh\ngit add \u003cresolved-file\u003e\n```\n\n5. Commit the Merge\nAfter resolving conflicts and adding the resolved files, commit the merge:\n```sh\ngit commit -m \"Merge updates from Typst Thesis Template\"\n```\n\n6. Push the Changes to Your Repository\nFinally, push the merged changes to your repository:\n```sh\ngit push origin \u003cbranch-name\u003e\n```\n\n## Working with the Typst Web Editor\nIf you prefer an integrated IDE-like experience with autocompletion and instant preview, the Typst web editor allows you to import files directly into a new or existing document. Here's how you can do this:\n\n1. Navigate to the [Typst Web Editor](https://typst.app/).\n2. Create a new blank document.\n3. Click on \"File\" on the top left menu, then \"Upload File\".\n4. Select all .typ and .bib files along with the figures provided in this template repository.\n\n\u003e [!Note]\n\u003e You can select multiple files to import. The editor will import and arrange all the files accordingly. Always ensure you have all the necessary `.typ`, `.bib`, and figures files you need for your document.\n\n## Working with VS Code\nIf you prefer to have a more integrated experience with your favorite code editor, you can use the Typst VS Code extension. The extension provides syntax highlighting, autocompletion, and error checking for Typst files. You can install the extension from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=nvarner.typst-lsp).\n\n1. Open your project in VS Code\n2. Set the correct file (`thesis.typ` or `proposal.typ`) as the main file. This can be done by opening the respective file and running the command `Typst: Pin the main file to the currently opened document`. Just hit `CMD + Shift + P` and search for the command.\n\n\n## Working with GitHub Copilot\n\nGitHub Copilot can significantly enhance your thesis workflow, especially for proposal review and development. As a student, you can access GitHub Copilot for free through GitHub Education.\n\n### Getting GitHub Copilot (Free for Students)\n\n1. Visit [GitHub Education](https://education.github.com/pack) and sign up for the GitHub Student Developer Pack using your university email\n2. After verification, you'll get free access to GitHub Copilot\n3. Install the GitHub Copilot extension:\n   - Open VS Code\n   - Go to Extensions (or press `Cmd+Shift+X` on Mac)\n   - Search for \"GitHub Copilot\"\n   - Click \"Install\"\n4. After installation, you'll need to sign in to your GitHub account in VS Code\n\n### Thesis Proposal Review Assistant\n\nThis template includes custom Copilot instructions specifically designed to help evaluate thesis proposals against academic standards. The instructions help Copilot provide detailed feedback on:\n\n- Structure and completeness of all required sections\n- Scientific rigor and citation quality\n- Diagram and figure requirements\n- Writing quality and style issues\n\nThese custom instructions are located in `.github/copilot-instructions.md`. You can modify or remove this file if you prefer different Copilot behavior.\n\n### Using Copilot for Proposal Review\n\nFor the best thesis proposal feedback experience:\n\n1. Open Copilot Chat by clicking the Copilot icon or use `Ctrl+Cmd+I` on Mac\n2. In the chat use the \"Ask\" mode (default) and select \"Claude 3.7 Sonnet Thinking\" as your model for comprehensive academic feedback (you might need to enable this in your GitHub settings)\n3. Ask questions such as:\n   - \"Do you have any feedback for my proposal?\"\n   - \"Review my problem description section for academic rigor\"\n   - \"Check if my citations follow proper academic standards\"\n4. Also try out the \"Agent\" mode for applying the feedback directly to your document. This mode can help you make changes based on Copilot's suggestions.\n\n\u003e [!NOTE]\n\u003e Remember to acknowledge AI assistance in your transparency statement if you used GitHub Copilot extensively for your thesis work.\n\n---\n\n## Further Resources\n\n- [Typst Documentation](https://typst.app/docs/)\n- [Typst Guide for LaTeX Users](https://typst.app/docs/guides/guide-for-latex-users/)\n- [Typst VS Code Extension (inofficial)](https://marketplace.visualstudio.com/items?itemName=nvarner.typst-lsp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fls1intum%2Fthesis-template-typst","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fls1intum%2Fthesis-template-typst","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fls1intum%2Fthesis-template-typst/lists"}