Модул:stringconvert/doc
This is the documentation page for Модул:stringconvert
Модуль предназначен для форматирования строки в ссылки. Этот модуль используется в шаблоне {{aslinks}}.
Описание функций и параметров
[вироиш]aslinks— функция форматирования строки в ссылки.- Принимает шесть параметров, которые могут иметь значения:
text=— исходная строка (обязательный)delimiter=— строка из разделителей (необязательный, по умолчанию = ", " — разделять слова запятой или пробелом)nospace=— без пробела (yes или no).hide=— слово, которые нужно удалить из текста (удаляются также ссылки на слово).nocomment— без комментариев в круглых скобках (yes или no).lang=— буквенный код языка (ru,en,frи т.п.).
- Принимает шесть параметров, которые могут иметь значения:
strip_macrons— функция удаляет макроны, знаки ударения и заменяет слоговые знаки на обычные- Принимает один неименованный параметр — исходную строку для обработки.
Технические детали
[вироиш]Ссылки в результирующей строке будут разделены также, как и в исходной. Существующие ссылки сохраняются. Например:
{{#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