community-itu-thesis:0.2.0

packages/preview/community-itu-thesis/0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hamza Sancakdaroğlu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/preview/community-itu-thesis/0.2.0/README.md

@@ -0,0 +1,82 @@
+# ITU Thesis Template (Typst) · `community-itu-thesis`
+
+A Typst template for graduate (master's and doctoral) theses at Istanbul
+Technical University (İTÜ), ported from the official LaTeX class (`itutez.cls`
+v1.7.1, January 2025). The thesis output itself is in Turkish (with optional
+English language mode), since that is the intended audience.
+
+> ⚠️ **Unofficial community port.** This package is not officially endorsed by
+> Istanbul Technical University; it is an independent, volunteer adaptation of
+> the official LaTeX class. Always verify the output against the current
+> official ITU thesis guidelines before submitting your thesis.
+
+## Quick start
+
+```bash
+typst init @preview/community-itu-thesis:0.2.0 my-thesis
+cd my-thesis
+typst watch main.typ
+```
+
+This creates a working sample project. Edit the information in `main.typ` to
+match your own thesis.
+
+## Features
+
+- Outer cover + Turkish inner cover + English inner cover
+- Jury approval / signature page
+- Dedication, Foreword, Table of Contents, Abbreviations, Symbols
+- List of Tables and List of Figures (automatic)
+- Özet / Summary (Turkish and English abstracts)
+- Roman page numbers (i, ii, …) in front matter, Arabic (1, 2, …) in the body
+- Numbered chapters (“1. …”, with subheadings “1.1”, “1.1.1”) and unnumbered
+  front/back-matter headings
+- Appendices (with an "EKLER" cover page) and Curriculum Vitae
+- NUM (numeric/IEEE) and APA citation styles — see `main.typ` and `main-apa.typ`
+- Turkish and English language support (`lang: "tr"` / `lang: "en"`)
+
+## Usage
+
+The main parameters of the `#show: thesis.with(...)` call:
+
+| Parameter | Description |
+| --- | --- |
+| `name`, `surname`, `student-id` | Student name, surname, and ID |
+| `title-tr`, `title-en` | Turkish/English title (up to 3 lines, as an array) |
+| `department-tr/-en`, `program-tr/-en` | Academic department / program |
+| `institute` | `"graduate"`, `"informatics"`, `"science"`, `"social-sciences"`, `"energy"`, `"eurasia"` |
+| `advisor-tr/-en`, `advisor-univ-tr/-en` | Advisor name and university (TR & EN) |
+| `co-advisor-*` | Co-advisor fields, same pattern as `advisor-*` (optional) |
+| `jury` | Array of `(name: "...", univ: "...")` dictionaries |
+| `cover-date-tr/-en` | Date shown on the covers (e.g. "Aralık 2024") |
+| `submission-date-tr/-en`, `defense-date-tr/-en` | Dates on the approval page |
+| `lang` | `"tr"` or `"en"` |
+| `degree` | `"masters"` or `"phd"` |
+| `binding` | `"hardcover"` (cloth/bez) or `"softcover"` (cardboard/karton) |
+| `printing` | `"two-sided"` (default) or `"one-sided"` |
+| `dedication`, `foreword`, `abbreviations`, `symbols`, `abstract-tr`, `abstract-en`, `appendices`, `cv` | Front/back-matter content |
+| `list-of-figures`, `list-of-tables` | Produce the lists? (default `true`) |
+| `bibliography` | `bibliography("refs.bib", style: "ieee", title: "KAYNAKLAR")` |
+
+Body chapters (`= Giriş`, `== Alt başlık`, …) are written as ordinary Typst
+headings after the `#show` call; they are numbered automatically.
+
+### Citations and bibliography
+
+Add BibTeX records to `refs.bib` and cite them in the text with `@key`. Choose
+the style via the `bibliography` parameter: `style: "ieee"` (numeric) or
+`style: "apa"`.
+
+## Notes
+
+- The template targets the `Times New Roman` font; if it is not installed, it
+  falls back to alternatives such as `TeX Gyre Termes` / `Libertinus Serif`.
+  Installing Times New Roman is recommended for a faithful look.
+- Typst does not support EPS; add figures as PNG/PDF/SVG.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Adapted from the official LaTeX thesis class prepared by the ITU Informatics
+Institute.