? 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 许可证获得许可 - 有关详细信息,请参阅许可证文件。