Date: Sun, 27 Jan 2002 17:28:55 -0500
Mime-Version: 1.0 (Produced by PhpWiki 1.3.2-jeffs-hacks)
X-Rcs-Id: $Id: CalendarPlugin,v 1.1 2004-04-29 23:59:07 rurban Exp $
Content-Type: application/x-phpwiki;
  pagename=CalendarPlugin;
  pgsrc_version="2 $Revision: 1.1 $";
  flags="";
  markup=2;
  charset=UTF-8
Content-Transfer-Encoding: binary

CalendarPlugin 可以用來在 wiki 頁面的月曆. 對 PersonalWiki~s 來說是很便利的.

在月曆裡的個別日期連結到一個特別名稱的 wiki 頁面.
"day pages"(日頁面)的名稱預設會以月曆存在頁面的名稱加上日期.

''此功能是從 [Manila|http://manila.userland.com/] 得到啟示,
並且首先由 GaryBenson 所實作. 後來則被 JeffDairiki 實作為 WikiPlugin.''

!!用法:

<verbatim>
<?plugin Calendar?>
</verbatim>

你將會得到:
<?plugin Calendar?>

--------

!! Plugin 引數

!月份的選擇

__year__:

  為月曆指定年. (預設: 目前的年份.)

__month__:

  為月曆指定月份. (預設: 目前的月份.)

__month_offset__:

  加到 ''month''. 可以用來含括好幾個月的月曆到一個 wiki 頁面.

  <?plugin Calendar month_offset=+1?>

!"Day Page" (日頁面)名稱

__date_format__:

  使用 [Strftime| php-function:strftime] 風格的格式字串來為 "day pages"
  產生頁面名稱.  預設值為 =%Y-%m-%d=.

__prefix__:

  Prepended to the date (formatted per ''date_format'') to generate
  the "day page" names. The default value is =~[pagename]/=.

!Appearance

__month_format__:

  使用 [Strftime| php-function:strftime] 風格的格式字串產生
  月曆的標題. (預設為 =%B, %Y=.)

__wday_format__:

  使用 [Strftime| php-function:strftime] 風格的格式字串產生
  在月曆上頭的 day-of-week 名稱.

__start_wday__:

  每週是由那一天開始.  這會是一個介於 0 (Sunday)到 6(Saturday) 的整數.

  <?plugin Calendar start_wday=1 ?>

-----

! Patch for 1.2

GaryBenson wrote the first calendar implementation for PhpWiki 1.2.
(Since 1.2 doesn't support plugins, it uses a =###CALENDAR###= token
as a trigger.) Gary provides a screenshot at
http://inauspicious.org/files/screenshots/calender.png|screenshot, a
[patch|http://inauspicious.org/files/phpwiki/phpwiki-1.2.0-calendar.patch]
(on 1.2.0), and
[calendar.php|http://inauspicious.org/files/phpwiki/calendar.php]
(which renders a view of the year.)

----

PhpWikiDocumentation