Содержание
Учебное пособие: Создание веб-сайта GitLab Pages с нуля
- Предварительные условия
- Создание файлов проекта
- Выбор образа Docker
- Установка Jekyll
- Указание
public
каталог для вывода4 12 90 the90 the 9000 публичный каталог для артефактов - Разверните и просмотрите свой веб-сайт
- Другие параметры файла CI/CD
- Развертывание определенных ветвей на сайте Pages
- Указание этапа развертывания
- Удалить повторяющиеся команды
- Ускорение сборки с помощью кэшированных зависимостей
В этом руководстве показано, как создать сайт Pages с нуля, используя
Генератор статических сайтов Jekyll (SSG). Вы начинаете с
пустой проект и создайте свой собственный файл конфигурации CI/CD, который дает
инструкции бегуну. Когда ваш CI/CD
запускается конвейер, создается сайт Pages.
В этом примере используется Jekyll, но другие группы SSG выполняют аналогичные действия.
Вам не нужно быть знакомым с Jekyll или SSG.
для завершения этого урока.
Чтобы создать веб-сайт GitLab Pages:
- Шаг 1. Создайте файлы проекта
- Шаг 2. Выберите образ Docker
- Шаг 3. Установите Jekyll
- Шаг 4. Укажите каталог
public
для вывода - Шаг 6. Разверните и просмотрите свой веб-сайт
3
4 Шаг 5. Укажите общедоступный каталог
для артефактов
Предварительные условия
У вас должен быть пустой проект в GitLab.
Создать файлы проекта
Создайте три файла в корневом каталоге (верхнего уровня):
.gitlab-ci.yml
: файл YAML, содержащий команды, которые вы хотите запустить.
Пока оставьте содержимое файла пустым.index.html
: файл HTML, который можно заполнить любым содержимым HTML.
вы хотите, например:<голова>
Главная голова> <тело>Привет, мир!
тело>Gemfile
: файл, описывающий зависимости для программ Ruby.Заполните его следующим содержанием:
источник "https://rubygems.org" драгоценный камень "Джекилл"
Выберите образ Docker
В этом примере средство выполнения использует образ Docker
для запуска скриптов и развертывания сайта.
Этот конкретный образ Ruby поддерживается на DockerHub.
Отредактируйте файл .gitlab-ci.yml
и добавьте этот текст в качестве первой строки:
изображение: рубин:2.7
Если вашему SSG требуется NodeJS для сборки, вы должны указать
изображение, которое содержит NodeJS как часть своей файловой системы. Например, для
Hexo-сайт, вы можете использовать изображение : node:12.17.0
.
Установить Джекилл
Чтобы запустить Jekyll локально, его необходимо установить:
- Откройте терминал.
- Установите Bundler, запустив
gem install bundler
. - Создайте
Gemfile.lock
, запустив пакетную установку - Установите Jekyll, запустив
bundle exec jekyll build
.
Чтобы запустить Jekyll в своем проекте, отредактируйте файл .gitlab-ci.yml
.
и добавляем команды установки:
скрипт: - сборщик установки драгоценных камней - пакетная установка - комплект сборки exec jekyll
Кроме того, в файле .gitlab-ci.yml
каждый скрипт
организован заданием
.
Задание
включает в себя сценарии и настройки, которые вы хотите применить к этому конкретному
задача.
задание: сценарий: - сборщик установки драгоценных камней - пакетная установка - комплект сборки exec jekyll
Для страниц GitLab это задание
имеет определенное имя, называемое pages
.
Этот параметр сообщает исполнителю, что вы хотите, чтобы задание развернуло ваш веб-сайт.
с GitLab Страницы:
страниц: сценарий: - сборщик установки драгоценных камней - пакетная установка - комплект сборки exec jekyll
Укажите общедоступный каталог
для вывода
Jekyll должен знать, где генерировать выходные данные.
GitLab Pages рассматривает только файлы в каталоге с именем 9.0012 общедоступный .
Jekyll использует флаг назначения ( -d
), чтобы указать выходной каталог для созданного веб-сайта.
Добавьте пункт назначения в файл .gitlab-ci.yml
:
страниц: сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d public
Укажите общедоступный каталог
для артефактов
Теперь, когда Jekyll вывел файлы в общедоступный каталог
,
бегун должен знать, где их взять. Артефакты хранятся
в общедоступный
каталог:
страницы: сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d public артефакты: пути: - общественный
Ваш файл .gitlab-ci.yml
теперь должен выглядеть так:
image: ruby:2.7 страницы: сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d public артефакты: пути: - общественный
Разверните и просмотрите свой веб-сайт
После выполнения предыдущих шагов,
развернуть свой веб-сайт:
- Сохраните и зафиксируйте файл
.
.gitlab-ci.yml
- Перейдите к CI/CD > Конвейеры , чтобы просмотреть конвейер.
Когда конвейер будет завершен, перейдите в Настройки > Страницы , чтобы найти ссылку на
ваш сайт Страницы.Если этот путь не отображается, выберите Развертывания > Страницы .
Это место является частью эксперимента.
Когда это заданиестраниц
завершается успешно, появляется специальное заданиестраниц: развертывание
.
появляется в представлении конвейера. Подготавливает содержимое веб-сайта к
Демон GitLab Pages. GitLab запускает его в фоновом режиме и не использует бегун.
Другие параметры файла CI/CD
Если вы хотите выполнять более сложные задачи, вы можете обновить файл .gitlab-ci.yml
.
с любым из доступных параметров. Вы можете подтвердить
файл .gitlab-ci.yml
с помощью инструмента CI Lint, входящего в состав GitLab.
В следующих разделах приведены примеры других параметров, которые можно добавить в файл CI/CD.
Развертывание определенных ветвей на сайте Pages
Возможно, вы захотите выполнить развертывание на сайте Pages только из определенных ветвей.
Сначала добавьте раздел рабочего процесса , чтобы конвейер запускался только при внесении изменений.
отправлено в ветки:
изображение: ruby:2.7 рабочий процесс: правила: - если: $CI_COMMIT_BRANCH страницы: сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d public артефакты: пути: - общественный
Затем настройте конвейер для запуска задания для
только ветвь по умолчанию (здесь main
).
изображение: рубин:2.7 рабочий процесс: правила: - если: $CI_COMMIT_BRANCH страницы: сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d public артефакты: пути: - общественный правила: - если: $CI_COMMIT_BRANCH == "основной"
Укажите этап для развертывания
По умолчанию для GitLab CI/CD существует три этапа: сборка, тестирование,
и развернуть.
Если вы хотите протестировать свой сценарий и проверить созданный сайт перед развертыванием
в производство, вы можете запустить тест точно так же, как он выполняется, когда вы
нажмите на ветку по умолчанию (здесь main
).
Чтобы указать этап выполнения задания,
добавьте строку stage
в ваш файл CI:
image: ruby:2.7 рабочий процесс: правила: - если: $CI_COMMIT_BRANCH страницы: этап: развертывание сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d public артефакты: пути: - общественный правила: - если: $CI_COMMIT_BRANCH == "основной" среда: производство
Теперь добавьте еще одно задание в файл CI, указав
тестировать каждое нажатие на каждую ветку , кроме , основная ветка
:
image: ruby:2.7 рабочий процесс: правила: - если: $CI_COMMIT_BRANCH страницы: этап: развертывание сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d public артефакты: пути: - общественный правила: - если: $CI_COMMIT_BRANCH == "основной" среда: производство тест: этап: тест сценарий: - сборщик установки драгоценных камней - пакетная установка - пакет exec jekyll build -d test артефакты: пути: - тест правила: - если: $CI_COMMIT_BRANCH != "основной"
Когда задание test
выполняется на этапе test
, Jekyll
создает сайт в каталоге с именем test
. Работа влияет
все филиалы кроме основной
.
При применении этапов к разным заданиям каждое задание в одном
этап строится параллельно. Если вашему веб-приложению требуется больше, чем
один тест перед развертыванием, вы можете запустить все свои тесты на
в то же время.
Удалить повторяющиеся команды
Чтобы избежать дублирования одних и тех же сценариев в каждом задании, вы можете добавить их
до раздел before_script
.
В примере были запущены gem install bundler
и bundle install
.
для обоих заданий страниц
и тестов
.
Переместите эти команды в раздел before_script
:
image: ruby:2.7 рабочий процесс: правила: - если: $CI_COMMIT_BRANCH до_скрипта: - сборщик установки драгоценных камней - пакетная установка страницы: этап: развертывание сценарий: - пакет exec jekyll build -d public артефакты: пути: - общественный правила: - если: $CI_COMMIT_BRANCH == "основной" среда: производство тест: этап: тест сценарий: - пакет exec jekyll build -d test артефакты: пути: - тест правила: - если: $CI_COMMIT_BRANCH != "основной"
Ускорьте сборку с кэшированными зависимостями
Чтобы сборка выполнялась быстрее, вы можете кэшировать установочные файлы для вашего
зависимости проекта с помощью параметра cache
.
В этом примере зависимости Jekyll кэшируются в каталоге поставщика
.
когда вы запускаете пакет , установите
:
image: ruby: 2.7 рабочий процесс: правила: - если: $CI_COMMIT_BRANCH кеш: пути: - продавец/ до_скрипта: - сборщик установки драгоценных камней - установка пакета --path vendor страницы: этап: развертывание сценарий: - пакет exec jekyll build -d public артефакты: пути: - общественный правила: - если: $CI_COMMIT_BRANCH == "основной" среда: производство тест: этап: тест сценарий: - пакет exec jekyll build -d test артефакты: пути: - тест правила: - если: $CI_COMMIT_BRANCH != "основной"
В этом случае необходимо исключить /vendor
из списка папок, которые создает Jekyll. В противном случае Джекилл
пытается создать содержимое каталога вместе с сайтом.
В корневом каталоге создайте файл с именем _config.yml
и добавьте это содержимое:
исключить: - продавец
Теперь GitLab CI/CD не только создает веб-сайт, но также:
- Подталкивает с помощью непрерывных тестов для добавления веток.
- Кэширует зависимости , установленные вместе с Bundler.
- Непрерывно развертывает при каждой отправке в основную ветку
Чтобы просмотреть HTML и другие ресурсы, созданные для сайта,
загрузить артефакты задания.
- Развертывание веб-приложения для промежуточной и рабочей среды
- Запуск заданий последовательно, параллельно или создание пользовательского конвейера
- Извлечение определенных каталогов из разных проектов
- Использование GitLab Pages для создания отчета о покрытии кода
Как создать адаптивный сайт с нуля | по Ахсан Саид | апрель 2023 г.
Создание адаптивного веб-сайта: советы и рекомендации для достижения успеха
Фото агентства KOBU на Unsplash
Планируете создать веб-сайт, который может адаптироваться к разным размерам экрана? В сегодняшнюю цифровую эпоху наличие адаптивного веб-сайта имеет важное значение. Адаптивный дизайн веб-сайта — это метод, который позволяет вашему веб-сайту настраивать макет в зависимости от размера экрана используемого устройства.
В этой статье мы проведем вас через этапы создания адаптивного веб-сайта с нуля.
Выберите платформу
Когда дело доходит до создания адаптивного веб-сайта, выбор правильной платформы имеет решающее значение. На рынке доступно множество фреймворков, и каждый из них имеет свои сильные и слабые стороны. Некоторые из самых популярных адаптивных фреймворков включают Bootstrap, Foundation и Materialise.
Bootstrap — это широко используемый фреймворк, который предлагает множество функций, таких как сеточная система, адаптивная типографика и готовые компоненты. Он относительно прост в использовании и имеет обширную библиотеку документации, что делает его популярным выбором как для начинающих, так и для опытных разработчиков.
Foundation — еще один популярный фреймворк, предлагающий гибкую систему сеток, готовые компоненты и надежную библиотеку документации. Он также имеет большое сообщество пользователей, которые вносят свой вклад в его развитие и оказывают поддержку.
Materialize — это новая платформа, использующая принципы Material Design для создания красивых и отзывчивых веб-сайтов. Он предлагает предварительно созданные компоненты, адаптивную сетку, а также ряд цветовых схем и вариантов типографики.
При выборе платформы учитывайте требования вашего проекта, уровень знаний и специфические функции, предлагаемые каждой платформой. Также рекомендуется просмотреть примеры веб-сайтов, созданных с использованием каждого фреймворка, чтобы увидеть, какой из них лучше всего соответствует вашим потребностям.
Планирование макета
После того, как вы выбрали структуру, следующим шагом в создании адаптивного веб-сайта является планирование макета. Адаптивный макет гарантирует, что ваш веб-сайт будет отлично выглядеть и работать на всех устройствах, включая настольные компьютеры, ноутбуки, планшеты и смартфоны.
Чтобы спланировать свой макет, вы должны начать с создания каркаса или грубого эскиза вашего веб-сайта. Это поможет вам визуализировать структуру и содержание вашего веб-сайта до того, как вы начнете программировать.
Далее вам следует рассмотреть элементы дизайна вашего веб-сайта, такие как цветовая схема, типографика и изображения. Выберите цветовую схему, которая дополняет ваш бренд и обеспечивает удобочитаемость. Выберите типографику, которая легко читается и соответствует индивидуальности вашего бренда. Выбирайте высококачественные изображения, оптимизированные для Интернета и улучшающие визуальную привлекательность вашего веб-сайта.
Также следует учитывать размещение вашего контента на странице. Используйте систему сеток, чтобы ваш контент был организован и удобен для навигации. Разместите самую важную информацию в верхней части страницы и используйте заголовки и подзаголовки, чтобы разбить контент на управляемые разделы.
Наконец, убедитесь, что ваш сайт доступен для всех пользователей, включая людей с ограниченными возможностями. Используйте теги alt для изображений, добавляйте подписи к видео и убедитесь, что ваш веб-сайт совместим с программами чтения с экрана.
Тщательно спланировав макет, вы сможете создать адаптивный веб-сайт, который одновременно будет эстетически привлекательным и функциональным на всех устройствах.
Выберите цветовую схему и шрифты
Выбор цветовой схемы и шрифтов для вашего веб-сайта — важный шаг в создании адаптивного веб-сайта. Правильная цветовая схема и шрифты могут повысить визуальную привлекательность вашего веб-сайта и создать единый фирменный стиль.
При выборе цветовой схемы учитывайте индивидуальность вашего бренда и эмоции, которые вы хотите вызвать у своих посетителей. Например, синий часто ассоциируется с доверием и профессионализмом, а желтый – с оптимизмом и дружелюбием. Выберите цветовую палитру, которая дополняет индивидуальность вашего бренда и обеспечивает удобочитаемость.
Выбрав цветовую схему, выберите шрифты, которые легко читаются и соответствуют индивидуальности вашего бренда. Рассмотрите возможность использования максимум двух-трех шрифтов для своего веб-сайта и убедитесь, что они одинаковы во всем.
При выборе шрифтов учитывайте стиль шрифта, размер и расстояние между ними. Используйте шрифты без засечек для заголовков и шрифты с засечками для основного текста. Убедитесь, что размер вашего шрифта достаточно велик, чтобы его можно было прочитать на всех устройствах, и используйте соответствующий межстрочный интервал, чтобы улучшить читаемость.
Вы также можете использовать типографику для создания иерархии и акцентов на своем веб-сайте. Используйте жирный шрифт и курсив для выделения, а также используйте заголовки и подзаголовки для создания четкой иерархии информации.
Выбрав цветовую схему и шрифты, которые дополняют индивидуальность вашего бренда, вы можете создать адаптивный веб-сайт, визуально привлекательный и единообразный во всем.
Создайте свои файлы HTML и CSS
После того, как вы спланировали свой макет, выбрали структуру и выбрали цветовую схему и шрифты, следующим шагом в создании адаптивного веб-сайта будет создание файлов HTML и CSS.
HTML (язык гипертекстовой разметки) — это стандартный язык, используемый для создания веб-страниц, а CSS (каскадные таблицы стилей) используется для оформления и компоновки веб-страниц.
Чтобы создать файл HTML, начните с создания нового документа в текстовом редакторе, таком как Блокнот или Sublime Text. Начните с базовой структуры документа HTML, которая включает объявление , тег, тег
и тег.Затем добавьте содержимое в тег
, используя соответствующие теги HTML для форматирования текста и добавления изображений, видео и других медиафайлов. Используйте систему сеток, чтобы ваш контент был организован и удобен для навигации, а также используйте заголовки и подзаголовки для создания четкой иерархии информации.Чтобы оформить веб-страницу с помощью CSS, создайте новый документ в текстовом редакторе и сохраните его как style.css. Используйте CSS для определения шрифта, цвета и макета веб-страницы и свяжите файл CSS с файлом HTML с помощью тега в разделе
вашего файла HTML.
Используйте медиа-запросы, чтобы ваш веб-сайт выглядел великолепно и работал на всех устройствах, включая настольные компьютеры, ноутбуки, планшеты и смартфоны. Медиа-запросы позволяют вам указывать разные стили для разных размеров экрана, гарантируя, что ваш сайт будет отзывчивым и адаптируется к устройству пользователя.
Создавая хорошо структурированные файлы HTML и CSS, вы можете создать адаптивный веб-сайт, визуально привлекательный и функциональный на всех устройствах.
Добавить адаптивные изображения
Добавление адаптивных изображений — важный шаг в создании адаптивного веб-сайта. Адаптивные изображения гарантируют, что ваш веб-сайт будет отлично выглядеть и работать на всех устройствах, включая настольные компьютеры, ноутбуки, планшеты и смартфоны.
Чтобы добавить адаптивные изображения, начните с создания нескольких версий каждого изображения с разными размерами и разрешениями. Используйте программное обеспечение для редактирования изображений, такое как Adobe Photoshop или GIMP, чтобы изменять размер изображений и сохранять их с разными разрешениями.
Затем используйте тег в HTML-коде, чтобы вставить изображения на веб-страницу. Используйте атрибут «srcset», чтобы указать разные версии каждого изображения, и используйте атрибут «sizes», чтобы указать размер контейнера изображения.
Например, следующий код отображает адаптивное изображение, которое адаптируется к размеру устройства пользователя:
srcset="image-480w.jpg 480w,
image-768w.jpg 768w,
image-1024w.jpg 1024w"
size="(max-width: 480px) 100vw,
(max-width: 768px) 50vw,
33.3vw">
В этом примере атрибут «srcset» указывает три версии изображения разной ширины, а атрибут «размеры» указывает ширину контейнера изображения для разных размеров экрана.
Добавив на свой веб-сайт адаптивные изображения, вы можете гарантировать, что ваш веб-сайт будет отлично выглядеть и работать на всех устройствах, что улучшит взаимодействие с пользователем и сделает ваш веб-сайт более доступным для более широкой аудитории.
Протестируйте свой веб-сайт
Тестирование вашего веб-сайта является важным шагом в создании адаптивного веб-сайта. Тестирование гарантирует, что ваш веб-сайт работает и отлично выглядит на всех устройствах, включая настольные компьютеры, ноутбуки, планшеты и смартфоны.
Чтобы протестировать свой веб-сайт, используйте различные устройства и веб-браузеры, чтобы убедиться, что ваш веб-сайт работает корректно. Используйте инструменты разработчика браузера, чтобы протестировать свой веб-сайт на экранах разных размеров и разрешений, а также инструменты онлайн-тестирования, такие как BrowserStack или CrossBrowserTesting, чтобы протестировать свой веб-сайт на нескольких устройствах и веб-браузерах.
Проверьте функциональность своего веб-сайта, включая навигацию, формы и интерактивные элементы, такие как ползунки и раскрывающиеся меню. Убедитесь, что все ссылки работают и все страницы загружаются правильно.
Проверьте скорость и производительность своего веб-сайта, используя онлайн-инструменты тестирования, такие как Google PageSpeed Insights или GTmetrix, чтобы выявить любые проблемы со временем загрузки страницы или производительностью.
Наконец, проверьте свой веб-сайт на доступность, убедившись, что он доступен для пользователей с ограниченными возможностями и соответствует рекомендациям по доступности, таким как Рекомендации по доступности веб-контента (WCAG).
Тщательно протестировав свой веб-сайт, вы можете убедиться, что он функционирует, отлично выглядит и доступен для широкой аудитории, улучшая взаимодействие с пользователями и привлекая трафик на ваш веб-сайт.
Запуск вашего веб-сайта
Запуск вашего веб-сайта — это захватывающий и важный шаг в создании адаптивного веб-сайта. Перед запуском веб-сайта убедитесь, что он полностью функционален, отлично выглядит и оптимизирован по скорости и производительности.
Чтобы запустить свой веб-сайт, вам необходимо получить доменное имя и веб-хостинг. Доменное имя — это адрес вашего веб-сайта, а веб-хостинг — это услуга, которая позволяет вам хранить файлы вашего веб-сайта на сервере и делать их доступными в Интернете.
Если у вас есть доменное имя и веб-хостинг, загрузите файлы веб-сайта в свою учетную запись веб-хостинга с помощью FTP-клиента или веб-файлового менеджера. Убедитесь, что все файлы находятся в правильном месте и что все ссылки работают правильно.
Затем еще раз протестируйте свой веб-сайт, чтобы убедиться, что он полностью функционален и отлично выглядит на всех устройствах и во всех веб-браузерах. Используйте инструменты онлайн-тестирования и попросите друзей и коллег протестировать ваш веб-сайт и оставить отзыв.
Наконец, объявите миру о запуске вашего веб-сайта. Используйте социальные сети, электронную почту и другие маркетинговые каналы для продвижения своего веб-сайта и привлечения на него трафика.
Запуск веб-сайта — это только начало. Продолжайте обновлять и улучшать свой веб-сайт, добавляя новый контент, функции и функции, чтобы он оставался свежим и привлекательным для вашей аудитории.
Создание адаптивного веб-сайта с нуля может быть сложной задачей, но в сегодняшнюю цифровую эпоху это необходимо. Выберите структуру, спланируйте макет, выберите цветовую схему и шрифты, создайте файлы HTML и CSS, добавьте адаптивные изображения, протестируйте свой веб-сайт и, наконец, запустите свой веб-сайт.