Расширение:SimpleCalendar

From mediawiki.org
This page is a translated version of the page Extension:SimpleCalendar and the translation is 97% complete.
This extension is maintained by a member of the MediaWiki Stakeholders' Group .
Справка по расширениям MediaWiki
Simple Calendar
Статус релиза: стабильно
Реализация Функция парсера
Описание Предоставляет очень простое расширение календаря , которое делает таблицу всех месяцев в году с каждым днем статьей в вики
Автор(ы) Aran Dunkley (Nadобсуждение)
Поддерживающий(ие) Osnardобсуждение
Последняя версия 1.4.0 (2021-06-14)
Политика совместимости В расширении есть соответствуюшая ветвь для каждого релиза MediaWiki, который является релизом долгосрочной поддержки (Long Term Support release).
MediaWiki 1.25+
Composer mediawiki/simple-calendar
Лицензия GNU General Public License 2.0 или позднее
Скачать
Ежеквартальные загрузки 31 (Ranked 114th)
Переведите расширение SimpleCalendar

Расширение SimpleCalendar - это очень простое расширение Calendar , которое делает таблицу всех месяцев в году с каждым днем статьей в вики. Дни, в которых нет страницы, появляются как красная ссылка, нажатие на нее создаст новую статью, как обычно. Он устанавливается как функция анализатора, поэтому используется следующий синтаксис:

{{#calendar:}}

При использовании без параметров, календарь всех двенадцати месяцев будет отображаться с указанием на каждый день статьи с использованием даты как его заголовка.

Установка

  • Скачайте и распакуйте файл(ы) в папку с названием SimpleCalendar в вашей папке extensions/.
    Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SimpleCalendar
  • Добавьте следующий код в конце вашего файла LocalSettings.php :
    wfLoadExtension( 'SimpleCalendar' );
    
  • Yes Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.


Использование

Parameters

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

  • title — Название статьи, к которому каждый день в таблице календаря соединяется, по умолчанию является датой, например 27 Jan 2008. Если вы хотите иметь разные календари для разных целей, то параметр заголовка будет предшествовать названиям с отдельным слайд-харектором, например, установка title на "Harry" приведет к форматированию дат как Harry/27 Jan 2008.
  • year — Это изменяет год календарной таблицы, по умолчанию, если год не указан,на - текущий год.
  • month — Если месяц будет указан, то вместо таблицы, содержащей все двенадцать месяцев, будет предоставлен только один месяц.
  • query — Это позволяет дополнительно присоединять информацию по строкам запросов к ссылкам в течение нескольких дней, которые не существуют. Основное использование этого расширения будет позволять загружать небольшое количество контента в недавно созданных статьях календаря. См. примеры ниже. Синтаксис выглядит немного странно, потому что в нем есть два равных символа.
  • format — Формат дата по умолчанию для дата-статей, связанных с днями в таблицах календаря, является, например, 2 February 1972, но может быть скорректирован путем предоставления формата даты PHP в параметре format. См. PHP Manual - strftime для подробностей о том, как указать формат даты.
  • dayformat — Это определяет формат названий каждого дня недели в верхней части таблиц месяца. The default setting is M T W T F S S, but can be set to %a for abbreviated names in the current language such as Mon Tue..., or %A for full names in the current language.

CSS

Расширение устанавливает собственный CSS, который форматирует таблицы, как показано на примере изображений. Вы можете добавить новые правила, чтобы приспособить таблицы к вашим собственным потребностям. По умолчанию CSS, который он устанавливает, следующий.

table.calendar       { margin: 0; padding: 10px; }
table.calendar td    { margin: 0; padding: 2px; vertical-align: top; }
table.calendar th    { padding: 2px; background-color: #ddd; color: #666; text-align: center; font-size: 120%; font-weight: bold; border: none; }
table.month          { border: 2px solid #ccc; }
table.month .dow th  { color: #aaa; text-align: center; font-size: 110%; }
table.month td.today { background-color:#ddd; }
table.month td {
	border: none;
	margin: 0;
	padding: 1pt 1.5pt;
	font-weight: bold;
	font-size: 8pt;
	text-align: right;
	background-color: #eee;
	}
table.month td.day-active a { color: #217A28; }
table.month td.day-empty  a { color: #cc0000; }

Примеры

Примерный календарь за январь 2024 года
В приведенных выше примерах используется переменная CURRENTUSER, которая не установлена по умолчанию. Если вы хотите добавить переменные, посмотрите Расширение:MyVariables
{{#calendar: title={{CURRENTUSER}} }}
{{#calendar: title={{CURRENTUSER}} | year=2001 }}
{{#calendar: year=2007 | month=jan | title={{CURRENTUSER}} }}


Этот пример показывает таблицу мая текущего года

{{#calendar: month=05 }}


в этом примере используется новый параметр query для предварительного загрузки статьи шаблона NewDay в недавно созданные даты. Это выглядит немного запутанным, но он говорит: добавить "preload=template" к ссылке

{{#calendar: query=preload=Template:NewDay }}

Журнал изменений

  • Version 1.4.0 (2021-06-14): Code refactoring; Compatility to modern MW versions.
  • Version 1.3.0 (2015-06-22): Uses the new Extension registration system for loading.
  • Version 1.2.11 (2015-06-19): Includes the default CSS in the extension now
  • Version 1.2.10 (2015-05-10): Fixed up lazy HTML and fixed default date format to work on Windows servers
  • Version 1.2.4 (2007-10-18): Don't die if generated title is invalid
  • Version 1.2.3 (2007-10-13): Use language settings for day and month names and add dayformat parameter
  • Version 1.2 (2007-05-03): Added format parameter.
  • Version 1.1 (2007-05-02): Changed to named parameters and added the query parameter. The style of the day-links are now handled by two new CSS classes, day-active and day-empty.