Pierwsze kroki
Twój pierwszy wpis w Chirping Astro. Dowiedz się, jak skonfigurować stronę, pisać wpisy i wdrażać projekt.
Witaj na swoim nowym blogu! Ten wpis przeprowadzi Cię przez podstawy Chirping Astro.
Otwórz src/config.ts i zmień:
- title - nazwa strony lub bloga
- description - opis widoczny w wyszukiwarkach i RSS
- author.name - nazwa wyświetlana w pasku bocznym i stopce
- url - produkcyjny adres URL (przez zmienną
SITE_URLpodczas wdrożenia)
Skopiuj .env.example do .env:
cp .env.example .envWażne zmienne:
| Zmienna | Rola |
|---|---|
SITE_URL | Produkcyjny adres URL (np. https://mojblog.com) |
BASE_PATH | /<nazwa-repo> dla GitHub Pages, w innym przypadku pozostaw puste |
PUBLIC_GITHUB_HANDLE | Wyświetla ikonę GitHub w pasku bocznym |
PUBLIC_GISCUS_* | Włącza komentarze Giscus (instrukcja) |
Twórz pliki Markdown w src/content/posts/pl/:
---title: 'Mój pierwszy wpis'description: 'Krótki opis dla SEO i list wpisów.'pubDate: 2026-05-03tags: [tag1, tag2]categories: [Kategoria]translationKey: moj-wpis---
Napisz tutaj treść w standardowym Markdown.| Pole | Wymagane | Opis |
|---|---|---|
title | Tak | Tytuł wpisu (1-140 znaków) |
description | Tak | Meta description (1-280 znaków) |
pubDate | Tak | Data publikacji (format ISO) |
tags | Nie | Lista tagów |
categories | Nie | Lista kategorii |
heroImage | Nie | Ścieżka do obrazu wyróżniającego |
pinned | Nie | Przypnij wpis na początku list |
toc | Nie | Pokaż spis treści |
draft | Nie | Ukryj w produkcji |
translationKey | Nie | Klucz współdzielony z wersją angielską |
Wpisy są łączone 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 włączyć przełącznik języka.
Wypchnij zmiany do gałęzi main na GitHubie. Dołączony workflow automatycznie zbuduje i wdroży stronę na GitHub Pages.
Dla własnej domeny ustaw SITE_URL w zmiennych repozytorium w Settings -> Environments -> github-pages.
Udanego blogowania! Usuń ten wpis, gdy będziesz gotowy opublikować własną treść.