Instalacja Astro za pomocą automatycznego CLI
Gotów do instalacji Astro? Podążaj za tym poradnikiem korzystając z CLI create astro aby rozpocząć.
Wymagania
Dział zatytułowany Wymagania- Node.js -
v18.17.1lubv20.3.0lub nowsza. (v19nie jest obsługiwana.) - Edytor tekstu - Zalecamy VS Code z naszym Oficjalnym rozszerzeniem Astro.
- Terminal - Dostęp do Astro uzyskuje się poprzez interfejs wiersza poleceń (CLI).
Instalacja
Dział zatytułowany Instalacjacreate astro to najszybszy sposób na rozpoczęcie nowego projektu Astro od podstaw. Przeprowadzi Cię przez każdy krok tworzenia nowego projektu oraz pozwoli Ci wybrać spośród kilku oficjalnych szablonów startowych bądź użyć dowolnego istniejącego projektu na GitHubie za pomocą argumentu --template.
1. Uruchamianie kreatora
Dział zatytułowany 1. Uruchamianie kreatoraWykonaj następujące polecenie w swoim terminalu, aby uruchomić nasz kreator instalacji:
# utwórz nowy projekt z npmnpm create astro@latest# utwórz nowy projekt z pnpmpnpm create astro@latest# utwórz nowy projekt z yarnyarn create astroMożesz wykonać create astro w dowolnym miejscu na swoim komputerze, więc nie ma potrzeby tworzenia nowego pustego katalogu dla twojego projektu przed rozpoczęciem. Jeśli nie masz jeszcze pustego katalogu dla swojego nowego projektu, kreator pomoże Ci go automatycznie utworzyć.
Jeśli wszystko pójdzie dobrze, zobaczysz komunikat “Liftoff confirmed. Explore your project!”, po czym otrzymasz zalecane następne kroki. Przejdź do katalogu z nowym projektem za pomocą polecenia cd, aby rozpocząć korzystanie z Astro.
Jeśli pominięto krok npm install podczas kreatora CLI, upewnij się że zainstalujesz zależności przed kontynuowaniem.
2. Uruchamianie Astro ✨
Dział zatytułowany 2. Uruchamianie Astro ✨Astro posiada wbudowany serwer deweloperski, który ma wszystko czego potrzebujesz do pracy nad projektem. Polecenie astro dev uruchomi lokalny serwer deweloperski, co pozwala zobaczyć swoją nową stronę w akcji po raz pierwszy.
Każdy szablon startowy posiada wstępnie skonfigurowany skrypt, który uruchomi dla Ciebie astro dev. Użyj swojego ulubionego menedżera pakietów, aby wykonać to polecenie i uruchomić serwer deweloperski Astro.
npm run devpnpm run devyarn run devJeśli wszystko pójdzie dobrze, Astro powinno teraz wyświetlać Twój projekt na http://localhost:4321/!
Astro będzie nasłuchiwać zmian plików w katalogu src/, więc nie musisz restartować serwera gdy dokonasz w nich zmian podczas pracy nad projektem.
Wejście na stronę w przeglądarce umożliwi korzystanie z narzędzi deweloperskich Astro. Pomogą Ci one inspekcjonować wyspy, znajdywać problemy z dostępnością oraz wiele więcej.
Jeśli nie jesteś w stanie otworzyć swojego projektu w przeglądarce, wróć do terminala, w którym wykonano komendę dev i sprawdź czy nie wystąpił błąd lub czy Twój projekt nie jest dostępny pod innym adresem URL niż ten, który został podany wyżej.
Szablony startowe
Dział zatytułowany Szablony startoweMożesz również rozpocząć nowy projekt astro oparty na oficjalnym przykładzie lub gałęzi main dowolnego repozytorium GitHub, przekazując argument --template do polecenia create astro.
# utwórz nowy projekt z oficjalnym przykłademnpm create astro@latest -- --template <nazwa-przykładu>
# utwórz nowy projekt na podstawie głównej gałęzi repozytorium GitHubnpm create astro@latest -- --template <użytkownik-githuba>/<repozytorium># utwórz nowy projekt z oficjalnym przykładempnpm create astro@latest -- --template <nazwa-przykładu>
# utwórz nowy projekt na podstawie głównej gałęzi repozytorium GitHubpnpm create astro@latest -- --template <użytkownik-githuba>/<repozytorium># utwórz nowy projekt z oficjalnym przykłademyarn create astro@latest -- --template <nazwa-przykładu>
# utwórz nowy projekt na podstawie głównej gałęzi repozytorium GitHubyarn create astro@latest -- --template <użytkownik-githuba>/<repozytorium>Domyślnie, polecenie to użyje gałęzi main danego repozytorium. Aby użyć innej gałęzi, przekaż ją jako część argumentu --template: <użytkownik-githuba>/<repozytorium>#<gałąź>.
Zerknij na nasz pokaz motywów i szablonów, gdzie możesz przeglądać motywy dla blogów, portfolio, dokumentacji, stron startowych i wielu innych! Możesz również szukać na GitHubie, aby znaleźć jeszcze więcej projektów startowych.
Następne kroki
Dział zatytułowany Następne krokiSukces! Jesteś teraz gotów aby rozpocząć tworzenie z Astro! 🥳
Oto kilka tematów które polecamy zgłębić. Możesz je czytać w dowolnej kolejności. Możesz nawet zostawić naszą dokumentację na jakiś czas i pobawić się w kodzie swojego nowego projektu Astro, oraz wrócić tutaj za każdym razem gdy napotkasz problemy lub będziesz mieć pytania.