---
title: "Поиск контента с помощью регулярных выражений и других методов"
id: "poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov"
updated: 2026-11-16T06:46:08Z
---

# Поиск контента с помощью регулярных выражений и других методов

Для выполнения более сложных операций с **[глобальным поиском и заменой](/articles/manual/globalnyy-poisk-i-zamena),**можно использовать регулярные выражения. В этом разделе описано несколько вариантов использования.

* [Синтаксис регулярных выражений](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2_1400878280)
* [Сценарий №1 — Замена текста на переменную](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2_216909860)
* [Сценарий №2 — Замена повторяющихся фрагментов контента сниппетами](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2__1811325886)
* [Сценарий №3 - Очистка форматирования после импорта контента](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2__1017331075)
* [Сценарий №4 — Поиск тега с переменными атрибутами](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2__1142750648)
* [Сценарий №5 — Очистка заголовков и футеров с неизвестной структурой тегов](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2__1343424284)
* [Сценарий №6 — Поиск определенного CSS-класса](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2_1956782223)
* [Сценарий №7 — Поиск условного тега](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2_2114977601)
* [Сценарий №8 — Поиск ссылки на страницу или изображение](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2_1677829090)
* [Сценарий №9 — Поиск и переименование переменных и условных тегов в режиме редактирования](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2_1850744870)
* [Сценарий №10 — Поиск и замена ссылок на изображения после перемещения изображений в другое место](/articles/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/a/h2_153853529)

## Синтаксис регулярных выражений

Перед началом обратите внимание на несколько ключевых моментов о синтаксисе регулярных выражений:

* **Глобальный поиск и замена** поддерживает синтаксис регулярных выражений .NET. Для получения более подробной информации ознакомьтесь со следующей статьей Microsoft: [Язык регулярных выражений — краткий справочник](https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference).
* При использовании диалогового окна **Поиск и замена** в редакторе исходного кода страницы, редакторе HTML, редакторе JavaScript, редакторе CSS и редакторе примеров кода Документерра использует синтаксис регулярных выражений JavaScript. Для получения более подробной информации обратитесь к этому разделу: [Справочник регулярных выражений](https://www.w3schools.com/jsref/jsref_obj_regexp.asp)JavaScript RegExp. Имейте в виду, что в Документерре можно использовать регулярные выражения без кавычек и косой черты.
* На странице **Глобальный поиск и замена** и в диалоговых окнах **Поиска и замены** в редакторах можно использовать символ $ с числом (например, $1, $2 и т. д.) для ссылки на конкретное совпадение поиска.
* Некоторые символы, такие как ? \*+.\$^{}()| могут иметь особое значение в регулярных выражениях. Если вам нужно использовать данные символы при поиске, убедитесь, что вы исключили их в строке поиска, добавив обратную косую черту перед символом. Например, \? или \\*.
* Если вы не уверены в правильности использования регулярных выражений, мы рекомендуем использовать [REGEX TESTER](http://regexstorm.net/tester) для тестирования и исправления регулярных выражений.

## **Сценарий №1 — Замена текста на переменную**
 
Предположим, вы добавили название своей компании на все свои страницы.

![Название компании на странице документации.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/nazvaniye-kompanii.png)
 
Теперь вы хотите использовать [переменную](/articles/manual/ispolzovaniye-peremennykh-v-kontente-stranitsy) для всех этих мест, чтобы упростить обновление названия компании, если это потребуется. Вы можете выполнить это изменение следующим образом:

* Введите название компании в поисковую строку и установите соответствующие галочки фильтров.
![Настройки глобального поиска и замены для обновления названия компании.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/poisk-po-nazvaniyu.png)
* Нажмите **Найти все**.
* Вставьте код &lt;ch:var name="companyName" /&gt; в поле **Заменить на**. 
![Код, вставленный в поле замены.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/zamenit-na.png)
* Выберите страницы, на которых вы хотите заменить название компании на переменную.
* Нажмите **Заменить выбранное** (или **Заменить все**, если вам нужно выполнить замену на всех страницах).
* Результат: 
![Результат замены названия компании на переменную.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/peremennaya.png)

## **Сценарий №2 — Замена повторяющихся фрагментов контента сниппетами**

Предположим, что после импорта документации у вас есть повторяющийся фрагмент контента на нескольких страницах. Например, такое предложение:

![Пример повторяющегося контента.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/snippet.png)

Давайте заменим его на **сниппет**. Для начала вам нужно создать отдельную страницу, которую вы будете использовать в качестве сниппета. Для получения более подробной информации о сниппетах обратитесь к этому разделу: [Сниппеты контента](/articles/manual/content-snippets).

Вот как выглядит разметка предложения:


```html
<p>Создайте робота за несколько шагов: сборка, подключение и программирование — быстро и легко!</p>
```


Чтобы оно появилось на всех страницах, вставьте \s\*?  до и после открывающих и закрывающих тегов. Для нашего предложения поисковый запрос будет выглядеть так:


```html
<p>\s*?Создайте робота за несколько шагов: сборка, подключение и программирование — быстро и легко!\s*?</p>
```


Это может показаться сложным, но главное, что нужно помнить, — это добавить `\s*?` перед каждым открывающим и закрывающим тегом.

Перейдите на страницу **Глобального поиска и замены**.

Чтобы заменить предложение сниппетом, выполните следующие шаги:

* Используйте поисковый запрос в качестве строки поиска.
* Установите соответствующие галочки фильтра — **Регулярное выражение** и **Страницы (название и HTML)** обязательны.
* Нажмите **Найти все**.
* Выберите все страницы, кроме той, которую вы только что создали в качестве сниппета (иначе ее код также будет заменен).
* Заполните поле **Заменить на** ссылкой на сниппет. Вот пример того, как это будет выглядеть:

```html
<ch:snippet url="/articles/project-rukovodstvo-po-izgotovleniyu-robotov/vstupleniye"/>
```

* Нажмите **Заменить выбранное**.

Вот и все — статический контент был успешно заменен на сниппет.

## **Сценарий №3 -** **Очистка форматирования после импорта контента**

Предположим, вы хотите удалить заголовок, который был импортирован из сторонней программы:

![Заголовок, импортированный сторонней программой.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/import-zagolovok.png)

При переключении в режим исходного кода HTML-код заголовка будет выглядеть так:

![Отображение заголовка в режиме исходного кода.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/html-zagolovka.png)

Чтобы найти его, вы можете использовать его идентификатор:


```html
<div[^>]*?id="pnlHeader"[^>]*?>\s*?Создано с помощью сторонней программы.\s*?</div>
```


или его класс:


```html
<div[^>]*?class="header"[^>]*?>\s*?Создано с помощью сторонней программы.\s*?</div>
```


Как видите, мы добавили [^&gt;]\*?. Чтобы игнорировать все остальные атрибуты текущего тега, вы можете использовать это регулярное выражение в подобных случаях.

## Сценарий №4 — Поиск тега с переменными атрибутами

Этот сценарий можно использовать в различных ситуациях, но в нашем случае мы хотим найти и удалить следующий заголовок:

![Пример заголовка, который нужно удалить.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/udalit-zagolovok.png) 
 Его код в режиме исходного кода выглядит так:
 
![Отображение заголовка в режиме исходного кода.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/ishodniy-kod.png)
 
В этой ситуации вы можете использовать его идентификатор, чтобы найти его, как показано в предыдущем сценарии, поэтому подход остается тем же.

Однако, если искомая разметка имеет вариации в атрибутах и тегах, может потребоваться игнорировать изменяющуюся часть и использовать статическую часть для поиска. Например, на одной странице у вас может быть следующее форматирование:

![Пример форматирования.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/primer-1.png)

А вот на другой странице (текст навигационной ссылки другой):

![Пример форматирования.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/primer-2.png)

Вы можете сопоставить обе версии, используя что-то общее, например:


```html
<div id="pnlHeader">
  <div[^>]*?class="headerText"[^>]*?>[^<]*?</div>
  <a[^>]*?>[^<]*?</a>
</div>
```


Итак, ваш поисковый запрос будет выглядеть следующим образом:


```html
<div id="pnlHeader">\s*?<div[^>]*?class="headerText"[^>]*?>[^<]*?</div>\s*?<a[^>]*?>[^<]*?</a>\s*?</div>
```


Это результат поиска. Как видите, показаны обе страницы: 
![Пример отображения двух страниц в поиске.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/rezultat-poiska.png)

## **Сценарий №5 — Очистка заголовков и футеров с неизвестной структурой тегов**

Иногда возникают ситуации, когда вы не знаете структуру тегов всех заголовков и футеров. В этом случае вы можете воспользоваться предыдущим методом и удалять группы по одной, либо применить противоположный подход — определить, что нужно сохранить. Ниже мы покажем последний способ:

* Например, у вас есть заголовок, который в режиме редактирования выглядит следующим образом:
![Пример заголовка.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/zagolovok.png)
* А вот исходный код для этого блока: 
![Отображение заголовка в режиме исходного кода.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/primer-zagolovka.png)
* Можно указать начало и конец контента, поэтому ваш поисковый запрос будет выглядеть следующим образом: 

```html
^.*?<div[^>]*?id="pnlContent"[^>]*?>(.+)</div>\s*?<div[^>]*?class="footer".*?$
```

* Заполните поле **Заменить на** регулярным выражением: $1
* Затем продолжайте выполнять шаги.
* Результат будет следующим: 
![Результат замены заголовка.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/rezultat-zameny.png)

Этот способ и механизм **Глобального поиска и замены** в целом являются мощным инструментом. Вы можете использовать его не только для заголовков и футеров, но и для других случаев, когда вам нужно найти и заменить элементы форматирования.

##  **Сценарий №6 — Поиск определенного CSS-класса**

Полезно очистить контент после импорта из MS Word, так как CSS-классы могут создаваться с автоматическими именами для повторяющихся стилей. Для получения более подробной информации обратитесь к этому разделу: [Импорт из Microsoft Word](/articles/manual/import-from-microsoft-word). Вот несколько примеров использования:

* ### **Автоматические имена CSS-классов**
 
    В этом случае используйте обычный текст, так как классы уникальны, и нет необходимости отмечать фильтр **Поиск целого слова**.

* ### **Имена других классов**  
 
    Имена классов могут различаться и даже совпадать с именами тегов. В таком случае требуется двухэтапная замена.

Например, если нужно найти имя класса «myClass» во всех CSS-стилях, мы будем использовать следующее регулярное выражение:


```css
\.myClass\b
```


Как видите, мы используем обратный слеш `\` для точки и `\b` для обозначения границы слова.

Для HTML поиск всех мест, где используется myClass, будет выглядеть следующим образом: 

```html
(<[^>]+?class=['"][^'"]*?)\bmyClass\b
```


* Затем следует сопоставить начало тега и его атрибут class с другими возможными классами, которые могут находиться перед нужным классом. Они будут в группе, которую мы не должны удалять или редактировать. Далее, мы находим нужный класс, который будет окружен границами слов. В квадратных скобках используются одинарные или двойные кавычки. Выражение типа `[^'"]` означает, что нужно найти все символы, кроме одинарных и двойных кавычек, чтобы не выйти за рамки атрибута класса.
* Заполните поле **Заменить на** выражением $1myNewClass. Затем продолжайте выполнять шаги.
* Например, для следующей части: 

```css
<div class="firstClass myClass otherClass">
```

* Результат будет таким: 

```css
<div class="firstClass myNewClass otherClass">
```


## Сценарий №7 — Поиск условного тега

Предположим, вам нужно найти тег PrintedDoc.
 
![Изображение того, как выглядит элемент PrintedDoc.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/printed-doc.png)
 
Используя регулярные выражения, поисковый запрос будет выглядеть следующим образом:


```html
(<ch:[^>]*?tags=['"][^'"]*?)\bPrintedDoc\b
```


Для того, чтобы заменить его, заполните поле **Заменить на** выражением $1NewOutputTag. Затем продолжайте выполнять шаги.

Например, если бы у нас была следующая разметка Exclude Block:


```html
<ch:exclude tags="AdminGuide,PrintedDoc">
```


После операции замены, результат будет выглядеть следующим образом:


```html
<ch:exclude tags="AdminGuide,NewOutputTag">
```


## **Сценарий №8 — Поиск ссылки на страницу или изображение**

В этом случае нет необходимости использовать регулярные выражения — можно обойтись фильтрами.

![Настройки Глобального поиска и замены.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/filtry-poiska.png)

Например, если нужно найти, где используется страница, просто введите в строку поиска её название, идентификатор или URL-адрес.

![Поиск ссылки на страницу.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/nazvaniye-stranitsy.png)

## **Сценарий №9 — Поиск и переименование переменных и условных тегов в режиме редактирования**

Например, если нужно переименовать переменную с тегом **companyName**:

* Вот как она выглядит в режиме **редактирования**:
![Отображение переменной в режиме редактирования.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/peremennaya-v-redaktore.png)
* Вот как она выглядит в режиме **исходного кода**:
![Отображение переменной в режиме исходного кода.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/peremennaya-v-ishodnom-kode.png)

Итак, вот шаги, которые необходимо выполнить, чтобы найти и заменить переменную:

* В этом случае нужно использовать регулярные выражения, поэтому поисковый запрос будет выглядеть следующим образом:


```html
(<ch:var[^>]+?name=['"])companyName(['"][^>]*?>)
```


Как вы можете заметить, для правильной работы регулярных выражений необходимо использовать:

* `['"]` для указания двойных или одинарных кавычек.
* `[^>]+?` для поиска пробела.
* `[^>]*?` для поиска пробела и косой черты.

Кроме того, следует использовать символы `(` и `)` для объединения совпадающих подвыражений в две группы.

* Чтобы выполнить переименование, заполните поле **Заменить на** выражением $1NewName$2. 
![Переименование путем замены.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/poisk-peremennoy.png)
* Выберите страницу, на которой хотите заменить переменную, затем нажмите **Заменить выбранное** (или, при необходимости, нажмите **Заменить все**). 
![Выбор страницы для замены переменной.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/zamenit-vybrannoe.png)
* В результате вы получите новую переменную с тегом **NewName**.

## Сценарий №10 — Поиск и замена ссылок на изображения после перемещения изображений в другое место

Если вы переместили изображение из одной папки в другую, оно будет отображаться в ваших проектах как поврежденное. Чтобы не просматривать каждую страницу и не менять ссылки на изображения вручную, вы можете заменить старый URL-адрес изображения на новый без использования регулярных выражений.

Например, замените:


```html
<img src="Storage/old-folder/image.png"
```


на следующее:


```html
<img src="Storage/new-folder/image.png"
```


![Замена URL-адреса изображения.](/resources/Storage/manual/poisk-kontenta-s-ispolzovaniyem-regulyarnykh-vyrazheniy-i-drugikh-metodov/zamenit-izobrazheniye.png)

После этого система обновит все ссылки на изображения, и они снова станут доступными.

| ![](/resources/Storage/manual/documenterra_baselang/Images/quick-parts/icon-info.svg) | Примечание |
| --- | --- |
| Этот способ будет работать только в том случае, если атрибут src размещается сразу после открывающего тега img, что является наиболее распространенным сценарием. |