Модуль:stringconvert/Документация

Модуль предназначен для форматирования строки в ссылки. Этот модуль используется в шаблоне {{aslinks}}.

Описание функций и параметров

• aslinks — функция форматирования строки в ссылки.

  Принимает шесть параметров, которые могут иметь значения:

  1. text= — исходная строка (обязательный)
  2. delimiter= — строка из разделителей (необязательный, по умолчанию = ", " — разделять слова запятой или пробелом)
  3. nospace= — без пробела (yes или no).
  4. hide= — слово, которые нужно удалить из текста (удаляются также ссылки на слово).
  5. nocomment — без комментариев в круглых скобках (yes или no).
  6. lang= — буквенный код языка (ru, en, fr и т.п.).

• strip_macrons — функция удаляет макроны, знаки ударения и заменяет слоговые знаки на обычные

  Принимает один неименованный параметр — исходную строку для обработки.

• correct_accent — функция убирает знак ударения в слове с одной гласной

  Принимает один неименованный параметр — исходную строку для обработки.

Технические детали

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

• {{#invoke:stringconvert|aslinks|петь орать голосить}} → петь орать голосить
• {{#invoke:stringconvert|aslinks|[[петь|пою]], орать, , голосить}} → пою, орать, , голосить

Для удаления слова или словосочетания из строки можно использовать параметр hide=. Следующие за словом пробелы и запятая тоже удаляются. Например:

• {{#invoke:stringconvert|aslinks|петь орать голосить|hide=петь}} → орать голосить
• {{#invoke:stringconvert|aslinks|поднять [[якорь|якоря]], полный вперед|hide=якорь}} → поднять полный вперед
• {{#invoke:stringconvert|aslinks|под вечер мы [[остановиться|остановились]]|hide=под вечер}} → под вечер мы остановились
• {{#invoke:stringconvert|aslinks|[[вечер]]ом мы [[остановиться|остановились]]|hide=вечер}} → мы остановились

С помощью второго параметра, можно переопределить разделители по умолчанию. Пробел в разделители добавлять не нужно, он добавляется по умолчанию. Например:

• {{#invoke:stringconvert|aslinks|choix {{m}}; sélection {{f}}|,;}} → choix м.; sélection ж.

Если нужно подавить добавление пробела используйте параметр nospace=1. Например:

• {{#invoke:stringconvert|aslinks|говоря́т тебе, говорят вам||1}} → говоря́т тебе, говорят вам
• {{#invoke:stringconvert|aslinks|семь бед — один ответ; беда одна не ходит'', за собой другую водит''|nospace=1}} → семь бед — один ответ; беда одна не ходит, за собой другую водит
• {{#invoke:stringconvert|aslinks|семь бед — один ответ; беда одна не ходит'', за собой другую водит''|;|1}} → семь бед — один ответ; беда одна не ходит, за собой другую водит

Используйте в разделителе escape последовательность  , если нужно разделять строки только пробелом. Например сравните:

• {{#invoke:stringconvert|aslinks|несчастье, крайне [[тяжёлый|тяжёлое]] или [[неприятный|неприятное]] событие или обстоятельство}} → несчастье, крайне тяжёлое или неприятное событие или обстоятельство
• {{#invoke:stringconvert|aslinks|несчастье, крайне [[тяжёлый|тяжёлое]] или [[неприятный|неприятное]] событие или обстоятельство| }} → несчастье, крайне тяжёлое или неприятное событие или обстоятельство

Чтобы учесть все разделители и знаки препинания используйте строку %s%p:

• {{#invoke:stringconvert|aslinks|Non, je vous préviens que si vous ne me dites pas que nous avons la guerre, si vous vous permettez encore de pallier toutes les infamies, toutes les atrocités de cet Antichrist (ma parole, j'y crois) — je ne vous connais plus, vous n'êtes plus mon ami, vous n'êtes plus мой верный раб, comme vous dites.|%s%p|1}} → Non, je vous préviens que si vous ne me dites pas que nous avons la guerre, si vous vous permettez encore de pallier toutes les infamies, toutes les atrocités de cet Antichrist (ma parole, j'y crois) — je ne vous connais plus, vous n'êtes plus mon ami, vous n'êtes plus мой верный раб, comme vous dites.

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

• {{#invoke:stringconvert|aslinks|мн.: люди, грабли}} → мн.: люди, грабли
• {{#invoke:stringconvert|aslinks|''мн.'': люди, грабли}} → мн.: люди, грабли
• {{#invoke:stringconvert|aslinks|<i>мн.</i>: люди, грабли}} → мн.: люди, грабли
• {{#invoke:stringconvert|aslinks|{{мн}} люди, грабли}} → мн. ч. люди, грабли
• {{#invoke:stringconvert|aslinks|''частичн.'': добро, счастье, удача}} → частичн.: добро, счастье, удача
• {{#invoke:stringconvert|aslinks|grablje {{f}} {{мн.}}}} → grablje ж. мн. ч.
• {{#invoke:stringconvert|aslinks|{{incorrect|ми́нутый}}}} → *ми́нутый
• {{#invoke:stringconvert|aslinks|{{пример|текст в примере}}}} → ◆ текст в примере

Для формирование ссылки на языковый раздел используйте параметр lang

• {{#invoke:stringconvert|aslinks|prōcēssus|lang=la}} → prōcēssus
• {{#invoke:stringconvert|aslinks|processus|lang=fr}} → processus