ListFeed (расширение MediaWiki) - История изменений

StasFomin в 15:02, 27 августа 2012

2012-08-27T15:02:58Z

StasFomin в 14:06, 19 апреля 2012

2012-04-19T14:06:45Z

VitaliyFilippov в 14:53, 5 апреля 2012

2012-04-05T14:53:41Z

VitaliyFilippov в 12:12, 15 сентября 2011

2011-09-15T12:12:00Z

VitaliyFilippov в 14:51, 9 августа 2011

2011-08-09T14:51:51Z

BenderBot: 1 версия

2010-12-02T01:09:05Z

1 версия

StasFomin в 17:14, 1 декабря 2010

2010-12-01T17:14:41Z

BenderBot: 1 версия

2010-03-26T01:00:43Z

1 версия

VitaliyFilippov в 21:43, 25 марта 2010

2010-03-25T21:43:16Z

Новая страница

'''ListFeed''' — расширение MediaWiki, позволяющее генерировать простые [[Изображение:Rss14.png]] [[RSS]]-ленты из стандартных списков [[mediawikiwiki:MediaWiki|MediaWiki]] (нумерованных «#» и маркированных «*»).

Инструкции по установке и исходные коды можно увидеть на '''[http://yourcmc.ru/wiki/ListFeed_(MediaWiki) домашней странице расширения]'''.

С помощью этого расширения практически любой список можно превратить в RSS-ленту.

Расширение добавляет два новых тега — '''<tt><listfeed></tt>''' и '''<tt><endlistfeed /></tt>''', а также функцию парсера '''<tt><nowiki>{{#listfeedurl:Feed Name}}</nowiki></tt>''', которая возвращает URL RSS-ленты, сгенерированной расширением из списка с заданным именем. Расширение позволяет легко превратить любой маркированный или нумерованный Wiki-список в RSS-ленты, которая автоматически обновляется при обновлении статьи.

Каждый элемент списка становится отдельной записью ленты.
* Заголовком записи становится первая строка текста элемента списка.
* Текстом записи — всё остальное, если оно присутствует, и просто весь текст элемента списка, если нет.
* Дата записи разбирается в соответствии с заданным регулярным выражением (см. ниже) и вырезается из заголовка.
* Ссылкой записи становится первая ссылка в тексте, за исключением даты, так как в дате может присутствовать ссылка на автора, например, если используются стандартные подписи (<nowiki>~~~~</nowiki>). Если ссылок в тексте нет, используется ссылка на статью с уникальным якорем (anchor) для идентификации записи.
* Автором записи становится первая ссылка в пространство имён <nowiki>[[Участник:]]</nowiki> из текста элемента списка, либо автор последней ревизии статьи.

Ленты идентифицируются по именам (<tt><listfeed '''name=<nowiki>"ИМЯ_ЛЕНТЫ"</nowiki>'''></tt>) и помещаются в один каталог, поэтому в пределах одной Wiki-системы две ленты с одинаковыми именами будут перезаписывать друг друга при каждом обновлении страницы. Описанием ленты служит любой Wiki-код, заключённый в тег <tt><listfeed></tt> — он преобразуется в HTML и включается в RSS-элемент <tt><about></tt>.

Чтобы начать использовать ListFeed, добавьте тег <tt><listfeed></tt> перед вашим списком:
<pre><listfeed name="ИМЯ_ЛЕНТЫ" [ОПЦИИ]>
ОПИСАНИЕ_ЛЕНТЫ
</listfeed></pre>

И тег <tt><endlistfeed></tt> после списка:
<pre><endlistfeed /></pre>

Чтобы вставить ссылку на ленту в текст статьи, нужно использовать функцию парсера:

<pre>{{#listfeedurl:ИМЯ_ЛЕНТЫ}}</pre>

На данный момент доступны две опции, связанные с разбором дат элементов ленты.

=== Опция date ===

<big><tt><listfeed '''date=<nowiki>"ВЫРАЖЕНИЕ"</nowiki>'''></tt></big>.

Рядом с каждым элементом вашего списка, скорее всего, будет стоять дата. Однако, в каком она формате? Для установки формата с помощью специального регулярного выражения для разбора дат и служит эта опция. По умолчанию выбирается выражение для разбора стандартных подписей (<nowiki>~~~~</nowiki>):
<pre>^(?:[^:]+|<[^<>]*>)*%H:%M(?::%S)?,\s*%d\s+%b\s+%Y(?:\s*\(UTC\))?(?:\s*:?)</pre>

ВЫРАЖЕНИЕ похоже на обычные [http://www.pcre.org/ Perl-совместимые регулярные выражения], однако, кроме стандартных инструкций, включаемых в регулярные выражения, оно также может содержать большинство <tt>[http://linux.die.net/man/3/strftime strftime(3)]</tt>-подобных подстановок (см. ниже полный список поддерживаемых подстановок) и, таким образом, является как бы «обратной функцией» к <tt>[http://linux.die.net/man/3/strftime strftime(3)]</tt>.

На данный момент поддерживаются следующие подстановки <tt>strftime</tt>:
<tab sep="tab" class="simpletable" head="left">
%Y год (4 цифры)
%y год (2 цифры)
%C век (2 цифры), может использоваться вместе с %y, по умолчанию выбирается текущий век, если выделенный год и текущий год лежат в одной половине века, и предыдущий/следующий, если в разных
%m месяц (2 цифры, от 01 до 12)
%b / %B имя месяца — либо полное (Январь, Января, January), либо сокращённое (Янв, Jan)
%d день месяца (2 цифры)
%e день месяца (1 или 2 цифры)
%H / %h часы
%M минуты
%S секунды
%s UNIX время — количество секунд, прошедших с начала Эпохи UNIX (1970-01-01 00:00:00)
%% символ %
</tab>
Прочие подстановки <tt>strftime</tt> признаны либо слишком специальными, либо производными от вышеупомянутых и поэтому отдельно не поддерживаются.

=== Опция headingdate ===

<big><tt><listfeed '''headingdate=<nowiki>"ВЫРАЖЕНИЕ"</nowiki>'''></tt></big>.

Даты, или их части, также могут быть заданы в заголовках между элементами. Предположим статью со следующим текстом:

<pre><listfeed name="News of extension" date="^%b %d:\s*" headingdate="%Y" />
= 2010 news =
* Jan 13: New version of ListFeed.
* Jan 01: Happy New Year!
= 2009 news =
* Dec 17: ...
* ...
<endlistfeed /></pre>

В данном случае даты не могут быть взяты целиком из каждого элемента, однако, год каждой даты со всей очевидностью присутствует в заголовке, поэтому и требуется разбирать его тоже. Для приведённого примера, выражение headingdate=<nowiki>"%Y"</nowiki> абсолютно корректно.

== Пример ==

<pre><listfeed name="Новости CustisWiki">
Новости CustisWiki - важные статьи, голосования, новости системы
</listfeed>
* [[Участник:EvgeniaUdalova|Евгения Удалова]] 09:00, 5 октября 2009: Опрос ДМС 2009 завершён! Результаты можно посмотреть [[Опрос_ДМС_2009| здесь]].
* [[Участник:MaksTsepkov|Макс Цепков]] 05:38, 26 сентября 2009 (UTC) Чтобы долго не искать - ссылки на блоги и rss:
*: [[Блог:Володя Рахтеенко]]
*: [[Блог:TechTools/Новости наших Wiki-систем: Блоги, черновики, интеграция с Subversion]] [[FeedOnFeeds]]
*: [[Служебная:Wikilog]] - общая лента блогов и замечание: когда ищите по wiki из панели слева, поиск в блогах отключен, надо включать галочку на результатах поиска.
<endlistfeed /></pre>

[[Категория:{{SITENAME}}:Справка]]
{{replicate-from-custiswiki-to-lib}}

← Предыдущая		Версия 15:02, 27 августа 2012
Строка 1:		Строка 1:
−	'''ListFeed''' — расширение MediaWiki, позволяющее генерировать простые [[~~Изображение~~:Rss14.png]] [[RSS]]-ленты из стандартных списков [[mediawikiwiki:MediaWiki\|MediaWiki]] (нумерованных «#» и маркированных «*»).	+	'''ListFeed''' — расширение MediaWiki, позволяющее генерировать простые [[File:Rss14.png]] [[RSS]]-ленты из стандартных списков [[mediawikiwiki:MediaWiki\|MediaWiki]] (нумерованных «#» и маркированных «*»).

	Инструкции по установке и исходные коды можно увидеть на '''[http://yourcmc.ru/wiki/ListFeed_(MediaWiki) домашней странице расширения]'''.		Инструкции по установке и исходные коды можно увидеть на '''[http://yourcmc.ru/wiki/ListFeed_(MediaWiki) домашней странице расширения]'''.

@@ Строка 87: / Строка 87: @@
 [[Категория:Справка]]
 {{replicate-from-custiswiki-to-lib}}
-{{replicate-from-custiswiki-to-tools}}
+{{replicate-from-custiswiki-to-4intranet}}

@@ Строка 80: / Строка 80: @@
 * [[Участник:EvgeniaUdalova|Евгения Удалова]] 09:00, 5 октября 2009: Опрос ДМС 2009 завершён! Результаты можно посмотреть  [[Опрос_ДМС_2009| здесь]].
 * [[Участник:MaksTsepkov|Макс Цепков]] 05:38, 26 сентября 2009 (UTC) Чтобы долго не искать - ссылки на блоги и rss:
-*: [[Блог:Володя Рахтеенко]]
+*: [[Blog:Володя Рахтеенко]]
-*: [[Блог:TechTools/Новости наших Wiki-систем: Блоги, черновики, интеграция с Subversion]] [[FeedOnFeeds]]
+*: [[Blog:TechTools/Новости наших Wiki-систем: Блоги, черновики, интеграция с Subversion]] [[FeedOnFeeds]]
 *: [[Служебная:Wikilog]] - общая лента блогов и замечание: когда ищите по wiki из панели слева, поиск в блогах отключен, надо включать галочку на результатах поиска.
 <endlistfeed /></pre>

← Предыдущая	Версия 01:09, 2 декабря 2010
(нет различий)

@@ Строка 1: / Строка 1: @@
-'''ListFeed''' — расширение MediaWiki, позволяющее генерировать простые [[Изображение:Rss14.png]] [[RSS]]-ленты из стандартных списков [[mediawikiwiki:MediaWiki|MediaWiki]] (нумерованных «#» и маркированных «*»).
+'''ListFeed''' — расширение MediaWiki, позволяющее генерировать простые [[Изображение:Rss14.png]] [[RSS]]-ленты из стандартных списков [[mediawikiwiki:MediaWiki|MediaWiki]] (нумерованных «#» и маркированных «*»).
 Инструкции по установке и исходные коды можно увидеть на '''[http://yourcmc.ru/wiki/ListFeed_(MediaWiki) домашней странице расширения]'''.
@@ Строка 5: / Строка 5: @@
 С помощью этого расширения практически любой список можно превратить в RSS-ленту.
-Расширение добавляет два новых тега — '''<tt>&lt;listfeed&gt;</tt>''' и '''<tt>&lt;endlistfeed /&gt;</tt>''', а также функцию парсера '''<tt><nowiki>{{#listfeedurl:Feed Name}}</nowiki></tt>''', которая возвращает URL RSS-ленты, сгенерированной расширением из списка с заданным именем. Расширение позволяет легко превратить любой маркированный или нумерованный Wiki-список в RSS-ленты, которая автоматически обновляется при обновлении статьи.
+Расширение добавляет два новых тега — '''<tt>&lt;listfeed&gt;</tt>''' и '''<tt>&lt;endlistfeed /&gt;</tt>''', а также функцию парсера '''<tt><nowiki>{{#listfeedurl:Feed Name}}</nowiki></tt>''', которая возвращает URL RSS-ленты, сгенерированной расширением из списка с заданным именем. Расширение позволяет легко превратить любой маркированный или нумерованный Wiki-список в RSS-ленты, которая автоматически обновляется при обновлении статьи.
 Каждый элемент списка становится отдельной записью ленты.
 * Заголовком записи становится первая строка текста элемента списка.
-* Текстом записи — всё остальное, если оно присутствует, и просто весь текст элемента списка, если нет.
+* Текстом записи — всё остальное, если оно присутствует, и просто весь текст элемента списка, если нет.
 * Дата записи разбирается в соответствии с заданным регулярным выражением (см. ниже) и вырезается из заголовка.
 * Ссылкой записи становится первая ссылка в тексте, за исключением даты, так как в дате может присутствовать ссылка на автора, например, если используются стандартные подписи (<nowiki>~~~~</nowiki>). Если ссылок в тексте нет, используется ссылка на статью с уникальным якорем (anchor) для идентификации записи.
 * Автором записи становится первая ссылка в пространство имён <nowiki>[[Участник:]]</nowiki> из текста элемента списка, либо автор последней ревизии статьи.
-Ленты идентифицируются по именам (<tt>&lt;listfeed '''name=<nowiki>"ИМЯ_ЛЕНТЫ"</nowiki>'''&gt;</tt>) и помещаются в один каталог, поэтому в пределах одной Wiki-системы две ленты с одинаковыми именами будут перезаписывать друг друга при каждом обновлении страницы. Описанием ленты служит любой Wiki-код, заключённый в тег <tt>&lt;listfeed&gt;</tt> — он преобразуется в HTML и включается в RSS-элемент <tt>&lt;about&gt;</tt>.
+Ленты идентифицируются по именам (<tt>&lt;listfeed '''name=<nowiki>"ИМЯ_ЛЕНТЫ"</nowiki>'''&gt;</tt>) и помещаются в один каталог, поэтому в пределах одной Wiki-системы две ленты с одинаковыми именами будут перезаписывать друг друга при каждом обновлении страницы. Описанием ленты служит любой Wiki-код, заключённый в тег <tt>&lt;listfeed&gt;</tt> — он преобразуется в HTML и включается в RSS-элемент <tt>&lt;about&gt;</tt>.
 Чтобы начать использовать ListFeed, добавьте тег <tt>&lt;listfeed&gt;</tt> перед вашим списком:
@@ Строка 45: / Строка 45: @@
 %C	век (2 цифры), может использоваться вместе с %y, по умолчанию выбирается текущий век, если выделенный год и текущий год лежат в одной половине века, и предыдущий/следующий, если в разных
 %m	месяц (2 цифры, от 01 до 12)
-%b / %B	имя месяца — либо полное (Январь, Января, January), либо сокращённое (Янв, Jan)
+%b / %B	имя месяца — либо полное (Январь, Января, January), либо сокращённое (Янв, Jan)
 %d	день месяца (2 цифры)
 %e	день месяца (1 или 2 цифры)
@@ Строка 51: / Строка 51: @@
 %M	минуты
 %S	секунды
-%s	UNIX время — количество секунд, прошедших с начала Эпохи UNIX (1970-01-01 00:00:00)
+%s	UNIX время — количество секунд, прошедших с начала Эпохи UNIX (1970-01-01 00:00:00)
 %%	символ %
 </tab>
@@ Строка 89: / Строка 89: @@
 [[Категория:{{SITENAME}}:Справка]]
 {{replicate-from-custiswiki-to-lib}}

← Предыдущая	Версия 01:00, 26 марта 2010
(нет различий)