Pierwsze kroki
Twój pierwszy wpis z Chirping Astro. Dowiedz się, jak skonfigurować stronę, pisać wpisy i wdrożyć projekt.
Witaj na swoim nowym blogu! Ten wpis przeprowadzi Cię przez podstawy Chirping Astro.
Otwórz src/config.ts i zmodyfikuj:
- title — nazwa Twojej strony/bloga
- description — wyświetlana w wyszukiwarkach i kanale RSS
- author.name — wyświetlana na pasku bocznym i w stopce
- url — Twój produkcyjny URL (przez zmienną
SITE_URLprzy wdrożeniu)
Skopiuj .env.example do .env:
cp .env.example .envNajważniejsze zmienne:
| Zmienna | Rola |
|---|---|
SITE_URL | Twój produkcyjny URL (np. https://moj-blog.pl) |
BASE_PATH | /nazwa-repo dla GitHub Pages, puste dla domeny głównej |
PUBLIC_GITHUB_HANDLE | Wyświetla ikonę GitHub na pasku bocznym |
PUBLIC_GISCUS_* | Włącza komentarze Giscus (poradnik) |
Twórz pliki Markdown w src/content/posts/pl/:
---title: 'Mój pierwszy wpis'description: 'Krótki opis do SEO i list wpisów.'pubDate: 2026-05-03tags: [tag1, tag2]categories: [Kategoria]translationKey: moj-wpis---
Napisz tu swoją treść w standardowym Markdown.| Pole | Wymagane | Opis |
|---|---|---|
title | Tak | Tytuł wpisu (1–140 znaków) |
description | Tak | Meta opis (1–280 znaków) |
pubDate | Tak | Data publikacji (format ISO) |
tags | Nie | Tablica tagów |
categories | Nie | Tablica kategorii |
heroImage | Nie | Ścieżka do obrazu wyróżniającego |
pinned | Nie | Przypnij na górze list |
toc | Nie | Pokaż spis treści |
draft | Nie | Ukryj w produkcji |
translationKey | Nie | Wspólny klucz z angielską wersją |
Wpisy są powiązane między językami przez pole translationKey. Utwórz plik w src/content/posts/en/ i drugi w src/content/posts/pl/ z tym samym kluczem, aby aktywować przełącznik języka.
Wypchnij zmiany na gałąź main na GitHub. Dołączony workflow automatycznie zbuduje i wdroży stronę na GitHub Pages.
Aby użyć własnej domeny, ustaw SITE_URL w zmiennych środowiskowych repozytorium w Settings → Environments → github-pages.
Miłego blogowania! Usuń ten wpis, gdy będziesz gotowy opublikować własną treść.