Часто задаваемые вопросы (FAQ-A)

SubScript для лент новостей

Версия 1.02 от 04.08.2011

Описанный здесь набор команд предназначен для использования в "Оформлении Лент" и не работает в других местах - содержимом (кроме команды lenta), теме выпуска и текстах отказа при модерации.

Включение новостей ленты в выпуск рассылки - lenta
Код ленты - lenta_nick
Название ленты - lenta_name
Свежих новостей в ленте - lenta_news
Порядковый номер новости - news_n
Чётность порядкового номера новости - news_even
Уникальный серийный номер новости - news_serial
Ссылка новости - news_link
Заголовок новости - news_title
Содержимое новости - news_content
Автор новости - news_author
идентификатор новости - news_id
Дата и время создания новости - news_dt
Дата создания новости - news_ymd
Время создания новости - news_hm
Год создания новости - news_year
Месяц создания новости - news_month
День создания новости - news_day
Час создания новости - news_hour
Минута создания новости - news_minute
Секунда создания новости - news_second
Условные операторы - if / elsif / endif - [УЛУЧШЕНО 04/VIII-2011]

Включение новостей ленты в выпуск рассылки [ SUBSCRIBE lenta код-ленты decor=оформление reverse ]

Описание - Команда используется в тексте и меню выпуска для включения на её места свежих новостей ленты c кодом "код-ленты".

Не обязательный параметр decor позволяет указать используемый при этом код оформления ленты

Не обязательный параметр reverse позволяет изменить стандартный порядок следования новостей "сначала более ранние" на обратный.

Команда не доступна бронзовым рассылкам.

Код ленты [ SUBSCRIBE lenta_nick ]

Описание - Код ленты указанный при её создании

Название ленты [ SUBSCRIBE lenta_name ]

Описание - Название ленты указанное при её создании

Свежих новостей в ленте [ SUBSCRIBE lenta_news ]

Описание - Количество свежих новостей в ленте, которые попали в публикацию

Порядковый номер новости [ SUBSCRIBE news_n ]

Описание - Порядковый номер новости в данном размещении ленты в выпуске. Начинается с единицы.

Уникальный серийный номер новости [ SUBSCRIBE news_serail ]

Пример - a10371fd98509dcde3a7a9d100f76dbe

Описание - Уникальный серийный номер новости присвоенной ей системой. Строка из 32 двух латинских букв и цифр.

Ccылка новости новости [ SUBSCRIBE news_link ]

Пример - https://subscribe.ru

Описание - Ссылка новости как она была указана. Вы должны сами использовать команду внутри тега <A>, что бы она стала кликабельной.

Заголовок новости [ SUBSCRIBE news_title ]

Описание - Заголовок новости как текстовая строка. Специальные HTML-символы уже предохранены.

Cодержимое новости [ SUBSCRIBE news_content ]

Описание - Содержимое новости как есть. Предполагается, что если в источнике данных содержимое в HTML, то автор источника сам позаботился о предохранении специальных HTML-символов.

Автор новости [ SUBSCRIBE news_author ]

Описание - Автор новости как текстовая строка. Специальные HTML-символы уже предохранены.

Идентификатор новости [ SUBSCRIBE news_id ]

Описание - Идентификатор новости как текстовая строка. Специальные HTML-символы уже предохранены.

Дата и время создания новости [ SUBSCRIBE news_dt ]

Пример - 2006/09/06 16:26

Описание - Дата создания новости с указанием даты и времени без секунд.

Дата создания новости [ SUBSCRIBE news_ymd ]

Пример - 2006/09/06

Описание - Дата создания новости без времени

Время создания новости [ SUBSCRIBE news_hm ]

Пример - 16:26

Описание - Час и минута создания новости

Компоненты даты и времени создания новости [ SUBSCRIBE news_year ], [ SUBSCRIBE news_month ], [ SUBSCRIBE news_day ],
[ SUBSCRIBE news_hour ], [ SUBSCRIBE news_minute ], [ SUBSCRIBE news_second ]

Описание - Год, месяц, день, час, минута и секунда создания новости соответственно.

Год - четыре цыфры, отсальное - две с ведущим нулём

Чётность порядкового номера новости [ SUBSCRIBE if news_even ]

........

[ SUBSCRIBE else ]

......

[ SUBSCRIBE endif]

Пример - чётные новости c красным заголовком. не чётные - зелёные.

<FONT [ SUBSCRIBE if news_enev ] color="red" [ SUBSCRIBE else ] color="green">[ SUBSCRIBE endif]> [ SUBSCRIBE news_title ] </FONT>

Описание - специальное имя news_even позволяет проверить четный или не чётный номер у новости и реализовать, скажем, их выделение цветом через одну.

Условные команды

[ SUBSCRIBE if условие ]

[ SUBSCRIBE elsif условие]

[ SUBSCRIBE else ]

[ SUBSCRIBE endif ]

Описание - Условные команды для выбора позволяют, например, иметь красивое оформление учитывающее что у новости отсутствует та или иная часть или что новости с определёнными номерами надо выводить как-то по другому.

Условие считается выполненным:

if news_*: когда указанный в нём компонент новости не пуст
if news_* eq слово или число: когда указанный в нём компонент новости равен указаному слову или числу
if news_* eq слово или число: когда указанный в нём компонент новости не равен указаному слову или числу

Специальное имя news_even позволяет проверить четный или не чётный номер у новости и реализовать, скажем, их выделение цветом через одну.

Развёрнутый пример с пояснениями можно найти в описании "Глобального стандартного оформления".

Ошибки вложенности и неправильной последовательности условных команд молча игнорируются.