Основы языка разметки гипертекста · GitBook
Хотите создать профессиональную документацию или электронную книгу? GitBook предоставляет вам инструменты для этого.
GitBook – популярная платформа, которая упрощает написание, совместную работу и публикацию документации. Она базируется на HTML, языке, который формирует структуру и содержание веб-страниц.
Основы языка разметки гипертекста GitBook
Создайте новый репозиторий GitBook:
gitbook init мой-гитбук
Добавьте Markdown-файлы для контента:
mkdir контент
cd контент
touch глава1.md глава2.md
Напишите Markdown в файлах:
Глава1.md:
# Глава 1: Введение
Глава2.md:
## Раздел 2.1: Подраздел
Создайте файл книги для сборки книги:
cd ..
touch книга.json
Настройте файл книги:
{
"format": "pdf",
"chapters": [
"контент/глава1.md",
"контент/глава2.md"
]
}
Соберите книгу:
gitbook build
Просмотрите созданную книгу:
откройте файл index.html в браузере
Создание нового документа
Для создания нового документа выполните следующие действия:
- Нажмите кнопку "Новый документ" на панели инструментов.
- Введите желаемое имя файла в поле "Имя документа".
- Выберите местоположение, где вы хотите сохранить документ.
- Нажмите кнопку "Создать" для сохранения нового HTML-документа.
Определение структуры документа
Для создания структуры документов используйте тег
`id`: уникальный идентификатор для поиска раздела в документе;
`class`: класс для сортировки разделов в документе.
Пример:
## Работа со стилями и форматированием
Управляйте стилями и форматированием с помощью редактора стилей или HTML/CSS-кода.
### Редактор стилей
Измените размер, цвет и семейство шрифтов для заголовков, подзаголовков и основного текста.
Установите выравнивание и отступы.
Создайте и управляйте классами стилей для повторного использования.
### HTML/CSS-код
Добавьте теги стилей непосредственно в свой HTML.
Используйте CSS-селекторы для таргетинга определенных элементов.
Установите свойства стиля, такие как размер шрифта, цвет и выравнивание.
### Советы по форматированию
Используйте пробелы и отступы для повышения удобочитаемости.
Применяйте заголовки для разделения контента и улучшения структуры.
Выделяйте важный текст жирным шрифтом или курсивом.
Учитывайте цветовой контраст и выбирайте шрифты, удобные для чтения.
Используйте HTML-теги, такие как ``, `` и ``, для форматирования текста.
Применяйте CSS-классы к элементам для управления стилями с помощью CSS.
Вставка изображений и мультимедиа
Чтобы вставить изображение, используйте тег src, указывающим на URL-адрес изображения:
| Синтаксис | |
| Вставляет изображение на страницу | |
Для вставки мультимедиа, такого как видео или аудио, используйте теги или . Добавьте атрибут src с URL-адресом файла мультимедиа:
| Синтаксис | |
| Вставляет видео на страницу | |
| Вставляет аудио на страницу | |
Ссылка на другие страницы
Для создания ссылки на другую страницу в GitBook используйте следующий синтаксис:
[% Название страницы %]
Вместо % Название страницы % введите название страницы, на которую вы хотите создать ссылку.
Публикация и управление документацией
Опубликуйте свою документацию в GitBook для широкого доступа. Используйте встроенные функции управления документацией для обновления и развертывания изменений без усилий.
Вопрос-ответ:
Что такое HTML?
HTML (HyperText Markup Language) - это язык разметки гипертекста, который используется для создания структуры и внешнего вида веб-страниц. Он определяет, как элементы страницы (например, заголовки, абзацы, изображения) будут отображаться в браузере.
Можно ли использовать HTML для создания сложных веб-приложений?
Базовый HTML используется в основном для создания статичных веб-страниц с простым контентом. Для создания сложных веб-приложений, требующих динамического поведения, обычно используются дополнительные технологии, такие как JavaScript и CSS.
Похожие статьи
Популярные статьи
