Тег это википедия: Недопустимое название | Викии Вики

Мета-теги: что это такое — SEO Википедия

Четкой стандартизации функций мета тегов нет. Выделяют следующие направления использования:

• для идентификации авторства страницы, ее адреса и частоты обновлений;
• для создания заголовков для гипертекстовых документов и индексации контента поисковыми системами;
• для отображения web-страниц.

Существует 2 группы мета тегов: 

• NAME
• HTTP-EQUIV.

NAME

1. Мета теги группы NAME отвечают за текстовую информацию о web-странице, ее авторе.
2. Author и Copyright. Обычно используются раздельно. Идентифицируют автора и принадлежность документа. Для раскрутки сайтов организаций предназначен тег Copyright. Атрибут lahg служит для определения языка документов.
3. Description. Кратко описывает страницу, используется поисковиками для индексации сайта и создания сниппета.
4. Document-state. С помощью свойств Static и Dynamic этого тега задается порядок индексации конкретной страницы (единоразовый или регулярный).
5. Generator. Предназначен для генераторов гипертекста.
6. Keywords. Используется поисковыми роботами для определения релевантности контента.
7. Resource-type. Описывает состояние или свойство страницы. Предназначен для крупных порталов, содержащих разные типы документов. Тег может иметь значения: build, creation, document, rating, site-languages, operator, creation, formatter и др.
8. Revisit. Служит для управления частотой индексации конкретного документа.
9. Robots. Используется для разрешения или запрещения индексации содержимого страниц. Возможны значения тега index, noindex, follow, nofollow, all и none.
10. Subject. Применяется для определения тематики документа.
11. Url. Перенаправляет поискового робота по указанной ссылке. Служит для отмены индексации страниц и зеркала сайта.

HTTP-EQUIV

1. Мета-теги группы HTTP-EQUIV выполняют ту же функцию, что и гипертекстовые заголовки для продвижения сайта, управляют действиями браузеров.
2. Content-Language. Определяет язык документа.
3. Content-Script-Type. Предназначен для указания языков программирования сценариев.
4. Content-Style-Type. Определяет язык таблицы стилей. Значение по умолчанию – text/css.
5. Content-Type. Тип и кодировка документа.
6. Expires. Используется для управления кэшированием.
7. PICS-Label. Показывает уровень доступности ресурса.
8. Pragma. Контролирует кэширование генерируемых скриптом страниц.
9. Refresh. Определяет задержку перед обновлением страницы браузером.
10. Set-Cookie. Используется для настройки куков.
11. Window-target. Определяет окно загружаемой страницы.
12. Imagetoolbar. Используется для отключения панели управления изображениями (при выводе баннеров, карты изображения, фона картинки т.д.).

Другие термины на букву «М»

Маркетинговая стратегияМаркетинговый аудитМассфолловингМедийная рекламаМикроданныеМикроформатыМисспелМобильный трафикМодераторМордоворот

Все термины SEO-Википедии

Теги термина

Текстовая оптимизацияПродвижение сайтов

Какие услуги тебе подходят

Оптимизация сайта в мобильной выдаче

Продвижение сайта по трафику

Продвижение сайта по позициям

SEO-оптимизация сайта

Оптимизация сайта под Google

Продвижение сайта в Google

Продвижение сайта в Яндексе

Продвижение интернет-магазина

Продвижение молодого сайта

SEO-продвижение с гарантией

Продвижение по ключевым словам

Продвижение сайта в ТОП 10 Яндекса и Google

Продвижение туристических сайтов

SEO аудит

Поисковый аудит сайта

Продвижение сайтов в ТОП 3 Яндекса и Google

Оптимизация сайта под Яндекс

Раскрутка сайтов за рубежом

Продвижение сайтов в Москве

Продвижение медицинских сайтов

SEO-продвижение лендинга в поисковых системах

Заказать продвижение сайта

Продвижение сайтов в Москве: проверенные решения от профессионалов

Продвижение стоматологической клиники

Продвижение сайтов медицинских клиник

Продвижение салона красоты

Продвижение автомобильных сайтов

Продвижение магазина автозапчастей

Продвижение и раскрутка автосервиса

Продвижение отелей и гостиниц

SEO-продвижение сайта в Новосибирске

SEO-продвижение сайта в Екатеринбурге

SEO-продвижение сайта в Самаре

SEO-продвижение сайта в Омске

SEO-продвижение сайта в Нижнем Новгороде

SEO-продвижение сайта в Казани

SEO-продвижение сайта в Челябинске

SEO-продвижение сайта в Красноярске

Поисковое продвижение сайтов в Перми: эффективно, профессионально, прозрачно

Поисковое продвижение сайтов в Ростове-на-Дону

Поисковое продвижение сайтов в Уфе

SEO-продвижение сайта в Воронеже

SEO-продвижение сайта в Волгограде

SEO-продвижение сайта в Краснодаре

Продвижение интернет-магазина бытовой техники

Продвижение интернет-магазина одежды

Продвижение интернет-магазина зоотоваров

Продвижение интернет-магазина книг

Продвижение интернет-магазина мебели

Продвижение интернет-магазина обуви

Продвижение интернет-магазина сантехники

Продвижение интернет-магазина спортивных товаров

Продвижение интернет-магазина стройматериалов

Продвижение интернет-магазина часов

Маркетинговый аудит сайта

Продвижение автосалона

Поисковое продвижение сайтов в Тольятти

Синтаксис Markdown для вики-сайтов — Azure DevOps

Twitter LinkedIn Facebook Адрес электронной почты

• Статья
• 11/19/2022
• Чтение занимает 6 мин

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019 | TFS 2018

Важно!

Чтобы просмотреть содержимое, доступное для вашей платформы, убедитесь, что в селекторе версии над содержанием выбрана правильная версия этой статьи.

Поддержка функций зависит от того, работаете ли вы в Azure DevOps Services или в локальной версии Azure DevOps Server, которая ранее называлась Team Foundation Server (TFS).
Сведения о том, какую локальную версию вы используете, см. в статье Поиск платформы и версии Azure DevOps.

В этой статье приведены некоторые вики-руководства по синтаксису Markdown для использования в Azure DevOps.

Оглавление (ОГЛА) для вики-страниц

Чтобы создать оглавление, добавьте [[_TOC_]]. ОГЛА создается при добавлении тега, и на странице есть хотя бы один заголовок.

[[_TOC_]] можно разместить в любом месте страницы, чтобы отобразить оглавление. Для оглавления учитываются только заголовки Markdown (теги заголовков HTML не учитываются).

Все теги HTML и Markdown удаляются из заголовков при добавлении в блок оглавления. См. следующий пример отрисовки оглавлиения при добавлении полужирного шрифта и курсивов в заголовок.

Согласованность поддерживается в форматировании в оглавление.

Примечание

Тег [[_TOC_]] учитывает регистр. Например, [[_toc_]] может не отображать оглавливать оглавливать. Кроме того, отрисовывается только первый экземпляр [[_TOC_]], а остальные игнорируются.

Добавление схем Mermaid на вики-страницу

Mermaid позволяет создавать схемы и визуализации с помощью текста и кода.

Примечание

• Не весь синтаксис в приведенном ниже содержимом для типов схем работает в Azure DevOps. Например, мы не поддерживаем большинство тегов HTML, Font Awesome, flowchart синтаксис (graph используется вместо него) или LongArrow ---->.
• Mermaid не поддерживается в браузере Internet Explorer.
• При возникновении «неподдерживаемого типа схемы» эта функция может быть еще недоступна в вашей организации из-за обычной схемы развертывания.

Вики-сайт поддерживает следующие типы схем Mermaid:

• Схемы последовательностей
• Диаграммы Гантта
• Блок-схемы
• Схема классов
• Схема состояний
• Пути взаимодействия пользователя
• Круговая диаграмма
• Схема требований

Дополнительные сведения см. в заметках о выпуске Mermaid и активных запросах в Сообщество разработчиков.

Чтобы добавить схему Mermaid на вики-страницу, используйте следующий синтаксис:

::: mermaid
<mermaid diagram syntax>
:::

Пример схемы последовательностей

Схема последовательностей — это схема взаимодействия, показывающая, как процессы работают друг с другом и в каком порядке.

::: mermaid
sequenceDiagram
    Christie->>Josh: Hello Josh, how are you?
    Josh-->>Christie: Great!
    Christie->>Josh: See you later!
:::

Пример диаграммы Ганта

Диаграмма Ганта записывает каждую запланированную задачу в виде одной непрерывной полосы, простирающейся слева направо. Ось X представляет время, а y записывает различные задачи и порядок их выполнения.

При исключении даты, дня или коллекции дат, относящихся к задаче, диаграмма Ганта учитывает эти изменения, расширяя равное количество дней справа, а не создавая разрыв внутри задачи.

::: mermaid
gantt
    title A Gantt chart
    dateFormat YYYY-MM-DD
    excludes 2022-03-16,2022-03-18,2022-03-19
    section Section
    A task          :a1, 2022-03-07, 7d
    Another task    :after a1 , 5d
:::

Пример блок-схемы

Блок-схема состоит из узлов, геометрических фигур и ребер, а также стрелок или линий. В следующем примере показана блок-схема с использованием graph

вместо flowchart.

Примечание

Мы не поддерживаем ---->flowchart ни синтаксис, ни ссылки на и из subgraph.

:::mermaid
graph LR;
    A[Hard edge] -->|Link text| B(Round edge) --> C{Decision}
    C -->|One| D[Result one]
    C -->|Two| E[Result two]
:::

Пример схемы классов

Схема классов является основной частью объектно-ориентированного моделирования. На схеме описываются объекты, их атрибуты, методы и наследование между ними.

:::mermaid
classDiagram
    Creature <|-- Superman
    Creature <|-- Vampire
    Creature <|-- Diavolo
    Creature: +int size
    Creature: +int weight
    Creature: +isBenign()
    Creature: +power()
    class Superman{
        +String currentName
        +fly()
        +heal()
    }
    class Vampire{
        -int age
        -canBite()
    }
    class Diavolo{
        +bool is_serving
        +heat()
    }
:::

Пример схемы состояния

Схема состояний используется для описания того, как системные состояния могут меняться от одного к другому.

:::mermaid
stateDiagram-v2
    [*] --> Active
    state Active {
        [*] --> NumLockOff
        NumLockOff --> NumLockOn : EvNumLockPressed
        NumLockOn --> NumLockOff : EvNumLockPressed
        --
        [*] --> CapsLockOff
        CapsLockOff --> CapsLockOn : EvCapsLockPressed
        CapsLockOn --> CapsLockOff : EvCapsLockPressed
        --
        [*] --> ScrollLockOff
        ScrollLockOff --> ScrollLockOn : EvScrollLockPressed
        ScrollLockOn --> ScrollLockOff : EvScrollLockPressed
    }
:::

Пример пути взаимодействия пользователя

На схеме взаимодействия пользователя описаны шаги, необходимые для выполнения определенных действий или задач более высокого уровня.

:::mermaid
journey
    title Home office day
    section Go to work
      Wake up: 1: Me, Dog
      Take shower: 2: Me
      Go downstairs: 3: Me, Dog
      Make coffee: 4: Me
      Have a breakfast: 5: Me, Dog
      Go upstairs: 3: Me, Dog
      Do work: 1: Me, Dog
    section Go home
      Go downstairs: 3: Me, Dog
      Sit down: 5: Me
:::

Пример круговой диаграммы

Круговая диаграмма используется для визуализации процентных значений в обведенном графике.

:::mermaid
pie title Fishermans in countries
    "Norway" : 684
    "Sweeden" : 234
    "Switzerland" : 10
:::

Пример схемы требований

Схема требований визуализирует требования и связи между ними.

:::mermaid
requirementDiagram
    requirement development_req {
    id: 1
    text: requirements spec.
    risk: medium
    verifymethod: test
    }
    element test_suite {
    type: manual test
    }
    test_suite - verifies -> development_req
:::

Добавление свертываемого раздела

Чтобы добавить свертываемый раздел на вики-странице, используйте следующий синтаксис:

# A collapsible section with markdown
<details>
  <summary>Click to expand!</summary>
  ## Heading
  1. A numbered
  2. list
     * With some
     * Sub bullets
</details>

Не забудьте добавить пустую строку в следующих областях:

• после закрывающего </summary> тега, в противном случае блоки markdown или code отображаются неправильно
• после закрывающего </details> тега при наличии нескольких свертываемых разделов

Внедрение видео на вики-страницу

Чтобы внедрить видео с YouTube и Microsoft Streams на вики-страницу, используйте следующий синтаксис:

::: video
<iframe src="https://www. youtube.com/embed/_EXAMPLE_" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
:::

IFrame — это блок внедрения IFrame видео YouTube или Microsoft Streams.

Чтобы предотвратить разрыв страницы, требуется окончание «::».

Внедрение результатов запроса Azure Boards на вики-сайте

Чтобы внедрить Azure Boards результаты запроса на вики-страницу в виде таблицы, используйте следующий синтаксис:

::: query-table <queryid>
:::

Например:

::: query-table 6ff7777e-8ca5-4f04-a7f6-9e63737dddf7 :::

Вы также можете использовать панель инструментов и селектор запросов , чтобы внедрить результаты запроса на вики-страницу.

Дополнительные сведения о копировании URL-адреса запроса, который предоставляет guid для запроса, см. в разделе Email элементов запроса или URL-адрес общего доступа.

@mention пользователи и группы

Для @mention пользователей или групп на вики-сайте введите клавишу «@» в редакторе вики-сайта. Откроется @mention автозаполнения, из которого можно упомянуть пользователей или группы для получения уведомлений по электронной почте.

Вы также можете выбрать @mention на панели инструментов редактирования.

При редактировании страниц непосредственно в коде используйте следующий шаблон @<{identity-guid}>: .

Посещения страниц для вики-страниц

Автоматически отображается агрегированное количество посещений страниц за последние 30 дней на каждой странице.

Используйте пакетный API pagesBatch для просмотра ежедневного количества посещений всех страниц с разбивкой на страницы. Однако они не отсортированы по количеству посещений. Для данных старше 30 дней вы можете получить все посещения страницы с помощью REST API. Отсортируйте эти страницы по количеству посещений, чтобы получить первые 100. Эти визиты можно хранить на панели мониторинга или в базе данных.

Примечание

Посещение страницы определяется определенным пользователем как просмотр страницы с 15-минутным интервалом.

Ссылка на рабочие элементы с вики-страницы

Введите знак фунта (#), а затем введите идентификатор рабочего элемента.

Примечание

Эта функция доступна в TFS 2018.2 и более поздних версиях.

Поддержка тегов HTML на вики-страницах

На вики-страницах можно также создавать полнофункционированный контент с помощью HTML-тегов.

Совет

Вы можете вложить Markdown в HTML, но необходимо включить пустую строку между HTML-элементом и Markdown.

<p>
 
 [A Markdown link](https://microsoft.com) 
</p>

Примечание

Вставка форматированного содержимого в формате HTML поддерживается в Azure DevOps Server 2019.1 и более поздних версиях.

Пример. Внедренное видео

<video src="path of the video file" width=400 controls>
</video>

<video src="https://sec. ch9.ms/ch9/7247/7c8ddc1a-348b-4ba9-ab61-51fded6e7247/vstswiki_high.mp4" width=400 controls>
</video>

Результат:

Пример. Формат формат форматированного текста

<p>This text needs to <del>strikethrough</del> <ins>since it is redundant</ins>!</p>
<p><tt>This text is teletype text.</tt></p>
<font color="blue">Colored text</font>
<center>This text is center-aligned.</center>
<p>This text contains <sup>superscript</sup> text.</p>
<p>This text contains <sub>subscript</sub> text.</p>
<p>The project status is <span>GREEN</span> even though the bug count / developer may be in <span>red.</span> - Capability of span
<p><small>Disclaimer: Wiki also supports showing small text</small></p>
<p><big>Bigger text</big></p>

Результат:

• Вики-сайт проекта
• Структура вики-файла
• Журнал просмотра вики-сайта

Теги — OpenStreetMap Wiki

Из OpenStreetMap Wiki

Перейти к навигацииПерейти к поиску

Тег состоит из двух элементов: ключа и значения . Теги описывают особенности элементов карты (узлов, путей или отношений) или наборов изменений. Оба элемента являются текстовыми полями произвольного формата, но часто представляют собой числовые или другие структурированные элементы. Согласованы соглашения о значении и использовании тегов, которые зафиксированы на этой вики. Хотя в некоторых относительно незначительных случаях существуют конкурирующие взгляды на то, что на самом деле означают теги, или картографы используют их по-разному.

Содержание

• 1 Ключи и значения
• 2 Поиск своего тега
• 3 Технические характеристики
• 4 Использование в редакторе
  • 4.1 ID
  • 4.2 StreetComplete
  • 4.3 Полная карта
• 5 синтаксис ключ=значение
• 6 Метаданные
• 7 См. также

Ключи и значения

Теги применяются к элементам или наборам изменений (т. е. их тегирование), что приводит к набору тегов любого размера. Однако каждая коллекция может содержать ключ только один раз. Там, где тег отсутствует, часто считаются значениями по умолчанию или значениями, унаследованными от родительских элементов.

Таким образом, ключ используется для описания темы, категории или типа объекта (например, шоссе или названия). Ключи можно уточнять с помощью префиксов, инфиксов или суффиксов (обычно разделенных двоеточием, :), образуя супер- или подкатегории или пространства имен. Общие пространства имен — это спецификация языка и спецификация пространства имен даты для ключей имен.

Значение предоставляет подробную информацию о функции, указанной ключом. Обычно значения представляют собой текст произвольной формы (например, name=»Jeff Memorial Highway»), одно из набора различных значений (перечисление; например, шоссе=автомагистраль ), несколько значений из перечисления (разделенных точкой с запятой) или число (целое или десятичное), например расстояние. Значение является обязательным для тега, даже если ключ говорит сам за себя (например, мотоцикл:прокат=да ).

Вот несколько примеров, используемых на практике:

• шоссе = жилой тег с ключом шоссе и значением жилой который должен использоваться на пути для обозначения дороги вдоль которой живут люди.
• имя = Park Avenue тег, для которого поле значения используется для передачи названия конкретной улицы
• maxspeed = 50 тег, значением которого является числовая скорость и единица измерения скорости. Единица измерения км/ч подразумевается, но может быть указана явно; Мили в час можно также указать, добавив миль в час . В OSM по умолчанию используются метрические единицы.
• maxspeed:forward =* ключ, включающий пространство имен для maxspeed , чтобы еще больше различать его значение.
• name:de:1953-1990 = Ernst-Thälmann-Straße тег с именем ключевых пространств имен с суффиксом для указания немецкого имени, которое было действительным в некоторые годы.

Поиск вашего тега

Для поиска подходящего тега или изучения его использования часто используются следующие ресурсы:

• Просмотреть эту вики
  • Функции карты – список допустимых тегов, сгруппированных по ключевому значению.
  • Category:Features — для тегов, сгруппированных по назначению или функции.
  • Категория: Предлагаемые функции — найти новых тегов и еще не популярных тегов .
  • категория теги
  • Как нанести на карту — алфавитный список объектов реального мира.
  • Поиск в этой вики
• Taginfo — сайт для изучения текущего использования тегов в базе данных OSM, включая значения тегов, которые не обязательно задокументированы (но содержит ссылки на эту вики, если есть документация по тегу)
• TagFinder — веб-сайт, обеспечивающий полнотекстовый поиск тегов OSM. (Также доступны веб-сервисы).
• Посмотрите, как отображается подобный объект в другом месте (если вы знаете, где он также может существовать)
• Читайте любые теги, которые вам нравятся
• Найдите архив списка рассылки по тегам или вопросы о тегах на справочном сайте или на forum. openstreetmap.org. Конечно, вы также можете спросить на всех трех сайтах (но только по одному за раз).
• Семантическая сеть OSM – машиночитаемая структура, содержащая теги OSM
• …

Технические характеристики

Элементы

описывает технические ограничения, кодирование и форматирование тегов.

Использование в редакторе

Некоторые редакторы OSM (например, iD, Potlatch 3, MapComplete) по умолчанию скрывают теги объектов, что делает их нередактируемыми напрямую; вместо этого пользователи выбирают пресет и заполняют форму. Однако в большинстве редакторов все теги можно отображать и редактировать, войдя в какой-либо расширенный режим вашего редактора.

Для примеров редакторов:

iD

1. (требуется только в том случае, если вы создали новый объект) Выберите предустановку общего типа объекта (нижняя). Например, выберите «точка», если вы создали новый объект «точка».
2. выберите «Все теги» (внизу слева)

StreetComplete

1. Нажмите кнопку отмены (внизу слева на экране)
2. Выберите последний вариант редактирования или отобразите историю изменений
3. На экране окончательного подтверждения StreetComplete отобразит теги, которые были добавлены при редактировании (и будут изменены при возврате)

MapComplete

MapComplete скрывает теги для новых пользователей. Как только у участника будет более 25 наборов изменений, добавленные теги будут отображаться чуть ниже кнопки «Сохранить» для вопроса и под пресетом.

ключ=значение синтаксис

В обсуждениях и при работе с некоторыми инструментами принято обращаться к тегу с использованием синтаксиса ключ = значение , то есть ключ, затем знак равенства, затем Значение. Иногда ключ или значение заключают в кавычки, чтобы избежать путаницы: ключ = "значение" или "ключ" = "значение" ; кавычки (и, действительно, знак равенства) не являются частью содержимого тега.

Синтаксис ключ=значение или его вариант используется в следующих инструментах:

• iD — когда функция выбрана, разверните раздел «Теги» на левой боковой панели и измените представление с на .
• Уровень 0
• Указатель предложения имени — набор тегов в формате ключ=значение указан под каждой записью указателя.
• Редактор тегов OpenStreetMap
• Osmium — выражения фильтра дополняют синтаксис ключ-значение дополнительным синтаксисом для альтернативных ключей или значений.
• Overpass turbo — этот синтаксис появляется в OverpassQL как фильтр has-kv и в более простом синтаксисе мастера.
• Taginfo — введите синтаксис ключ=значение в поле поиска, чтобы найти тег.

В этой вики вы можете ссылаться на тег, используя синтаксис ключ=значение, включая шаблон {{Tag}}.

Иногда роль отношения задается как role=… . Это означает, что роль элемента в отношении устанавливается на значение справа от знака равенства, а не ключ с именем role =* на это значение.

Метаданные

Некоторые теги использовались в элементах данных только для прикрепления метаданных, отображаемых в редакторах карт или в инструментах обеспечения качества (таких как статус завершения, действия, приблизительные значения, источник данных или изображений, версия инструмента или редактора и т. д.) . Начиная с версии 0.6 API, редакторам карт и инструментам импорта рекомендуется прикреплять несколько тегов метаданных к создаваемым ими наборам изменений (наборы изменений не являются элементами данных) вместо того, чтобы помечать каждый добавленный или измененный элемент данных: эти теги теперь задокументированы на этой вики. как «отбрасываемые», что означает, что они могут быть удалены редакторами из элементов данных без уведомления при их обновлении (их по-прежнему можно использовать в наборах изменений, и эти теги по-прежнему видны в более старых версиях элементов, где эти отбрасываемые теги были удалены, и вы можете по-прежнему проверять эти старые теги из старых наборов изменений, которые не использовали этот теперь предпочтительный метод тегирования, потому что эти наборы изменений по-прежнему указывают на более старые версии элементов, которые имели эти теги).

См. также

• Синтаксические соглашения для новых тегов
• Одноименные ключи
• Синонимичные теги
• Противоречивые ключи и значения

Wiki | GitLab

• Просмотр вики проекта
• Настройка ветки по умолчанию для вашей вики
• Создание домашней страницы вики
• Создание новой вики-страницы
  • Локальное создание или редактирование вики-страниц
  • Специальные символы в заголовках страниц
  • Ограничения длины имен файлов и каталогов
• Редактировать вики-страницу
  • Создать оглавление
• Удалить вики-страницу
• Переместить вики-страницу
• Просмотр истории страницы вики
  • Просмотр изменений между версиями страницы
• Отслеживание событий вики
• Включение или отключение вики проекта
• Ссылка на внешнюю вики
• Отключение вики проекта
• Редактор контента
  • Использование редактора контента
  • Вернуться к старому редактору
  • Поддержка GitLab Flavored Markdown
• Устранение неполадок
  • Рендеринг слагов страницы с помощью обратного прокси-сервера Apache
  • Воссоздание вики проекта с помощью консоли Rails

История версий

• Загрузка страницы изменена на асинхронную в GitLab 14. 9.
• Метод кодирования слагов страницы изменен на ERB::Util.url_encode в GitLab 14.9.

Если вы не хотите хранить свою документацию в репозитории, но хотите чтобы сохранить его в том же проекте, что и ваш код, вы можете использовать вики, которую GitLab предоставляет в каждом проекте GitLab. Каждая вики — это отдельный репозиторий Git, поэтому вы можете создать вики-страницы в веб-интерфейсе или локально с помощью Git.

Вики GitLab поддерживают Markdown, Rdoc, AsciiDoc и Org для контента. Вики-страницы, написанные в Markdown, поддерживают все функции Markdown, а также обеспечить некоторое поведение, специфичное для вики для ссылок.

В GitLab 13.5 и более поздних версиях Вики-страницы отображают боковую панель, которую вы можете настроить. Этот боковая панель содержит неполный список страниц вики, отображаемый в виде вложенного дерева, с родственными страницами, перечисленными в алфавитном порядке. Чтобы просмотреть список всех страниц, выберите Просмотреть все страницы на боковой панели:

Посмотреть вики проекта

Чтобы получить доступ к вики проекта:

1. В верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. Чтобы отобразить вики, выполните одно из следующих действий:
   • На левой боковой панели выберите Wiki .
   • На любой странице проекта используйте g + w сочетание клавиш вики.

Если Wiki не указан на левой боковой панели вашего проекта, администратор проекта отключил его.

Настройте ветку по умолчанию для вашей вики

Представлено в GitLab 14.1.

Ветка по умолчанию для вашего вики-репозитория зависит от вашей версии GitLab:

• GitLab версии 14.1 и выше: вики наследуют имя ветки по умолчанию, настроенное для ваш экземпляр или группу. Если пользовательское значение не настроено, GitLab использует main .
• GitLab версии 14.0 и более ранние: GitLab использует мастер .

Для любой версии GitLab вы можете переименуйте эту ветку по умолчанию для ранее созданных вики.

Создать домашнюю страницу вики

При создании вики она пуста. При первом посещении вы можете создать пользователи домашней страницы видят при просмотре вики. Эта страница требует определенного заголовка для использования в качестве домашней страницы вашей вики. Для его создания:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Выберите Создайте свою первую страницу .
4. GitLab требует, чтобы эта первая страница называлась home . Страница с этим title служит главной страницей вашей вики.
5. Выберите формат для оформления текста.
6. Добавьте приветственное сообщение для своей домашней страницы в разделе Content . Ты можешь всегда редактируйте его позже.
7. Добавить сообщение фиксации . Git требует сообщения фиксации, поэтому GitLab создает его если вы не введете его самостоятельно.
8. Выберите Создать страницу .

Создать новую вики-страницу

Пользователи с ролью хотя бы разработчика могут создавать новые вики-страницы:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Выберите Новая страница на этой странице или на любой другой вики-странице.
4. Выберите формат содержимого.
5. Добавьте заголовок для своей новой страницы. Использование заголовков страниц специальные символы для подкаталогов и форматирования, и имеют ограничения по длине.
6. Добавьте контент на свою вики-страницу.
7. Дополнительно. Прикрепите файл, и GitLab сохранит его в Git-репозитории вики.
8. Добавить сообщение фиксации . Git требует сообщения фиксации, поэтому GitLab создает его если вы не введете его самостоятельно.
9. Выберите Создать страницу .

Локальное создание или редактирование вики-страниц

Wiki основаны на репозиториях Git, поэтому вы можете клонировать их локально и редактировать их, как вы бы сделали с любым другим репозиторием Git. Чтобы клонировать вики-репозиторий локально выберите Клонировать репозиторий с правой боковой панели любой вики-страницы, и следуйте инструкциям на экране.

Файлы, которые вы добавляете в свою вики локально, должны использовать один из следующих поддерживаемые расширения, в зависимости от языка разметки, который вы хотите использовать. Файлы с неподдерживаемыми расширениями не отображаются при отправке в GitLab:

• Расширения Markdown: . mdown , .mkd , .mkdn , .md , .md ,

  .50050 .5053 .mkd .

• Расширения AsciiDoc: .adoc , .ad , .asciidoc .
• Другие расширения разметки: 9

Специальные символы в заголовках страниц

Вики-страницы хранятся в виде файлов в репозитории Git, поэтому некоторые символы имеют особое значение:

• При сохранении страницы пробелы преобразуются в дефисы.
• Дефисы ( - ) преобразуются обратно в пробелы при отображении страницы.
• Косая черта ( / ) используются в качестве разделителей путей и не могут отображаться в заголовках. Если вы создайте заголовок, содержащий / символов, GitLab создаст все подкаталоги необходимо построить этот путь. Например, заголовок docs/my-page создает вики. страница с путем /wikis/docs/my-page .

Ограничения длины для имен файлов и каталогов

Представлено в GitLab 12. 8.

Многие распространенные файловые системы имеют ограничение в 255 байт. для имен файлов и каталогов. Git и GitLab поддерживают пути, превышающие те пределы. Однако, если ваша файловая система налагает эти ограничения, вы не можете извлечь локальная копия вики, имена файлов которой превышают это ограничение. Чтобы предотвратить это проблема, веб-интерфейс и API GitLab налагают следующие ограничения:

• 245 байт для заголовков страниц (зарезервировано 10 байт для расширения файла).
• 255 байт для имен каталогов.

Символы, отличные от ASCII, занимают более одного байта.

Хотя вы по-прежнему можете создавать файлы локально, превышающие эти ограничения, ваши товарищи по команде после этого вы не сможете зайти на вики локально.

Редактировать вики-страницу

Для редактирования вики-страницы вам нужна как минимум роль разработчика:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на страницу, которую хотите отредактировать, и одним из следующих способов:
   • Используйте сочетание клавиш e вики.
   • Выберите значок редактирования ().
4. Редактировать содержимое.
5. Выбрать Сохранить изменения .

Несохраненные изменения вики-страницы сохраняются в локальном хранилище браузера для предотвращения случайной потери данных.

Создать оглавление

Чтобы создать оглавление из подзаголовков вики-страницы, используйте тег [[_TOC_]] . Для примера прочтите Оглавление.

Удалить вики-страницу

Для удаления вики-страницы вам нужна роль хотя бы разработчика:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на страницу, которую хотите удалить.
4. Выберите значок редактирования ().
5. Выбрать Удалить страницу .
6. Подтвердить удаление.

Переместить вики-страницу

Для перемещения вики-страницы требуется как минимум роль разработчика:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на страницу, которую хотите переместить.
4. Выберите значок редактирования ().
5. Добавьте новый путь в поле Заголовок . Например, если у вас есть вики-страница позвонил о под компанией и вы хотите переместить ее в корень вики, изменить название с около на / около .
6. Выберите Сохранить изменения .

Просмотр истории вики-страницы

Изменения вики-страницы с течением времени записываются в Git-репозиторий вики. Страница истории показывает:

• Ревизия (Git commit SHA) страницы.
• Автор страницы.
• Сообщение фиксации.
• Последнее обновление.
• Предыдущие редакции, выбрав номер редакции в столбце Версия страницы .

Чтобы просмотреть изменения для вики-страницы:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Вики .
3. Перейдите на страницу, для которой вы хотите просмотреть историю.
4. Выберите История страниц .

Просмотр изменений между версиями страницы

Представлено в GitLab 13.2.

Вы можете увидеть изменения, сделанные в версии вики-страницы, аналогично просмотрам версий файлов различий:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на интересующую вас вики-страницу.
4. Выберите История страниц , чтобы увидеть все версии страниц.

5. Выберите сообщение фиксации в столбце Изменения для интересующей вас версии.

Отслеживание событий вики

История версий

• Представлено в GitLab 12.10.
• События Git появились в GitLab 13. 0.
• Флаг функции для событий Git был удален в GitLab 13.5.

GitLab отслеживает события создания, удаления и обновления вики. Эти события отображаются на этих страницах:

• Профиль пользователя.
• Страницы активности, в зависимости от типа вики:
  • Активность группы.
  • Проектная деятельность.

Коммиты в вики не учитываются в аналитике репозитория.

Представленная в GitLab 13.8 боковая панель может быть настроена нажатием кнопки Edit sidebar .

Для настройки вики требуется как минимум роль разработчика боковая панель навигации. Этот процесс создает вики-страницу с именем _sidebar , которая полностью заменяет боковую панель навигации по умолчанию:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. В правом верхнем углу страницы выберите Редактировать боковую панель .
4. По завершении выберите Сохранить изменения .

A _sidebar пример, отформатированный с помощью Markdown:

 ### [Home](home)
- [Привет, мир] (привет)
- [Фу] (фу)
- [Бар](бар)
---
- [Боковая панель](_sidebar)
 

Включить или отключить вики проекта

Вики по умолчанию включены в GitLab. Администраторы проекта можно включить или отключить вики проекта, следуя инструкциям в Общий доступ и разрешения.

Администраторы самоуправляемых установок GitLab могут настроить дополнительные параметры вики.

Вы можете отключить групповые вики в настройках группы

Чтобы добавить ссылку на внешнюю вики из левой боковой панели проекта:

1. На верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. На левой боковой панели выберите Настройки > Интеграция .
3. Выберите Внешняя вики .
4. Добавьте URL-адрес вашей внешней вики.
5. Дополнительно. Для проверки соединения выберите Test settings .
6. Выберите Сохранить изменения .

Теперь вы можете увидеть опцию Внешняя вики в вашем проекте. левая боковая панель.

При включении этой интеграции ссылка на внешний вики не заменяет ссылку на внутреннюю вики. Чтобы скрыть внутреннюю вики с боковой панели, отключите вики проекта.

Чтобы скрыть ссылку на внешнюю вики:

1. В верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. На левой боковой панели выберите Настройки > Интеграция .
3. Выберите Внешняя вики .
4. В разделе Включить интеграцию снимите флажок Active .
5. Выберите Сохранить изменения .

Отключить вики проекта

Чтобы отключить внутреннюю вики проекта:

1. На верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. Перейдите к своему проекту и выберите Настройки > Общие .
3. Развернуть Видимость, функции проекта, разрешения .
4. Прокрутите вниз, чтобы найти Wiki и отключите его (выделено серым цветом).
5. Выберите Сохранить изменения .

Внутренняя вики теперь отключена, а пользователи и участники проекта:

• Не могут найти ссылку на вики на боковой панели проекта.
• Невозможно добавлять, удалять или редактировать вики-страницы.
• Невозможно просмотреть ни одну вики-страницу.

Ранее добавленные вики-страницы сохраняются на случай, если вы хотите снова включить вики. Чтобы снова включить его, повторите процесс чтобы отключить вики, но включить ее (синим цветом).

Редактор контента

История версий

• Представлено в GitLab 14.0.
• Представлено переключение между возможностями редактирования в GitLab 14.7 с помощью флага с именем wiki_switch_between_content_editor_raw_markdown 9.0054 . Включено по умолчанию.
• Переключение между функциями редактирования, обычно доступными в GitLab 14.10. Флаг функции wiki_switch_between_content_editor_raw_markdown удален.

GitLab предоставляет возможность редактирования WYSIWYG для GitLab Flavored Markdown в вики.

Поддержка включает:

• Форматирование текста, в том числе использование жирного шрифта, курсива, кавычек, заголовков и встроенного кода.
• Форматирование нумерованных списков, ненумерованных списков и контрольных списков.
• Создание и редактирование структуры таблицы.
• Вставка и форматирование блоков кода с подсветкой синтаксиса.
• Предварительный просмотр диаграмм Mermaid, PlantUML и Kroki (представлено в GitLab 15. 2).
• Создание и редактирование комментариев HTML (появилось в GitLab 15.7).

Использование редактора содержимого

1. Создайте новую вики-страницу или отредактируйте существующую.
2. Выберите Markdown в качестве формата.
3. Выше Содержание , выберите Редактировать форматированный текст .
4. Настройте содержимое своей страницы, используя различные параметры форматирования, доступные в редакторе содержимого.
5. Выберите Создать страницу для новой страницы или Сохранить изменения для существующей страницы.

Режим редактирования форматированного текста остается по умолчанию, пока вы не вернетесь к отредактируйте необработанный источник.

Вернуться к старому редактору

1. Если вы редактируете страницу в редакторе содержимого, прокрутите до Содержание .
2. Выбрать Редактировать источник .

Поддержка GitLab Flavored Markdown

Поддержка всех типов контента GitLab Flavored Markdown в редакторе контента находится в стадии разработки. Статус текущей разработки поддержки CommonMark и GitLab Flavored Markdown см. по адресу:

• . Основные расширения форматирования Markdown epic.
• Эпические расширения GitLab Flavored Markdown.

• Настройки Wiki для администраторов
• API вики проектов
• API перемещения хранилища групповых репозиториев
• API групповых вики
• Сочетания клавиш для вики

Устранение неполадок

Рендеринг слагов страницы с помощью обратного прокси-сервера Apache

В GitLab 14.9 и более поздних версиях слаги страниц теперь кодируются с помощью Метод ERB::Util.url_encode . Если вы используете обратный прокси-сервер Apache, вы можете добавить аргумент nocanon к ProxyPass . строку вашей конфигурации Apache, чтобы убедиться, что слаги вашей страницы отображаются правильно.