Макрос изменяет содержимое между [pro] и [/pro] с учетом определенных настроек. Настройки можно сочетать для получения необходимого результата (см. примеры ниже).
Каждая настройка может иметь обязательные или не обязательные параметры, которые указываются в кавычках, по анологии с html: param="value", так же допускается написание со скобками param(value). Например: «[pro before="Привет! "]Как дела?[/pro]», результатом выполнения такой конструкции будет строка: «Привет! Как дела?». Настройка before имеет обязательный параметр — текст, который будет вставлен до содержимого макроса.
Если настройка имеет обязательный параметр, то это указано в таблице ниже, если обязательный параметр для настройки не указан, то это значит, что настройка поддерживает вероятность.
Например, настройка bold выделит указанный текст жирным шрифтом:
[pro bold]текст[/pro] → <b>текст</b>, но если мы хотим, чтобы программа выделила текст с вероятностью 45%,
то мы можем указать параметр для настройки, который задает вероятность того, что эта настройка сработает: [pro bold="45%"]текст[/pro].
Для удобства, настройки макроса pro поддерживаются и многими другими макросами программы (об этом обязательно указано в справке по конкретному макросу). Например, макрос key выводит текущее ключевое слово. Но, если нам надо вывести текущее ключевое слово с большой буквы и синонимизировать его с вероятностью 50%, то мы могли бы использовать макрос [pro] следующим образом: [pro uc syn="50%"][key][/pro]. Но так как макрос key поддерживает настройки макроса pro, мы можем упростить эту конструкцию следующим образом: [key uc syn="50%"].
Другой пример. Макрос file.lines предназначен для того, чтобы выводить из файла указанное кол-во строк, этот макрос так же поддерживает настройки макроса pro. Допустим, мы хотим, чтобы макрос file.lines выводил 5 строк, обрамлял их html тегами <li> для формирования списка, а так же вставлял в выводимые строки ссылки на случайные статьи с вероятностью 50%. Эту задачу можно решить с помощь следующей конструкции: [file.lines count="5" before="<li>" after="</li>" link="50%"]
Настройки макроса:
| Выделение: | |
| bold | выделение с помощью тега <b> |
| strong | выделение с помощью тега <strong> |
| italic | выделение с помощью тега <italic> |
| before="любой текст" | вставить указанное значение до содержимого |
| after="любой текст" | вставить указанное значение после содержимого |
| Текстовые преобразования: | |
| uppercase uc | первое слово с большой буквы |
| uppercase_each_word ucw | все слова с большой буквы |
| uppercase_each_letter ucl | все буквы большие |
| lowercase_each_letter lcl | все буквы маленькие |
| Морфологические преобразования: | |
| synonymize syn | синонимизировать |
| case="1-6" | просклонять в нужный падеж:
|
| random.nouns rand.nouns rnd.nouns | заменять существительные на случайные |
| random.adjectives rand.adjectives rnd.adjectives | заменять прилагательные на случайные |
| random.verbs rand.verbs rnd.verbs | заменять глаголы на случайные |
| random.adverbs rand.adverbs rnd.adverbs | заменять наречия на случайные |
| Очистка текста: | |
| old.value="старое значение" | значение, которое необходимо заменить на new.value |
| new.value="новое значение" | значение которым необходимо заменить old.value |
| old.path="c:\old.txt" | файл со списком значений, которые необходимо заменить значениями из new.path |
| new.path="c:\new.txt" | файл со списком значений, на которые необходимо заменить значения из old.path |
| remove.value="текст" | значение, которое необходимо удалить |
| remove.path="c:\remove.txt" | файл со списком значений, которые необходимо удалить |
| remove.html | удалит все html теги |
| remove.html.a | удалит html теги <a> |
| remove.html.img | удалит html теги <img> |
| Перелинковка: | |
| link | вставить ссылку на случайную страницу |
| link.morph | вставить ссылку на случайную страницу учитывая морфологию |
| link.external | вставить ссылку на случайную страницу случайного аккаунта |
| link.external.morph | вставить ссылку на случайную страницу случайного аккаунта учитывая морфологию |
| Кодирование: | |
| translit translit="+" | транслитерировать транслитерировать и заменить пробелы на «+» (вместо «+» можно указывать другие символы) |
| urlencode.utf8 urlenc.utf8 | URL-кодирование строки в UTF-8 |
| urlencode.ansi urlenc.ansi | URL-кодирование строки в ANSI |
| urldecode.utf8 urldec.utf8 | URL-декодирование строки UTF8 |
| urldecode.ansi urldec.ansi | URL-декодирование строки UTF8 |
| htmlencode htmlenc | HTML кодирование |
| htmldecode htmldec | HTML декодирование |
| base64encode base64enc | Base64 кодирование |
| base64decode base64dec | Base64 декодирование |
Примеры:
результат: «Пластиковое окно»
результат: «Пластиковому Окну»
результат: «<b>Пластиковому окну</b>»
результат: «plastikovoe okno»
результат: «plastikovoe-okno»
результат: «http://site.ru/?q=%D0%BE%D0%BA%D0%BD%D0%BE» может пригодиться для передачи строки в качестве параметра URL
результат: «<i>ПЛАСТИКОВОЕ ОКНО</i>» будет выделено с вероятностью 30%
результат: «прекрасному дому»
результат: «красивый сад»