Hello Astro は、Typescript と TailwindCSS で書かれたフル機能の Astro 多目的スターター テーマです。 Markdown および MDX ベースのページとブログ投稿をサポートします。
Hello Astro は、次のいずれかまたはすべてに使用できます。
次の統合を使用します。
さらに、SVG および PNG イラストは Undraw から提供されています。
このプロジェクトは当初、hello-gatsby-starter の最低限の移植として始まりましたが、現在はさらに多くの機能 (ライト/ダーク モード、カテゴリ ページ、検索、図、数学など) が含まれています。
$
... $
または$$
... $$
で囲まれています)mermaid
、 markmap
、 plantuml
のコード ブロックとして作成)Map
コンポーネントを使用して地図を地理座標とズーム レベルで表示します ( extra: ['map']
はページの CSS/JS アセットをロードするためのフロントマターです)開始では次の外部パッケージを使用します。
Git リポジトリから静的バージョンを自動的に構築することで、JAMstack アーキテクチャに従っています。デモは Github Pages にデプロイされます。
このスターター内には、次のフォルダーとファイルが表示されます。
/
├── public/
│ └── favicon.ico
├── src/
│ ├── assets/
│ │ ├── image.png
│ │ └── gallery/
│ │ └── gallery-name/
│ │ └── image.jpg
│ ├── components/
│ │ └── header.astro
│ ├── content/
│ │ ├── blog/
│ │ | └── 2022-08-01-post.md
│ │ ├── doc/
│ │ | └── documentation-page.md
| │ └── config.ts
│ ├── layouts/
│ │ ├── base.astro
│ │ ├── blog.astro
│ │ └── doc.astro
│ ├── pages/
│ │ ├── index.astro
│ │ └── contact.astro
│ └── config.ts
└── package.json
Astro は、 src/pages/
ディレクトリで.astro
、 .md
、または.mdx
ファイルを探します。各ページは、ファイル名に基づいてルートとして公開されます。
src/components/
は Astro コンポーネントを配置し、同様にレイアウトの場合はsrc/layouts/
を配置します。
画像はsrc/assets/
に配置できます。
ブログとドキュメントのコンテンツは、 Markdown ファイルまたは MDX ファイルのコレクションとしてsrc/content
に作成されます。
あらゆる静的資産。画像はpublic/
ディレクトリに配置できます。
すべてのコマンドは、プロジェクトのルートまたはターミナルから実行されます。
指示 | アクション |
---|---|
pnpm install | 依存関係をインストールします |
pnpm dev | localhost:3000 でローカル開発サーバーを起動します |
pnpm build | 運用サイトを./dist/ に構築します。 |
pnpm preview | デプロイする前にビルドをローカルでプレビューする |
pnpm lint | ソースコードをきれいに出力する |
pnpm check | ソースコードにエラーがないか確認してください |
pnpm astro ... | astro add 、 astro preview などの CLI コマンドを実行します。 |
pnpm astro --help | Astro CLI を使用してヘルプを表示する |
@astrojs/images
svg
サポートするようになったため、特別な処理が必要なくなりました@astrojs/markdoc
0.4.x および最新の astro にアップグレードする