--- title: "Tutorial - Instalacja i konfiguracja Cecil, generatora stron statycznych (SSG) w PHP" description: "Dowiedz się, jak Cecil pozwala na tworzenie strony statycznej przy użyciu nowoczesnego silnika szablonu (Jamstack)" url: https://docs.ovhcloud.com/pl/guides/web-cloud/web-hosting/static-website-installation-cecil lang: pl lastUpdated: 2026-06-08 --- # Tutorial - Instalacja i konfiguracja Cecil, generatora stron statycznych (SSG) w PHP ## Wprowadzenie Tutorial wyjaśnia, jak zainstalować i skonfigurować [Cecil](https://cecil.app/). Jest to aplikacja napisana w PHP pozwalająca na generowanie i administrowanie statycznymi stronami [WWW](http://WWW). Strona www zawierająca statyczne strony internetowe gwarantuje lepszy czas ładowania się strony i większe bezpieczeństwo. Bez dynamicznych treści twoje strony są mocniejsze w obliczu ataków komputerowych. Wygenerowanie strony statycznej daje większą swobodę tworzenia wybranej strony [www](http://www). Zyskujesz również czas, ponieważ nie będziesz musiał zaczynać od zera. **Dowiedz się, jak Cecil pozwala na tworzenie strony statycznej za pomocą nowoczesnego silnika szablonu (Jamstack).** ## Wymagania początkowe - Posiadanie [hostingu OVHcloud](https://www.ovhcloud.com/pl/web-hosting/) z dostępem SSH Dostęp ten pozwala na zainstalowanie w wierszu poleceń jednego lub kilku rozwiązań alternatywnych wobec tych oferowanych domyślnie w naszych pakietach hostingowych. - Zapoznanie się z wprowadzaniem wiersza poleceń. - Możliwość przesyłania plików przez FTP z klientem, takim jak [FileZilla](/pl/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md). - Skonfiguruj swoją strefę DNS, aby przekierować nazwę domeny (lub poddomeny) na Twoje współdzielone hostowanie. Może to być szczególnie przydatne, jeśli chcesz hostować wiele [strony WWW](/pl/guides/web-cloud/web-hosting/multisites-configure-multisite.md) na swoim współdzielonym hostingu. - Zainstaluj wcześniej [Composer](https://getcomposer.org/) z plikiem `composer.phar` w katalogu głównym hostingu lub w katalogu docelowym Twojej domeny. ## W praktyce Współdzielone [hosting współdzielony](https://www.ovhcloud.com/pl/web-hosting/) umożliwia zadeklarowanie domen lub poddomen na stronach internetowych, które zawiera. Domena lub poddomena jest wymagana, aby wdrożyć swoją stronę internetową stworzoną za pomocą **Cecil**. Aby pomóc Ci zadeklarować domenę lub poddomenę na jednej z stron internetowych Twojego hostingu, zapoznaj się z naszą stroną "[Dzielenie się hostowaniem między wiele stron](/pl/guides/web-cloud/web-hosting/multisites-configure-multisite.md)". ### Utwórz katalog, w którym będą Twoje pliki Po zalogowaniu się przez SSH do hostingu, utwórz katalog w katalogu głównym za pomocą polecenia: ```sh mkdir mystaticwebsite ``` Zastąp `mystaticwebsite` wybraną przez Ciebie nazwą katalogu (bez akcentów i spacji). Następnie przejdź do tego katalogu: ```sh cd mystaticwebsite ``` Zastąp `mystaticwebsite` nazwą katalogu. ### Do pobrania W katalogu, który właśnie utworzyłeś, pobierz Cecil: ```sh curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar ``` ### Instalacja Uruchom instalację Cecila za pomocą następującego polecenia: ```sh php cecil.phar new:site ``` Wpisz wymagane elementy: - nazwa Twojej strony _(title)_ - _baseline_ - adres strony internetowej (np. `https://mywebsite.ovh`) - opis strony ![Instalacja Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil01.png) Po wprowadzeniu tych elementów uruchom stronę, wpisując następujące polecenie: ```sh php cecil.phar build ``` Wyświetlając zawartość katalogu, zobaczysz obecność katalogu `_site`. Katalog ten będzie zawierał wszystkie pliki HTML i assets: ![Instalacja Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil02.png) Teraz możesz zobaczyć wynik wyświetlając nazwę Twojej domeny: ![Instalacja Cecil](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil03.png) #### Konfiguracja wskazania domeny lub subdomeny Aby zobaczyć wynik Twojej strony w przeglądarce, zmień wskazanie Twojej domeny lub subdomeny w katalogu `_site` utworzonym poprzednio podczas instalacji **Cecil**. Jeśli Twoja domena lub poddomena znajduje się na serwerze OVHcloud, zapoznaj się z naszymi przewodnikami dotyczącymi [konfiguracji DNS](/pl/guides/web-cloud/domains/dns-zone-edit.md) oraz wdrożenia [strony WWW na Twoim hostingu](/pl/guides/web-cloud/web-hosting/multisites-configure-multisite.md). ### Konfiguracja strony Ogólne informacje dotyczące Twojej strony mogą być skonfigurowane w pliku `config.yml`: ```sh nano config.yml ``` Zastąp Twoje domyślne informacje i zapisz plik. ![Plik konfiguracji YAML](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil04.png) ### Utwórz nową stronę Tworzenie stron zawierających dane strony odbywa się poprzez pliki w formacie _Markdown_. Te strony można spersonalizować. **Cecil** zawiera silnik _template_ [Twig](https://twig.symfony.com/) który jest używany domyślnie z _framework_ [Symfony](https://symfony.com/). foldery i pliki są zorganizowane w następujący sposób: - `assets`: zawiera elementy graficzne, audio i video, skrypty JavaScript i style (CSS, Sass) - `layouts` : katalog, w którym będą _templates_ - `strona`: miejsce, gdzie będą Twoje pliki _Markdown_ - `_site`: katalog, który zawiera wygenerowane pliki i który jest wskazywany przez Twoją domenę - `static`: wszystkie pliki statyczne typu PDF #### Utwórz plik _Markdown_ w wierszu poleceń W katalogu głównym strony wpisz następujące polecenie: ```sh php cecil.phar new:page mypage.md ``` Następnie plik `mypage.md` jest tworzony w katalogu `/pages`. Zastąp `mypage` nazwą swojej strony. ![Instalacja Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil05.png) #### Wygeneruj pliki statyczne Wpisz następujące polecenie w katalogu głównym: ```sh php cecil.phar build ``` Twój plik znajduje się w katalogu `_site/mypage/`: ![Instalacja Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil06.png) Możesz wyświetlić go na Twoim serwerze, wpisując adres URL strony, a następnie `/mypage/`: ![Wynik przeglądarki](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil07.png) ### Personalizacja plików strony #### Zmiana dla serwera Edycja plików _Markdown_ może odbywać się bezpośrednio na serwerze hostingowym. W ofercie [hostingu OVHcloud](https://www.ovhcloud.com/pl/web-hosting/) z dostępem SSH (**od oferty Pro**) możesz korzystać z [GNU nano](https://nano-editor.org/), [vi](https://ex-vi.sourceforge.net/) lub [vim](https://www.vim.org/). Zrzuty ekranu z niniejszego tutoriala przeprowadzono w **GNU nano**. Edytuj plik `mypage.md` znajdujący się w katalogu `pages`, wpisując następujące polecenie, jeśli znajdujesz się w katalogu głównym Twojej strony: ```sh nano pages/mypage.md ``` Zastąp `mypage` nazwą swojej strony. ![Edycja pliku w GNU nano](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil08.png) Dodaj kilka linii zgodnie z składnią _Markdown_: ![Dodaj zawartość do pliku](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil09.png) Usuń pliki w cache za pomocą polecenia: ```sh php cecil.phar clear ``` Zbuduj swoje strony po wykonaniu kopii zapasowej pliku: ```sh php cecil.phar build ``` Następnie wróć na stronę, aby zobaczyć wynik: ![Strona zaktualizowana](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil10.png) #### Zmiana dla Twojego stanowiska pracy Jeśli wolisz używać Twojego zwykłego edytora kodu, zaloguj się z klientem FTP do Twojego serwera, aby pobrać pliki na komputerze: ![Do pobrania z FileZilla](/images/assets/screens/other/web-tools/filezilla/cecil-folder.png) Teraz możesz edytować pliki I.D.E. w swoim repozytorium: ![Wyświetlanie w Visual Studio Code](/images/assets/screens/other/web-tools/vscode/static-website-installation-cecil12.png) Wystarczy przesłać na serwer pliki zmienione lub nowe pliki i _rebuilder_, aby móc udostępniać swoje strony online. ### Dodaj stronę wygenerowaną w menu swojej strony Aby dodać tę nową stronę do menu strony internetowej, ręcznie zmodyfikuj nagłówek pliku `.md`, dodając następujący wiersz: ```sh menu: main ``` ### Podsumowanie **Cecil** jest narzędziem, które pozwala na skuteczne tworzenie strony statycznej z plików _Markdown_ , języka znacznika prostszego do wdrożenia niż HTML. Organizacja plików Markdown warunkuje hierarchię Twoich stron [www](http://www) . Korzystanie z silnika szablonu, bardzo popularnego wśród deweloperów WWW, pozwoli Ci łatwo znaleźć wiele źródeł w Internecie, aby zaprojektować profesjonalny interfejs graficzny. ## Sprawdź również [Dodaj dynamiczne treści do statycznej strony internetowej generowanej przez Cecil](/pl/guides/web-cloud/web-hosting/static-website-installation-cecil-api-call.md) [Oficjalna strona aplikacji Cecil](https://cecil.app/) Un [przewodnik na temat formatu Markdown](https://www.markdownguide.org/) Nasz [Przewodnik dotyczący korzystania z FileZilla](/pl/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md) W przypadku wyspecjalizowanych usług (pozycjonowanie, rozwój, etc.) skontaktuj się z [partnerami OVHcloud](https://partner.ovhcloud.com/pl/directory/). Dołącz do [grona naszych użytkowników](https://community.ovhcloud.com/).