Википедия:Викификатор

**Викификатор** — инструмент для автоматической обработки вики-текста согласно некоторым правилам вики-разметки и русской типографики. Запускается нажатием соответствующей кнопки над окном редактирования и обрабатывает либо выделенный текст, либо сразу весь текст при отсутствии выделения текста.
* Кнопка Викификатора в улучшенной панели инструментов:Акс:Wikify-toolbutton_new.png
* Кнопка Викификатора в старой панели инструментов:Акс:Кнопка Викификатора.png

Викификатор написан на JavaScript, его код находится на странице .

Рекомендации по установке Викификатора на своём вики-сайте даны на странице Википедия:Викификатор/Инструкция по установке.

Сообщения об ошибках и пожелания по улучшению следует добавлять на страницу **[[Обсуждение Википедии:Викификатор]]**.

По некоторым подсчётам, в русской Википедии Викификатором обрабатывают 1% всех страниц примерно за 2—3 недели.

## Описание работы

### Необрабатываемый текст
Перед обработкой текста Викификатор исключает из обработки:
* текст, окружённый тегами , , , , , , , 
* строки, начинающиеся с пробела (неформатированный текст)
* ``
* ``
* `` (текст ссылки после `|` не прячется)
*  (кроме `&lt;!-- комментариев -->`)
* `="атрибуты таблиц"`

### Замены
Для унификации и упрощения переноса статей из английской Википедии заменяются:
* `` → ``
* `` / `` / `` → ``

HTML-теги на вики-разметку:
*  и  → ``
*  и  → ``
*  → ``

В соответствии с договорённостями русской типографики:
* `` → `№`
* `` (одиночный машинописный апостроф внутри слов) → `` (типографский апостроф)

Сокращения «», «» и «» расшифровываются полностью.

HTML-мнемоники заменяются на символы Юникода (отключено в пространстве шаблонов):
* `` → `©`
* `` → `§` (для кодов больше 127)
* `` → `√` (для кодов больше 7F)

Некоторые сочетания также заменяются на символы:

**Примечания**


### Дефис, минус и тире
Викификатор заменяет на минус (−):
* дефис, за которым следует цифра, и которому предшествует пробел
* дефис, за которым следует цифра, и которому предшествует последовательность «sup&gt;» или «sub&gt;»

После обработки минусов Викификатор заменяет на длинное тире ():
* короткое тире ()
* дефис, окружённый пробелами ()
* дефис в начале строки (прямая речь)
* дефис, окружённый с каждой стороны тремя или четырьмя цифрами ()
* дефис, окружённый римскими цифрами ()
* двойной и тройной дефисы ( и ), окружённые пробелами или цифрами ()
Дефис, просто окружённый цифрами, не обрабатывается Викификатором. Это сделано специально, чтобы избежать многозначностей: «Когда Васе было где-то  года [*нужно тире*], он думал, что другие дети в возрастном периоде  года [*нужно тире*] не смогут понять, что 3−4=−1 [*нужны минусы*]».

### Кавычки
Викификатор сначала конвертирует все кавычки (``) в тексте в обычные (``), а потом вновь их расставляет, но уже согласно правилам набора русского текста:  конвертируются в , а кавычки внутри кавычек — в .

### Обработка пробелов
Удаляются лишние пробелы:
* в конце строк
* несколько подряд (заменяются одним)
* перед запятой:  «слово, слово»
* перед точкой с запятой:  «слово; слово»
* после открывающей круглой скобки и перед закрывающей:  «бегемот (гиппопотам)»
* в диапазонах годов и веков:  «1988—1995»
* перед сносками:  `слово`

Вставляются пропущенные пробелы:
* после точки в конце предложения:  «слово.Слово»
* после запятой:  «слово,слово»

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

### Вставка неразрывных пробелов
Неразрывные пробелы расставляются:
* Перед тире после видимого знака (чтобы при завороте строки тире не отрывалось от предыдущего текста). Например, в «Пушкин — наше всё».
* В русских инициалах. Например, «» → «А. С. Пушкин».
* Перед знаком процента () или промилле (). Так, «» будут преобразованы в «5 % и 16,7 ‰». Исключения составляют такие сокращения, как «».
* После «» или «», если за этими знаками следует цифра.
* В сокращениях «», «», «», «».
* После цифр перед обозначением единиц измерения «м», «мм», «см», «дм», «км», «г», «кг», «мг», «с», а также перед сокращениями «тыс.», «млн», «млрд», «трлн». Сокращение «тыс» дополняется точкой. Для остальных точка убирается в тех случаях, если сокращение очевидно не приходится на конец предложения.
* После цифр перед сокращениями «г.», «гг.», «в.», «вв.».
При этом в нечётных пространствах и в пространстве «Википедия» (то есть везде, где могут быть обсуждения) вместо неразрывного пробела используется обычный, чтобы минимизировать изменения в чужих сообщениях, а также не допустить слишком большие сравнения версий из-за Firefox 1 и 2 (подробнее см. ссылку про неразрывные пробелы выше).

### Градусы
Викификатор расставляет пропущенные знаки градуса, например:
* `` → `+4 °C`
* `` → `−20 °F`
При этом перед знаком градуса ставится неразрывный пробел.

### Захват в ссылки
Викификатор для удобства заменяет викификацию некоторых слов и словосочетаний на равносильную или на устоявшуюся.
* `` → ``
* `` → ``
* `` → ``
* `` → ``
* `` → ``
Последние две замены работают в том случае, если в «хвосте» только строчные русские или латинские буквы.

## Сообщения Викификатора

; Викификатор не может работать в вашем браузере.Wikificator can not work in your browser.
: Означает, что браузер не поддерживает регулярные выражения на достаточном уровне. Используйте другой браузер.

; Викификатор обработает ВЕСЬ текст на этой странице. Продолжить?
: Означает, что реализация JavaScript в браузере не позволяет обработать только выделенный фрагмент. Нажмите , чтобы разрешить Викификатору обработать весь текст.

; Викификатор не обрабатывает страницы обсуждения целиком.Выделите ваше сообщение — обработано будет только оно.
: Викификатор отказывается обрабатывать текст на страницах обсуждений (всех нечётных пространств и в пространстве 4 «Википедия»), если находит в нём более одной подписи. Не следует без необходимости править чужие сообщения.

## Известные проблемы
* `` правильно обрабатываются только после пробела или в начале строки.

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

Если имеет место редкое исключение из правил обработки Викификатора, которое невозможно или очень трудно исправить (например, цитата «авторского текста»), следует окружить проблемный кусок текста тегами  либо поместить его в , чтобы Викификатор его не обрабатывал. При этом для будущих редакторов статьи стоит рядом в комментарии указать `&lt;!-- защита от Викификатора --&gt;`.

Для того, чтобы Викификатор не вставлял пробел после знака пунктуации в некоторых *относительно* распространённых особых случаях, можно использовать шаблоны , ,  (или их короткие синонимы , , ). Примеры употребления указаны в документации этих шаблонов.

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

Код расширения примерно следующий:

```javascript
window.wfPlugins = window.wfPlugins || [];
window.wfPlugins.push(function (txt, r) {
// здесь ваши замены
// Например: r(/<br\s?\/>/g, '<br>');
});
```

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

Некоторые расширения можно подключить непосредственно в настройках:
* Википедия:Гаджеты/Исправление орфографии
* Википедия:Гаджеты/ISBN

## См. также

* Википедия:Викификация
* Википедия:Специальные символы
* Википедия:Инструменты

Гурӯҳ:Википедия:Тарзҳои ороиши мақолаҳо
Гурӯҳ:Википедиа:Абзорҳо