quiltmc.org
1.0.0
被子项目的网站。
该网站由Astro，MDX和I18Next构建。它托管在Cloudflare页面上。如果您想更熟悉Astro，则可以阅读其文档。
如果您陷入困境或有疑问，请加入我们的Discord服务器上的#Website线程。
最简单的编辑器是Visual Studio Code（VSCODE），因为它具有针对Astro和MDX的官方语言扩展。当您在Vscode中打开存储库时，您会在右下角提供一个弹出窗口，以安装一些推荐的扩展名。您还可以在扩展搜索栏中键入@recommended ，以浏览推荐的扩展名并手动安装所需的扩展名。
如果您希望不使用VSCODE，则可以根据您的操作使用任何支持以下工具子集的编辑器：
如前所述，该网站是使用Astro构建的，该网站是用Typescript编写的，因此您需要一个node.js兼容的JavaScript运行时，才能构建和运行它以进行开发。如果您仅做出简单的贡献，例如不兼容的mod或博客文章，则建立开发环境并不是必需的：当您提交拉动请求以确保一切正常工作时，将建立该网站的预览版本。
Node.js是一个跨平台JavaScript运行时。它可以直接安装，也可以用于您喜欢的软件包管理器。
我们使用pnpm作为我们的node.js软件包管理器。它可以通过以下方式安装：
npm install -g pnpm有关更多选项，请参见PNPM的文档。
在项目内部，使用PNPM安装所有必需的软件包：
pnpm iAstro包括一台开发服务器，该服务器会自动重新加载项目，然后更改项目内部的文件。要启动它，请运行pnpm dev ：
> pnpm dev
15:05:32 [types] Generated 1ms
astro v4.15.2 ready in 702 ms
┃ Local http://localhost:4321/
┃ Network use --host to expose
15:05:32 watching for file changes...
开发服务器在访问它们时构建页面以减少开始时间，因此其性能比完全构建的站点更糟。
建立最终网站的完整副本：
pnpm build
该站点将内置在dist/文件夹中。构建网站是一种有用的方法，可以检查您是否没有注意到任何东西。
您可以使用pnpm astro preview构建的网站，但是在大多数情况下，这比Dev Server具有性能是唯一的优势。
如果您需要测试CloudFlare特定的功能（例如functions/目录中的任何内容），则可以使用Cloudflare的Wrangler Clito仿效Cloudflare页面部署。
首先，安装牧马人
pnpm install -g wrangler建立网站：
pnpm build使用Wrangler运行输出的dist文件夹：
wrangler pages dev dist
与Astro的开发服务器不同，Wrangler只能预览完全构建的网站。
有关如何布置存储库的详细说明，请参见ARCHITECTURE.md
做出各种常见类型的贡献的说明。
在public/api/v1/incompatible-mods.json中打开incompatible-mods.json文件，并在列表的底部添加一个新条目。
您的条目必须具有以下字段：
"ids": - 受影响的MOD ID列表。"Name": - 受影响mod的全名。"type": - 不相容的类型。可以是以下之一："GAME" - 崩溃或打破了香草游戏。"OTHERS" - 打破一个或多个其他mod。"SELF" - 破裂。"WORKAROUND" - 具有解决方法，可以使其正常运行。"Status": - 不兼容的距离有多近。可以是以下之一："BLOCKED" - MOD作者知道了这个问题，但是修复程序被外部因素阻止。"IN_PROGRESS" - Mod作者正在实现修复程序。"NO_ANSWER" - 已经报告了问题，但MOD作者尚未回应。"ON_HOLD" - mod作者正在等待实现或发布修复程序。"UNKNOWN" - 该问题尚未报告给MOD作者，或者您找不到报告。"WONT_FIX" - 已报告了问题，但MOD作者拒绝修复它。"tracking": - 报告跟踪不相容性的报告的链接，例如，GitHub问题。如果您不知道，请设置为"UNKNOWN" 。"notes":可选） - 例如，任何其他注释，即已知的解决方法。 在src/pages/en/blog中创建一个新的Markdown文件，该文件命名为当前日期和标题的缩短版本。日期应为格式yyyy-mm-dd ，标题应为小写，并由连字符（ - ）隔开，例如2024-03-09-example-post.md 。
在文件的顶部，您需要添加前面物质，这是用yaml编写的元数据。博客文章的前提看起来像这样：
---
title : " An Example Title " # The full title of the post
date : 2024-09-03 20:00:00 -00:00 # The date, time, and timezone that the post was written, relative to UTC. It is best practice to give the time in UTC and use an offset of -00:00, as shown.
authors : # A list of one or more authors
- Pineapple
layout : /src/layouts/Post.astro # This tells Astro what layout to use for the page, and should always be the same.
---写一个简短的第一段，然后插入两行，put <!-- MORE --> ，然后再插入两行。例如：
A succinct first paragraph.
<!-- MORE -->
More text here.
这告诉网站在主页和博客文章列表中的简短预览中还包含什么。从这里开始，您可以继续写下对内心的内容的宣传。还支持代码块中的语法突出显示。
如果您是Quilt的开发人员或社区团队之一的一部分，则可能在网站的团队列表页面上有一张卡。此页面上的卡中的数据是从src/data/的TeamData.mjs文件构建的。
每个团队成员在此文件中都有一个对象，其中包含有关它们的数据。您列出的页面部分基于您在GitHub上的哪些团队。
您可以更改以下数据以自定义您的卡：
name: - 卡顶部的名称。它可以是您想要的任何东西。discord: - 您的Discord用户名。github: - 您的github用户名。这用于确定您在GitHub上的哪些团队。avatar: - 这是您喜欢的任何图像的URL。为了获得最佳效果，它应该是正方形的，而且不大。您可以将public/assets/team/images中的文件放在网站上托管，也可以使用您喜欢的任何其他图像URL。description:可选） - 关于您是谁的句子或小段落。links:可选） - 指向各种网页或社交媒体配置文件的链接列表。每个链接由以下对象表示：icon ：代表链接的图标。您可以从图标集CoreUI品牌（ cib: ，材料设计图标（ mdi: ：）或材料符号（ material-symbols: ：）中进行选择。或使用我们的自定义图标进行诅咒（ curseforge ）和Modrinth（ modrinth-small ）。当使用图标集中的图标（与自定义图标相反）时，您必须将图标名称带有图标集的名称，例如cib:youtube来使用Coreui Brands中的youtube图标。url ：网页的链接。systemMembers:可选） - 该字段旨在使复数系统显示其每个成员。它有一些可能的值："---"将向您展示是一个复数系统，您的成员隐藏了。name:系统成员的名称。icon: - 成员的化身。您可以使用所需的任何URL，也可以在该网站上以public/assets/team/images/<your-system-name>/托管图像。
