Добро пожаловать в шаблон AstroGlass! Это руководство поможет вам настроить среду разработки и адаптировать шаблон под ваши нужды.
Предварительные требования
Прежде чем начать, убедитесь, что у вас установлено следующее:
- Node.js версии 20 или выше
- pnpm (рекомендуется) или npm
- Редактор кода (рекомендуется VS Code)
Мы рекомендуем использовать pnpm для быстрой и эффективной работы с пакетами.
Установка
Клонируйте репозиторий
Сначала клонируйте репозиторий шаблона на свой локальный компьютер:
git clone https://github.com/kamsqee/astroglass.git my-projectcd my-projectУстановите зависимости
Установите зависимости проекта, используя ваш любимый менеджер пакетов:
pnpm installnpm installyarn installЗапустите сервер разработки
Запустите сервер разработки, чтобы увидеть шаблон в действии:
pnpm devnpm run devyarn devВаш сайт теперь должен быть доступен по адресу http://localhost:4321 🎉
Структура проекта
Обзор структуры папок проекта:
- src/
- components/
- sections/
- hero/
- HeroLiquid.astro
- HeroGlass.astro
- HeroNeo.astro
- …
- features/
- pricing/
- about/
- portfolio/
- …
- hero/
- layout/
- header/
- ui/
- docs/
- mdx/
- sections/
- config/
- themes.ts
- locales.ts
- docs.ts
- navigation.ts
- content/
- docs/
- en/
- ru/
- blog/
- docs/
- locales/
- en/
- ru/
- pages/
- index.astro
- [theme].astro
- docs/
- blog/
- styles/
- global.css
- _themes.css
- components/
- components/
- public/
- astro.config.mjs
- package.json
Выбор темы
Шаблон поставляется с 6 великолепными темами:
| Тема | Описание |
|---|---|
| Liquid | Плавные анимации, градиентные фоны |
| Glass | Эффекты стекломорфизма, полупрозрачные панели |
| Neo | Смелая типографика, сильный контраст |
| Luxury | Элегантные золотые акценты, премиальный вид |
| Minimal | Чистый, сфокусированный дизайн без лишних деталей |
| Aurora | Иммерсивные градиенты, геометрическая структура |
Чтобы переключить тему, воспользуйтесь переключателем в шапке сайта или посетите демонстрационные страницы тем напрямую (например, /liquid, /glass, /aurora).
Следующие шаги
Теперь, когда ваша среда разработки настроена:
- Система тем — Узнайте, как работает архитектура динамических тем
- Маршрутизация и i18n — Добавьте поддержку новых языков
- Развёртывание на Cloudflare — Разверните проект на Cloudflare Pages
Ознакомьтесь с руководством по формам и валидации или создайте тикет, если у вас возникли проблемы.