如何投稿一篇文章
本站支援兩種投稿方式：在站內用 Markdown 撰寫，或上傳一個 HTML 檔。兩者提交後都會進入審核佇列，由管理員審核通過後才會公開。本頁說明 HTML 上傳的格式要求。
一、最重要的原則
一個 HTML 檔就是一篇文章。若要支援多語言（例如繁體中文＋英文），同一個檔案裡要為每種語言各放一個區塊，讀者切換介面語言時，網站會自動顯示對應語言的內容。
二、檔案結構
你的 HTML 需要包含這幾個部分：
1. 分類：用 <span class="kicker">Crypto</span> 標明文章分類（例如 Crypto、AI、Crypto × AI）。
2. 主標題：用 <h1 class="title">標題</h1>。這是預設標題。
3. 各語言區塊：每種語言的正文，各自包在一個 <section data-lang="語言碼"> 裡。目前支援的語言碼是 zh-Hant（繁體中文）和 en（英文）。
三、每個語言區塊裡要放什麼
這一點很關鍵，直接影響首頁卡片與文章頁能否正確切換語言：
· 各語言自己的分類與署名：在每個語言區塊開頭放
<span class="kicker article-meta">分類</span> 與
<div class="byline article-meta">作者、日期、閱讀時長</div>。
切換語言時，文章頂部與首頁卡片的分類、署名會顯示對應語言的版本（例如中文「安全」、英文「Security」）。這兩個元素不會出現在正文裡，只作為資料來源。
· 每個語言區塊的第一個 <h2>（或該語言的標題）會被當作該語言下的文章標題與首頁卡片標題。若某個區塊沒有自己的標題，會退回使用主標題。
· 每個語言區塊的第一段 <p> 會被截取作為首頁卡片的摘要（前 200 字）。所以請把每個語言區塊的第一段寫成一句清楚的導言，而不是免責聲明或空話。
四、常見錯誤
· 英文區塊裡忘了寫英文標題 → 切到英文時，首頁卡片標題還是中文。
· 沒有在各語言區塊放 article-meta 分類／署名 → 切換語言時分類與署名不會跟著變。
· 語言區塊的第一段不適合當摘要（例如放了一段版權聲明）→ 首頁摘要會很奇怪。
· 用了未註冊的語言碼 → 上傳時會被擋下。目前只支援 zh-Hant 和 en。
五、最省事的做法
直接下載我們的範本檔，把裡面的範例內容換成你自己的即可，結構已經幫你排好。你也可以在投稿頁的「上傳 HTML」分頁裡直接複製最小範本。
六、提交之後
上傳後，文章會進入審核佇列，管理員審核通過才會公開。你可以在提交前用頁面的預覽功能檢查排版。已發布的內容若需要修改，目前需要重新投稿。
There are two ways to contribute: write in Markdown on the site, or upload a single HTML file. Either way your submission enters a review queue and only goes public after an admin approves it. This page explains the HTML upload format.
1. The core principle
One HTML file is one article. To support multiple languages (e.g. Traditional Chinese + English), put one block per language inside the same file. When a reader switches the interface language, the site automatically shows the matching block.
2. File structure
Your HTML should contain:
Category — <span class="kicker">Crypto</span> marks the article category (Crypto, AI, Crypto × AI, …).
Main title — <h1 class="title">Title</h1>. This is the default title.
Per-language blocks — the body for each language goes inside a <section data-lang="code">. Supported codes are zh-Hant (Traditional Chinese) and en (English).
3. What goes inside each language block
This matters — it determines whether the article page and homepage card switch languages correctly:
· Per-language category & byline — at the top of each block, add
<span class="kicker article-meta">Category</span> and
<div class="byline article-meta">author, date, read time</div>.
When readers switch language, the category and byline shown at the top of the article (and on the homepage card) follow — e.g. 「安全」in Chinese, "Security" in English. These elements are data sources only and never appear in the body.
· The first <h2> (or that language's heading) in each block becomes the article/card title for that language. Without one, it falls back to the main title.
· The first <p> in each block is used as the card summary (first 200 characters). Write that first paragraph as a clear lead sentence — not a disclaimer.
4. Common mistakes
· Forgetting a heading inside the English block → the English card title stays Chinese.
· Skipping the article-meta category/byline in each block → the category and byline won't switch with the language.
· A first paragraph that doesn't work as a summary → an odd-looking card.
· An unregistered language code → the upload is rejected. Only zh-Hant and en are supported.
5. The easy way
Download the template file and replace the sample content with your own — the structure is already set up. You can also copy the minimal template right in the "Upload HTML" tab.
6. After you submit
Once uploaded, the article enters the review queue and goes public only after an admin approves it. Use the preview before submitting to check formatting.