Fandom Developers Wiki
Advertisement

SyntaxHighlight — форкнутая версия скрипта Syntax highlighter, созданного участником Remember the dot на MediaWiki.org.

Данный скрипт возвращает прежнюю подсветку синтаксиса, которая использовалась на старой платформе Фэндома, делая ее доступной в редакторе исходного кода UCP (также известен как редактор 2010).

Установка[]

Использование[]

Убедитесь, что вы используете редактор 2010. Для этого нужно сходить в настройки и поменять предпочитаемый редактор на "Редактор исходного кода".

SyntaxHighlight (preference)

Выберите "Source editor" как предпочитаемый редактор

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

SyntaxHighlight (toolbar)

Иконка маркера должна быть не активна

Настройка[]

Скрипт позволяет настраивать как внешний вид подсветки, так и ее поведение.

Цвета[]

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

Светлые вики[]

  • bold or italic#e4e5f3для syntax$boldOrItalicColor
  • comments#f8dbdaдля syntax$commentColor
  • entities#e8ebdaдля syntax$entityColor
  • external links#dbecebдля syntax$entityColor
  • headings#e4e5f3для syntax$headingColor
  • hr syntax#e4e5f3для syntax$hrColor
  • list and indents#f8dbdaдля syntax$listOrIndentColor
  • parameters#f5e0d8для syntax$parameterColor
  • signatures#f5e0d8для syntax$signatureColor
  • tags#f6dde9для syntax$tagColor
  • tables#f0ebdbдля syntax$tableColor
  • templates#f0ebdbдля syntax$templateColor
  • internal links#d9eaf6для syntax$wikilinkColor


Темные вики[]

  • bold or italic#44466dдля syntax$boldOrItalicColor
  • comments#4d1a19для syntax$commentColor
  • entities#474d23для syntax$entityColor
  • external links#244d491для syntax$entityColor
  • headings#44466dдля syntax$headingColor
  • hr syntax#44466dдля syntax$hrColor
  • list and indents#4d1a19для syntax$listOrIndentColor
  • parameters#66331eдля syntax$parameterColor
  • signatures#66331eдля syntax$signatureColor
  • tags#662946для syntax$tagColor
  • tables#5e5129для syntax$tableColor
  • templates#5e5129для syntax$templateColor
  • internal links#245477для syntax$wikilinkColor


Пользовательские цвета[]

Изменить цвета подсветки возможно путем редактирования настроек внутри объекта window.syntaxHighlighterConfig, который добавляется в MediaWiki:Common.js. Вот что можно поменять:

window.syntaxHighlighterConfig = {
    boldOrItalicColor: '',
    commentColor: '',
    entityColor: '',
    externalLinkColor: '',
    headingColor: '',
    hrColor: '',
    listOrIndentColor: '',
    parameterColor: '',
    signatureColor: '',
    tagColor: '',
    tableColor: '',
    templateColor: '',
    wikilinkColor: ''
};

Например, можно настроить цвета так:

window.syntaxHighlighterConfig = {
    externalLinkColor: '#FFCC66',
    wikilinkColor: '#E6FFFF'
}

Другие параметры[]

У скрипта есть и другие настраиваемые параметры. Чтобы узнать о них, обратитесь к документации оригинального Syntax highlighter.

Оригинальный скрипт[]

Оригинальный код скрипта представлен на странице User:Remember the dot/Syntax highlighter.js на MediaWiki.org. Он был создан Remember the dot'ом и другими участниками и используется на MediaWiki.org и проектах Фона Викимедиа в качестве гаджета.

A version of the original upon which this script has been based can be found in the top comment on MediaWiki:SyntaxHighlight.js.

Если вам кажется, что вы нашли ошибку, не связанную с работой скрипта на Фэндоме, пожалуйста, напишите об этом Remember the dot'у на странице обсуждения Syntax highlighter.

Отличия от оригинала[]

Для корректной работы на Фэндоме в скрипт были внесены некоторые изменения:

  • Added support for i18n-js library to assure easy and user-friendly translation updates.
  • улучшена производительность;
  • стандартные цвета настроены так, чтобы точно отражать дизайна подсветки синтаксиса старой платформы на вики как со светлой темой, так и с темной;
  • добавлена поддержка тегов <infobox> и <templatedata>;
  • эта версия скрипта написана специально для UCP, поэтому она не будет работать на проектах с версией MediaWiki 1.19.

Возможные проблемы[]

Хоть скрипт и работает на всех википроектах Фэндома, могут возникнуть следующие проблемы:

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

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

Advertisement