Как да

Инсталирайте и използвайте Zola Static Site generator

Инсталирайте и използвайте Zola Static Site generator

Генераторът на статични сайтове (SSG) е инструмент, който генерира пълен статичен HTML уебсайт въз основа на сурови данни и набор от шаблони. Zola е един такъв инструмент, подобен на Hugo, Pelican и Jekyll. Той е написан на Rust и използва двигател на шаблони Tera, който е подобен на Jinja2, шаблони на Django, Liquid и Twig. Съдържанието е написано в CommonMark, силно дефинирана, силно съвместима спецификация на Markdown. Източник: уебсайт Zola

Трябва да се отбележи, че в сравнение с други сайтове, статичните сайтове са много бързи и не изискват бази данни, което ги прави лесни за хостване. В това ръководство ще инсталираме и използваме Zola, за да създадем проста статична страница. Преди всичко друго, трябва да започнем с инсталирането му, след което ще продължим да създаваме и попълваме статичен сайт.

Инсталиране на Zola на Linux | macOS

Екипът на Zola свърши фантастична работа, като се увери, че много дистрибуции и операционни системи могат да имат достъп до Zola с лекота. Можем да инсталираме Zola както следва на различни платформи.

macOS

Ако сте на Mac, можете да вземете Zola от Brew по следния начин:

варете инсталирайте

Arch Linux

Благочестивите потребители на Arch Linux ще имат какво да кажат, когато ги информираме, че Zola се предлага в официалните хранилища на Arch Linux. Една проста команда е достатъчна, за да го изтеглите и инсталирате. Изпълнете следната команда, за да го направите.

sudo pacman -S zola

Alpine Linux

За тези, които предпочитат Alpine Linux, Zola се предлага в официалното хранилище на Alpine Linux, засега само в най-новата версия. Така че можете да го инсталирате по следния начин:

apk добави zola --repository http: // dl-cdn.алпинелинукс.org / alpine / edge / community /

Fedora

За всички любители на Fedora вие не сте изоставени. Zola е достъпна в официалните хранилища от Fedora 29! Вземете го във вашата машина / сървър така:

sudo dnf инсталирай zola

Празно Linux

Фенове на празнотата, ето вашето време. Ще се радваме да чуем, че Zola се предлага в официалните хранилища на Void Linux. Така че просто ще го инсталирате като други приложения като това:

sudo xbps-install zola

FreeBSD

Независимо от това, FreeBSD не е изостанал. Zola се предлага в официалното хранилище на пакети. Всички потребители на FreeBSD и които биха искали да използват Zola, могат да го инсталират толкова просто, колкото да изпълнят тази команда:

pkg инсталиране на zola

OpenBSD

Освен това Zola се предлага в официалното хранилище на пакети на OpenBSD. За да го инсталирате в операционната система OpenBSD, е достатъчно да изпълните командата по-долу.

doas pkg_add zola

Snapcraft

Ако по една или друга причина не можете да намерите Zola в нито едно от хранилищата като в Ubuntu, можете да използвате Snap store. Zola се предлага в snapcraft и ако приемете, че сте инсталирали snap, можете да инсталирате Zola, както следва:

sudo snap install --edge zola

Използване на Zola Static Site generator

В зависимост от операционната система или дистрибуцията, които използвате в момента, ние вярваме, че Zola вече е инсталирана и готова за използване. Както се досещате, веднага ще преминем към подробностите за това как работи Zola и ще направим това, като направим прост сайт. С примера се надяваме, че ще ви бъде по-лесно да надграждате върху него и да създавате своите пълноценни уебсайтове. Нека започнем:

Стъпка 1: Инициализирайте вашия блог или уебсайт

Първата стъпка е да инициализирате вашия блог или уебсайт, защото за разлика от някои генератори на статични сайтове, Zola не прави предположения относно структурата на вашия сайт. Ще ви бъдат зададени няколко въпроса, така че Zola ще разбере как ще поръча повечето от нещата, от които се нуждаете. Инициализирайте сайта си, както следва. Можете да замените „computingforgeeksite”С всяко име, което харесвате.

cd ~ zola init computingforgeeksite

След стартиране на тази команда ще възникнат следните въпроси

> Какъв е URL адресът на вашия сайт? (https: // пример.com): // computingforgeeks.com> Искате ли да активирате компилирането на Sass? [Y / n]:> Искате ли да активирате подчертаването на синтаксиса? [y / N]:> Искате ли да изградите индекс за търсене на съдържанието? [y / N]: Готово! Вашият сайт е създаден в / home / vagrant / computingforgeeksite

След като приключите с отговорите на въпросите, сега трябва да имате „computingforgeeksite”Директория със следната структура:

├── конфигурация.toml ├── съдържание ├── sass ├── статично ├── шаблони └── теми

За да докажем, че нашата Zola работи, можем да стартираме сървъра за разработка на Zola със следната команда:

$ cd ~ / computingforgeeksite $ zola serve -i 172.23.209.227 Изграждане на сайт ... -> Създаване на 0 страници (0 сираци), 0 секции и обработка на 0 изображения

Когато отворите браузъра си и зададете идентификатор на име на домейн или IP адрес на вашия сървър (http: // Име на домейн | IP адрес: 1111). Ако сървърът ви е на отдалечено място и имате работеща защитна стена, трябва да разрешите порт 1111. Трябва да видите страница, подобна на споделената по-долу.

Стъпка 2: Създайте примерна начална страница

Както беше споменато в уводния раздел на това ръководство, Zola използва механизма за шаблони на Tera, който е подобен на Jinja2, шаблоните на Django, Liquid и Twig. Ще видим как работи този механизъм за шаблониране тук. Нека отидем до директорията с шаблони, след което създадем основен шаблон, който другите страници ще използват повторно.

$ cd ~ / computingforgeeksite / шаблони $ vim base.html     Блог на ComputingForGeeks   
% block content% % endblock% ## Този раздел се възползва от механизма за шаблониране на Tera. Други страници ще бъдат инжектирани тук.

Този основен шаблон може да бъде разширен от други страници, така че повтарящите се раздели просто да се обработват от тази основна страница. Другите страници ще се фокусират върху специфичната функционалност, за която са предназначени. За да видим как се прави това, нека създадем страница с индекс, която ще разшири този основен шаблон.

В същата директория на шаблони създайте индекс.html файл

% удължава "база.html "% % block content% 

Страница ComputingForGeeks, разширяваща основния шаблон с помощта на механизма за шаблониране на Tera.

% endblock content%

Текстът между % block content% и % endblock content% таговете ще бъдат инжектирани в основния шаблон.
В този момент, ако стартираме нашия zola сървър и посетим http: // Име на домейн | IP адрес: 1111, ще видим страница като по-долу:

Стъпка 3: Добавяне на малко съдържание

В Zola има нещо, наречено a “Раздел„. Секция се създава, когато директория (или поддиректория) в директорията със съдържание съдържа „_index.md”Файл. Ако директория не съдържа _index.md файл, няма да бъде създаден раздел, но Markdown файловете в тази директория все пак ще създават страници (известни като страници сираци).

Преди да продължим, ще започнем, като направим „сайт”В директорията на съдържанието, след което създайте“_index.md”Файл вътре в него.

Този файл казва на Zola, че „сайт”Е раздел, който е начинът на категоризиране на съдържанието в Zola.

mkdir ~ / computingforgeeksite / content / site

Вътре в _index.md файл, имаме възможност да предадем някои променливи, които можем да използваме в нашите страници. В това, нека зададем следните променливи във формат TOML:

$ cd ~ / computingforgeeksite / content / site $ vim _index.md +++ title = "Речник на публикациите в блога на Geeks" sort_by = "date" template = "сайт.html "page_template =" сайт-страница.html "+++ ## Публикации в блога тук

Стъпка 4: Създайте шаблони за сайтове

След като информирахме „_index.md“Файл за търсене“сайт.html”Шаблон като основен шаблон за изброяване на файловете Markdown в този раздел и заредете“сайт-страница.html"Като шаблон за отделни файлове на сайта Markdown, нека продължим и създаваме тези файлове в"шаблони”Директория.

$ cd ~ / computingforgeeksite / шаблони $ nano сайт.html % разширява "база.html "% % block content% 

раздел.заглавие

% endblock content%

сайт.html разширява базата.html, но този път използваме този шаблон, за да изброим публикациите в блога. Заглавието, което зададохме в _index.md файлът по-горе ни е достъпен като раздел.заглавие . В списъка под заглавието прелистваме всички страници в нашия раздел (директория на сайта) и извеждаме заглавието и URL адреса на страницата, като използваме страница.заглавие и страница.постоянна връзка | безопасно, съответно.

В този момент, когато стартираме zola сървъра и насочим браузъра си към http: // Име на домейн | IP адрес: 1111/сайт, трябва просто да видим заглавието, както следва:

Стъпка 5: Създайте съдържание за маркиране

Страниците, които ще зареждаме в областта на раздела, са във формат за намаление и те трябва да бъдат в директорията „сайт“. В директорията на сайта създайте файл, наречен blog1.md със следното съдържание:

$ cd ~ / computingforgeeksite / content / site $ nano blog1.md +++ title = "Моята първа уеб страница" дата = 2021-04-18 +++ Това е първата ми публикация в блога за изчисления за отрепки.

Заглавието и датата ще бъдат достъпни за нас на страницата на сайта.html шаблон като страница.заглавие и страница.дата , съответно. Целият текст под затварянето +++ ще ни бъде на разположение като страница.съдържание.

В този момент, когато стартираме zola сървъра и насочим браузъра си към http: // Име на домейн | IP адрес: 1111/сайт, би трябвало да видим заглавието и първото заглавие на файла като хипервръзка по следния начин:

Нека добавим сайт-страница.html файл на същото място

% удължава "база.html "% % block content% 

страница.заглавие

страница.дата

страница.съдържание | безопасно % endblock content%

След добавяне на този шаблон можем да задействаме zola сървъра и когато насочим браузъра си към http: // Име на домейн | IP адрес: 1111 / site / bolg1, трябва да видим цялото съдържание на файла за маркиране, както е показано по-долу:

Стъпка 6: Внедряване на готови файлове

След като приключим със стилизирането и настройката или блога, е време да го покажем на вашите приятели. Zola сървърът може да се използва за изграждане на вашия сайт с „zola build”Команда. Командата създава сайта в публичната папка / папка, която можете лесно да копирате във вашия уеб сървър, Vercel, Netlify, GitHub Pages и т.н.

Това е последната файлова структура за този изследван пример.

├── конфигурация.toml ├── съдържание / │ └── блог / │ ├── _index.md │ └── блог1.md ├── sass / ├── статични / ├── шаблони / │ ├── база.html │ ├── страница-сайт.html │ ├── сайт.html │ └── индекс.html └── теми /

Заключителни бележки

Това е само върхът на айсберга за Зола. Той се предлага с много повече такива като теми, интеграция с CSS Frameworks и много други. Можете да научите повече за Zola в нейната Основна уеб страница, докато се подготвяте да се справите добре с този прекрасен статичен генератор на сайтове.

Legend of Fae Преглед на играта Bejeweled + RPG = Пристрастяване [Безплатно подарък]
Сигурен съм, че сте играли Bejeweled или друг подобен вид игра за размяна на скъпоценни камъни преди. Сигурен съм, че и вие сте играли RPG игра, къдет...
PS Сега срещу. Външен твърд диск, който е най-подходящ за вас?
Ако притежавате PS4 и обичате да изтегляте игри, има голяма вероятност да знаете болката от деинсталирането и преинсталирането на игри, за да управляв...
Как да използваме Google Assistant с Xbox One
Забравете Cortana, вече можете да използвате Google Assistant с вашия Xbox One. С интеграцията на Google Assistant можете да използвате гласа си, за д...