[projects] Add initial projects

YDX-2147483647 · YDX-2147483647 · commit 3b617e034427 · 2025-08-21T21:09:06.000+08:00
diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
@@ -73,4 +73,4 @@ available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.ht
 [homepage]: https://www.contributor-covenant.org
 
 For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq
+https://www.contributor-covenant.org/faq
diff --git a/config/footer.md b/config/footer.md
@@ -1,20 +1,48 @@
 
 ---
 
-## Related Resources
+## Related Resources and Comparisons
+
+- The [official **Typst Universe**](https://typst.app/universe) covers [packages](https://typst.app/universe/search/?kind=packages) and [templates](https://typst.app/universe/search/?kind=templates).
+
+  TCDM covers the others.
+
+- [**Awesome Typst**](https://github.com/qjcg/awesome-typst) created in 2023 by qjcg is the earliest list. (TCDM will import its data in near future.)
+
+  Unlike Awesome Typst, TCDM ranks project by a calculated project-quality score. In addition, inactive projects will be automatically hidden in TCDM.
+
+- [Community platforms - Meta - **Typst Forum**](https://forum.typst.app/t/community-platforms/2318) records places where community members gather.
+
+  TCDM does not include these places.
+
+- The [Typst-community **Scoop bucket**](https://github.com/typst-community/scoop-bucket/) focuses on binaries or executables running on Windows.
+
+  TCDM is not limited to CLI and Windows.
 
 - [**Best-of lists**](https://best-of.org): Discover other best-of lists with awesome open-source projects on all kinds of topics.
 
+  TCDM was [created from the best-of template](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
+
 ## Contribution
 
 Contributions are encouraged and always welcome! If you like to add or update projects, choose one of the following ways:
 
 - Open an issue by selecting one of the provided categories from the [issue page](https://github.com/YDX-2147483647/best-of-typst/issues/new/choose) and fill in the requested information.
 - Modify the [projects.yaml](https://github.com/YDX-2147483647/best-of-typst/blob/main/projects.yaml) with your additions or changes, and submit a pull request. This can also be done directly via the [Github UI](https://github.com/YDX-2147483647/best-of-typst/edit/main/projects.yaml).
 
+For more information on how to add or update projects, please read the [contribution guidelines](https://github.com/YDX-2147483647/best-of-typst/blob/main/CONTRIBUTING.md). By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/YDX-2147483647/best-of-typst/blob/main/.github/CODE_OF_CONDUCT.md).
+
 If you like to contribute to or share suggestions regarding the project metadata collection or markdown generation, please refer to the [best-of-generator](https://github.com/best-of-lists/best-of-generator) repository. If you like to create your own best-of list, we recommend to follow [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
 
-For more information on how to add or update projects, please read the [contribution guidelines](https://github.com/YDX-2147483647/best-of-typst/blob/main/CONTRIBUTING.md). By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/YDX-2147483647/best-of-typst/blob/main/.github/CODE_OF_CONDUCT.md).
+## Star History
+
+<a href="https://star-history.com/#YDX-2147483647/best-of-typst&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=YDX-2147483647/best-of-typst&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=YDX-2147483647/best-of-typst&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=YDX-2147483647/best-of-typst&type=Date" />
+  </picture>
+</a>
 
 ## License
 
diff --git a/config/header.md b/config/header.md
@@ -1,20 +1,34 @@
 <!-- markdownlint-disable -->
 <h1 align="center">
-    best-of-typst
-    <br>
+  Best of Typst (TCDM)
+  <br>
 </h1>
 
 <p align="center">
-    <strong>🏆&nbsp; A ranked list of awesome projects. Updated weekly.</strong>
+  <strong>
+    🏆&nbsp;
+    A ranked list of awesome projects related to <a href="https://typst.app/home">Typst</a>,
+    or the charted dark matter in Typst Universe (TCDM).
+  </strong>
 </p>
 
 <p align="center">
-    <a href="https://best-of.org" title="Best-of Badge"><img src="http://bit.ly/3o3EHNN"></a>
-    <a href="#Contents" title="Project Count"><img src="https://img.shields.io/badge/projects-{project_count}-blue.svg?color=5ac4bf"></a>
-    <a href="#Contribution" title="Contributions are welcome"><img src="https://img.shields.io/badge/contributions-welcome-green.svg"></a>
-    <a href="https://github.com/YDX-2147483647/best-of-typst/releases" title="Best-of Updates"><img src="https://img.shields.io/github/release-date/YDX-2147483647/best-of-typst?color=green&label=updated"></a>
+  <a href="https://best-of.org" title="Best-of Badge"><img src="http://bit.ly/3o3EHNN"></a>
+  <a href="#Contents" title="Project Count"><img
+      src="https://img.shields.io/badge/projects-{project_count}-blue.svg?color=5ac4bf"></a>
+  <a href="#Contribution" title="Contributions are welcome"><img
+      src="https://img.shields.io/badge/contributions-welcome-green.svg"></a>
+  <a href="https://github.com/YDX-2147483647/best-of-typst/releases" title="Best-of Updates"><img
+      src="https://img.shields.io/github/release-date/YDX-2147483647/best-of-typst?color=green&label=updated"></a>
 </p>
 
-This curated list contains {project_count} awesome open-source projects with a total of {stars_count} stars grouped into {category_count} categories. All projects are ranked by a project-quality score, which is calculated based on various metrics automatically collected from GitHub and different package managers. If you like to add or update projects, feel free to open an [issue](https://github.com/YDX-2147483647/best-of-typst/issues/new/choose), submit a [pull request](https://github.com/YDX-2147483647/best-of-typst/pulls), or directly edit the [projects.yaml](https://github.com/YDX-2147483647/best-of-typst/edit/main/projects.yaml). Contributions are very welcome!
+This list contains {project_count} awesome open-source projects with a total of {stars_count} stars grouped into
+{category_count} categories. All projects are ranked by a project-quality score, which is calculated based on various
+metrics automatically collected from GitHub and different package managers. If you like to add or update projects, feel
+free to open an [issue](https://github.com/YDX-2147483647/best-of-typst/issues/new/choose), submit a [pull
+request](https://github.com/YDX-2147483647/best-of-typst/pulls), or directly edit the
+[projects.yaml](https://github.com/YDX-2147483647/best-of-typst/edit/main/projects.yaml). Contributions are very
+welcome!
 
-> 🧙‍♂️  Discover other [best-of lists](https://best-of.org) or [create your own](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
+> 🧙‍♂️ Discover other [best-of lists](https://best-of.org) or [create your
+own](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
diff --git a/projects.yaml b/projects.yaml
@@ -3,17 +3,129 @@ configuration:
   markdown_footer_file: "config/footer.md"
 
 categories:
-  # - category: "data-engineering"
-  #   title: "Machine Learning & Data Engineering"
-  #   subtitle: "Best-of lists about machine learning, data engieering, data science, or other topics related to big data."
+  - category: docs
+    title: 📔 Documentation
+    subtitle: Supplements to the [official documentation](https://typst.app/docs/), such as examples, translations, and local builds.
+  - category: writing
+    title: 📝 Writing
+    subtitle: Tools for composing articles and books.
 
 labels:
-  # - label: "python"
-  #   image: "https://www.python.org/static/favicon.ico"
-  #   description: "Best-of list with Python projects"
+  - label: cli
+    name: 🤖 CLI
+    description: Command-line binaries.
+  - label: runnable
+    name: 📦 Runnable
+    description: Runnable projects that needs a proper environment (e.g., pip/npm install).
+  - label: api
+    name: 🔌 API
+    description: Libraries providing API for development.
+  - label: app
+    name: 🎨 App
+    description: Local apps with graphical user interface.
+  - label: web
+    name: 🦋 Web
+    description: Web pages and Web apps.
+  - label: extension
+    name: 🧩 Extension
+    description: Browser addons and user scripts.
+  - label: multilingual
+    name: 🗺️ Multilingual
+    description: Projects that are available in multiple languages or scripts.
+  - label: non-english
+    name: 🐧 non-English
+    description: Projects that are not available in English.
 
 projects:
-  # - name: best-of-ml-python
-  #   github_id: ml-tooling/best-of-ml-python
-  #   labels: ["python"]
-  #   category: "data-engineering"
+  - name: Typst Examples Book
+    github_id: sitandr/typst-examples-book
+    category: docs
+    labels: [web]
+
+  - name: Typst 日本語ドキュメント
+    github_id: typst-jp/typst-jp.github.io
+    category: docs
+    labels: [web, non-english]
+
+  - name: Typst 中文社区导航
+    github_id: typst-doc-cn/guide
+    category: docs
+    labels: [web, non-english]
+
+  - name: The Raindrop-Blue Book (Typst中文教程)
+    github_id: typst-doc-cn/tutorial
+    category: docs
+    labels: [web, non-english]
+
+  - name: clreq-gap for typst
+    github_id: typst-doc-cn/clreq
+    category: docs
+    labels: [web, multilingual]
+
+  - name: typst-docs-l10n
+    github_id: typst-doc-cn/docs
+    category: docs
+    labels: [runnable, api]
+
+  - name: Typst MdBook Docs
+    github_id: JL710/typst-mdbook-docs
+    category: docs
+    labels: [runnable]
+    # NOTE: This description was manually recorded on 2025-08-21.
+    description: |
+      This tool generates Typst documentation in Markdown and builds an MdBook from it.
+
+  - name: jcbhmr/typst-docs
+    github_id: jcbhmr/typst-docs
+    category: docs
+    labels: [web, multilingual]
+
+  - name: Engage-Press/typst-docs
+    github_id: Engage-Press/typst-docs
+    category: docs
+    labels: [runnable]
+
+  - name: Its-Just-Nans/typst.github.io
+    github_id: Its-Just-Nans/typst.github.io
+    category: docs
+    labels: [web, multilingual]
+
+  - name: Typst-Automatic-Translation
+    github_id: Yourouchour/Typst-Automatic-Translation
+    category: docs
+    labels: [extension, multilingual]
+
+  - name: tinymist
+    github_id: Myriad-Dreamin/tinymist
+    category: writing
+    labels: [extension, cli, api]
+    cargo_id: tinymist-query
+
+  - name: typst-lsp
+    github_id: nvarner/typst-lsp
+    category: writing
+    labels: [extension, cli]
+
+  - name: typstyle
+    github_id: typstyle-rs/typstyle
+    category: writing
+    labels: [cli, extension, web, api]
+    cargo_id: typstyle-core
+    npm_id: "@typstyle/typstyle-wasm-bundler"
+    greasy_fork_id: 542164
+
+  - name: typstfmt
+    github_id: astrale-sharp/typstfmt
+    category: writing
+    labels: [cli, extension, api]
+    cargo_id: typstfmt
+
+  - name: Katvan
+    github_id: IgKh/katvan
+    category: writing
+    labels: [app]
+
+  - name: TyX
+    github_id: tyx-editor/TyX
+    category: writing
+    labels: [app]
