Part 1

AstroGlassを始めよう

テーマ、国際化(i18n)、およびクラウドへのデプロイメントを使用して、Astroテンプレートをセットアップおよびカスタマイズする方法について学びます。

AstroGlassテンプレートへようこそ!このガイドでは、開発環境のセットアップと、ニーズに合わせてテンプレートをカスタマイズする手順を説明します。

前提条件

始める前に、以下がインストールされていることを確認してください:

  • Node.js v20 以上
  • pnpm (推奨) または npm
  • コードエディタ (VS Code を推奨)
💡
プロのヒント

より高速でディスク効率の良いパッケージ管理のために、pnpmの使用を推奨します。

インストール

リポジトリのクローン

まず、テンプレートリポジトリをローカルマシンにクローンします:

Terminal
git clone https://github.com/kamsqee/astroglass.git my-project
cd my-project

依存関係のインストール

お好みのパッケージマネージャーを使用して、プロジェクトの依存関係をインストールします:

Terminal window
pnpm install
Terminal window
npm install
Terminal window
yarn install

開発用サーバーの起動

開発用サーバーを実行して、テンプレートの動作を確認します:

Terminal window
pnpm dev
Terminal window
npm run dev
Terminal window
yarn dev

これで、あなたのサイトが http://localhost:4321 で実行されているはずです 🎉

プロジェクト構造

プロジェクトのフォルダ構造の概要は以下の通りです:

  • src/
    • components/
      • sections/
        • hero/
          • HeroLiquid.astro
          • HeroGlass.astro
          • HeroNeo.astro
        • features/
        • pricing/
        • about/
        • portfolio/
      • layout/
        • header/
      • ui/
      • docs/
      • mdx/
    • config/
      • themes.ts
      • locales.ts
      • docs.ts
      • navigation.ts
    • content/
      • docs/
        • en/
        • ru/
      • blog/
    • locales/
      • en/
      • ru/
    • pages/
      • index.astro
      • [theme].astro
      • docs/
      • blog/
    • styles/
      • global.css
      • _themes.css
      • components/
  • public/
  • astro.config.mjs
  • package.json

テーマの選択

テンプレートには、すぐに使える6つの美しいテーマが用意されています:

テーマ説明
Liquid流れるようなアニメーション、グラデーションの背景
Glassグラスモーフィズム効果、すりガラスのパネル
Neo大胆なタイポグラフィ、強いコントラスト
Luxuryエレガントなゴールドのアクセント、プレミアムな質感
Minimalクリーンで焦点が絞られた、気を散らさないデザイン
Aurora没入感のあるグラデーション、幾何学的な構造

テーマを切り替えるには、ヘッダーのテーマスイッチャーに移動するか、テーマのデモページ(例:/liquid/glass/aurora)に直接アクセスするだけです。

次のステップ

開発環境のセットアップが完了しました:

  1. テーマシステム — ダイナミックなテーマアーキテクチャの仕組みを学ぶ
  2. ルーティング & i18n — より多くの言語のサポートを追加する
  3. Cloudflare へのデプロイ — Cloudflare Pages にデプロイする
ℹ️
ヘルプが必要ですか?

問題が発生した場合は、フォーム & バリデーションガイドを確認するか、issueを作成してください。