Tutorial - Instalacja i konfiguracja Cecil, generatora stron statycznych (SSG) w PHP

Wprowadzenie

Tutorial wyjaśnia, jak zainstalować i skonfigurować Cecil. Jest to aplikacja napisana w PHP pozwalająca na generowanie i administrowanie statycznymi stronami 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. 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 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.
• 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 na swoim współdzielonym hostingu.
• Zainstaluj wcześniej Composer z plikiem composer.phar w katalogu głównym hostingu lub w katalogu docelowym Twojej domeny.

W praktyce

Współdzielone hosting współdzielony 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".

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:

mkdir mystaticwebsite

Zastąp mystaticwebsite wybraną przez Ciebie nazwą katalogu (bez akcentów i spacji).

Następnie przejdź do tego katalogu:

cd mystaticwebsite

Zastąp mystaticwebsite nazwą katalogu.

Do pobrania

W katalogu, który właśnie utworzyłeś, pobierz Cecil:

curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar

Instalacja

Uruchom instalację Cecila za pomocą następującego polecenia:

php cecil.phar new:site

Wpisz wymagane elementy:

• nazwa Twojej strony (title)
• baseline
• adres strony internetowej (np. https://mywebsite.ovh)
• opis strony

Po wprowadzeniu tych elementów uruchom stronę, wpisując następujące polecenie:

php cecil.phar build

Wyświetlając zawartość katalogu, zobaczysz obecność katalogu _site. Katalog ten będzie zawierał wszystkie pliki HTML i assets:

Teraz możesz zobaczyć wynik wyświetlając nazwę Twojej domeny:

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 oraz wdrożenia strony WWW na Twoim hostingu.

Konfiguracja strony

Ogólne informacje dotyczące Twojej strony mogą być skonfigurowane w pliku config.yml:

nano config.yml

Zastąp Twoje domyślne informacje i zapisz plik.

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 który jest używany domyślnie z framework Symfony.

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:

php cecil.phar new:page mypage.md

Następnie plik mypage.md jest tworzony w katalogu /pages.

Zastąp mypage nazwą swojej strony.

Wygeneruj pliki statyczne

Wpisz następujące polecenie w katalogu głównym:

php cecil.phar build

Twój plik znajduje się w katalogu _site/mypage/:

Możesz wyświetlić go na Twoim serwerze, wpisując adres URL strony, a następnie /mypage/:

Personalizacja plików strony

Zmiana dla serwera

Edycja plików Markdown może odbywać się bezpośrednio na serwerze hostingowym. W ofercie hosting Performance dostęp SSH pozwala na korzystanie z protokołu GNU nano, vi lub vim. 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:

 nano pages/mypage.md

Zastąp mypage nazwą swojej strony.

Dodaj kilka linii zgodnie z składnią Markdown:

Usuń pliki w cache za pomocą polecenia:

php cecil.phar clear

Zbuduj swoje strony po wykonaniu kopii zapasowej pliku:

php cecil.phar build

Następnie wróć na stronę, aby zobaczyć wynik:

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:

Teraz możesz edytować pliki I.D.E. w swoim repozytorium:

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:

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.
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

Oficjalna strona aplikacji Cecil

Un przewodnik na temat formatu Markdown

Nasz Przewodnik dotyczący korzystania z FileZilla

W przypadku wyspecjalizowanych usług (pozycjonowanie, rozwój, etc.) skontaktuj się z partnerami OVHcloud.

Dołącz do grona naszych użytkowników.