astro ink

Astro Ink 是一個最小主題，旨在滿足基於簡約 Markdown 的部落格需求。它附帶了您在創建輕量級、高效能的個人部落格時可能需要的幾乎所有基本 Astro 元件，這些元件預設為傳輸較少的 Javascript。

它的靈感來自於 Hugo 的 Ink 主題，力求保持輕量，同時為美麗、簡約的部落格提供基礎。

特徵

• Minimal、Crisp、Markdown-Blog Ready總是會在後台更新到 Astro 的最新版本（目前為2.x版本）。
• Svelte Ready - 為了保持 Astro 的 POV 的輕量級、高效能和更平易近人，Svelte 用於主題切換器等互動式元件
• 模組化－結構高度模組化，組件只做一項工作，只做好一項工作。
• Astro 2.0 Content Collection + 動態頁面- 它已準備好與 Next.js 一起使用，例如動態頁面，支援基於標籤的分類系統，具有分頁結果，所有可配置
• 深色模式和顏色代碼- 它支援深色模式以及使用tailwind.config.js選擇的6 種以上顏色模式。您可以透過dev或build腳本/命令傳遞THEME_KEY例如： THEME_KEY=purpleheart astro build/dev來變更正在使用的顏色主題。所有可用的主題都可以在 tailwind.theme.config.js 中找到。要自訂部落格部分，請添加此處提到的任何 Tailwind Typography 的prose-{color}類
• Netlify CMS - 使用您的 Netlify 憑證存取your-site.netlify.com/admin例如：astro-ink.netlify.app/admin，新增/編輯/更新/blog目錄中的所有貼文。它需要Netlify Identity（https://app.netlify.com/sites/your-site/settings/identity#registration）和Git Gateway（https://app.netlify.com/sites/your-site/settings/identity ） #services) 已啟用。
• 未來的帖子（使用 Github Actions）- 在/src/drafts目錄中以YYYY-MM-DD格式創建未來date帖子，並讓專門設計的 Github Action 負責在您指定的日期自動發布它。您可以在 Github Action 中設定檢查間隔。
• 客戶端搜尋- 讓您的用戶透過客戶端搜尋功能快速存取您的部落格文章。 Lunr.js
• 查看反擊壯舉。 Redis/Upstash Redis - 設定您的 Redis 主機，將其連接 URL 放入託管提供者的控制台（Vercel、Netlify 等）或.env檔案（本機開發）中，取消註解此處的連接程式碼並部署。您的網站配備了動態瀏覽量計數器。請參閱 .env.example 以了解您需要配置的不同環境值。
• 支援 YT 頻道的媒體頁面- 只需將您的頻道 ID 放入設定檔的ytChannelId常數中，即可輕鬆在媒體頁面上顯示您的 YT 頻道內容。 （可選）透過將USE_MEDIA_THUMBNAIL設定為false從 YT 頻道的影片清單中停用影像縮圖。
• 作者卡- 透過在設定檔中將USE_AUTHOR_CARD設為true ，輕鬆新增基於貼文或網站範圍的作者卡，其中包括 Twitter 追蹤按鈕。
• 主題圖像疊加- 您可以選擇啟用疊加，透過在設定檔中將USE_POST_IMG_OVERLAY設為true可以在貼文圖片頂部新增漂亮的主題漸層。

如何開始？

只需克隆此模板，然後從您的克隆開始工作。您可以使用所有常見的 NPM 指令，例如dev 、 build等。

注意：使用npx degit one-aalam/astro-ink複製模板，無需任何git歷史記錄

注意：此範本預設產生server （SSR 就緒）輸出。如果你想要static構建

• 在 astro.config.js 中將server的output改為static
• 刪除adapter: vercel()
• 刪除瀏覽次數計數器 API
• 在 config.ts 中將USE_VIEW_STATS設定為false

注意：在第一次運行npm run dev之前 -

• 透過執行mv .env.example .env建立.env檔（如果您使用的是 Linux 發行版或 Mac）
• 將SITE_URI變數設定為SITE_URI=http://localhost:4321 （其中 4321 是專案運行的連接埠）

採用 Astro Ink 打造

• jamesperkins.dev - 開發者、YouTube 講師 James R Perkins 的個人網站
• highlandcows.github.io Nick Jacob 的個人博客

知道用 Astro Ink 建立的網站嗎？在 Twitter 上告訴我

想在建構 Ink 的同時學習 Astro 嗎？

這個主題最初是使用Astro框架的 alpha 版和 beta 版建構的。如果您剛開始使用Astro ，那麼您實際上可以在建立這個主題的同時學習Astro ，方法是遵循我編寫的一系列從頭開始教您 Astro 的部落格！

前往aalam.in/blog並了解

• 如何設定 Astro 並使其使用樣式、原型設計和增量部署的基本預設值運行
• 管理演示元件和建立 Astro 頁面
• 將本地和遠端資料提供給 Astro 頁面
• 在 Astro 中將互動性置於您絕對離不開的地方
• 在 Astro 中建立資料驅動的動態頁面和分頁結果
• 使用基於 Git 的 CMS 創作 Astro 網站的內容