Начало работы — HTTP сервер Apache Версия 2.4
HTTP сервер Apache Версия 2.4
Available Languages: en | fr | ru
Если вы абсолютный новичок в работе с HTTP-сервером Apache или в запуске веб-сайтов вообще, вы можете не знать с чего начать или какие вопросы задавать. Этот документ познакомит вас с основами.
- Клиенты, серверы и URL-адреса
- Имена хостов и DNS
- Файлы конфигурации и директивы
- Контент веб-сайта
- Файлы журналов и устранение неполадок
- Что дальше?
См. также
- Comments
Адреса в Интернете записываются с помощью URL — Uniform Resource
Locator (унифицированный указатель ресурса), который указывает на
используемый протокол (например, http
), имя сервера
(например, www.apache.org
), URL-путь (например, /docs/current/getting-started.html
) и, возможно,
строку запроса (например, ?arg=value
), используемую для
передачи серверу дополнительных аргументов.
Клиент (например, веб-браузер) подключается к серверу (например, вашему HTTP-серверу Apache), используя определённый протокол, и отправляет запрос на ресурс, используя URL-путь.
URL-путь может обозначать множество вещей на сервере. Это может быть
файл (как getting-started.html
), обработчик
(как server-status) или файл какой-то
программы (как index.php
). Мы рассмотрим это подробней ниже,
в разделе Контент веб-сайта.
Сервер отправляет ответ, содержащий код состояния и, опционально, тело ответа. Код состояния указывает, был ли запрос успешно обработан, а если нет, то какая ошибка произошла. Это говорит клиенту, что он должен делать с ответом. Вы можете прочитать о возможных кодах ответа на Вики HTTP-сервера Apache.
Детали транзакции и условия возникновения ошибки записываются в файлы журналов. Это описывается более подробно ниже, в разделе Файлы журналов и устранение неполадок.
Для того чтобы соединиться с сервером, клиент сначала должен преобразовать имя сервера в IP-адрес — место в Интернете, где находится сервер.
Таким образом, чтобы ваш веб-сервер был доступен, необходимо, чтобы имя сервера было в DNS.Если вы не знаете как это сделать, вам нужно обратиться к сетевому администратору или поставщику услуг Интернета (провайдеру). Они могут сделать это для вас.
Несколько хостов могут указывать на один и тот же IP-адрес, а один физический сервер может иметь больше одного IP-адреса. Таким образом на одном физическом сервере вы можете запустить больше одного сайта с помощью особенности: виртуальные хосты.
Если вы тестируете сервер, не имеющий выхода в Интернет, можете поместить
имена хостов в файл hosts для того что бы имя разрешалось локально.
Например, вы можете добавить запись для отправки запросов к www.example.com
на локальный компьютер, для тестирования.
Эта запись будет выглядеть так:
127.0.0.1 www.example.com
Файл hosts, скорее всего, расположен в /etc/hosts
или C:\Windows\system32\drivers\etc\hosts
.
Вы можете узнать больше о файле hosts и больше о DNS.
HTTP-сервер Apache настроен с помощью простых текстовых файлов.
Эти файлы могут располагаться в разных местах, в зависимости от того как вы
установили сервер. Общие места расположения файлов можно найти в
Вики
HTTP-сервера Apache. Если вы установили httpd из исходного кода,
то расположение файлов конфигурации по умолчанию следующее: /usr/local/apache2/conf
.
По умолчанию файл конфигурации называется httpd.conf
.
Это тоже может варьироваться в сторонних дистрибутивах сервера.
Конфигурация часто разбивается на несколько небольших файлов, для
удобства управления. Эти файлы загружаются через директиву Include
.
Имена или расположения этих файлов конфигурации
могут сильно отличаться от одной установки к другой.
Расположите и разделите эти файлы наиболее подходящим для вас образом. Если расположение файлов по умолчанию,
не имеет смысла для вас, не стесняйтесь изменить его.
Сервер настраивается путём размещения директив конфигурации в этих файлах конфигурации. Директива — это ключевое слово с одним или несколькими аргументами, устанавливающими её значение.
На вопрос: «Где я должен прописать эту директиву?» – обычно
отвечают, там где ты хочешь использовать её. Если это глобальная настройка,
она должна располагаться в конфигурационном файле вне разделов <Directory>
, <Location>
, <VirtualHost>
или других
разделов. Если настройка относится только к конкретному каталогу,
значит она должна быть внутри секции
,
которая описывает этот каталог, и так далее.
Смотри документ Разделы конфигурации
с подробным описанием вышеуказанных разделов.
В дополнение к основному файлу конфигурации, некоторые директивы могут
располагаться в файлах .htaccess
, расположенных в папках с
контентом. Файлы .htaccess
в первую очередь предназначены для
людей у которых нет доступа к главному конфигурационному файлу сервера.
Вы можете узнать больше о файлах . htaccess
в инструкции .htaccess
.
Содержимое сайта может принимать различные формы, но в широком смысле разделяется на статический и динамический контент.
Статический контент — это, например, HTML-файлы, файлы изображений,
CSS-файлы и другие файлы, которые просто лежат на диске.
Директива DocumentRoot
указывает
где в вашей файловой системе, вы должны разместить эти файлы.
Эта директива устанавливается глобально или отдельно для каждого
виртуального хоста. Посмотрите в своём файле(ах) конфигурации,
чтобы узнать, как именно эта директива используется на вашем сервере.
Обычно, когда запрашивается каталог, без указания имени файла, то будет
отдан документ с именем index.html
. Например, если для директивы DocumentRoot
установлено значение /var/www/html
и приходит запрос на адрес http://www.example.com/work/
,
то файл расположенный по пути /var/www/html/work/index.html
будет отдан клиенту.
Динамический контент — это всё что генерируется во время запроса и может изменяться от запроса к запросу. Существует множество способов создания динамического контента. Различные обработчики доступны для генерации содержимого. Могут быть написаны специальные CGI программы для генерации контента на сайте.
Для написания кода с разнообразным функционалом могут использоваться сторонние модули, такие как mod_php. Множество сторонних приложений, написанных на различных языках программирования, и утилит доступны для скачивания и установки на ваш HTTP-сервер Apache. Поддержка сторонних продуктов выходит за рамки этой документации. При необходимости вы должны самостоятельно найти их документацию или форумы поддержки, где вы сможете получить ответы на свои вопросы.
Для вас, как администратора HTTP-сервера Apache, самые ценные активы — это файлы журналов (лог-файлы), в частности, журнал ошибок. Исправление любой проблемы без журнала ошибок можно сравнить с вождением автомобиля с закрытыми глазами.
Расположение журнала ошибок задаётся директивойErrorLog
,
которая может быть установлена глобально или для каждого виртуального хоста.
Записи в журнале ошибок расскажут вам, что и когда пошло не так.
Зачастую они также смогут подсказать, как что-то исправить.
Каждая запись в журнале ошибок содержит код ошибки,
по которому вы можете поискать в Интернете более подробное
описание того, как решить проблему.
Вы также можете настроить журнал ошибок так, чтобы в него записывался
идентификатор журнала, который можно сопоставить с записями в журнале
доступа — это поможет определить, какой запрос какую ошибку вызвал.Больше о логирование вы можете узнать в документации о журналах.
Теперь, когда вы знакомы с основами, пора двигаться дальше.
Этот документ содержит только базовую информацию. Мы надеемся, что она поможет вам начать работу, но есть множество других вещей, о которых вам, возможно, нужно узнать.
- Загрузки
- Установка
- Настройка
- Старт
- Часто задаваемые вопросы
Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our mailing lists.
🚀 Начало работы
Parcel — это упаковщик для веб-приложений для разработчиков с различным опытом. Он предлагает великолепную быструю работу с использованием многоядерной обработки и не требует настройки.
Сначала установите Parcel с помощью Yarn или npm:
Yarn:
yarn global add parcel-bundler
npm:
npm install -g parcel-bundler
Создайте файл package.json в папке вашего проекта, используя:
yarn init -y
или
npm init -y
Parcel может принимать любой тип файла в качестве точки входа, но лучше всего использовать файл HTML или JavaScript. Если вы подключили свой основной JavaScript-файл в HTML, используя относительный путь, Parcel также обработает его для вас и заменит ссылку URL-адресом на выходной файл.
Далее создайте файлы index.html и index.js.
<html> <body> <script src="./index.js"></script> </body> </html>
console.log('Привет, Мир!')
Parcel имеет встроенный сервер разработки, который будет автоматически пересобирать ваше приложение, так как поддерживает горячую замену модулей для увеличения скорости разработки. Просто выполните команду:
parcel index.html
Теперь откройте http://localhost:1234/ в браузере. Если горячая заменя модулей не работает, возможно вам нужно настроить ваш редактор кода. Вы также можете переопределить порт по умолчанию, с помощью опции параметра -p <port number>
.
Используйте сервер разработки, если у вас нет собственного сервера или ваше приложение полностью отрисовывается на клиенте. Если у вас есть собственный сервер, вы можете запустить Parcel в режиме watch
. Этот режим по-прежнему будет автоматически пересобирать приложение при измении файлов и поддерживает горячую замену модулей, но не запускает веб-сервер.
parcel watch index.html
Вы так же можете воспользоваться сервисом createapp.dev чтобы создать Parcel-проект в браузере. Выбирайте компоненты, которые вам нужны, например React, Vue, Typescript или CSS, и вы увидите сгенерированный в реальном времени шаблон проекта. Вы можете использовать этот сервис в качестве примера настройки нового проекта. Или даже загрузить ZIP-архив с готовым шаблоном и сразу начать работу.
Несколько точек входа
В случае, если в вашем приложении более одной точки входа, например index.html
и about.html
, у вас есть два варианта запуска Parcel:
Указать пути к файлам:
parcel index.html about.html
Использовать glob-правило:
parcel *.html
Обратите внимание: В случае, если в вашем проекте структура директорий похожа на следующую:
- folder-1 -- index.html - folder-2 -- index.html
То переход к http://localhost:1234/folder-1/ не будет работать. Вместо этого вы должны обращаться точно к html-файлу: http://localhost:1234/folder-1/index. html.
Сборка для продакшена
Когда вы готовы для продакшен-сборки, команда Parcel build
не будет отслеживать изменения файлов и просто соберет приложение только один раз. Смотрите подробности в разделе Работа в продакшене.
Добавление Parcel в ваш проект
Бывает, что установить Parcel глобально нет возможности — например, если у вас нет root-доступа к системе или вы используете CI для автоматической сборки вашего проекта. В таком случае вы можете установить и использовать Parcel как локальный пакет.
Чтобы установить с помощью Yarn:
yarn add parcel-bundler --dev
Чтобы установить с помощью NPM:
npm install parcel-bundler --save-dev
Далее, добавьте следующие скрипты в package.json
вашего проекта:
{ "scripts": { "dev": "parcel <your entry file>", "build": "parcel build <your entry file>" } }
Теперь вы можете запускать их из консоли:
# Для запуска в режиме разработки yarn dev # or npm run dev # Для запуска продакшен-сборки yarn build # or npm run build
Помогите нам улучшить документацию
Если что-то отсутствует или не совсем понятно, пожалуйста опишите проблему в репозитории сайта или отредактируйте эту страницу.
Командная строка Git | GitLab
- Выберите терминал
- Подтвердите установку Git
- Настройте Git
- Выберите репозиторий
- Клонировать репозиторий
- Клонировать с помощью SSH
- Клонировать с HTTPS
- Клонировать с помощью токена
- Преобразование локального каталога в репозиторий
- Добавление удаленного
- Просмотр удаленных репозиториев
- Загрузка последних изменений в проекте
- Ветки
- Создать ветку
- Перейти на ветку
- Просмотреть отличия
- Просмотреть файлы, в которых есть изменения
- Добавить и зафиксировать локальные изменения
- Подготовить и зафиксировать все изменения
- Отправить изменения на GitLab.com
- Удалить все изменения в ветке
- Отменить все изменения, которые были добавлены в область подготовки
- Отменить последнюю фиксацию
- Объединить ветку с веткой по умолчанию
- Расширенное использование Git через командную строку
- Синхронизация изменений в разветвленном репозитории с исходным
Git — это распределенная система управления версиями с открытым исходным кодом. GitLab создан поверх Git.
Многие операции с Git можно выполнять непосредственно в GitLab. Однако командная строка требуется для сложных задач, например, исправление сложных конфликтов слияния или откат коммитов.
Если вы новичок в Git и хотите учиться, работая над собственным проектом, узнать, как сделать свой первый коммит.
Для быстрого ознакомления с командами Git загрузите памятку по Git.
Для получения дополнительной информации о преимуществах работы с Git и GitLab:
- Посмотрите пошаговое руководство по управлению исходным кодом GitLab.
- Узнайте, как GitLab стал основой среды разработки Worldline.
Чтобы визуализировать то, что вы делаете локально, вы можете установить Приложение Git с графическим интерфейсом.
Выберите терминал
Чтобы выполнять команды Git на вашем компьютере, вы должны открыть терминал (также известный как команда подсказка, командная оболочка и командная строка). Вот несколько вариантов:
- Для пользователей macOS:
- Встроенный терминал. Нажмите ⌘ команду + пробел и введите
терминал
. - iTerm2. Вы можете интегрировать его с Zsh и Oh My Zsh для выделения цветом и других дополнительных функций.
- Встроенный терминал. Нажмите ⌘ команду + пробел и введите
- Для пользователей Windows:
- Встроенная командная строка. На панели задач Windows выберите значок поиска и введите
cmd
. - PowerShell.
- Гит Баш. Он встроен в Git для Windows.
- Встроенная командная строка. На панели задач Windows выберите значок поиска и введите
- Для пользователей Linux:
- Встроенный терминал Linux.
Подтвердите, что Git установлен
Вы можете определить, установлен ли Git на вашем компьютере, открыв терминал и запустив эту команду:
git --version
Если Git установлен, вывод будет следующим:
git версии X.Y.Z.
Если ваш компьютер не распознает git
как команду, вы должны установить Git.
Настройка Git
Чтобы начать использовать Git со своего компьютера, вы должны ввести свои учетные данные идентифицировать себя как автора своей работы. Имя пользователя и адрес электронной почты должны соответствовать тем, которые вы используете в GitLab.
В вашей оболочке добавьте ваше имя пользователя:
git config --global user.name "your_username"
Добавьте свой адрес электронной почты:
git config --global user.email "[email protected]"
Чтобы проверить конфигурацию, выполните:
git конфиг --global --list
Параметр
--global
указывает Git всегда использовать эту информацию для всего, что вы делаете в своей системе. Если вы опустите--global
или используете--local
, конфигурация будет применяться только к текущему репозиторий.
Подробнее о том, как Git управляет конфигурациями, можно прочитать в Документация по настройке Git.
Выберите репозиторий
Прежде чем начать, выберите репозиторий, в котором вы хотите работать. Вы можете использовать любой проект, на который у вас есть разрешение. доступ на GitLab.com или любой другой экземпляр GitLab.
Чтобы использовать репозиторий в примерах на этой странице:
- Перейдите на https://gitlab.com/gitlab-tests/sample-project/.
- В правом верхнем углу выберите Вилка .
- Выберите пространство имен для своего форка.
Проект становится доступным по адресу https://gitlab.com/
.
Вы можете разветвить любой проект, к которому у вас есть доступ.
Клонировать репозиторий
При клонировании репозитория файлы из удаленного репозитория загружаются на ваш компьютер, и соединение создано.
Для этого подключения необходимо добавить учетные данные. Вы можете использовать SSH или HTTPS. Рекомендуется использовать SSH.
Клонирование с помощью SSH
Клонировать с помощью SSH, если вы хотите пройти аутентификацию только один раз.
- Выполните аутентификацию в GitLab, следуя инструкциям в документации по SSH.
- Перейдите на целевую страницу вашего проекта и выберите Clone . Скопируйте URL-адрес . Клонируйте с помощью SSH .
- Откройте терминал и перейдите в каталог, в который вы хотите клонировать файлы. Git автоматически создает папку с именем репозитория и загружает туда файлы.
Запустите эту команду:
git clone [email protected]:gitlab-tests/sample-project.git
Для просмотра файлов перейдите в новый каталог:
cd sample-project
Вы также можете клонируйте репозиторий и откройте его непосредственно в Visual Studio Code.
Клон с HTTPS
Клонировать с помощью HTTPS, если вы хотите аутентифицироваться каждый раз при выполнении операции между вашим компьютером и GitLab.
- Перейдите на целевую страницу вашего проекта и выберите Клон . Скопируйте URL-адрес . Клонируйте с помощью HTTPS .
- Откройте терминал и перейдите в каталог, в который вы хотите клонировать файлы.
Выполните следующую команду. Git автоматически создает папку с именем репозитория и загружает туда файлы.
клон git https://gitlab.com/gitlab-tests/sample-project.git
GitLab запрашивает ваше имя пользователя и пароль.
Если вы включили двухфакторную аутентификацию (2FA) в своей учетной записи, вы не можете использовать пароль своей учетной записи. Вместо этого вы можете сделать одно из следующего:
- Клонируйте, используя токен с разрешениями
read_repository
илиwrite_repository
. - Установите диспетчер учетных данных Git.
Если вы не включили двухфакторную аутентификацию, используйте пароль своей учетной записи.
- Клонируйте, используя токен с разрешениями
Для просмотра файлов перейдите в новый каталог:
cd sample-project
В Windows, если вы несколько раз неправильно введете пароль и появится сообщение Доступ запрещен
,
добавьте свое пространство имен (имя пользователя или группу) к пути: клон git https://[email protected]/gitlab-org/gitlab.git
.
Клонирование с использованием токена
Клонировать с помощью HTTPS с помощью токена, если:
- Вы хотите использовать 2FA.
- Вы хотите, чтобы отзываемый набор учетных данных был привязан к одному или нескольким репозиториям.
Вы можете использовать любой из этих токенов для аутентификации при клонировании через HTTPS:
- Токены личного доступа.
- Разверните токены.
- Токены доступа к проекту.
- Токены группового доступа.
git clone https://<имя пользователя>:<токен>@gitlab. example.com/tanuki/awesome_project.git
Преобразование локального каталога в репозиторий
Вы можете инициализировать локальную папку, чтобы Git отслеживал ее как репозиторий.
- Откройте терминал в каталоге, который вы хотите преобразовать.
Запустите эту команду:
git init
Папка
.git
создана в вашем каталоге. Эта папка содержит Git записи и файлы конфигурации. Вы не должны редактировать эти файлы напрямую.- Добавьте путь к вашему удаленному репозиторию чтобы Git мог загрузить ваши файлы в правильный проект.
Добавить пульт
Вы добавляете «удаленный», чтобы сообщить Git, какой удаленный репозиторий в GitLab привязан в определенную локальную папку на вашем компьютере. Удаленный сообщает Git, откуда нажимать или извлекать.
Чтобы добавить удаленный сервер в локальную копию:
- В GitLab создайте проект для хранения ваших файлов.
- Посетите домашнюю страницу этого проекта, прокрутите вниз до Нажмите существующую папку и скопируйте команду, начинающуюся с
git remote add
. На вашем компьютере откройте терминал в каталоге, который вы инициализировали, вставьте скопированную команду и нажмите , введите :
git remote add origin [email protected]:username/projectpath.git
После этого вы можете подготовить свои файлы и загрузить их в GitLab.
Просмотр удаленных репозиториев
Чтобы просмотреть удаленные репозитории, введите:
git удаленный -v
Флаг -v
означает подробное описание.
Скачать последние изменения в проекте
Чтобы работать с актуальной копией проекта, вы тянете
, чтобы получить все изменения, сделанные пользователями
с момента последнего клонирования или извлечения проекта. Заменить <название ветки>
с именем вашей ветки по умолчанию
чтобы получить основной код ветки, или заменить его на название ветки ветки
вы сейчас работаете.
git pull <УДАЛЕННЫЙ> <имя-ветки>
Когда вы клонируете репозиторий, REMOTE
обычно представляет собой origin
. Вот где
репозиторий был клонирован, и указывает URL-адрес SSH или HTTPS репозитория
на удаленном сервере.
обычно является названием вашего
ветвь по умолчанию, но это может быть любая
существующая ветка. При необходимости вы можете создать дополнительные именованные пульты и ветки.
Вы можете узнать больше о том, как Git управляет удаленными репозиториями, в Документация Git Remote.
Филиалы
Ветвь — это копия файлов в репозитории на момент создания ветки.
Вы можете работать в своей ветке, не затрагивая другие ветки. Когда
вы готовы добавить свои изменения в основную кодовую базу, вы можете объединить свою ветку в
ветка по умолчанию, например, основная
.
Используйте ветки, когда:
- Хотите добавить код в проект, но не уверены, работает ли он правильно.
- Сотрудничаете над проектом с другими и не хотите, чтобы ваша работа смешивалась.
Новую ветвь часто называют функциональной ветвью , чтобы отличать ее от предыдущей. ветвь по умолчанию.
Создать филиал
Чтобы создать функциональную ветку:
git checkout -b <имя-ветки>
Имена ветвей не могут содержать пробелы и специальные символы. Используйте только строчные буквы, цифры,
дефисы ( -
) и подчеркивания ( _
).
Перейти на филиал
Вся работа в Git выполняется в ветке. Вы можете переключаться между ветвями, чтобы видеть состояние файлов и работать в этой ветке.
Чтобы переключиться на существующую ветку:
git checkout <имя-ветки>
Например, чтобы перейти на ветку main
:
git checkout main
Посмотреть различия
Для просмотра различий между вашими локальными неустановленными изменениями и последней версией которые вы клонировали или вытащили:
git diff
Просмотр файлов с изменениями
Когда вы добавляете, изменяете или удаляете файлы или папки, Git узнает об изменениях. Чтобы проверить, какие файлы были изменены:
статус git
Добавить и зафиксировать локальные изменения
При вводе git status
локально измененные файлы отображаются красным цветом. Эти изменения могут
быть новыми, измененными или удаленными файлами или папками.
Чтобы подготовить файл для фиксации:
git add <имя файла ИЛИ имя папки>
Повторите шаг 1 для каждого файла или папки, которые вы хотите добавить. Или, чтобы подготовить все файлы в текущем каталоге и подкаталоге, введите
git add .
.Подтвердите, что файлы были добавлены в staging:
git status
Файлы должны отображаться зеленым текстом.
Чтобы зафиксировать промежуточные файлы:
git commit -m "КОММЕНТАРИЙ ДЛЯ ОПИСАНИЯ НАМЕРЕНИЯ КОММИТА"
Подготовить и зафиксировать все изменения
В качестве ярлыка вы можете добавить все локальные изменения в staging и зафиксировать их с помощью одной команды:
git commit -a -m «КОММЕНТАРИЙ ДЛЯ ОПИСАНИЯ НАМЕРЕНИЯ КОММИТА»
Отправить изменения на GitLab.
comЧтобы отправить все локальные изменения в удаленный репозиторий:
git push
Например, чтобы отправить ваши локальные коммиты в основную ветку
ветки origin
remote:
git push origin main
Иногда Git не позволяет отправлять в репозиторий. Вместо, вы должны принудительно обновить.
Удалить все изменения в ветке
Чтобы отменить все изменения в отслеживаемых файлах:
git checkout .
Это действие удаляет изменений в файлах, но не в самих файлах. Неотслеживаемые (новые) файлы не изменяются.
Отменить все изменения, которые были добавлены в область подготовки
Чтобы отключить (удалить) все файлы, которые не были зафиксированы:
git reset
Отменить последнюю фиксацию
Чтобы отменить последнюю фиксацию:
git reset HEAD~1
Это действие оставляет измененные файлы и папки неподготовленными в локальном репозитории.
предостережениеКоммит Git не должен быть отменен, если вы уже отправили его в удаленный репозиторий. Хотя вы можете отменить фиксацию, лучше всего избегать ситуацию в целом, работая осторожно.
Вы можете узнать больше о различных способах, которыми Git может отменить изменения в Документация по Git Undoing Things.
Объединить ветку с веткой по умолчанию
Когда вы будете готовы внести свои изменения в ветвь по умолчанию, вы объединяете в нее ветвь функций:
git checkout <ветка по умолчанию> git слить <функция-ветвь>
В GitLab вы обычно используете запрос на слияние для слияния ваших изменений вместо использования командной строки.
Чтобы создать запрос на слияние из форка в вышестоящий репозиторий, см. разветвление рабочего процесса.
Расширенное использование Git через командную строку
Знакомство с более продвинутыми методами Git см. в разделе Git rebase, force-push и конфликты слияния.
Синхронизация изменений в разветвленном репозитории с вышестоящим
Чтобы создать копию репозитория в вашем пространстве имен, вы создаете его форк. Изменения, внесенные в вашу копию репозитория, не синхронизируются автоматически с оригиналом.
Чтобы сохранить синхронизацию проекта с исходным проектом, вам необходимо извлечь
из исходного репозитория.
Вы должны создать ссылку на удаленный репозиторий для извлечения
изменения из оригинального репозитория. Обычно этот удаленный репозиторий называют восходящим
.
Теперь вы можете использовать вверх по течению
как <удаленный>
до вытягивать
новые обновления
из оригинального репозитория и используйте источник
для отправки локальных изменений и создания мерж-реквестов.
Справка и обратная связь
Документы
Редактировать эту страницу чтобы исправить ошибку или добавить улучшение в мерж-реквест.Создать задачу чтобы предложить улучшение этой страницы.
Показывать и оставлять комментарии чтобы просмотреть и оставить отзыв об этой странице.
Продукт
Создать проблему если вам что-то не нравится в этой функции.Предложить функциональность отправив запрос функции.
Присоединяйтесь к первому просмотру чтобы помочь сформировать новые функции.
Доступность функций и пробные версии продуктов
Посмотреть цены для просмотра всех уровней и функций GitLab или для обновления.Попробуйте GitLab бесплатно с доступом ко всем функциям на 30 дней.
Получить помощь
Если вы не нашли то, что искали,
поищите в документах.
Если вам нужна помощь с чем-то конкретным и вам нужна поддержка сообщества,
сообщение на форуме GitLab.
При проблемах с настройкой или использованием этой функции (в зависимости от вашего GitLab
подписка).
Запросить поддержку
Включите JavaScript для просмотра комментарии на базе Disqus.Что нужно и что нельзя делать при добавлении разрыва строки HTML
В HTML абзац всегда начинается с новой строки, но что, если вы хотите, чтобы текст внутри абзаца начинался с новой строки? В этом случае вам нужно будет создать разрыв строки HTML.
Давайте подробнее рассмотрим этот элемент HTML и способы его использования ниже.
Что такое разрыв строки в HTML?
В HTML элемент
создает разрыв строки. Вы можете добавить его туда, где хотите, чтобы текст заканчивался на текущей строке и возобновлялся на следующей. Элемент разрыва строки HTML можно использовать для отображения стихов, текстов песен или других форм содержимого, в которых разделение строк имеет важное значение для значения или внешнего вида содержимого.
Например, вы пишете сообщение в блоге о том, как адресовать конверт или посылку. Вы хотите включить пример того, как форматировать адреса отправителя и получателя. В этом случае вы можете использовать элемент разрыва строки, чтобы поместить имена отправителя и получателя, адреса, города, штаты и почтовые индексы в отдельные строки.
Ниже вы увидите один и тот же адрес, отображаемый двумя разными способами. Первый использует один элемент абзаца и несколько разрывов строк. Во втором используется несколько элементов абзаца и нет разрывов строк. В результате между строками добавляются ненужные отступы и поля.
См. раздел Pen Paragraph vs Line Break Element от Christina Perricone (@hubspot) на CodePen.
Совет для профессионалов: Если вы хотите, чтобы связанный раздел контента отображался в разных строках, например, почтовый адрес или строфа стихотворения, используйте элементы разрыва строки вместо элементов абзаца.
Теперь, когда мы поняли идеальный вариант использования разрывов строк, давайте рассмотрим, как их создавать в HTML.
Как сделать разрыв строки в HTML
Чтобы сделать разрыв строки в HTML, используйте тег
. Просто поместите тег там, где вы хотите принудительно разорвать строку. Поскольку разрыв строки HTML — это пустой элемент, закрывающий тег отсутствует.
Ниже приведен HTML-файл с элементами
и
.
Поскольку элемент
чаще всего используется для отображения стихов или адресов, давайте рассмотрим пример. Скажем, я хочу отобразить на веб-странице «kitchenette building» Гвендолин Брукс.
В этом случае я бы заключил строфы в теги
. Затем я бы поместил HTML-тег новой строкивезде, где я хочу, чтобы строки разрывались в каждой строфе.
Вот HTML-код:
кухонное здание
Мы — существа сухих часов и невольного плана,
Серые и серые. «Мечта» звучит головокружительно, но не сильно
Как «рента», «кормление жены», «удовлетворение мужчины».
Но может ли мечта подняться через луковый пар
Оно бело-фиолетовое, боремся с жареной картошкой
И вчерашний мусор зреет в зале,
Вихрь, или пой арию по этим комнатам
Даже если бы мы позволили это внутри,
Успели согреть его, содержать в чистоте,
Предвидеть сообщение, пусть оно начнется?
Интересно. Но не хорошо! ни на минуту!
Поскольку Номер Пять сейчас не в ванной,
Мы думаем о теплой воде, надеемся попасть в нее.
-Гвендолин Брукс
Вот результат:
См. Pen Poem with line break element by Christina Perricone (@hubspot) на CodePen.
Совет для профессионалов: Поместите элемент
в каждую точку, где вы хотите, чтобы строка текста прерывалась. Это означает, что текст после
будет начинаться с начала следующей строки текстового блока.
Разрыв строки HTML не работает
Если разрыв строки HTML не работает, особенно если вы работаете в текстовом редакторе CMS, такой как WordPress, возможно, вы неправильно используете элемент.
Наиболее распространенное неправильное использование HTML-тега новой строки — его использование в целях презентации. Практически для всего, что связано с макетом, вместо этого вы должны использовать CSS.
Например, вы хотите создать больше пространства между блоками текста или другими элементами. Вместо использования тега
следует использовать семантический элемент HTML и, при необходимости, свойства поля или заполнения CSS.
Почему? Две причины.
- Использование элемента разрыва строки HTML, когда доступен более семантический элемент, делает ваш код менее доступным, особенно для читателей, использующих программы чтения с экрана.
- Использование тега
для разрыва строки исключительно в презентационных целях может хорошо выглядеть в вашем браузере, но не в других браузерах или устройствах, особенно если ваш сайт адаптивен. Адаптивный сайт автоматически изменит макет в зависимости от размера экрана. Таким образом, он уже будет переносить текст по мере необходимости и переносить текст, когда дело доходит до тега
. Это приведет к прерывистым, неровным блокам текста. Давайте посмотрим на пример.
Например, я хочу показать отрывок из пьесы Дрянь: Писание . Я должен использовать элемент блочной кавычки, который автоматически добавит поля слева и справа от текста. Если бы я использовал тег
для имитации отступа элемента блочной кавычки, я бы неправильно использовал HTML-тег новой строки.
Вот правильный HTML:
Вот результат:
См. Pen YzZpaRG Кристины Перриконе (@hubspot ) на CodePen.
Совет для профессионалов: Используйте семантический элемент, например элемент цитаты, вместо элемента разрыва строки, когда это применимо, чтобы сделать ваш сайт более доступным для читателей, использующих программу чтения с экрана.
Использование элемента блочной кавычки не только лучше для доступности, но и для адаптивного веб-дизайна. Если вы измените размер окна браузера, вы заметите, что элемент кавычек в ручке выше автоматически подстраивается под размер экрана и не имеет зубчатых краев или неровных строк текста.
При использовании несемантических элементов, таких как элементы рисунка и разрыва строки, они не будут вести себя таким образом.
Вот неправильный HTML:
Вот результат:
См. перо Неправильное использование элемента
для отображения отрывка из пьесы Кристина Перриконе (@hubspot) на CodePen.
Совет для профессионалов: Чтобы заставить текст отображаться или разрываться определенным образом, используйте семантически значимый элемент HTML или CSS вместо элемента разрыва строки, чтобы избежать проблем с макетом, таких как прерывистый текст и неровные края.
Если вы измените размер окна браузера, вы заметите, что элемент абзаца с элементами разрыва строки приводит к неровным краям и неровным строкам текста.