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>/託管圖像。
