## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnMacros/MonthCalendar
##master-date:2010-05-14T18:02:05Z
#acl -All:write Default
#format wiki
#language ru

= Макрокоманда MonthCalendar =

<<TableOfContents>>

Данная макрокоманда предназначена для тех, кто использует МойнМойн как хранилище персональных данных (в том числе, ежедневных записей) и нуждается в интеграции календаря в вики.

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

{{{
<<MonthCalendar(БазоваяСтраница, год, месяц, смещение месяца, смещение месяца в ссылках, высота6, годовой календарь, шаблон)>>
}}}

||<rowbgcolor="#ffffcc"> '''Название параметра''' || '''Возможные значения''' || '''Значение по умолчанию''' || '''Описание''' ||
|| !БазоваяСтраница                               || имя страницы             || текущая страница            || Базовая страница для записей календаря. Можно указывать несколько страниц через `*`. ||
|| год                                            || целое число              || текущий год                 || Год, отображаемый в календаре. ||
|| месяц                                          || `1`..`12`                || текущий месяц               || Месяц для отображения в календаре. См. также `смещение месяца`, `смещение месяца в ссылках`. ||
|| смещение месяца                                || целое число              || `0`                         || Смещение, добавляемое к месяцу при отображении. ||
|| смещение месяца в ссылках                      || целое число              || `0`                         || Смещение, кумулятивно со значением параметра `смещение месяца` добавляемое к ссылкам навигации в календаре (переход на следующий/предыдущий месяц/год). ||
|| высота6                                        || `0` или `1`              || `0`                         || Выравнивание календаря по высоте в 6 строк (полезно для календарей на несколько месяцев). ||
|| годовой календарь                              || `0` или `1`              || `0`                         || Годовой календарь (календарь, где ссылки не содержат год; полезно для дней рождения и других ежегодно повторяющихся событий). ||
|| шаблон                                         || имя страницы             || —                           || Страница шаблона, используемого для добавления новых записей при переходе по ссылкам календаря. ||

Любой из параметров может быть быть пустым, при этом он будет иметь значение по умолчанию.

Когда событие присутствует в календаре (существует соответствующая дате вложенная страница), его дата будет выделена, и при наведении на неё будет появляться всплывающее сообщение. В его теле будет находиться содержимое заголовков первого уровня.

== Примеры ==

=== Отображение календаря на один месяц ===

||||||<style="border:none; text-align:left"> <<BR>>Простейший вариант: ||
||<bgcolor="#ffffcc"> '''Разметка'''            ||<bgcolor="#ffffcc"> '''Результат'''         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar>>`                          || <<MonthCalendar>>                          ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> <<BR>>Календарь предыдущего месяца для страницы "!ДругойПользователь" выглядит следующим образом: ||
||<bgcolor="#ffffcc"> '''Разметка'''            ||<bgcolor="#ffffcc"> '''Результат'''         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(ДругойПользователь,,,-1)>>` || <<MonthCalendar(ДругойПользователь,,,-1)>> ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> <<BR>>Календарь для пользователя !КакойТоПользователь на декабрь текущего года: ||
||<bgcolor="#ffffcc"> '''Разметка'''            ||<bgcolor="#ffffcc"> '''Результат'''         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(КакойТоПользователь,,12)>>` || <<MonthCalendar(КакойТоПользователь,,12)>> ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> <<BR>>Календарь для текужей страницы, декабрь этого года: ||
||<bgcolor="#ffffcc"> '''Разметка'''            ||<bgcolor="#ffffcc"> '''Результат'''         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(,,12)>>`                    || <<MonthCalendar(,,12)>>                    ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> <<BR>>Календарь на декабрь 2001 года: ||
||<bgcolor="#ffffcc"> '''Разметка'''            ||<bgcolor="#ffffcc"> '''Результат'''         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(,2001,12)>>`                || <<MonthCalendar(,2001,12)>>                ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> <<BR>>Календарь на месяц, идущий через один после декабря 2001 год (малопрактично, но возможно) ||
||<bgcolor="#ffffcc"> '''Разметка'''            ||<bgcolor="#ffffcc"> '''Результат'''         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(,2001,12,+2)>>`             || <<MonthCalendar(,2001,12,+2)>>             ||<style="border:none; width:99%"> ||

=== Календарь на год ===
Календарь на 2002 год (каждый месяц выровнен по высоте в 6 строк):

==== Разметка ====
{{{
||||||||<bgcolor="#ffffcc"> '''2002 год'''                                                              ||
|| <<MonthCalendar(,2002,1,,,1)>>  || <<MonthCalendar(,2002,2,,,1)>>  ||<<MonthCalendar(,2002,3,,,1)>>  ||
|| <<MonthCalendar(,2002,4,,,1)>>  || <<MonthCalendar(,2002,5,,,1)>>  ||<<MonthCalendar(,2002,6,,,1)>>  ||
|| <<MonthCalendar(,2002,7,,,1)>>  || <<MonthCalendar(,2002,8,,,1)>>  ||<<MonthCalendar(,2002,9,,,1)>>  ||
|| <<MonthCalendar(,2002,10,,,1)>> || <<MonthCalendar(,2002,11,,,1)>> ||<<MonthCalendar(,2002,12,,,1)>> ||
}}}

==== Результат ====
{{{#!wiki dashed
||||||||<bgcolor="#ffffcc"> '''2002 год'''                                                              ||
|| <<MonthCalendar(,2002,1,,,1)>>  || <<MonthCalendar(,2002,2,,,1)>>  ||<<MonthCalendar(,2002,3,,,1)>>  ||
|| <<MonthCalendar(,2002,4,,,1)>>  || <<MonthCalendar(,2002,5,,,1)>>  ||<<MonthCalendar(,2002,6,,,1)>>  ||
|| <<MonthCalendar(,2002,7,,,1)>>  || <<MonthCalendar(,2002,8,,,1)>>  ||<<MonthCalendar(,2002,9,,,1)>>  ||
|| <<MonthCalendar(,2002,10,,,1)>> || <<MonthCalendar(,2002,11,,,1)>> ||<<MonthCalendar(,2002,12,,,1)>> ||
}}}

=== Другие примеры ===
||||||<style="border:none; text-align:left"> <<BR>>Календарь для страниц !МояСтраница, Пользователь1, Пользователь2: ||
||<bgcolor="#ffffcc"> '''Разметка'''                            ||<bgcolor="#ffffcc"> '''Результат'''                         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(МояСтраница*Пользователь1*Пользователь2)>>` || <<MonthCalendar(МояСтраница*Пользователь1*Пользователь2)>> ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> <<BR>>Календари вложенных страниц: ||
||<bgcolor="#ffffcc"> '''Разметка'''                            ||<bgcolor="#ffffcc"> '''Результат'''                                         ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(МоёИмя/ЛичныеДела)>>`                       || <<MonthCalendar(МоёИмя/ЛичныеДела)>>                    ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(МоёИмя/РабочиеДела)>>`                      || <<MonthCalendar(МоёИмя/РабочиеДела)>>                   ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(МоёИмя/ЛичныеДела*МоёИмя/РабочиеДела)>>`    || <<MonthCalendar(МоёИмя/ЛичныеДела*МоёИмя/РабочиеДела)>> ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> <<BR>>Годовой календарь: ||
||<bgcolor="#ffffcc"> '''Разметка'''                            ||<bgcolor="#ffffcc"> '''Результат'''                                             ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(СобытияЗаГод,,,+1,,1,1)>>`                  || <<MonthCalendar(СобытияЗаГод,,,+1,,1,1)>>               ||<style="border:none; width:99%"> ||
||||||<style="border:none; text-align:left"> Страницы событий при этом имеют формат СобытияЗаГод/ММ-ДД. Это позволяет хранить информацию о днях рождения и прочих событиях, дабы не создавать записи о них каждый год. ||
||||||<style="border:none; text-align:left"> <<BR>>В этом примере для создания новых страниц будет использоваться шаблон !ШаблонСобытиеКалендаря: ||
||<bgcolor="#ffffcc"> '''Разметка'''                            ||<bgcolor="#ffffcc"> '''Результат'''                      ||<style="border:none; width:99%"> ||
|| `<<MonthCalendar(,,,,,,,ШаблонСобытиеКалендаря)>>`           || <<MonthCalendar(,,,,,,,ШаблонСобытиеКалендаря)>>        ||<style="border:none; width:99%"> ||

см. также: ПомощьПоМакроКомандам.
