Jedna z trudności, których doświadczyłem, kiedy spróbuj przejść od Worpress do Jekyll fMuszę zrozumieć, do czego służył każdy komponent i jak współdziałały ze sobą. Znalazłem rozwiązanie, gdy przestałem tworzyć bloga od zera i zacząłem używać inżynierii wstecznej temat opracowany przez kogoś innego. Zalety open source.
Aby rozpocząć, zakładając, że masz zainstalowane wymagania wstępne, które opisaliśmy w poprzednich artykułach, zamierzamy zbudować naszą witrynę. Przykładem jest blog ogrodniczy.
jekyll new blog_de_jardineria
Jeśli przejdziesz do folderu, zobaczysz następujące informacje:
- Folder o nazwie _posty.
- Dwa pliki z rozszerzeniem Markdown
- Strona internetowa.
- Plik konfiguracyjny z rozszerzeniem .yml, który szczegółowo omówimy w następnym artykule.
- Plik Gemfile zawierający listę składników witryny i inny o tej samej nazwie, ale z rozszerzeniem .lock, które zapobiega niezamierzonym modyfikacjom.
Struktura projektu
Jak każda witryna oparta na WordPressie, Jekyll tworzy również strukturę folderów, w której przechowuje wszystkie pliki, i robi to z tych samych powodów. Pozwól użytkownikowi grupować pliki w uporządkowany sposób, a wraz z rozwojem projektu pozostań w zarządzaniu.
Tworzymy folder podstawowy za pomocą polecenia jekyll new. Wewnątrz znajduje się dwa rodzaje folderów; te, które są związane z konfiguracją bloga, które są oznaczone myślnikiem przed nazwą (w naszym przypadku folder _post i te, które mają zasoby, które nie zostaną uwzględnione w procesie tworzenia. Na przykład te, które zawierać obrazy.
Foldery oparte na zawartości
W tej grupie se przechowuje treści przeznaczone dla osób odwiedzających serwis
_ Poczta
Folder _POST zawiera wszystkie wpisy na blogu. Tutaj dla każdego z zapisanych w nim plików używany jest bardzo specyficzny format. Nazwa pliku musi mieć format data-nazwa-pliku - rok- miesiąc- data- pełna_nazwa_pliku.md - a ta data publikacji będzie wyświetlana jako data opublikowania tego posta na blogu Jekyll. Należy pamiętać, że chociaż folder nosi nazwę _ postów, tutaj jest cała treść, którą zobaczą czytelnicy bloga, na przykład formularz kontaktowy lub biografie autorów. Później zobaczymy, że można przypisać różne projekty do stron.
_warcaby
Jest to odpowiednik zapisywania wersji roboczej WordPressa. Zalecane jest użycie w przypadku postów, które nie są gotowe do publikacji, chociaż można ich użyć do przechowywania list pomysłów, projektów do późniejszego wykorzystania itp.
_ zawiera
W tej przestrzeni możemy przechowywać kod html, który można wielokrotnie wykorzystać. Na przykład w naszym przypadku baner witający początek sezonu w zależności od półkuli, na której znajduje się użytkownik.
_układy
Jak powiedzieliśmy powyżej, różne części treści mogą wymagać różnych układów. Na przykład, aby pokazać wideo, możemy chcieć, aby strona była pojedynczą kolumną, podczas gdy jeśli jest to gość będący autorem, potrzebowalibyśmy kolumny, aby pokazać ich biografię i dane kontaktowe. W tym folderze przechowywane są różne projekty, z których będzie korzystać witryna.
Foldery informacyjne
Te dwa foldery są wykorzystywane przez witrynę do jej działania.
_dane
W jednoosobowym blogu plik konfiguracyjny może przechowywać wszystkie niezbędne dane. Jeśli jednak mamy bloga z wieloma autorami, potrzebny jest inny sposób zarządzania informacjami. Folder _dane Służy do przechowywania danych w formatach JSON lub CSV, które witryna może pobrać w zależności od interakcji z użytkownikami.
_Jeśli ty
Folder _Jeśli ty Witryna uzupełnia go o wszystkie informacje dostępne w poprzednich folderach. Tutaj znajdziemy witrynę, którą prześlemy na serwer, aby użytkownicy mieli do niej dostęp. Oczywiście, ponieważ jest to kod html i css, można go modyfikować jak każdą inną stronę internetową.
W następnym artykule zaczniemy modyfikować plik konfiguracyjny.