@diplodoc/cli 5.46.1 → 5.47.0

package/tests/mocks/pdf-page/pc-page/input/with-pc-page.md

@@ -0,0 +1,363 @@
+# Page constructor
+
+Page constructor (далее – PC) — это библиотека семейства [Gravity UI](https://gravity-ui.com/) для рендеринга веб-страниц на основе данных представленных в YAML формате.
+При создании страниц используется компонентный подход: страница строится с использованием набора готовых блоков, которые можно размещать в любом порядке. Каждый блок имеет определенный тип и набор параметров входных данных.
+Формат входных данных и список доступных блоков можно посмотреть в [документации библиотеки](https://preview.gravity-ui.com/page-constructor/?path=/docs/documentation-blocks--docs). В сторибуке PC есть [удобная песочница](https://preview.gravity-ui.com/page-constructor/?path=/story/editor-main--default), в которой сначала можно опробовать все блоки и собрать страницу, а уже потом скопировать готовый конфиг к себе в документацию.
+
+Примеры оформление страниц с помощью PC [\[1\]](./index.yaml) [\[2\]](./index2.yaml) [\[3\]](./index2.yaml)
+
+## Способы использования
+
+Page constructor можно использовать двумя способами:
+
+1. **Отдельные YAML-файлы** — создание полноценных страниц с помощью YAML-конфигурации.
+2. **Встраивание блоков** — добавление отдельных блоков Page constructor прямо в markdown-документацию.
+
+## Добавление Page constructor страниц { #page }
+
+Стандартная структура конфигурации PC страницы хранится в `.yaml` формате и имеет вид:
+
+```yaml
+blocks:
+  - type: 'header-block'
+    width: 's'
+    offset: 'default'
+    title: 'Diplodoc'
+    resetPaddings: true
+    verticalOffset: 'l'
+    description: 'Платформа для создания технической документации в концепции Docs as Сode с открытым исходным кодом. Простое и удобное решение для развёртывания документации больших и маленьких команд.'
+    background:
+      image:
+        mobile: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-cover-mini.png'
+        desktop: '_assets/test-move.png'
+      color: '#C6FE4D'
+      fullWidth: false
+    buttons:
+      - text: 'Начать'
+        theme: 'dark'
+        size: 'promo'
+        url: '/quickstart'
+      - text: 'GitHub'
+        theme: 'outlined'
+        size: 'promo'
+        url: 'https://github.com/diplodoc-platform'
+```
+
+Описание полей для каждого блока можно посмотреть в [документации](https://preview.gravity-ui.com/page-constructor/?path=/docs/documentation-blocks--docs).
+
+## Добавление блоков Page constructor в Markdown { #block }
+
+Вы можете встраивать отдельные блоки Page constructor непосредственно в markdown-документацию. Это позволяет комбинировать обычный markdown-контент с интерактивными блоками Page constructor на одной странице.
+
+### Синтаксис
+
+Для добавления блока Page constructor в markdown используйте директиву `page-constructor`:
+
+```yaml
+::: page-constructor
+blocks:
+  - type: 'header-block'
+    title: 'Заголовок'
+    description: 'Описание'
+:::
+```
+
+Важно: свойство `blocks:` обязательно. Внутри директивы используется тот же YAML-формат, что и при создании отдельных YAML-файлов. В текстовых полях (заголовках, описаниях, текстах) поддерживается базовый YFM-синтаксис.
+
+### Примеры использования
+
+Вы можете использовать Page constructor для добавления одного блока или нескольких блоков одновременно.
+
+{% cut "Разметка блока" %}
+
+```yaml
+::: page-constructor
+blocks:
+  - type: 'filter-block'
+    centered: true
+    title:
+      text: 'Нам доверяют'
+    tags:
+      - id: 'one'
+        label: 'DoubleСloud'
+      - id: 'two'
+        label: 'Yandex Support'
+      - id: 'three'
+        label: 'Yandex Cloud'
+      - id: 'four'
+        label: 'YDB'
+      - id: 'five'
+        label: 'CatBoost'
+    colSizes:
+      all: 12
+      xl: 12
+      md: 12
+      sm: 12
+    indent:
+      top: s
+    items:
+      - tags:
+          - 'one'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/diplodoc-tab-1.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://double.cloud/docs/en/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+
+      - tags:
+          - 'two'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-trust-support.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://yandex.ru/support2/audience/ru/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+      - tags:
+          - 'three'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/ddos-index-trust-yandex-cloud.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://cloud.yandex.ru/docs/compute/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+      - tags:
+          - 'four'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/ddos-index-trust-ydb.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://ydb.tech/en/docs/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+      - tags:
+          - 'five'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/ddos-index-trust-yandex-cat.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://catboost.ai/en/docs/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+  - type: 'card-layout-block'
+    title: 'Как это работает?'
+    colSizes:
+      all: 12
+      md: 4
+      sm: 6
+    indent:
+      top: sm
+    children:
+      - type: 'layout-item'
+        content:
+          title: 'Архитектура'
+          text: 'Платформа Diplodoc имеет клиент-серверную архитектуру: серверная часть состоит из компонентов на Node.js, которые генерируют и отображают документационные проекты. Такая архитектура обеспечивает надёжность и горизонтальное масштабирование в случае необходимости.  '
+        media:
+          image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-item-01-01.png'
+          disableCompress: true
+        fullScreen: true
+        border: true
+        disableCompress: true
+      - type: 'layout-item'
+        content:
+          title: 'Интеграция с GitHub'
+          text: 'Платформа Diplodoc имеет сквозную интеграцию с GitHub для обеспечения простого и стабильного механизма сборки и развёртывания документационных проектов. GitHub используется как хранилище исходного кода для документов и исполнения пайплайна проекта.'
+        media:
+          image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-item-01-02.png'
+          disableCompress: true
+        fullScreen: true
+        border: true
+        disableCompress: true
+      - type: 'layout-item'
+        content:
+          title: 'Развёртывание'
+          text: 'Компании – пользователи сервиса Diplodoc используют встроенные механизмы выкладки документационного проекта с последующей их индексацией и отслеживанием версий. Документы могут обновляться как в автоматическом, так и в полуавтоматическом режиме с привлечением администратора со стороны пользователя.'
+        media:
+          image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-item-01-03.png'
+          disableCompress: true
+        fullScreen: true
+        border: true
+        disableCompress: true
+:::
+```
+
+{% endcut %}
+
+Результат отображения:
+
+::: page-constructor
+blocks:
+  - type: 'filter-block'
+    centered: true
+    title:
+      text: 'Нам доверяют'
+    tags:
+      - id: 'one'
+        label: 'DoubleСloud'
+      - id: 'two'
+        label: 'Yandex Support'
+      - id: 'three'
+        label: 'Yandex Cloud'
+      - id: 'four'
+        label: 'YDB'
+      - id: 'five'
+        label: 'CatBoost'
+    colSizes:
+      all: 12
+      xl: 12
+      md: 12
+      sm: 12
+    indent:
+      top: s
+      bottom: m
+    items:
+      - tags:
+          - 'one'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/diplodoc-tab-1.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://double.cloud/docs/en/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+
+      - tags:
+          - 'two'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-trust-support.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://yandex.ru/support2/audience/ru/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+      - tags:
+          - 'three'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/ddos-index-trust-yandex-cloud.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://cloud.yandex.ru/docs/compute/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+      - tags:
+          - 'four'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/ddos-index-trust-ydb.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://ydb.tech/en/docs/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+      - tags:
+          - 'five'
+        card:
+          type: 'layout-item'
+          media:
+            image: 'https://storage.yandexcloud.net/cloud-www-assets/pages/index-diplodoc/ddos-index-trust-yandex-cat.png'
+            disableCompress: true
+          border: true
+          content:
+            links:
+              - text: 'Посмотреть документацию'
+                url: 'https://catboost.ai/en/docs/'
+                theme: 'normal'
+                arrow: true
+                color: #54BA7E
+  - type: 'card-layout-block'
+    title: 'Как это работает?'
+    colSizes:
+      all: 12
+      md: 4
+      sm: 6
+    indent:
+      top: s
+      bottom: xl
+    children:
+      - type: 'layout-item'
+        content:
+          title: 'Архитектура'
+          text: 'Платформа Diplodoc имеет клиент-серверную архитектуру: серверная часть состоит из компонентов на Node.js, которые генерируют и отображают документационные проекты. Такая архитектура обеспечивает надёжность и горизонтальное масштабирование в случае необходимости.  '
+        media:
+          image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-item-01-01.png'
+          disableCompress: true
+        fullScreen: true
+        border: true
+        disableCompress: true
+      - type: 'layout-item'
+        content:
+          title: 'Интеграция с GitHub'
+          text: 'Платформа Diplodoc имеет сквозную интеграцию с GitHub для обеспечения простого и стабильного механизма сборки и развёртывания документационных проектов. GitHub используется как хранилище исходного кода для документов и исполнения пайплайна проекта.'
+        media:
+          image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-item-01-02.png'
+          disableCompress: true
+        fullScreen: true
+        border: true
+        disableCompress: true
+      - type: 'layout-item'
+        content:
+          title: 'Развёртывание'
+          text: 'Компании – пользователи сервиса Diplodoc используют встроенные механизмы выкладки документационного проекта с последующей их индексацией и отслеживанием версий. Документы могут обновляться как в автоматическом, так и в полуавтоматическом режиме с привлечением администратора со стороны пользователя.'
+        media:
+          image: 'https://storage.yandexcloud.net/diplodoc-www-assets/pages/index-diplodoc/ddos-index-item-01-03.png'
+          disableCompress: true
+        fullScreen: true
+        border: true
+        disableCompress: true
+:::

package/tests/mocks/pdf-page/title-pages/input/.yfm

@@ -0,0 +1,6 @@
+pdf:
+    enabled: true
+
+resources:
+    style:
+        - __assets/start-page.css

package/tests/mocks/pdf-page/title-pages/input/__assets/start-page.css

@@ -0,0 +1,16 @@
+.pdf-title-page-wrapper {
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    align-items: center;
+    background-color: grey;
+    padding: 20px;
+    height: 100vh;
+    background-image: url(../__images/mountain.jpg);
+    background-size: cover;
+}
+
+img {
+    width: 100px;
+    height: 100px;
+}

package/tests/mocks/pdf-page/title-pages/input/__includes/include1.md

@@ -0,0 +1 @@
+### Include Pdf title

package/tests/mocks/pdf-page/title-pages/input/index.md

@@ -0,0 +1 @@
+# PDF mock index

package/tests/mocks/pdf-page/title-pages/input/page1.md

@@ -0,0 +1,3 @@
+# Page 1
+
+Page 1 content

package/tests/mocks/pdf-page/title-pages/input/page2.md

@@ -0,0 +1,3 @@
+# Page 2
+
+Page 2 content

package/tests/mocks/pdf-page/title-pages/input/pdf-endings/pdf-ending-page1.md

@@ -0,0 +1,13 @@
+### Pdf ending page 1
+
+Should be able to use variables {{test}}
+
+Should be able to use link to other pages [test](../page1.md)
+
+Should be able to use inlcudes 
+
+{% include [test-include](../__includes/include1.md) %}
+
+Should be able to resolve liquid syntax
+
+{% if test == "pdf" %} should be visible {% endif %}

package/tests/mocks/pdf-page/title-pages/input/pdf-endings/pdf-ending-page2.md

@@ -0,0 +1,3 @@
+<div class="pdf-title-page-wrapper">
+    <p>Lorem ipsum ending page with var {{test}}</p>
+</div>

package/tests/mocks/pdf-page/title-pages/input/pdf-titles/pdf-title-page1.md

@@ -0,0 +1,13 @@
+### Pdf title page 1
+
+Should be able to use variables {{test}}
+
+Should be able to use link to other pages [test](../page1.md)
+
+Should be able to use inlcudes 
+
+{% include [test-include](../__includes/include1.md) %}
+
+Should be able to resolve liquid syntax
+
+{% if test == "pdf" %} should be visible {% endif %}

package/tests/mocks/pdf-page/title-pages/input/pdf-titles/pdf-title-page2.md

@@ -0,0 +1,3 @@
+<div class="pdf-title-page-wrapper">
+    <p>Lorem ipsum title page with var {{test}}</p>
+</div>

package/tests/mocks/pdf-page/title-pages/input/presets.yaml

@@ -0,0 +1,2 @@
+default:
+  test: pdf

package/tests/mocks/pdf-page/title-pages/input/toc.yaml

@@ -0,0 +1,15 @@
+title: Pdf title pages
+href: index.md
+pdf:
+  startPages:
+    - ./pdf-titles/pdf-title-page1.md
+    - ./pdf-titles/pdf-title-page2.md
+  endPages:
+    - ./pdf-endings/pdf-ending-page1.md
+    - ./pdf-endings/pdf-ending-page2.md
+
+items:
+  - name: Title 1
+    href: page1.md
+  - name: Title 2
+    href: page2.md

package/tests/mocks/pdf-page/yfm-config/input/.yfm

@@ -0,0 +1,5 @@
+allowHtml: true
+
+pdf:
+  enabled: true
+  hddenPolicy: true

package/tests/mocks/pdf-page/yfm-config/input/index.md

@@ -0,0 +1,6 @@
+# Header
+
+Content
+
+[Link 1](page1.md)
+[Link 2](page2.md)

package/tests/mocks/pdf-page/yfm-config/input/page1.md

@@ -0,0 +1,3 @@
+# Page 1
+
+[Link](page2.md#hash)

package/tests/mocks/pdf-page/yfm-config/input/page2.md

@@ -0,0 +1,7 @@
+# Page 2
+
+## hash
+
+[External link](https://example.com)
+
+<div data-pdf-hidden="true"> Will be deleted in pdf <div>

package/tests/mocks/pdf-page/yfm-config/input/page3.md

@@ -0,0 +1 @@
+# Page 3

package/tests/mocks/pdf-page/yfm-config/input/toc.yaml

@@ -0,0 +1,15 @@
+title: Skip html extension
+href: index.md
+
+items:
+  - name: Title 1
+    href: page1.md
+  - name: Title 2
+    href: page2.md
+    hidden: true
+  - name: Without href
+    hidden: true
+    items:
+      - name: Title 3
+        href: page3.md
+    

package/tests/mocks/plugin-corner-cases/images-in-deflists/input/index.md

@@ -0,0 +1,5 @@
+**Term 1**
+
+:   Definition 1
+  
+    ![](image.jpeg)

package/tests/mocks/plugin-corner-cases/images-in-deflists/input/toc.yaml

@@ -0,0 +1,4 @@
+title: Test diplodoc-cli run
+items:
+  - name: Intro
+    href: index.md

package/tests/mocks/preprocess/input/.yfm

@@ -0,0 +1 @@
+allowHtml: true

package/tests/mocks/preprocess/input/1.md

@@ -0,0 +1,29 @@
+# Title
+
+Text not_var{{not-var}} not_var{{skip()}} {{default-var}}
+
+Text `not_var{{not-var}}` `not_var{{skip()}}` `{{default-var}}`
+
+Text
+```
+not_var{{not-var}}
+
+not_var{{skip()}}
+
+{{default-var}}
+```
+
+
+`[not a link](./path/to/relative/file.md)`
+
+## Subtitle {#subtitle}
+
+[{#T}](mermaid.md)
+
+[{#T}](mermaid.md#info)
+
+[](latex.md)
+
+[noext-link](includes)
+
+{% include [user](includes/user.md) %}

package/tests/mocks/preprocess/input/_assets/1.svg

@@ -0,0 +1,15 @@
+<svg width="20px" height="20px" viewBox="0 0 512 512" enable-background="new 0 0 512 512" id="search" version="1.1" xml:space="preserve" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g id="search_1_">
+<linearGradient gradientUnits="userSpaceOnUse" id="SVGID_1_" x1="57.9473" x2="407.9511" y1="351.4531" y2="149.3783">
+<stop offset="0" stop-color="#F14D5C"/>
+<stop offset="0.1309" stop-color="#F05454"/>
+<stop offset="0.3346" stop-color="#3bf488"/>
+<stop offset="0.3492" stop-color="#ED683C"/>
+<stop offset="0.714" stop-color="#1e15a3"/>
+<stop offset="1" stop-color="#FDC70C"/>
+</linearGradient>
+<path d="M300.766,87.509c-33.056,0-64.133,12.873-87.507,36.246c-23.374,23.374-36.247,54.451-36.247,87.507   c0,24.234,6.927,47.4,19.83,67.252l-12.669,12.669c0,0.001-0.001,0.001-0.001,0.001l-90.664,90.665   c-8.353,8.354-7.88,22.418,1.055,31.353l4.261,4.262c4.669,4.668,10.736,7.028,16.658,7.028c5.417,0,10.713-1.976,14.703-5.966   l15.405-15.405l75.259-75.259l12.671-12.672c19.85,12.9,43.014,19.826,67.246,19.826c33.056,0,64.133-12.873,87.506-36.247   c48.252-48.251,48.252-126.762,0-175.014C364.898,100.382,333.821,87.509,300.766,87.509z M138.518,396.049   c-4.454,4.453-12.178,3.979-17.219-1.063l-4.261-4.262c-5.036-5.035-5.509-12.756-1.055-17.21l71.38-71.38   c3.284,4.164,6.834,8.16,10.601,11.926c3.766,3.766,7.764,7.318,11.935,10.607L138.518,396.049z M105.894,410.391l-4.261-4.26   c-5.036-5.036-5.509-12.757-1.055-17.211l2.902-2.902c0.936,4.27,3.101,8.393,6.486,11.779l4.261,4.26   c3.392,3.393,7.523,5.549,11.799,6.483l-2.914,2.914C118.658,415.908,110.934,415.432,105.894,410.391z M213.788,320.779   c0.002-0.003,0.005-0.006,0.007-0.008l0,0L213.788,320.779z M217.033,317.534c-4.201-3.248-8.229-6.775-11.998-10.544   c-3.771-3.771-7.295-7.797-10.537-11.99l8.214-8.214c3.233,4.181,6.749,8.185,10.547,11.982c3.8,3.8,7.806,7.317,11.989,10.552   L217.033,317.534z M381.201,291.697c-21.485,21.485-50.052,33.318-80.436,33.318c-30.385,0-58.951-11.833-80.436-33.318   c-21.485-21.484-33.318-50.051-33.318-80.436s11.833-58.95,33.318-80.436c21.485-21.485,50.051-33.317,80.436-33.317   c30.384,0,58.95,11.832,80.436,33.317C425.553,175.179,425.553,247.346,381.201,291.697z" fill="url(#SVGID_1_)"/>
+<path d="M258.117,115.27l3.604,9.328c2.592-1.001,5.267-1.887,7.949-2.632l-2.676-9.636   C263.998,113.162,261.012,114.151,258.117,115.27z" fill="#3bf488ff"/>
+<path d="M206.264,162.886l8.985,4.389c8.299-16.992,22.191-30.997,39.118-39.433l-4.46-8.95   C231.022,128.304,215.523,143.928,206.264,162.886z" fill="#1e15a3ff"/>
+</g>
+</svg>

package/tests/mocks/preprocess/input/_assets/2.svg

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 20.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg width="20px" height="20px" viewBox="0 0 512 512" enable-background="new 0 0 512 512" id="search" version="1.1" xml:space="preserve" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g id="search_1_">
+<linearGradient gradientUnits="userSpaceOnUse" id="SVGID_1_" x1="57.9473" x2="407.9511" y1="351.4531" y2="149.3783">
+<stop offset="0" stop-color="#F14D5C"/>
+<stop offset="0.1309" stop-color="#F05454"/>
+<stop offset="0.3346" stop-color="#3bf488"/>
+<stop offset="0.3492"
+stop-color="#ED683C"/>
+<stop offset="0.714" stop-color="#1e15a3"/>
+<stop offset="1" stop-color="#FDC70C"/>
+</linearGradient>
+<path d="M300.766,87.509c-33.056,0-64.133,12.873-87.507,36.246c-23.374,23.374-36.247,54.451-36.247,87.507 
+c0,24.234,6.927,47.4,19.83,67.252l-12.669,12.669c0,0.001-0.001,0.001-0.001,0.001l-90.664,90.665   c-8.353,8.354-7.88,22.418,1.055,31.353l4.261,4.262c4.669,4.668,10.736,7.028,16.658,7.028c5.417,0,10.713-1.976,14.703-5.966   l15.405-15.405l75.259-75.259l12.671-12.672c19.85,12.9,43.014,19.826,67.246,19.826c33.056,0,64.133-12.873,87.506-36.247   c48.252-48.251,48.252-126.762,0-175.014C364.898,100.382,333.821,87.509,300.766,87.509z M138.518,396.049   c-4.454,4.453-12.178,3.979-17.219-1.063l-4.261-4.262c-5.036-5.035-5.509-12.756-1.055-17.21l71.38-71.38   c3.284,4.164,6.834,8.16,10.601,11.926c3.766,3.766,7.764,7.318,11.935,10.607L138.518,396.049z M105.894,410.391l-4.261-4.26   c-5.036-5.036-5.509-12.757-1.055-17.211l2.902-2.902c0.936,4.27,3.101,8.393,6.486,11.779l4.261,4.26   c3.392,3.393,7.523,5.549,11.799,6.483l-2.914,2.914C118.658,415.908,110.934,415.432,105.894,410.391z M213.788,320.779   c0.002-0.003,0.005-0.006,0.007-0.008l0,0L213.788,320.779z M217.033,317.534c-4.201-3.248-8.229-6.775-11.998-10.544   c-3.771-3.771-7.295-7.797-10.537-11.99l8.214-8.214c3.233,4.181,6.749,8.185,10.547,11.982c3.8,3.8,7.806,7.317,11.989,10.552   L217.033,317.534z M381.201,291.697c-21.485,21.485-50.052,33.318-80.436,33.318c-30.385,0-58.951-11.833-80.436-33.318   c-21.485-21.484-33.318-50.051-33.318-80.436s11.833-58.95,33.318-80.436c21.485-21.485,50.051-33.317,80.436-33.317   c30.384,0,58.95,11.832,80.436,33.317C425.553,175.179,425.553,247.346,381.201,291.697z" fill="url(#SVGID_1_)"/>
+<path d="M258.117,115.27l3.604,9.328c2.592-1.001,5.267-1.887,7.949-2.632l-2.676-9.636   C263.998,113.162,261.012,114.151,258.117,115.27z" fill="#3bf488ff"/>
+<path d="M206.264,162.886l8.985,4.389c8.299-16.992,22.191-30.997,39.118-39.433l-4.46-8.95   C231.022,128.304,215.523,143.928,206.264,162.886z" fill="#1e15a3ff"/>
+</g>
+</svg>

package/tests/mocks/preprocess/input/autotitle.md

@@ -0,0 +1,39 @@
+# Autotitles ![](_assets/1.svg)
+
+Empty title
+[](./1.md)
+
+### Uploading Attributes via Import File {#create-attribute-with-template}
+
+Empty subtitle
+[](./1.md#subtitle)
+
+Special title
+[{#T}](./1.md)
+
+Special subtitle
+[{#T}](./1.md#subtitle)
+
+Empty local title
+[](#header)
+
+Special local title
+[{#T}](#header)
+
+Reference link
+[{#T}][link]
+
+Reference link with hash
+[{#T}][link-with-hash]
+
+[link]: ./mermaid.md
+[link-with-hash]: ./1.md#subtitle
+
+Link another level
+[{#T}](./includes/level11.md)
+
+## Header {#header}
+
+Content
+
+#### Step 1. Follow the steps described in the [{#T}](#create-attribute-with-template) section

package/tests/mocks/preprocess/input/commented-include.md

@@ -0,0 +1,3 @@
+![](./missed-asset.png)
+
+[](./missed-link.md)