Файл: README - Документация для jekyll-seo-tag (2.2.3)

  1. Что оно делает
  2. Что это не делает
  3. Монтаж
  4. использование
  5. Расширенное использование
  6. Отключение вывода <title>
  7. Информация об авторе
  8. Настройка вывода JSON-LD
  9. Настройка вывода изображения
  10. Установка изображения по умолчанию
  11. SmartyPants Названия

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

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

Что оно делает

Jekyll SEO Tag добавляет на ваш сайт следующие метатеги:

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

Что это не делает

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

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

Монтаж

  1. Добавьте следующее в Gemfile вашего сайта:

драгоценный камень "Jekyll-SEO-тег"

  1. Добавьте следующее в _config.yml вашего сайта:

драгоценные камни: - Jekyll-SEO-тег

  1. Добавьте следующее прямо перед </ head> в шаблон (ы) вашего сайта:

{% seo%}

использование

Тег SEO будет учитывать любое из следующего, если он включен в _config.yml вашего сайта (и просто не включать их, если они не определены):

  • title - название вашего сайта (например, потрясающий сайт Бена, блог GitHub и т. д.)
  • description - краткое описание (например, блог, посвященный просмотру картинок кошек)
  • url - полный URL вашего сайта. Примечание: site.github.url будет использоваться по умолчанию.
  • author - глобальная информация об авторе (см. ниже)
  • twitter: username - твиттерный дескриптор сайта. Вы хотите описать это так:

twitter: имя пользователя: benbalter

  • facebook - доступны следующие свойства:
    • facebook: app_id - идентификатор приложения Facebook для понимания Facebook
    • facebook: publisher - URL страницы Facebook или идентификатор издателя
    • facebook: admins - идентификатор пользователя Facebook для информации о домене, связанной с личным аккаунтом

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

facebook: app_id: 1234 издатель: 1234 администраторы: 1234

  • логотип - URL-адрес логотипа всего сайта (например, /assets/your-company-logo.png)
  • социальный - для указание социальных профилей , Доступны следующие свойства:
    • name - если имя пользователя или организации отличается от имени сайта
    • ссылки - массив ссылок на профили в социальных сетях.
    • date_modified - вручную укажите поле dateModified в выводе JSON-LD, чтобы переопределить собственный dateModified в Jekyll. Это поле будет иметь первый приоритет для выходных данных dateModified JSON-LD. Это полезно, когда временная метка файла не соответствует истинному времени изменения содержимого. Пользователь также может установить Последнее изменение в который предложит альтернативный способ предоставления поля dateModified.

социальные сети: имя: ссылки Бена Балтера: - https://twitter.com/BenBalter - https://www.facebook.com/ben.balter - https://www.linkedin.com/in/BenBalter - https: / /plus.google.com/+BenBalter - https://github.com/benbalter - https://keybase.io/benbalter `` `*` google_site_verification` для подтверждения прав собственности с помощью инструментов Google для веб-мастеров * Либо подтвердите право собственности с помощью нескольких услуги сразу, используя следующий формат: `` `yml webmaster_verifications: google: 1234 bing: 1234 alexa: 1234 yandex: 1234

  • lang - язык, в котором отмечены эти теги. В формате language_TERRITORY. По умолчанию это en_US.

SEO-тег будет учитывать следующие вопросы, связанные с YAML, если они включены в сообщение, страницу или документ:

  • title - название поста, страницы или документа
  • описание - краткое описание содержания страницы
  • изображение - URL-адрес изображения, связанного с сообщением, страницей или документом (например, /assets/page-pic.jpg)
  • автор - информация об авторе для страницы, поста или документа (см. ниже)
  • lang - языковая информация для страницы, пост-документа или документа

Расширенное использование

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

Отключение вывода <title>

Если по какой-то причине вы не хотите, чтобы плагин выводил теги <title> на каждой странице, просто вызовите плагин в вашем шаблоне следующим образом:

{% seo title = false%}

Информация об авторе

Информация об авторе используется для распространения поля создателя сводных карточек Twitter. Это должен быть специфичный для автора, а не дескриптор Twitter для всего сайта (имя пользователя для всего сайта должно храниться как site.twitter.username).

TL; DR. В большинстве случаев указывайте author: [ваш дескриптор Twitter] в начале документа для сайтов с несколькими авторами. Если вам нужно что-то более сложное, читайте дальше.

Есть несколько способов передать эту специфическую для автора информацию. Информация об авторе находится в следующем порядке приоритета:

  1. Авторский объект, в начале документа, например:

автор: twitter: benbalter

  1. Авторский объект, в _config.yml сайта, например:

автор: twitter: benbalter

  1. site.data.authors [author], если автор указан в тексте документа и соответствующий ключ существует в site.data.authors. Например, у вас есть следующее в начале документа:

автор: benbalter

И у вас есть следующее в _data /hors.yml:

benbalter: изображение: /img/benbalter.png twitter: jekyllrb potus: изображение: /img/potus.png twitter: whitehouse

В приведенном выше примере, дескриптор автора benbalter в Twitter будет преобразован в @jekyllrb. Это позволяет вам централизовать информацию об авторе в одном файле _data / авторы для сайта со многими авторами, которым требуется больше, чем просто имя пользователя автора.

Совет: если авторы представлены в начале документа в виде массива (а автор - нет), плагин будет использовать первого автора в списке, поскольку Twitter поддерживает только одного автора.

  1. Автор в начале документа (самый простой способ), например:

автор: benbalter

  1. Автор в сайте _config.yml, например:

автор: benbalter

Настройка вывода JSON-LD

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

  • поисковая оптимизация
    • name - если название вещи, которую представляет страница, отличается от названия страницы. (то есть: "Кафе Фрэнка" против "Добро пожаловать в Кафе Фрэнка")
    • type - Тип вещей, которые представляет страница. Это должно быть Тип Schema.org и, вероятно, обычно будет что-то вроде BlogPosting , Новостная статья , Человек , организация , так далее.
    • ссылки - массив других URL-адресов, представляющих то же, что и эта страница. Например, био-страница Джейн может содержать ссылки на профили Джейн GitHub и Twitter.

Настройка вывода изображения

Для большинства пользователей достаточно установить image: [path-to-image] для каждой страницы. Если вам нужно больше контроля над тем, как представлены изображения, свойство image также может быть объектом со следующими параметрами:

  • путь - относительный путь к изображению. То же, что и изображение: [путь к изображению]
  • height - высота изображения Open Graph (og: image)
  • width - ширина изображения Open Graph (og: image)

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

image: path: /img/twitter.png высота: 100 ширина: 100

Установка изображения по умолчанию

Вы можете определить изображение по умолчанию, используя Front Matter по умолчанию , чтобы обеспечить изображение по умолчанию Twitter Card или OGP для всех ваших сообщений и страниц.

Вот очень простой пример того, что вам рекомендуется адаптироваться к вашим потребностям:

значения по умолчанию: - область действия: путь: "" значения: изображение: /assets/images/default-card.png

SmartyPants Названия

Названия будут обработаны с использованием Smartify фильтр Джекилла , Это будет использовать SmartyPants для перевода простой пунктуации ASCII в «умную» типографскую пунктуацию. Это не будет отображать или удалять любые уценки, которые вы можете использовать в заголовке страницы.

galotchka.ru — Экономическая политика. Все права защищены. 2015
При копировании материалоaв с сайта обратная ссылка обязательна