Платформа QSP дозволяє використовувати HTML в описі локацій, додатковому описі і т.п. (USEHTML = 1), що додає можливостей по частині форматування тексту. Це здорово, однак, html-теги неабияк обтяжують текст, роблячи його исходник не тільки складним для прочитання, а й незручним для редагування.
Даний модуль вирішує деякі проблеми за допомогою скорочених форм запису тегів. Наприклад, щоб позначити частину тексту як параграф (html-тег параграфа
) Потрібно на початку параграфа поставити "п.", Для заголовка - "з1.", Щоб притиснути текст до правого краю екрану - ">.". Щоб зробити текст жирним, потрібно на початку і в кінці потрібної ділянки тексту поставити символи "**", а щоб зробити похилим - "//".
Також модуль робить ще кілька корисних речей: замінює знак дефіса в потрібних місцях на довге тире (—), Кілька точок - на символ трьох крапок (...), а також розставляє по тексту "правильні" лапки і замінює деякі знаки і дробу.
"Запозичення" в модулі
Функціонал даного модуля є по суті компіляцією ідей і напрацювань, почерпнутих з наступних джерел:
- Модуль "Textile", що входить в CMS "Textpattern", який реалізує коротку запис html-тегів. Взята загальна ідея записи тегів.
- Модуль "WP Typograph Full" який в свою чергу базується на ідеях і вихідних кодах купи скриптів (за посиланням все це є). Взято за частиною заміни деяких символів.
- Модуль "Кавичкер" Дмитра Смирнова (spectator.ru). Само собою, реалізація модуля розстановки лапок взята звідти повністю.
варіанти модуля
Починаючи з версії 1.5 модуль поставляється тільки з російськомовними варіантами команд і тегів.
Вхідні в пакет файли
Обов'язковий параметр. "Сирий" текст, в якому використовуються короткі записи html-тегів.
Необов'язковий параметр. Якщо не вказати або вказати 0, то текст буде розглядатися як звичайний текст, без html-тегів, тобто символи "<", "> "," "Будуть екрановані. Для вставки в такий текст html-блоку, потрібно використовувати запис ... . Однак якщо переданий в функцію текст містить html-код (без тегів ), Наприклад, складне форматування, таблиці і т.п. - то має сенс встановлювати цей параметр, відмінним від нуля.
Приклад передачі тексту саме як тексту:
Приклад передачі тексту як html-тексту:
Тіпограф.Отступ
Встановлює, як повинен виглядати відступ, що використовується в тезі "кс.". За замовчуванням відступ виглядає як п'ять нерозривних пробілів.
Обов'язковий параметр. Текст, вміст якого буде використовуватися в якості відступу.
Порожня стрічка
Перевіряє, чи можна вважати рядок порожній (тобто в ній немає жодного "значимого" символу). Символи пробілу, табуляції, перекладу рядка і повернення каретки до "значущим" символам не належать.
Обов'язковий параметр. Перевіряється текст.