? 2022 年和 2023 年最受歡迎和分叉的Astro 主題。 ?
AstroWind是一個免費的開源模板,可使用Astro 5.0 + Tailwind CSS製作您的網站。準備開始一個新項目,並根據網路最佳實踐進行設計。
? https://astrowind.vercel.app/
我們正在與AstroWind 2.0一起踏上激動人心的旅程,我們希望您成為其中的一部分!我們目前正在採取開發這個新版本的第一步,您的見解非常寶貴。加入討論並分享您的回饋、想法和建議,以幫助塑造AstroWind的未來。讓我們一起讓AstroWind 2.0變得更好!
在我們的討論中分享您的回饋!
AstroWind嘗試讓您快速造訪使用 Astro 5.0 + Tailwind CSS 建立網站。這是一個免費主題,專注於簡單性、良好實踐和高效能。
很少有原生 JavaScript 僅用於提供基本功能,以便每個開發人員決定使用哪個框架(React、Vue、Svelte、Solid JS...)以及如何實現他們的目標。
在此版本中,範本支援output
配置中的所有選項, static
、 hybrid
和server
,但部落格僅適用於prerender = true
。我們正在開發下一個版本,目標是使其與 SSR 完全相容。
在AstroWind範本內,您將看到以下資料夾和檔案:
/
├── public/
│ ├── _headers
│ └── robots.txt
├── src/
│ ├── assets/
│ │ ├── favicons/
│ │ ├── images/
│ │ └── styles/
│ │ └── tailwind.css
│ ├── components/
│ │ ├── blog/
│ │ ├── common/
│ │ ├── ui/
│ │ ├── widgets/
│ │ │ ├── Header.astro
│ │ │ └── ...
│ │ ├── CustomStyles.astro
│ │ ├── Favicons.astro
│ │ └── Logo.astro
│ ├── content/
│ │ ├── post/
│ │ │ ├── post-slug-1.md
│ │ │ ├── post-slug-2.mdx
│ │ │ └── ...
│ │ └-- config.ts
│ ├── layouts/
│ │ ├── Layout.astro
│ │ ├── MarkdownLayout.astro
│ │ └── PageLayout.astro
│ ├── pages/
│ │ ├── [...blog]/
│ │ │ ├── [category]/
│ │ │ ├── [tag]/
│ │ │ ├── [...page].astro
│ │ │ └── index.astro
│ │ ├── index.astro
│ │ ├── 404.astro
│ │ ├-- rss.xml.ts
│ │ └── ...
│ ├── utils/
│ ├── config.yaml
│ └── navigation.js
├── package.json
├── astro.config.ts
└── ...
Astro 在src/pages/
目錄尋找.astro
或.md
檔案。每個頁面都根據其檔案名稱公開為路徑。
src/components/
沒有什麼特別的,但我們喜歡在其中放置任何 Astro/React/Vue/Svelte/Preact 組件。
任何靜態資產(例如影像)如果不需要任何轉換,都可以放置在public/
目錄中;如果直接匯入,則可以放置在assets/
目錄中。
?刪除此檔案
README.md
。更新src/config.yaml
和內容。玩得開心!
所有命令都從專案的根目錄的終端運行:
命令 | 行動 |
---|---|
npm install | 安裝依賴項 |
npm run dev | 在localhost:4321 啟動本機開發伺服器 |
npm run build | 將您的生產網站建置到./dist/ |
npm run preview | 在部署之前在本地預覽您的構建 |
npm run check | 檢查您的項目是否有錯誤 |
npm run fix | 運行 Eslint 並使用 Prettier 格式化程式碼 |
npm run astro ... | 執行 CLI 指令,例如astro add 、 astro preview |
基本設定檔: ./src/config.yaml
site :
name : ' Example '
site : ' https://example.com '
base : ' / ' # Change this if you need to deploy to Github Pages, for example
trailingSlash : false # Generate permalinks with or without "/" at the end
googleSiteVerificationId : false # Or some value,
# Default SEO metadata
metadata :
title :
default : ' Example '
template : ' %s — Example '
description : ' This is the default meta description of Example website '
robots :
index : true
follow : true
openGraph :
site_name : ' Example '
images :
- url : ' ~/assets/images/default.png '
width : 1200
height : 628
type : website
twitter :
handle : ' @twitter_user '
site : ' @twitter_user '
cardType : summary_large_image
i18n :
language : en
textDirection : ltr
apps :
blog :
isEnabled : true # If the blog will be enabled
postsPerPage : 6 # Number of posts per page
post :
isEnabled : true
permalink : ' /blog/%slug% ' # Variables: %slug%, %year%, %month%, %day%, %hour%, %minute%, %second%, %category%
robots :
index : true
list :
isEnabled : true
pathname : ' blog ' # Blog main path, you can change this to "articles" (/articles)
robots :
index : true
category :
isEnabled : true
pathname : ' category ' # Category main path /category/some-category, you can change this to "group" (/group/some-category)
robots :
index : true
tag :
isEnabled : true
pathname : ' tag ' # Tag main path /tag/some-tag, you can change this to "topics" (/topics/some-category)
robots :
index : false
isRelatedPostsEnabled : true # If a widget with related posts is to be displayed below each post
relatedPostsCount : 4 # Number of related posts to display
analytics :
vendors :
googleAnalytics :
id : null # or "G-XXXXXXXXXX"
ui :
theme : ' system ' # Values: "system" | "light" | "dark" | "light:only" | "dark:only"
若要自訂字體系列、顏色或更多元素,請參閱以下文件:
src/components/CustomStyles.astro
src/assets/styles/tailwind.css
您可以使用以下方法建立最佳化的生產版本:
npm run build
現在,您的網站已準備好部署。所有產生的檔案都位於dist
資料夾中,您可以將該資料夾部署到您喜歡的任何託管服務。
在您自己的 GitHub 帳戶上複製此儲存庫並將其部署到 Netlify:
在您自己的 GitHub 帳戶上複製此儲存庫並部署到 Vercel:
如果您有任何想法、建議或發現任何錯誤,請隨時展開討論、提出問題或建立拉取要求。這對我們所有人都非常有用,我們很樂意傾聽並採取行動。
最初由 onWidget 創建並由貢獻者社群維護。
AstroWind根據 MIT 許可證獲得許可 - 有關詳細信息,請參閱許可證文件。