В директе длина текста: Ограничения по символам в объявлениях Яндекс.Директа | Convert Monster

Содержание

Заголовок Яндекс.Директ | Расширяем до 56 символов!

Многие из вас, уважаемые пользователи, мне часто задают вопрос: «Как именно увеличить заголовок Яндекс.Директ?». Просто у некоторых не получается сделать это правильно. А ведь от заголовка Яндекс.Директ зависит весь успех контекстной рекламы, вся ваша прибыль от продаж и эффективный рост бизнеса!

Как мы знаем, стандартная длина заголовка в Яндекс.Директе — 33 символа, учитывая пробелы. И если вы в настройках кампании не отключали функцию подстановки части текста объявления в заголовок, то заголовок, зачастую, будет показываться в непривлекательном виде типа обрубка, прямо как в фильме ужасов, вот так (выделено красным). 😯

Будет добавляться «некрасивый» обрубок в виде адреса сайта или будет подхватываться из начала текста объявления то, что влезет уже в расширенный заголовок Яндекс.Директ (56 символов). Это может быть какое-нибудь словосочетание или короткая фраза из начала объявления, после которой стоит точка. Оно нам надо? НЕТ!

Мы сделаем длинный заголовок, максимально привлекающий внимание, куда влезут даже ключевые слова длиной в 53 символа, которые чаще всего являются НЧ запросами и стоят меньше денег (цена за клик)!

Расширенный заголовок Яндекс.Директ

Итак, сразу стоит сказать, почему мы можем расширить заголовок только до 53 символов, а не до 56. Все дело в том, что когда Директ добавляет часть текста в заголовок, то перед этой «добавкой» он ставит 3 знака: пробел, тире, пробел, — в итоге нам остается только 53 символа, вместе с точкой, восклицательным или другим знаком на конце заголовка.

Вот пример расширенного заголовка Яндекс.Директ в 56 символов со всеми необходимыми знаками препинания. Ключ «оказание услуг по бухгалтерскому обслуживанию дешево»: 53 символа с точкой на конце + добавленные Директом 3 заветных знака = 56 символов.

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

В итоге, с такой длиной заголовка Яндекс.Директ вы получаете магнетически привлекающее внимание объявление, которое увеличивает кликабельность и тем самым повышает CTR, что конечно же ведет к снижению цен за клики! Многие рекламодатели вообще не используют такие длинные ключевые слова, теряя реально целевых клиентов и выгодные цены за клики, все в ваших руках — накажите своих конкурентов, используя расширенный заголовок!

 

итоги «Дзен-среды» / Skillbox Media

Шеф-редактор площадки Мария Усольцева и руководитель коммерческой редакции «Яндекс.Дзена» Олег Копылов рассказали о результатах исследования 16 тысяч текстов, размещённых на «Дзене». Они выделили пять факторов, которые влияют на дочитываемость, конверсию и счастье клиента. Их выводы мы кратко описали ниже.

Самый популярный диапазон знаков в тексте — от 3300 до 5700. Чтобы пользователь дочитывал статью до конца, Усольцева и Копылов рекомендуют придерживаться этих рамок.

Если в тексте меньше 3000 знаков, то, скорее всего, в нём не уместилась подробная информация о продукте — а без неё сложно прогреть читателя. Если в тексте больше 6000 знаков, вероятнее всего, начнёт снижаться процент дочитывания, потому что длинные тексты дочитывают хуже.

«Ещё мы смотрели на процент дочитываний — в среднем дочитываемость у рекламных публикаций от 20 до 48%. Если у вас меньше 20%, то нужно оптимизировать текст и увеличивать этот показатель, а если больше 48% — вы молодец, вы вышли за порог этой средней рамки», — отметила Мария Усольцева.

Примеры статей подходящего размера:

Что предпочесть: кредит или кредитку?

«Этот пример показывает, что важно структурировать текст. В этой статье есть главы и списки, которые выделены с помощью эмодзи. Это помогло получить около 70% дочитываний», — пояснил Олег Копылов.

Средний размер статей с хорошей конверсией в «Дзене» — 5590 знаков. В длинных текстах можно больше рассказать о продукте и лучше прогреть аудиторию.

«Если вам нужны конверсии, то лучше писать тексты от 4000 до 10 000 знаков. Да, скорее всего, вы потеряете в дочитываниях — по сравнению с более короткими материалами. Однако вы приведёте на посадочную страницу максимально прогретую, релевантную аудиторию, которая совершит то действие, которого вы от неё хотите», — рассказала Мария Усольцева.

Пример длинного конверсионного текста:

7 фактов про игровой ноутбук OMEN 15 (2020)

«В этом материале 7700 знаков. Есть попадания в боль, есть примеры, какими обычно бывают игровые ноутбуки, описание технических характеристик, много фотографий. Процент дочитывания — около 70%», — говорит Олег Копылов.

Оптимальное число изображений в «Дзене» — 5–10 картинок на текст. Они позволяют показать свой продукт, создать ассоциации с рекламируемой услугой, передать настроение. Столько картинок в тексте увеличивает процент дочитывания.

Примеры текстов с хорошими картинками:

Где достать сыр, который победил на сырном чемпионате Франции?

«Сейчас у текста около 300 000 дочитываний. Этот текст классно визуально оформлен. Здесь есть фото с сырами на производстве. А в конце — картинка с промокодом на скидку. Такая картинка воспринимается гораздо круче, чем просто промокод, который стоит в конце статьи. И это тоже работает и на запоминание, и на восприятие», — рассказала Мария Усольцева.

Мария и Олег рекомендуют делать 10–15 комбинаций «заголовок + картинка». Это пять заголовков, по-разному скомбинированных с тремя картинками.

Эксперты «Дзена» выяснили, что большее количество заголовков в обложках влияет на рост CTR лучше, чем большее количество картинок. В обложках количество заголовков даёт лучший результат по CTR, чем количество картинок. Если вы хотите повысить CTR, то лучше сначала поработать с заголовками и уже затем менять картинки.

Пример подобной статьи:

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

Исследование показало, что длина заголовка не влияет на CTR обложки. Средний CTR по всем рекламным публикациям в «Дзене» — 1,8%. «Делайте любые заголовки, хоть длинные, хоть короткие, главное, чтобы они не нарушали правила „Дзена“», — сказали представители площадки.


Обложка: кадр: Блог-платформа Яндекс.Дзен / YouTube

Оценка качества Поиск Яндекс.Директ

Отчет оценка качества 


Поиск Яндекс.Директ


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

В отчете анализируются следующие показатели рекламной кампании:

  • Качество объявлений — насколько корректно составлены объявления и соответствие поисковым фразам, все ли поля объявления заполнены.
  • Релевантность текстов— анализируются параметры фраз и текстов, наличие минус-слов, соответствие текстов объявлений выбранным фразам.
  • Релевантность ссылок — анализируется соответствие посадочной страницы поисковой фразе.
  • Метрические показатели сайта — анализируется скорость ответа страницы, время, которое провел пользователь на страниц.
  • Наличие счетчика Яндекс.Метрики — если счетчик установлен, будут начислены дополнительные баллы
  • Кампания разделена на Поиск и РСЯ — если кампания разделена на Поиск и РСЯ, бюджет РК будет использоваться эффективнее.

В отчете выводятся 2 блока оценок:

  • Оценка РК c учетом значимости фраз — отчет формируется на основании данных наиболее значимых фраз.
      

    Важно! В этом блоке показываются все фразы, но оценка показана только для значимых фраз (фразы, на которые суммарно приходится 95% бюджета). Оценки по каждой фразе РК можно увидеть в блоке Оценка фраз без учета значимости. 


  • Оценка РК без учета значимости фраз — в отчете учитывается оценка всех фраз рекламной кампании, можно просмотреть подробную информацию по объявлениям поисковых фраз и увидеть оценку.

По клику на столбец показателя

можно увидеть описание оцениваемых параметров


Значимость фраз оценивается по кликам и расходу бюджета рекламной кампании. 
В столбце Значимость фраз выводится уровень значимости в %. Значение веса присваивается фразе в зависимости от того в какую группу попадает фраза (Топ 80%, Топ 85%, Топ 90%, Топ 95%), либо не попала ни в одну из групп.

Топ 80% — фразы рекламной кампании, на которые приходится 80% от общего количества кликов/расхода. Т.е.  сумма кликов/расхода по фразам которые попали в Топ 80% составляет 80% от общего бюджета. Для фраз этой группы будет выставлена значимость — 100%

Топ 85% — в эту группу попадают фразы, которые не попали в Топ 80%, но суммарно с фразами Топ 80% дают 85% кликов/расхода. Таким фразам будет указана значимость 75%. 

Топ 90% — в эту группу попадают фразы, которые не попали в Топ 80%

и Топ 85%, но суммарно с фразами Топ 80% и Топ 85% дают 90% кликов/расхода. Таким фразам будет указана значимость 50%. 

Топ 95% — в эту группу попадают фразы, которые не попали в Топ 80% и Топ 85%, но суммарно с фразами Топ 80%, Топ 85% и Топ 90% дают 95% кликов/расхода. Таким фразам будет указана значимость 25%.

Остальным фразам присваивается значение — 0.


На скрин-шоте: 

1 — фразы из Топ 80%                     

2 — фразы из Топ 90%

 

Значимость по кликам

Значимость по расходу

Фраза попадает в Топ фраз по кликам за последние 30 дней, если сумма Топ фраз даёт определённый % кликов всей РК

Топ 80%  — вес фразы 100%

Топ 85%  — вес фразы 75%

Топ 90%  — вес фразы 50%

Топ 95%  — вес фразы 25%

Иначе — вес фразы 0

Если информация недоступна, по умолчанию ставится 100%

Фраза попадает в Топ фраз по расходу за последние 30 дней, если сумма Топ фраз даёт определённый % расхода всей РК

Топ 80%  — вес фразы 100%

Топ 85%  — вес фразы 75%

Топ 90%  — вес фразы 50%

Топ 95%  — вес фразы 25%

Иначе — вес фразы 0

Если информация недоступна, по умолчанию ставится 100%

В верхней таблице — оценка рекламных кампаний и количество баллов, начисленных за параметры.
В строке Максимум — максимальное количество баллов, которое может быть начислено по показателям. Чтобы улучшить РК, исправьте те параметры, по которым набрано минимальное количество баллов от общего количества возможных.


Оценка РК без учета значимости фраз

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

Зеленым выделены столбцы с суммарным количеством баллов
Синим — баллы по каждому из параметров.

Оценка фраз без учета значимости. 


В блоке выведены фразы и их оценки по параметрам.
Подробное описание оценок и их составляющих в правых столбцах таблицы.

  • Фраза с минус-словами
  • Оценка
  • (%) от максимума
  • Всего по зачтённой фразе
  • Релевантность текстов
  • Релевантность ссылок
  • Метрические показатели 
  • Фраза зачтена: да/нет
  • ID фразы

Объявления

Выводятся все параметры объявления: 

  • id фразы, 
  • id объявления, 
  • заголовок 1,
  • заголовок 2, 
  • текст, 
  • ссылка, 
  • отображаемая ссылка, 
  • регион показа, 
  • контакты, 
  • заголовок быстрых ссылок, 
  • адреса быстрых ссылок


Зачет / Незачет фраз

В блоке перечислены параметры по которым фразы идут в зачет.
Если параметры были заполнены — фраза зачтена.

Фраза зачтена, если «Да» по всем критериям.

Фраза НЕ зачитывается, если в объявлении отсутствует один из параметров:

  • ключевая фраза 
  • заголовок 1 — корректен, если не превышает 36 символов, заголовок начинается с прописной буквы, текст после точки начинается с прописной буквы, корректная обработка решетки (если используется шаблон)
  • заголовок 2 — корректен, если не превышает 31 символ, заголовок начинается с прописной буквы, текст после точки начинается с прописной буквы, корректная обработка решетки (если используется шаблон)
  • текст — корректен, если не превышает 82 символа, текст начинается с прописной буквы, после точки используется прописная буква
  • ссылка (отображаемая часть) — отображаемая часть не превышает 20 символов, добавлено описание быстрых ссылок, ссылки начинаются с прописной буквы, адреса быстрых ссылок ведут на лендинг объявления
  • быстрая ссылка (ссылки и заголовки)
  • уточнения —
    корректны, если не превышают 65 символов, начинаются с прописной буквы

Релевантность текстов

В этом блоке оцениваются тексты объявлений, релевантность текстов объявлений фразам.

Общий балл – сумма по всем критериям

Оценка ключевых слов в заголовке -максимальный балл если все слова ключевой фразы использованы в заголовке.

Формула расчёта = Максимальный балл х (%) ключа, использованных в заголовке

Оценка ключевых слов в тексте — максимальный балл, если все слова ключевой фразы использованы в тексте.

Оценка ключевых слов в быстроссылках — максимальный балл, если 40% и более слов ключевой фразы использованы в заголовке. Если менее, максимальный балл пропорционально уменьшается от 100% до 0%.

Оценка длины текста — текст объявления должен быть больше, чем:

  • Количество слов в заголовке + 3 слова.
  • Если в тексте объявления — короткий текст из заголовка, то вам зачислятся штрафные баллы

Наличие минус слов — учитываются минус слова РК.


Релевантность ссылок

Если ссылка нерелевантна, будет выводиться рекомендованная ссылка.


Метрические показатели

Суммарная оценка и показателей работы сайта.

Оцениваются параметры: 

Скорость загрузки посадочной страницы — максимальный балл выставляется, если скорость загрузки посадочной страницы меньше 3 секунд, минимальный, если посадочная страница загружается больше 15 секунд.

Показатель отказов и время на сайте по данным Google Analytics — баллы выставляются на основании данных за последние 30 дней.


Значимость фраз

В столбцах значение значимости фраз по кликам и расходам.

Размещение Контекстной Рекламы в Директе Без Сайта

В Яндекс Директе могут размещаться как рекламодатели, имеющие собственный сайт, так и те, у кого пока нет сайта. Использовать контекстную рекламу не имея сайта поможет виртуальная визитка Директа. Она представляет собой карточку с подробной информацией о компании.

Увидеть такие визитные карточки можно в объявлениях контекстной рекламы, при клике по ссылке «Контактная информация» открывается виртуальная визитка.

Разберем поэтапно, как создать рекламную кампанию в Директе, не имея сайта.

Первым делом необходимо создать рекламный аккаунт в Яндекс.Директ, если ранее у вас его не было. Если в аккаунте еще не размещалась реклама, вы увидите страницу следующего вида:

Смело кликаем по кнопке «Разместить рекламу» и переходим к созданию рекламной кампании. Для новых рекламодателей система предлагает выбрать страну и тип первой рекламной кампании. Мы выбрали тип Текстово-графические объявления. Далее, нажимаем на кнопку «Начать пользоваться сервисом».

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

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

На данном шаге выбираем необходимые регионы для показа рекламы.

Например, Иркутск.

Теперь переходим к Визитной карточке. Чтобы заполнить ее поля, переведите флажок в положение «Да».

Появляются поля для заполнения контактов. Укажите ваш регион, номер телефона для связи, название, режим работы, адрес местоположения, E-mail и текстовый блок с описанием.

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

В графе «Подробнее о товаре/услуге» напишите информативный текст описывающий ваше предложение. Максимально допустимая длина текста 200 символов.

Когда визитная карточка заполнена и выбраны оптимальные настройки кампании, переходим на шаг 2, для этого нажимаем «Дальше» внизу страницы.

Следующим шагом является страница с созданием рекламного объявления. То есть требуется написать заголовки и текст объявления, указать ключевые слова.

Поле «Ссылка на сайт» оставляем незаполненным, так как рекламироваться будем только с помощью визитной карточки. Поле «Отображаемая ссылка» тоже остается пустым, так как у нас нет сайта, к которому мы могли бы добавить такую удобочитаемую ссылку. То же самое касается и «быстрых ссылок».

Кстати, рекомендуем добавить «Уточнения», длина одного уточнения может содержать до 25 символов. Это небольшие тексты, в которых вы можете описать свои УТП и главные особенности. Они будут показаны в дополнительной строке внизу объявления. Например:

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

Затем сохраняем все заполненные данные, нажав на кнопку «Сохранить» внизу страницы.

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

Теперь ваша рекламная кампания готова к запуску! Можете отправлять объявления на модерацию, и пополнять баланс кликов.

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

Отметим, что многие инструменты в контекстной рекламе будут недоступны для размещения без сайта. Соответственно, объявление не сможет содержать максимум информации, будет занимать меньше пространства в выдаче и выглядеть на фоне конкурентов не в лучшем виде.

Сравним возможности сайта и виртуальной визитки Яндекса.

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

P.S. Ну и, как всегда, мы готовы поддержать вас в любом вашем решении:

Зачем нужен второй заголовок в Яндекс.Директ? Использование заголовка на примерах

Не так давно Яндекс добавил возможность использования второго заголовка длиной до 30 символов для текстово-графических объявлений.

Связано это с исследованиями Яндекса, которые показали, что длинные заголовки привлекают внимание пользователей лучше, чем короткие. Следовательно, это приводит к увеличению числа кликов и прибыли (как рекламодателя, так и Яндекса).

Как обещает российская компания — использование второго заголовка позволяет увеличить CTR рекламным объявлений: до 5% на ПК и до 10% — на рекламе в мобильных устройствах.

Отмечу, что приложение Директ Коммандер также поддерживает создание объявлений с двумя заголовками. Почитайте, что пишет сам Яндекс о новых возможностях — https://yandex.ru/support/direct-news/n-2017-08-15.html

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

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

1. Можно использовать в качестве призыва к действию:

2. Описывать преимущества товара или компании: акции, гарантия, цена или скидка:

3. Дополнительное упоминание бренда и компании:

4. Прочая дополнительная информация:

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

Вывод

Нововведения Яндекса дают ощутимую свободу для творчества всем рекламодателям. Длина первой части осталась неизменной и составляет 35 символов, вторая позволит добавить 30 дополнительных знаков. Кроме этого, увеличилась длина объявления с 75 знаков до 81-го.

Невероятная возможность реализовать все задуманные фантазии в месседже для клиента!

Но это еще не все! Теперь не учитываются знаки препинания в общем объеме текста, что позволяет написать максимально «вкусное» и интересное предложение для аудитории. Однако, и здесь есть ограничения по количеству ‒ максимум 15 знаков, но этого более чем достаточно. К таким относятся:

  • кавычки и двоеточие;
  • запятая и точка;
  • восклицательный знак.

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

Остались вопросы по настройке? Задавайте в комментариях ниже или пишите мне на личную почту [email protected]. С удовольствием помогу с решением вопроса

Сохраните ссылку

Читайте дальше:

Метки #контекстная реклама, #яндекс.директ

angular2-character-count-directive / char-count.directive.ts на главном сервере · dan-lennox / angular2-character-count-directive · GitHub

angular2-character-count-directive / char-count.directive.ts на главном сервере · Dan-lennox / angular2-character-count-директива · GitHub Постоянная ссылка

В настоящее время невозможно получить участников Этот файл содержит двунаправленный текст Unicode, который может интерпретироваться или компилироваться иначе, чем то, что показано ниже.Для просмотра откройте файл в редакторе, который показывает скрытые символы Юникода. Подробнее о двунаправленных символах Юникода
импортировать {OnInit, Directive, ElementRef, Renderer} из ‘@ angular / core’;
/ **
* Определите директиву CharCount.
* /
@Directive ({
Селектор : ‘[charCount]’,
входов: [‘limit: charCount’],
хост: {
‘(клавиатура)’: ‘_onKeyUp ()’,
}
})
/ **
* Класс CharCount.
* /
экспортный класс CharCount реализует OnInit {
// Ограничение по умолчанию, если ничего не указано.
частный _defaultLimit: number = 200;
// Входная переменная ограничения количества символов.
частный _limit: номер;
// HTML nativeElement (span) для отображения количества символов.
приватный _countDisplay: любой;
/ **
* Конструктор класса.
*
* @param {ElementRef} _elRef
* Экземпляр объекта ElementRef.
* @param {Renderer} _renderer
* Экземпляр объекта Renderer.
* /
конструктор (частный _elRef: ElementRef, частный _renderer: Renderer) {}
/ **
* Обработка событий нажатия клавиш от хост-компонента.
* /
частный _onKeyUp () {
// Когда поле на хосте обновляется. Обновите счетчик.
let count: any = this._elRef.nativeElement.value.length;
this._renderer.setText (this._countDisplay, (this._limit — count) + ‘Осталось.’);
// Установите цвет счетчика на красный, если счет превышает лимит.
if (count> this._limit) {
this._renderer.setElementStyle (this._countDisplay, ‘цвет’, ‘красный’);
}
остальное {
это._renderer.setElementStyle (this._countDisplay, ‘цвет’, ‘наследование’);
}
}
/ **
* Реализует ловушку жизненного цикла OnInit Angular2.
* /
ngOnInit (): любой {
// Если через ввод не было указано ограничение на количество символов, используйте ограничение по умолчанию.
this._limit = this._limit || this._defaultLimit;
// Инициализируем новый элемент для отображения счетчика и визуализируем его ниже хост-компонента.
this._countDisplay = this._renderer.createElement (this._elRef.nativeElement.parentElement, ‘диапазон’);
// Установите отображение счетчика на значение длины строки хост-компонента.
this._renderer.createText (this._countDisplay, (this._limit — this._elRef.nativeElement.value.length) + ‘остаток.’);
}
}
Вы не можете выполнить это действие в настоящее время. Вы вошли в систему с другой вкладкой или окном. Перезагрузите, чтобы обновить сеанс.Вы вышли из системы на другой вкладке или в другом окне. Перезагрузите, чтобы обновить сеанс.

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

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

Многие американцы сталкиваются с вопросами о лечении, но могут быть не в состоянии принять эти решения, например, в экстренных случаях или в конце жизни. В этой статье объясняются типы решений, которые могут потребоваться в таких случаях, и вопросы, о которых вы можете подумать сейчас, чтобы подготовиться к этому позже. Это может помочь вам подумать о том, кто бы вы хотели принимать решения за вас, если вы не можете принимать их самостоятельно. Также будет обсуждаться, как вы можете поделиться своими пожеланиями с другими. Знание того, кто вы хотите принимать решения от своего имени и как вы будете принимать решения, может снять часть бремени с семьи и друзей.

Что такое предварительное планирование ухода?

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

Предварительное распоряжение также позволяет вам выразить свои ценности и желания, связанные с уходом в конце жизни. Вы можете думать об этом как о живом документе, который вы можете корректировать по мере изменения вашей ситуации из-за новой информации или изменений в вашем здоровье.

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

Решения о заблаговременном планировании медицинской помощи

Иногда необходимо принять решение об использовании неотложной помощи, чтобы сохранить вам жизнь. Врачи могут использовать несколько искусственных или механических способов сделать это. Решения, которые могут появиться в это время, относятся к:

  • СЛР (сердечно-легочная реанимация)
  • Использование вентилятора
  • Искусственное питание (зондовое питание) и искусственная гидратация (внутривенное или внутривенное введение жидкости)
  • Комфортный уход

Что такое СЛР? Сердечно-легочная реанимация может восстановить ваше сердцебиение, если ваше сердце остановится или его ритм будет угрожающим для жизни.Он включает в себя многократные сильные надавливания на грудную клетку, при этом воздух попадает в легкие. Эта сила должна быть довольно сильной, иногда ломаются ребра или разрушается легкое. Электрошок, известный как дефибрилляция, и лекарства также могут использоваться как часть процесса. Сердце молодого, в остальном здорового человека может возобновить нормальное биение после СЛР. Часто СЛР не помогает пожилым людям, страдающим множественными хроническими заболеваниями или уже ослабленным.

Использование аппарата ИВЛ в качестве неотложной помощи. Вентиляторы — это аппараты, которые помогают дышать. Трубка, подключенная к аппарату ИВЛ, вводится через горло в трахею (дыхательное горло), чтобы аппарат мог нагнетать воздух в легкие. Проведение трубки в горле называется интубацией. Поскольку трубка неудобна, во время ИВЛ часто используются лекарства, чтобы успокоить вас. Если предполагается, что вы будете находиться на ИВЛ в течение длительного времени, врач может выполнить трахеотомию или «трахею» (рифмуется со словом «make»). Во время этой прикроватной операции трубка вводится непосредственно в трахею через отверстие в шее.При длительной помощи с дыханием удобнее трахать, и седация не требуется. Люди, использующие такую ​​дыхательную трубку, не могут говорить без специальной помощи, потому что выдыхаемый воздух не проходит через их голосовые связки.

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

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

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

Что такое забота о комфорте в конце жизни? Комфортный уход — это все, что может быть сделано, чтобы успокоить вас и облегчить страдания, оставаясь в соответствии с вашими желаниями. Уход за комфортом включает в себя управление одышкой; ограничение медицинских обследований; предоставление духовных и эмоциональных консультаций; и давать лекарства от боли, беспокойства, тошноты или запора.

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

Начало работы с предварительным планированием медицинского обслуживания

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

Начните с размышлений о том, какое лечение вы хотите или не хотите в неотложной медицинской помощи. Возможно, вам будет полезно поговорить с врачом о том, как ваше текущее состояние здоровья может повлиять на ваше здоровье в будущем. Например, с какими решениями вы или ваша семья столкнетесь, если высокое кровяное давление приведет к инсульту? Вы можете попросить своего врача помочь вам понять и продумать свой выбор, прежде чем изложить его в письменной форме.Обсуждение решений о предварительном планировании медицинского обслуживания с вашим врачом бесплатно через Medicare во время вашего ежегодного посещения оздоровительного центра. Частное медицинское страхование также может покрыть эти обсуждения.

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

При принятии решения о лечении ваши личные ценности являются ключевыми.Ваше главное желание — провести как можно больше дней в жизни? Или вы бы сосредоточили свое внимание на качестве жизни, как вы его видите? Что делать, если из-за болезни вы парализованы или впадаете в постоянную кому, и вам нужна искусственная вентиляция легких? Вы бы этого хотели?

Что делает жизнь значимой для вас? Если у вас остановится сердце или у вас возникнут проблемы с дыханием, хотели бы вы принять меры по спасению жизни, если бы это означало, что в будущем вы могли бы выздороветь достаточно, чтобы проводить время со своей семьей? Вы были бы довольны, если бы в результате чрезвычайной ситуации вы могли просто проводить дни, слушая записанные на пленку книги или глядя в окно?

Но есть много других сценариев.Вот несколько. Что бы вы решили?

  • Если в результате инсульта вы не можете двигаться, а затем ваше сердце останавливается, вы бы хотели СЛР? Что, если бы у вас также было психическое нарушение из-за инсульта — изменится ли ваше решение?
  • Что делать, если вы испытываете боль в конце жизни? Вы хотите, чтобы лекарство облегчило боль, даже если оно сделает вас более сонливым и вялым?
  • Что делать, если вы постоянно без сознания, а затем заболели пневмонией? Вы бы хотели, чтобы вас поместили на аппарат искусственной вентиляции легких и антибиотики?

Для некоторых людей самое важное — остаться в живых как можно дольше с медицинской точки зрения или достаточно долго, чтобы увидеть такое важное событие, как свадьба внука.Предварительное распоряжение может помочь сделать это возможным. У других есть четкое представление о том, когда они больше не захотят продлевать свою жизнь. В этом также может помочь предварительное распоряжение.

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

Многие люди не готовы справиться с юридическими и финансовыми последствиями серьезного заболевания, такого как болезнь Альцгеймера. Заблаговременное планирование может помочь людям с болезнью Альцгеймера и их семьям уточнить свои пожелания и принять обоснованные решения в отношении медицинского обслуживания и финансовых договоренностей.

Узнайте больше о правовом и финансовом планировании для людей с болезнью Альцгеймера.

Извещение о ваших пожеланиях по уходу за больными

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

  • Жилая воля
  • Долгосрочная доверенность на медицинское обслуживание
  • Прочие документы для предварительного планирования ухода

Жилая воля. Завещание о жизни — это письменный документ, который помогает вам сообщать врачам, как вы хотите лечиться, если вы умираете или постоянно теряете сознание и не можете принимать собственные решения относительно неотложной помощи.В завещании при жизни вы можете сказать, какие из процедур, описанных в разделе «Решения, которые могут возникнуть», вам нужны, какие — нет, и при каких условиях применим каждый из ваших вариантов.

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

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

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

Медицинские проблемы, которые могут возникнуть в конце жизни, включают:

  • DNR заказов
  • Донорство органов и тканей
  • Формы POLST и MOLST

Приказ DNR (не реанимировать) сообщает медицинскому персоналу в больнице или учреждении сестринского ухода, что вы не хотите, чтобы они пытались вернуть ваше сердце к нормальному ритму, если оно останавливается или неустойчиво бьется с помощью СЛР или другого жизненного цикла. меры поддержки.Иногда этот документ упоминается как DNAR (не пытаться реанимировать) или AND (разрешить естественную смерть). Даже несмотря на то, что живой человек может сказать, что СЛР нежелательна, полезно иметь приказ DNR как часть вашей медицинской карты, если вы идете в больницу. Размещение DNR рядом с вашей кроватью может избежать путаницы в чрезвычайной ситуации. Без приказа DNR медицинский персонал приложит все усилия, чтобы восстановить ваше дыхание и нормальный ритм вашего сердца.

Аналогичный документ, называемый приказом DNI (не интубировать), сообщает медицинскому персоналу в больнице или учреждении сестринского ухода, что вы не хотите, чтобы вам надели дыхательный аппарат.

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

Донорство органов и тканей позволяет трансплантировать органы или части тела умершего в целом здорового человека людям, которые в них нуждаются. Обычно дарят сердце, легкие, поджелудочную железу, почки, роговицу, печень и кожу. Возрастных ограничений для донорства органов и тканей нет.Карту пожертвований можно носить в кошельке. В некоторых штатах разрешено добавлять это решение к своим водительским правам. Некоторые люди также включают донорство органов в свои документы о заблаговременном планировании ухода.

В случае смерти членов семьи могут спросить о донорстве органов. Если близкие вам люди, особенно ваше доверенное лицо, знают, что вы думаете о донорстве органов, они будут готовы ответить. Для семьи донора этот дар жизни бесплатный. Если человек запросил приказ DNR, но хочет пожертвовать органы, ему или ей, возможно, придется указать, что желание пожертвовать заменяет DNR.Это потому, что может потребоваться использование машин, чтобы поддерживать сердцебиение, пока медицинский персонал не будет готов удалить пожертвованные органы.

Узнайте больше о донорстве органов и тканей.

Донорство мозга отличается от донорства других органов тем, что мозг передается для научных исследований. Изучая мозг умерших людей — как тех, у кого были нарушения мозга, так и тех, кто был здоров в течение жизни, исследователи узнают больше о том, как определенные заболевания влияют на мозг и как лучше лечить и предотвращать их.

Узнайте больше о донорстве мозга.

Формы POLST и MOLST содержат указания относительно ваших предпочтений в отношении медицинского обслуживания в виде предписаний врача. Как правило, вы составляете POLST (предписания врача о поддерживающем жизнь лечении) или MOLST (медицинские предписания о поддерживающем жизнь лечении), когда вы приближаетесь к концу жизни или находитесь в критическом состоянии и знаете конкретные решения, которые, возможно, потребуется принять от вашего имени. . Эти формы служат в качестве медицинского приказа в дополнение к вашему предварительному распоряжению.Они позволяют вам предоставить рекомендации, которые специалисты здравоохранения могут немедленно предпринять в случае возникновения чрезвычайной ситуации.

В ряде штатов используются формы POLST и MOLST, которые заполняет ваш врач, а иногда и практикующая медсестра или помощник врача. Врач заполняет POLST или MOLST после обсуждения ваших пожеланий с вами и вашей семьей. После подписания вашим врачом эта форма имеет те же полномочия, что и любое другое медицинское распоряжение. Обратитесь в департамент здравоохранения своего штата, чтобы узнать, доступны ли эти формы там, где вы живете.

У некоторых людей есть кардиостимуляторы, которые помогают сердцу регулярно биться. Если он у вас есть и вы находитесь на грани смерти, это не обязательно поможет вам выжить. Но вам может быть вставлен ICD (имплантируемый кардиовертер-дефибриллятор) под кожу, чтобы ваше сердце снова стало регулярным, если ритм станет нерегулярным. Если вы откажетесь от других мер по поддержанию жизни, ИКД может быть отключен. Вы должны указать в своем предварительном указании, что вы хотите сделать, если врач предлагает, чтобы пора его выключить.

Как выбрать доверенность на медицинское обслуживание

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

Вы можете решить, насколько авторитетно ваше доверенное лицо в отношении вашего медицинского обслуживания — имеет ли он право принимать широкий спектр решений или только несколько конкретных.Старайтесь не включать инструкции, которые не позволяют доверенному лицу выполнять свои обязанности. Например, вероятно, нет ничего необычного в том, что кто-то в разговоре говорит: «Я не хочу идти в дом престарелых», но хорошо подумайте, хотите ли вы такого ограничения в своем предварительном указании. Иногда по финансовым или медицинским причинам это может быть лучшим выбором для вас.

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

Официальные директивы о вашем медицинском обслуживании

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

Во многих штатах есть свои формы предварительных распоряжений. Местное агентство по вопросам старения может помочь вам найти нужные формы. Вы можете узнать номер телефона местного агентства, позвонив в Eldercare Locator по бесплатному телефону 1-800-677-1116 или посетив https://eldercare.acl.gov.

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

В некоторых штатах есть реестры, в которых могут храниться ваши предварительные распоряжения для быстрого доступа поставщиков медицинских услуг, вашего доверенного лица и всех, кому вы дали разрешение. Частные фирмы также сохранят ваше предварительное распоряжение. За хранение вашей формы в реестре может взиматься плата. Если вы сохраняете предварительную директиву в реестре и позже вносите изменения, вы должны заменить оригинал обновленной версией в реестре.

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

Что делать после того, как вы настроите предварительную директиву

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

Время от времени пересматривайте свои решения о предварительном планировании ухода — например, каждые 10 лет, если не чаще. Возможно, вы захотите пересмотреть свои предпочтения в отношении ухода, если изменится ваша ситуация или ваше здоровье. Или вы можете внести коррективы, если вам поставили серьезный диагноз; если вы женились, разошлись или развелись; если ваш супруг умирает; или если что-то случится с вашим прокси или альтернативой.Если ваши предпочтения изменятся, вы захотите убедиться, что ваш врач, доверенное лицо и семья знают о них.

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

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

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

Еще один способ выразить свои пожелания — снять видео, в котором вы говорите о них. Это позволяет вам выражать свои пожелания своими словами. Видео не заменяют предварительное распоряжение, но они могут быть полезны вашему доверенному лицу в сфере здравоохранения и вашим близким.

Будьте готовы

Что произойдет, если у вас нет предварительных указаний или планов, и вы не сможете говорить за себя? В таких случаях штат, в котором вы живете, поручит кому-либо принимать медицинские решения от вашего имени. Вероятно, это будет ваш супруг (а), ваши родители, если они есть, или ваши дети, если они взрослые. Если у вас нет членов семьи, государство выберет кого-нибудь, кто будет представлять ваши интересы.

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

Трудно с уверенностью предсказать будущее. Возможно, вы никогда не столкнетесь с медицинской ситуацией, когда вы не сможете говорить за себя и заявить о своих желаниях. Но предварительное распоряжение может дать вам и вашим близким некоторое спокойствие.

Возможно, вы захотите сделать карту для ношения в кошельке, указав, что у вас есть предварительное распоряжение и где она хранится. Вот пример карты кошелька, предлагаемой Американской ассоциацией больниц.Вы можете распечатать это, чтобы заполнить и носить с собой. PDF-файл можно найти в Интернете (PDF, 40 КБ).

Прочтите эту тему на испанском. Lea sobre este tema en español.

Для получения дополнительной информации о директивах здравоохранения

Этот контент предоставлен Национальным институтом старения NIH (NIA). Ученые NIA и другие эксперты проверяют этот контент, чтобы убедиться, что он точен и актуален.

Проверено содержание: 15 января 2018 г.

один шаг вперед, два шага назад

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

Европейские законодатели недавно согласовали окончательный текст новой директивы об авторском праве. Многие люди, в том числе ассоциации потребителей, создатели, небольшие издатели, ученые и стартапы, поделились своими опасениями по поводу результата. Изучив окончательный текст, мы согласны с тем, что директива не поможет, а скорее сдержит творческую и цифровую экономику Европы.

Начнем с позитива.Последний текст улучшает версию, принятую Европейским парламентом в сентябре 2018 года. Возьмите статью 13. Платформы, добросовестно пытающиеся помочь правообладателям идентифицировать и защищать произведения, не должны нести ответственность за каждый фрагмент контента, который загружает пользователь, особенно если ни один из них ни правообладатель, ни платформа конкретно не знают, кому на самом деле принадлежит этот контент. Окончательный текст включает формулировку, признающую этот принцип.

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

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

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

Затем идет статья 11. И снова мы заметили улучшения в более ранних версиях текста. Мы всегда говорили, что директива об авторском праве должна давать всем издателям право контролировать свои собственные бизнес-модели, давая им возможность отказаться от формальной коммерческой лицензии на свой контент.И похоже, что директива дает издателям свободу предоставлять бесплатные лицензии, что облегчает издателям любого размера зарабатывать деньги на привлечении большего числа читателей.

Тем не менее, эта последняя версия наносит ущерб небольшим и начинающим издателям и ограничивает доступ потребителей к разнообразным источникам новостей. В соответствии с директивой запрещается показ чего-либо, кроме простых фактов, гиперссылок и «отдельных слов и очень коротких отрывков». Такой узкий подход создаст неопределенность и снова может привести к тому, что онлайн-сервисы будут ограничивать объем информации от издателей прессы, которую они показывают потребителям.Сокращение длины фрагментов затруднит доступ потребителей к новостному контенту и сократит общий трафик для новостных издателей, как показал один из наших недавних поисковых экспериментов.

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

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

reStructuredText Primer — документация Sphinx

reStructuredText — это язык разметки открытого текста по умолчанию, используемый Sphinx.Этот раздел — это краткое введение в концепции и синтаксис reStructuredText (reST), предназначен для предоставления авторам достаточной информации для составления документов продуктивно. Поскольку reST был разработан как простая ненавязчивая разметка язык, это не займет много времени.

См. Также

Авторитетная документация пользователя reStructuredText. Ссылки «ref» в этом ссылка на документ с описанием отдельных конструкций в reST ссылка.

Пункты

Абзац (ref) — это самый основной блок в reST документ.Абзацы — это просто куски текста, разделенные одним или несколькими пробелами. линий. Как и в Python, в reST важен отступ, поэтому все строки тот же абзац должен быть выровнен по левому краю с тем же уровнем отступа.

Встроенная разметка

Стандартная встроенная разметка reST довольно проста: используйте

  • одна звездочка: * текст * для выделения (курсив),

  • две звездочки: ** текст ** для сильного выделения (жирный шрифт) и

  • обратных кавычек: `` текст '' для примеров кода.

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

Обратите внимание на некоторые ограничения этой разметки:

  • не может быть вложенным,

  • содержимое не может начинаться или заканчиваться пробелом: * текст * неверно,

  • он должен отделяться от окружающего текста символами, отличными от слов. Использовать обратная косая черта экранировала пробел, чтобы обойти это: thisis \ * one * \ word .

Эти ограничения могут быть сняты в будущих версиях документации.

Также можно заменить или расширить часть этой встроенной разметки с помощью роли. Обратитесь к Роли для получения дополнительной информации.

Списки и блоки, похожие на цитаты

Разметка списка (ссылка) является естественной: просто поместите звездочку в начало абзаца и правильный отступ. То же самое касается пронумерованных списки; они также могут быть автоматически пронумерованы с помощью знака # :

 * Это маркированный список.* Имеет два предмета, второй
  item использует две строки.

1. Это нумерованный список.
2. В нем тоже есть два предмета.

#. Это нумерованный список.
#. В нем тоже есть два предмета.
 

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

 * это
* список

  * с вложенным списком
  * и некоторые подпункты

* и здесь родительский список продолжается
 

Списки определений (ref) создаются следующим образом:

 термин (до строки текста)
   Определение термина, в котором должен быть отступ

   и даже может состоять из нескольких абзацев

следующий семестр
   Описание.

Обратите внимание, что термин не может содержать более одной строки текста.

Цитированные абзацы (ref) создаются простым отступом их больше, чем окружающие абзацы.

Блоки строк (ref) — это способ сохранения разрывов строк:

 | Эти строки
| сломан точно так же, как в
| исходный файл.
 

Также доступны еще несколько специальных блоков:

  • списков полей (см. С оговорками, указанными в Полевые списки)

  • списки опций (исх.)

  • цитируемые буквенные блоки (исх.)

  • блоков doctest (исх.)

Буквальные блоки

Литеральные кодовые блоки (ref) вводятся окончанием абзац специальным маркером :: .Буквальный блок должен иметь отступ (и, как и все абзацы, отделенные от окружающих пустым линий):

 Это обычный текстовый абзац. Следующий абзац - это образец кода:

   Никаким образом не обрабатывается, кроме
   что отступ убран.

   Он может охватывать несколько строк.

Это снова обычный текстовый абзац.
 

Маркер :: удобен в обращении:

  • Если он встречается как отдельный абзац, этот абзац полностью опускается документа.

  • Если перед ним стоит пробел, маркер удаляется.

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

Таким образом, второе предложение в первом абзаце приведенного выше примера будет отображается как «Следующий абзац — образец кода:».

Подсветка кода может быть включена для этих литеральных блоков на уровне всего документа. на основе директивы Highlight и на уровне проекта с помощью параметра конфигурации highlight_language code-block директива может использоваться для установки выделения на поблочная основа. Эти директивы обсуждаются позже.

Доктест блоков

Блоки Doctest (ref) — это интерактивные сеансы Python вырезаны и вставлены в строки документации. Они не требуют синтаксис буквальных блоков. Блок доктеста должен заканчиваться с пустой строкой и не должен заканчиваться неиспользуемым приглашением:

Столы

Для таблиц сетки (ref) вы должны «раскрасить» ячейку решите сами.Выглядят они так:

 + ------------------------ + ------------ + ---------- + ---------- +
| Строка заголовка, столбец 1 | Заголовок 2 | Заголовок 3 | Заголовок 4 |
| (строки заголовка необязательны) | | | |
+ ======================== + ============ + ========== + ========== +
| тело строка 1, столбец 1 | столбец 2 | столбец 3 | столбец 4 |
+ ------------------------ + ------------ + ---------- + ---------- +
| 2-й ряд тела | ... | ... | |
+ ------------------------ + ------------ + ---------- + ---------- +
 

Простые таблицы (ссылка) легче писать, но ограничено: они должны содержать более одной строки, а ячейки первого столбца не могут содержат несколько строк.Выглядят они так:

 ===== ===== =======
А Б А и Б
===== ===== =======
Ложь Ложь Ложь
Верно Неверно Неверно
Ложь Верно Ложь
Правда правда правда
===== ===== =======
 

Поддерживаются еще два синтаксиса: таблицы CSV и таблицы списка . Они используют блок явной разметки . Обратитесь к таблицам для получения дополнительной информации.

Гиперссылки

Внешние ссылки

Используйте `Текст ссылки `_ для встроенных веб-ссылок. Если текст ссылки должен быть веб-адресом, специальная разметка не нужна вообще, парсер находит ссылки и почтовые адреса в обычном тексте.

Важно

Между текстом ссылки и открывающим

Вы также можете разделить ссылку и определение цели (ссылка), например:

 Это абзац, содержащий `ссылку`_.

.. _сылка: https: //domain.invalid/
 

Внутренние ссылки

Внутреннее связывание осуществляется через специальную роль reST, предоставляемую Sphinx, см. раздел о конкретной разметке, Перекрестные ссылки на произвольные местоположения.

Разделы

Заголовки разделов (ref) создаются подчеркиванием (и необязательно перекрытие) заголовок раздела знаком препинания, по крайней мере до тех пор, пока текст:

 =================
Это заголовок
=================
 

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

  • ", по пп.

  • Конечно, вы можете использовать свои собственные символы-маркеры (см. документации) и используйте более глубокий уровень вложенности, но имейте в виду, что большинство целевые форматы (HTML, LaTeX) имеют ограниченную поддерживаемую глубину вложенности.

    Списки полей

    Списки полей (ref) — это последовательности полей, помеченных как это:

    : fieldname: Содержание поля
     

    Они обычно используются в документации Python:

     def my_function (my_arg, my_other_arg):
        "" "Функция только для меня.
    
        : param my_arg: Первый из моих аргументов.
        : param my_other_arg: Второй из моих аргументов.
    
        : returns: Сообщение (конечно, только для меня).
        "" "
     

    Sphinx расширяет стандартное поведение Docutils и перехватывает указанные списки полей в начале документов.Обратитесь к спискам полей для получения дополнительной информации Информация.

    Роли

    Роль или «роль настраиваемого интерпретируемого текста» (ссылка) является встроенной кусок явной разметки. Это означает, что заключенный текст должен быть интерпретируется определенным образом. Sphinx использует это для обеспечения семантической разметки и перекрестные ссылки идентификаторов, как описано в соответствующем разделе. В общий синтаксис: : имя роли: `content` .

    Docutils поддерживает следующие роли:

    См. Роли для ролей, добавленных Sphinx.

    Явная разметка

    «Явная разметка» (ref) используется в reST для большинство конструкций, требующих особой обработки, например сноски, специально выделенные абзацы, комментарии и общие директивы.

    Явный блок разметки начинается со строки, начинающейся с .. , за которой следует пробел и заканчивается следующим абзацем на том же уровне отступ. (Между явной разметкой и нормальные абзацы. Все это может показаться немного сложным, но интуитивно понятно достаточно, когда вы это напишете.)

    Директивы

    Директива (ref) — это общий блок явной разметки. Наряду с ролями это один из механизмов расширения reST, и Sphinx активно его использует.

    Docutils поддерживает следующие директивы:

    • Увещевания: внимание, осторожность, опасность, ошибка, подсказка, важно, примечание, подсказка, предупреждение и общий замечание. (Большинство тем имеют стиль только «примечание» и «Предупреждение» специально.)

    • Изображений:

    • Дополнительные элементы кузова:

      • содержимое (местное, т.е. для текущего файла только, оглавление)

      • контейнер (контейнер с настраиваемым классом, полезный для создания внешний

        в HTML)

      • рубрика (заголовок без отношения к секционированию документа)

      • тема, боковая панель (специальные выделенные элементы тела)

      • parsed-literal (буквенный блок, поддерживающий встроенную разметку)

      • эпиграф (цитата с дополнительной линией атрибуции)

      • выделения, цитаты (цитаты блокируются собственными атрибут класса)

      • составной (составной параграф)

    • Специальные столы:

      • таблица (таблица с заголовком)

      • csv-table (таблица, созданная из значений, разделенных запятыми)

      • список-таблица (таблица, сформированная из списка списков)

    • Специальные директивы:

      • raw (включая необработанную разметку целевого формата)

      • include (включить reStructuredText из другого файла) — в Sphinx, когда указан абсолютный путь к включаемому файлу, эта директива принимает его как относительно исходного каталога

      • класс (присвоить атрибут класса следующему элементу)

    • Особенности HTML:

    • Влияющая на разметка:

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

    Директивы, добавленные Sphinx, описаны в Директивах.

    По сути, директива состоит из имени, аргументов, параметров и содержимого. (Помните об этой терминологии, она используется в следующей главе, описывающей пользовательские директивы.) В этом примере

     .. функция :: foo (x)
                  foo (y, z)
       : модуль: some.module.name
    
       Вернуть строку ввода текста от пользователя.
     

    функция — это имя директивы. Здесь приводятся два аргумента: остаток первой и второй строк, а также один вариант модуль (как видите, варианты указаны в строках сразу после аргументов и обозначены двоеточиями).Параметры должны быть с отступом на тот же уровень, что и содержание директивы.

    Содержимое директивы следует после пустой строки и имеет отступ относительно начало директивы или, если присутствуют параметры, на ту же сумму, что и параметры.

    Будьте осторожны, так как отступ — это не фиксированное количество пробелов, например три, но любое число пробелов. Это может быть удивительно, когда используется фиксированный отступ. по всему документу и может иметь значение для директив, которые чувствителен к пробелам.Сравнить:

     .. кодовый блок ::
       : caption: Классный пример
    
           Вывод этой строки начинается с четырех пробелов.
    
    .. кодовый блок ::
    
           В начале вывода этой строки нет пробелов.
     

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

    Изображения

    reST поддерживает директиву изображения (ref), которая используется так:

    .. image :: gnu.png
       (параметры)
     

    При использовании в Sphinx имя файла (здесь gnu.png ) должно быть относительно исходного файла или абсолютный, что означает, что они относятся к верхний исходный каталог. Например, файл sketch / spam.rst может см. изображение images / spam.png как ../images/spam.png или /images/spam.png .

    Sphinx автоматически копирует файлы изображений в подкаталог вывода. справочник по строительству (эл.грамм. каталог _static для вывода HTML.)

    Расшифровка вариантов размера изображения ( ширина и высота ) выглядит следующим образом: если размер не имеет единицы измерения или единица измерения — пиксели, заданный размер будет только соблюдается для выходных каналов, поддерживающих пиксели. Другие единицы (например, pt для точек) будет использоваться для вывода HTML и LaTeX (последний заменяет pt на bp , поскольку это модуль TeX, такой, что 72bp = 1 из ).

    Sphinx расширяет стандартное поведение Docutils, добавляя звездочку для добавочный номер:

    Sphinx затем ищет все изображения, соответствующие заданному шаблону, и определяет их тип.Затем каждый строитель выбирает лучшее изображение из этих кандидаты. Например, если было дано имя файла gnu. * и два файла gnu.pdf и gnu.png существовали в дереве исходных текстов, LaTeX строитель выбрал бы первое, а конструктор HTML предпочел бы последний. Поддерживаемые типы изображений и приоритет выбора определены в Строители.

    Обратите внимание, что имена файлов изображений не должны содержать пробелов.

    Изменено в версии 0.4: Добавлена ​​поддержка имен файлов, оканчивающихся звездочкой.

    Изменено в версии 0.6: Пути к изображениям теперь могут быть абсолютными.

    Изменено в версии 1.5: мишень из латекса поддерживает пиксели (по умолчанию 96 пикселей = 1 дюйм ).

    Цитаты

    Стандартные ссылки reST (ref) поддерживаются, с дополнительная функция, что они являются «глобальными», т. е. можно ссылаться на все цитаты. из всех файлов. Используйте их так:

     Lorem ipsum [Ref] _ dolor sit amet.
    
    .. [Ref] Ссылка на книгу или статью, URL или что-то еще.
     

    Использование цитирования аналогично использованию сносок, но с меткой, которая не числовой или начинается с # .

    Замены

    reST поддерживает «замены» (ref), которые являются фрагментами текста и / или разметки, на которые в тексте ссылаются как | name | . Они определены как сноски с явными блоками разметки, например:

     .. | имя | replace :: замена * текст *
     

    или это:

     .. | осторожность | image :: warning.png
                 : alt: Внимание!
     

    См. Ссылку на reST для замен для подробностей.

    Если вы хотите использовать некоторые замены для всех документов, поместите их в rst_prolog или rst_epilog или поместить их в отдельный файл и включите его во все документы, в которых вы хотите их использовать, используя включает директиву .(Обязательно дайте включаемому файлу имя файла расширение, отличное от других исходных файлов, чтобы Sphinx не нашел его как отдельный документ.)

    Sphinx определяет некоторые замены по умолчанию, см. Замены.

    Метаданные HTML

    Мета директива (ссылка) позволяет указать HTML элемент метаданных страницы документации Sphinx. Например, директива:

     .. мета ::
       : description: Конструктор документации Sphinx
       : ключевые слова: Sphinx, документация, строитель
     

    сгенерирует следующий HTML-вывод:

     
    
     

    Кроме того, Sphinx добавит ключевые слова, указанные в метадирективе, в поисковый индекс.Таким образом, атрибут lang метаэлемента считается. Например, директива:

     .. мета ::
       : ключевые слова: резервное копирование
       : ключевые слова lang = en: pleasefindthiskey pleasefindthiskeytoo
       : ключевые слова lang = de: bittediesenkeyfinden
     

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

    • , пожалуйста, найдите этот ключ , , пожалуйста, найдите этот ключ

    • bittediesenkeyfinden от до Немецкие сборки ;

    • резервное копирование для сборок на всех языках.

    Исходное кодирование

    Так как самый простой способ включить специальные символы, такие как длинное тире или копирайт знаков в reST заключается в том, чтобы напрямую записывать их как символы Unicode, необходимо укажите кодировку. Sphinx предполагает, что исходные файлы будут закодированы в UTF-8 с помощью дефолт; вы можете изменить это с помощью значения конфигурации source_encoding .

    Попался

    При создании документов reST часто встречаются проблемы:

    • Разделение встроенной разметки: Как сказано выше, промежутки встроенной разметки должны быть отделены от окружающего текста символами, не являющимися словами, вы должны использовать пробел с обратной косой чертой, чтобы обойти это.См. Ссылку для подробностей.

    • Нет вложенной встроенной разметки: Примерно * см.: Func: `foo` * не возможный.

    Сноски

    Cookies, GDPR и Директива о конфиденциальности

    Cookies - важный инструмент, который может дать компаниям возможность лучше понять онлайн-активность своих пользователей. Несмотря на их важность, правила, регулирующие использование файлов cookie, разделены между GDPR и Директивой о конфиденциальности.

    Файлы cookie - это небольшие текстовые файлы, которые веб-сайты размещают на вашем устройстве во время просмотра. Они обрабатываются и сохраняются вашим веб-браузером. Сами по себе файлы cookie безвредны и выполняют важные функции для веб-сайтов. Файлы cookie также можно легко просмотреть и удалить.

    Однако файлы cookie могут хранить большой объем данных, достаточный для того, чтобы потенциально идентифицировать вас без вашего согласия. Файлы cookie - это основной инструмент, который рекламодатели используют для отслеживания вашей онлайн-активности, чтобы они могли настроить таргетинг на вас с помощью очень конкретной рекламы.Учитывая объем данных, которые могут содержать файлы cookie, при определенных обстоятельствах они могут считаться личными данными и, следовательно, подпадать под действие GDPR.

    Прежде чем анализировать, что GDPR и Директива о конфиденциальности говорят о файлах cookie, важно иметь общее представление о различных типах файлов cookie.

    Типы файлов cookie

    В общем, существует три различных способа классификации файлов cookie: для какой цели они служат, как долго они действуют и их происхождение.

    Продолжительность

    • Сессионные файлы cookie - Эти файлы cookie являются временными и истекают после закрытия браузера (или после завершения сеанса).
    • Постоянные файлы cookie - В эту категорию входят все файлы cookie, которые остаются на вашем жестком диске до тех пор, пока вы не удалите их или не удалите их в браузере, в зависимости от даты истечения срока действия файлов cookie. У всех постоянных файлов cookie есть срок годности, записанный в их код, но их продолжительность может варьироваться. Согласно Директиве ePrivacy, они не должны длиться дольше 12 месяцев, но на практике они могут оставаться на вашем устройстве намного дольше, если вы не примете меры.

    Provenance

    • Основные файлы cookie - Как следует из названия, основные файлы cookie размещаются на вашем устройстве непосредственно веб-сайтом, который вы посещаете.
    • Сторонние файлы cookie - это файлы cookie, которые размещаются на вашем устройстве не посещаемым вами веб-сайтом, а третьей стороной, например рекламодателем или аналитической системой.

    Цель

    • Строго необходимые файлы cookie - эти файлы cookie необходимы для просмотра веб-сайта и использования его функций, таких как доступ к защищенным областям сайта.Файлы cookie, которые позволяют интернет-магазинам хранить ваши товары в корзине, пока вы совершаете покупки в Интернете, являются примером строго необходимых файлов cookie. Эти файлы cookie, как правило, представляют собой файлы cookie сеанса первой стороны. Хотя получение согласия на использование этих файлов cookie не требуется, пользователю следует объяснить, что они делают и почему они необходимы.
    • Файлы cookie предпочтений. Эти файлы cookie, также известные как функциональные файлы cookie, позволяют веб-сайту запоминать выбранные вами ранее настройки, например, какой язык вы предпочитаете, для какого региона вы хотите получать отчеты о погоде или какое ваше имя пользователя и пароль. так что вы можете автоматически войти в систему.
    • Статистические файлы cookie - также известные как «файлы cookie производительности», эти файлы cookie собирают информацию о том, как вы используете веб-сайт, например, какие страницы вы посещали и по каким ссылкам переходили. Никакая из этой информации не может быть использована для вашей идентификации. Все это агрегировано и, следовательно, анонимно. Их единственная цель - улучшить функции веб-сайта. Сюда входят файлы cookie сторонних аналитических служб, если они предназначены исключительно для использования владельцем посещаемого веб-сайта.
    • Маркетинговые файлы cookie - эти файлы cookie отслеживают вашу онлайн-активность, чтобы помочь рекламодателям предоставлять более релевантную рекламу или ограничивать количество просмотров рекламы.Эти файлы cookie могут передавать эту информацию другим организациям или рекламодателям. Это постоянные файлы cookie и почти всегда стороннего происхождения.

    Это основные способы классификации файлов cookie, хотя есть файлы cookie, которые не могут точно соответствовать этим категориям или могут соответствовать нескольким категориям. Когда люди жалуются на риски для конфиденциальности, которые представляют файлы cookie, они обычно имеют в виду сторонние постоянные маркетинговые файлы cookie. Эти файлы cookie могут содержать значительный объем информации о вашей онлайн-активности, предпочтениях и местоположении.Цепочка ответственности (кто может получить доступ к данным файлов cookie) для сторонних файлов cookie также может усложняться, только повышая их потенциал для злоупотреблений. Возможно, из-за этого использование сторонних файлов cookie снизилось с момента принятия GDPR

    Cookies и GDPR

    Общие правила защиты данных (GDPR) являются наиболее полным законодательством о защите данных, которое было принято любой руководящий орган к этому моменту. Однако на всех своих 88 страницах он упоминает файлы cookie только один раз, в Recital 30.

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

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

    Директива о файлах cookie и конфиденциальности

    Принятая в 2002 г. и измененная в 2009 г. Директива о конфиденциальности данных (EPD) стала известна как «закон о файлах cookie», поскольку ее наиболее заметным эффектом стало распространение всплывающих окон согласия на использование файлов cookie после ее принятия. . Он дополняет (а в некоторых случаях отменяет) GDPR, затрагивая важные аспекты конфиденциальности электронных сообщений и отслеживания пользователей Интернета в более широком смысле.

    Соответствие файлам cookie

    Для соблюдения правил, регулирующих использование файлов cookie в соответствии с GDPR и Директивой о конфиденциальности, вы должны:

    • Получать согласие пользователей, прежде чем использовать какие-либо файлы cookie за исключением строго необходимых файлов cookie.
    • Предоставьте точную и конкретную информацию о данных, отслеживаемых каждым файлом cookie, и его цели на понятном языке до получения согласия.
    • Задокументируйте и сохраните согласие, полученное от пользователей.
    • Разрешить пользователям доступ к вашим услугам, даже если они отказываются разрешить использование определенных файлов cookie.
    • Сделайте так, чтобы пользователям было так же легко отозвать свое согласие, как если бы они сами дали свое согласие.

    Регламент электронной конфиденциальности

    Возможная замена EPD, Регламент электронной конфиденциальности (EPR), будет основываться на EPD и расширять его определения. (В ЕС директива должна быть включена в национальное законодательство стран ЕС, в то время как постановление становится юридически обязательным на всей территории ЕС с даты ее вступления в силу.)

    EPR должен был быть принят в 2018 г. одновременно с вступлением в силу GDPR. ЕС явно упустил эту цель, но в Интернете есть проекты документа, и его планируется завершить где-то в этом году, хотя еще нет даты, когда он будет реализован.EPR обещает устранить отпечатки пальцев браузера способами, аналогичными файлам cookie, создать более надежную защиту метаданных и принять во внимание новые методы связи, такие как WhatsApp.

    Правила, регулирующие файлы cookie, все еще устанавливаются, а сами файлы cookie постоянно развиваются, что означает, что поддержание текущей политики файлов cookie будет постоянной работой. Однако правильное информирование ваших пользователей о файлах cookie, которые использует ваш сайт, и, при необходимости, получение их согласия, сделают ваших пользователей счастливыми и обеспечат соблюдение вами GDPR.

    Директивы | Vue.js

    Подробности:

    Запомните поддерево шаблона. Может использоваться как на элементах, так и на компонентах. Директива ожидает, что массив значений зависимостей фиксированной длины будет сравниваться для мемоизации. Если каждое значение в массиве было таким же, как и при последней визуализации, то обновления для всего поддерева будут пропущены. Например:

      
    ...

    1
    2
    3

    При повторной визуализации компонента, если оба значения valueA, и valueB остаются прежними, все обновления для этого

    и его дочерних элементов будут пропущены.Фактически, даже создание виртуального DOM-узла VNode также будет пропущено, поскольку запомненную копию поддерева можно использовать повторно.

    Важно правильно указать массив мемоизации, иначе мы можем пропустить обновления, которые действительно должны быть применены. v-memo с пустым массивом зависимостей ( v-memo = "[]" ) будет функционально эквивалентен v-once .

    Использование с v-for

    v-memo предоставляется исключительно для микрооптимизации в сценариях, критичных к производительности, и в этом нет необходимости.Наиболее распространенный случай, когда это может оказаться полезным, - это отображение больших списков v-for (где длина > 1000 ):

      

    ID: {{item.id}} - выбрано: {{item.id === selected}}

    ... дополнительные дочерние узлы

    1
    2
    3
    4

    При изменении состояния компонента, выбранного , будет создано большое количество виртуальных узлов, хотя большинство элементов осталось в точности таким же.Использование v-memo здесь по существу говорит: «обновлять этот элемент только в том случае, если он перешел с невыбранного на выбранный, или наоборот». Это позволяет каждому незатронутому элементу повторно использовать свой предыдущий VNode и полностью пропустить различие. Обратите внимание, что нам не нужно включать item.id в массив зависимостей мемо здесь, поскольку Vue автоматически выводит его из : ключ элемента.

    ПРЕДУПРЕЖДЕНИЕ

    При использовании v-memo с v-for убедитесь, что они используются на одном элементе. v-memo не работает внутри v-for .

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

    Директива окна поиска - Разработка Sitefinity CMS

    Вы используете sfSearchBox , чтобы посетители могли выполнять поиск на вашем веб-сайте.Директива предоставляет интерфейс для пользовательского ввода, используемый функцией поиска.

    sfSearchBox - это директива с изолированной областью действия, которая определена в модуле с тем же именем sfSearchBox . Вы можете использовать директиву как атрибут или как элемент.
    Для получения дополнительной информации см. Изоляция области действия директивы.

    Атрибуты

    Директива поля поиска предоставляет следующие атрибуты:

    Атрибут Описание
    SF-действие
    Этот атрибут принимает делегата функции с одним аргументом, определенным в текущей области.Поле поиска вызывает этого делегата, когда вводится текст.
    sf-min-text-length
    Этот атрибут является необязательным параметром. Это целое число, определяющее минимальную длину пользовательского ввода, поэтому директива sfSearchBox вызывает sfAction . Например, если вы установите для этого атрибута значение -1, тогда директива вызывает sfAction при любом изменении в поле поиска, независимо от длины ввода.
    SF-заполнитель
    Этот атрибут является необязательным параметром. Это позволяет вам указать атрибут HTML-заполнителя для ввода без изменения шаблона.
    SF-enable-предложения
    Этот атрибут активирует функциональность предложений. Чтобы использовать эту функциональность, необходимо объединить атрибут sf-enable-questions с атрибутом sfGetSuggestions ниже.
    SF-Get-предложения
    При использовании атрибута sfEnableSuggestions атрибут sfGetSuggestions принимает делегата функции с одним аргументом, определенным в текущей области. Эта функция всегда должна возвращать массив строк, которые представляют соответствующие предложения для запроса, предоставленного в аргументах.
    sf-clear-search-string
    Этот атрибут очищает текст, введенный в поле поиска.Значение атрибута должно быть свойством в вашей области.

    Добавить директиву поля поиска

    В следующем примере показано, как добавить директиву поля поиска в представление конструктора виджетов.

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

    1. Sitefinity CMS автоматически регистрирует необходимые сценарии, и, если не существует другого представления дизайнера с явно заданным приоритетом, Sitefinity CMS устанавливает приоритет представления дизайнера 1.Если вам нужно иметь полный контроль над загружаемыми скриптами или вы хотите установить собственный приоритет, вы также можете создать свой собственный файл DesignerView.YourView.json . Если у вас есть файл JSON , который соответствует соглашению (даже если он пуст), эта автоматическая регистрация сценариев не произойдет. В файле DesignerView.YourView.json добавьте массив скриптов. В результате содержимое файла должно быть примерно таким:
    2. В версии designerview-yourview.js , прямо перед определением вашего настраиваемого контроллера представления поместите следующий фрагмент кода:
    3. В файле DesignerView.YourView.cshtml поместите следующий тег там, где вы хотите отобразить директиву sfSearchBox :

      В следующем примере передается делегат в поле поиска, чтобы директива могла выбирать, когда нужно применить запрос, на основе атрибутов. Кроме того, вы включаете функцию предложений и определяете функцию предлагает .Функция вызывает службу, которая получает элементы на основе текущего запроса. Полученное обещание возвращается после извлечения заголовков элементов.

    Добавить комментарий

    Ваш адрес email не будет опубликован. Обязательные поля помечены *