Просмотр

Материал информационного ресурса НКК "Красная Застава"

== Введение ==

Wiki-расширение "'''Random Citation'''" предназначено для контролируемой случайной выборки цитат из специальным образом подготовленного набора. Результат выборки может быть получен на специальной странице [[Служебная:RandomCitation]] или внутри любой страницы.

== Страницы с цитатами ==

Расширение извлекает цитаты из страниц, расположенных в пространстве имен '''Citation''' и имеющих название определенного вида, а именно, <tt><nowiki><название>.Rating.<рейтинг></nowiki></tt>, где ''<название>'' - это исходное название страницы (например, название произведения, цитаты из которого расположены на ней), а ''<рейтинг>'' - целочисленный рейтинг страницы. (Название и рейтинг пишутся без угловых скобок.) Пример: <tt>Иван Ефремов, Лезвие бритвы.Rating.8</tt>.

Для того, чтобы не загромождать название страницы, можно оставить для самой страницы с цитатами "простое" название (<tt>Иван Ефремов, Лезвие бритвы</tt>), а чтобы расширение могло ее использовать, создать дополнительно страницу-перенаправление со "сложным" названием (<tt>Иван Ефремов, Лезвие бритвы.Rating.8</tt>), ссылающуюся на страницу с цитатами.

Расширение использует рейтинг страницы для определения, насколько часто из нее будут браться цитаты. Частота появления цитаты из данной страницы прямо пропорциональна ее рейтингу.

== Размещение цитат на странице ==

Отдельные цитаты должны быть заключены в теги '''<nowiki><rcitation></nowiki>''' с необязательным указанием рейтинга, например, так: <tt><nowiki><rcitation rating="4">Это - цитата.</rcitation></nowiki></tt>, или так: <tt><nowiki><rcitation>Это - другая цитата.</rcitation></nowiki></tt>. Если рейтинг не указан, по умолчанию он принимается равным двум. Вне тегов '''<nowiki><rcitation></nowiki>''' страница может быть оформлена как угодно.

Рейтинг отдельных цитат используется аналогично рейтингу страниц - частота появления каждой цитаты пропорциональна ее рейтингу. Нужно иметь в виду, что рейтинги страниц и цитат, а также рейтинги цитат на разных страницах рассматриваются независимо - сначала происходит выбор страницы в соответствии с рейтингами страниц, а потом - выбор цитаты на данной странице в соответствии с рейтингом цитат, поэтому можно не беспокоиться об обеспечении соразмерности рейтингов цитат на разных страницах.

== Вставка случайной цитаты ==

Для вставки случайной цитаты в страницу используется тег '''<nowiki><insert_rcitation></nowiki>''', вот так: <tt><nowiki><insert_rcitation /></nowiki></tt>, или так: <tt><nowiki><insert_rcitation disablecache="1" /></nowiki></tt>. Если указан параметр '''disablecache''', расширение запретит кэширование данной страницы, так что при каждом ее запросе будет отображаться новая цитата. Иначе новая цитата будет появляться лишь при обновлении кэша (с периодом, вроде бы, порядка суток) или при внесении правок в данную страницу.
Возврат к странице Справка:Случайные Цитаты.
Источник — «http://krasnaya-zastava.ru/wiki/index.php/%D0%A1%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0:%D0%A1%D0%BB%D1%83%D1%87%D0%B0%D0%B9%D0%BD%D1%8B%D0%B5_%D0%A6%D0%B8%D1%82%D0%B0%D1%82%D1%8B»