View source for Calendar zh-tw

{{Calendar navigation}}

這是 '''DPL Calendar''' 的官方中文網頁。

== 概說 (Concept) ==
*如果您運用數個極受歡迎的外掛，則您即可以wiki語法來產生一個行事曆。(If you combine the power of some popular extensions it is possible to write a calendaring application completely in wiki code.)
*它相較於使用php程式設計的方式更為有彈性。(This is very flexible compared to php programming.)

==結構(Architecture)==

{{#wgraph: svg| thumb=90 |
 node Current_events {type cal}

 node 2007-09-28-Event_A {}
 node YYYY-10-04-Event_B   {}
 node 2007-10-19-Event_C   {}

 node Event                                     {type tpl}
 node CatEvent                                  {type category label Events}
 node CatHoliday                                {type category label Holiday}
 edge Event CatEvent                            {type cat}
 node Event_template                            {type editsample}
 node Event_intro                               {type editintro}
 edge Event_intro          Event_template       {kind rightnear type editintro}
 edge 2007-09-28-Event_A   Event                {type incl}
 edge YYYY-10-04-Event_B   Event                {type incl}
 edge YYYY-10-04-Event_B   CatHoliday           {type catgeory}
 edge 2007-10-19-Event_C   Event                {type incl}
 edge Event_template       2007-09-28-Event_A   {type edit}
 edge Event_template       YYYY-10-04-Event_B   {type edit}
 edge Event_template       2007-10-19-Event_C   {type edit}
 edge Event_template       Event                {type incl}

 edge Current_events       Calendar_month       {type incl}

 node Calendar_month                            {type tpl}
 node CalendarSingle                            {type tpl}
 node Calendar_link                             {type tpl}
 edge Calendar_month       2007-09-28-Event_A   {type dpl}
 edge Calendar_month       YYYY-10-04-Event_B   {type dpl}
 edge Calendar_month       2007-10-19-Event_C   {type dpl}
 edge Calendar_month       CalendarSingle       {type incl}
 edge CalendarSingle       Calendar_link        {type incl}
 edge CalendarSingle       Current_events       {type link label 'next month<br>prev. month' }

 node Calendar/MonthStartMon                    {type tpl}
 node Calendar/MonthStartTue                    {type tpl}

 edge CalendarSingle    Calendar/MonthStartMon  {type incl}
 edge CalendarSingle    Calendar/MonthStartTue  {type incl}

 nodetype tpl        {color yellow    }
 nodetype category   {color lightgreen}
 nodetype cal        {color lightblue }
 nodetype editsample {color lightcyan }
 nodetype editintro  {color lightcyan }
 nodetype *          {color #ffdddd bordercolor darkgray}

 edgetype incl  {color darkgray}
 edgetype link  {color blue}
 edgetype cat   {color darkgreen}
 edgetype dpl   {color red thickness 4 label 'DPL query'}
 edgetype edit  {linestyle dotted color blue}

 node.fontname helvR10
}}
* Templates are in yellow.
* The pages describing an event are in red. Their names must start with the date of the event (format: YYYY-MM-DD) or with 'YYYY-' plus month and day (for recurring yearly events).
* We use two edit helpers (in cyan) when event pages are created.
* The entry page for the calendar (''Current events'') is in blue. 
* Categories are in green.

The design is as follows:
# The user calls the entry page [[Current events zh-tw]]. Be careful if you change its name: The name of this page must be passed as an argument (named 'basepage') to the template 'Calendar month'.
# The basepage can be called by the user without any arguments. Then it uses a date function to calculate the current month. It can also be called from another calendar page - in which case the desired year & month are passed as parameters via the [[Call extension]]. There are more parameters for [[Current events]] - see the explanation below.
# Template 'Calendar month' ... 
#* shows the calendar box. The calendar box contains the titles of the event pages (the first part of the titles´ names which contain the resp. date is suppressed). Below the calendar there is an optional event list which shows either all events of the current month or all events regardless of month.
#* expects a 'purpose' parameter. If this parameter is set it acts as a filter, i.e. only events will be shown which belong to a category with the name of the 'purpose'. This allows you to have several calendars in parallel
#* uses a DPL query to find all articles in category 'Event' which belong to the selected year/month
#* shows the selected articles in a list, together with some selected chapters (like Participants ..) and with their categories
#* offers a link to create new events (using the edit template "Event template")


== 安裝(Installation) ==

=== 安裝外掛(Install extensions) ===

您需要：
# 從本站下載 (經由 [[Download]]頁面下載後解壓縮) 
#* DPL 外掛
#* Call 外掛
#* Inputbox 外掛 (此版本與官方版本有些許的差異)
#從 mediawiki.org：
#* [[mw:Extension:VariablesExtension]]
#* [[mw:Extension:StringFunctions]] -- 於本站內的版本[[StringFunctions extension|StringFunctions]]則為小幅度功能增強版本，其可使用正則表達式( regular expressions); 雖然並非必須，但還是建議您使用本站所提供之版本。 
#* [[mw:Extension:ParserFunctions]]

The process of installation is the same as always: create a directory per extension in the 'extension' folder and put a 'require_once' statement into your LocalSettings.php.

===安裝行事曆樣板(Install Calendar Templates)===

複製(Copy) / 貼上(paste)以下的頁面至[[Special:export]] 然後將此頁所產出的 XML 文字檔 匯入您的wiki:

<small>
 [[Current events zh-tw]]
 [[Template:Calendar month zh-tw]]
 [[Template:CalendarSingle zh-tw]]
 [[Template:Calendar link zh-tw]]
 [[Template:Calendar/MonthStartMon]]
 [[Template:Calendar/MonthStartTue]]
 [[Template:Calendar/MonthStartWed]]
 [[Template:Calendar/MonthStartThu]]
 [[Template:Calendar/MonthStartFri]]
 [[Template:Calendar/MonthStartSat]]
 [[Template:Calendar/MonthStartSun]]
 [[Template:!]]
 [[Template:(!]]
 [[Template:!)]]
 [[Event template zh-tw]]
 [[Event intro zh-tw]]
 [[Template:Event zh-tw]]
</small>

以下是英文版 (Followed pages are English version)
<small>
 [[Current events]]
 [[Template:Calendar month]]
 [[Template:CalendarSingle]]
 [[Template:Calendar link]]
 [[Template:Calendar/MonthStartMon]]
 [[Template:Calendar/MonthStartTue]]
 [[Template:Calendar/MonthStartWed]]
 [[Template:Calendar/MonthStartThu]]
 [[Template:Calendar/MonthStartFri]]
 [[Template:Calendar/MonthStartSat]]
 [[Template:Calendar/MonthStartSun]]
 [[Template:!]]
 [[Template:(!]]
 [[Template:!)]]
 [[Event template]]
 [[Event intro]]
 [[Template:Event]]
 [[Template:Create Event]]
</small>

=== 使用方式(Using the calendar) ===

建立一個用以描述紀事(events)的新文件，您可以點選行事曆上的日期數字或是以其他方式自行建置一個符合行事曆命名規範的文件。
*請依照下列的命名規範：頁面名稱須以日期(date)為起首 (如"YYYY-MM-DD"其後再加些簡短的描述。
*:例如： "2007-10-31 一些重要的事情"
*請記得該文件須隸屬於'Events'此一分類(category)，如果您在文件的第一行使用了"Event"樣板，則其自動完成此一設定。
*如有必要，您請可另行增加其他分類 (像是<tt><nowiki>[[Category:假日]]</nowiki></tt> )，這樣的話該資訊亦會顯示於行事曆下方的表格(event table)之中。
* 您可以'YYYY'的方式來定義每年一度重複性(yearly recurring events)的紀事。
*:例如"YYYY-12-24 耶誕夜"
* 同樣的您可以'YYYY-MM'的方式來定義每個月重複性(yearly recurring events)的紀事。
*: 例如"YYYY-MM-05 領薪水"

目前尚無法以其他方式定義經常性的紀事。

=== 客製化Customizing ===

如您想要客製化此一行事曆，請您撥冗查閱一下DPL的使用手冊(DPL manual)特別是[[include]] 參數及[[format]] 參數。在我們的範例中[[Template:calendar month zh-tw]], 設有：
<pre>
#主旨,#參加人員,#地點
</pre>

分別將顯示 ''Summary'', ''Participants'' 及 ''Location'' 等段落。(which means to take the content of ''Summary'', ''Participants'' and ''Location'' sections.)

You could modify the name of sections, the number of sections or even take the parameters of a template inside the event page. Again, see the DPL manual.

==Demo==
您可以如下的方式使用<nowiki>{{:Current events zh-tw|namespace=Test|purpose=Michael's events¦dpl group's event|width=500px}}</nowiki> 此行事曆有如下的參數(parameters)：
* year - 預設值為今年。
* month - 預設值為本月。
* purpose - 可不設定本參數，一經設定本參數後，則僅屬於指定分類(category)的紀事(events)才會被顯示出來，本項目可以設定多個項目，以管線符號(¦)來分隔多項。
* namespace - 可不設定本參數，一經設定本參數後，則僅屬於指定名字空間(namespace)的紀事(events)才會被顯示出來，且新增紀事時該頁面名稱也會配套的使用該名字空間。
* show - 可不設定本參數，或設定纪事頁面中的章節名稱(chpater name)，而該章節的內容則會在行事曆中被顯示出來，若內容含有圖片(images)時，該圖片亦會被顯示出來。
* eventList = {no|current|all}, 預設值為'current'；可產生一可表格式的報表來呈現您所指定的紀事(events)。
* width = 可不設定本參數，或指定一寬度值像是'500px' 或 '100%'; 預設值為將使您的行事曆以最小面積的方式來呈現。
* noadd = 可不設定本參數或可設為 '1'； 當您設定此一參數為'1'時，則此一行事曆將不會顯示可用於新增紀事的超連結(link)。
* nolink = 可不設定本參數或可設為 '1'； 當您設定此一參數為'1'時，則此一行事曆上的紀事將不會顯示可連到該頁面的超連結(link)而是由該日的日期提供您連至頁面所需的超連結，使用此一參數配合"eventList=no" 則是不合理的使用方式。如果此參數設為'1'則noadd參數也就設為'1'了。

{{:Current events}}
[[Category:Test]]