编辑“TiddlyWiki/宏”

{{TiddlyWiki top}}

'''宏'''（Macro）是 [[TiddlyWiki]] 作者 Jeremy Ruston 新增的一个非常强大的功能。利用宏，我们可以在不修改任何原代码的情況下加入新功能。在 TiddlyWiki 里已经內建了很多有用的宏。另外有很多玩家也在他们的 wiki 里提供很多自家开发的宏。像 [http://homes.jcu.edu.au/~ccscb/mptw/ MonkeyPirateTiddlyWiki] 和 [http://checketts.objectis.net/wiki/ TiddlerWiki]。在台湾， [http://bram.cozysite.com/ptw/ BramChen] 也不遑多让的貢献他所制作的宏。

以下列出 TiddlyWiki 內建的宏：
==today==
*说明
显示目前的日期时间。
*用法
 <<today>>
*效果
现在在是 Fri Feb 24 2012 13:54:30 GMT+0800 (中国标准时间)
==tag==
*说明
产生一个下拉菜单，列出属于某个标签的所有 [[TiddlyWiki/Tiddler|Tiddler]] ，并可直接打开 Tiddler 或將该标签的所有 Tiddler 一次全部打开。
*用法
 产生"语法"标签的Tiddler菜单<<tag 语法>>
*效果
[[image:Tiddlywikitag.jpg|TiddlyWiki Tag宏语法|link=TiddlyWiki/宏]]

==newJournal==
*说明
建立一个创建日志的超级链接，通过这个超级链接，我们可以创建新的 Tiddler ，并直接产生日期组成的标题。适合用来建立日志式的 Tiddler 。侧边栏里的创建日志便是用这个內建宏产生的。
*用法
 <<newJournal 'DD MM YYYY'>>
*效果
[[image:tiddlywikinewj.jpg|TiddlyWiki newJournal宏语法|link=TiddlyWiki/宏]]

点击，出现如下的编辑框：

[[image:tiddlywikinewj2.jpg|TiddlyWiki newJournal宏语法|link=TiddlyWiki/宏]]

==newTiddler==
*说明
建立一个创建文章的超级链接，通过这个超级链接，我们可以创建新的 Tiddler 。侧边栏里的创建文章便是用这个內建宏产生的。
*用法
 <<newTiddler>>
*效果
[[image:tiddlywikinewt.jpg|TiddlyWiki newTiddler宏语法|link=TiddlyWiki/宏]]

点击后，显示如下编辑框：

[[image:tiddlywikinewt2.jpg|TiddlyWiki newTiddler宏语法|link=TiddlyWiki/宏]]

==tiddler==
*说明
这个宏让我们引用其它 Tiddler 的內容。我们可以用 Tiddler 随时记下小段落的內容，最后再利用这个宏將所有的 Tiddler 组织成一篇文章而不用將他们重写。像在Tiddler里面，我们就利用这个宏引用了 [[TiddlyWiki/FreeLink|FreeLink]] 这个 Tiddler 。
*用法
 <<tiddler TiddlyWiki>>
==slider==
*说明
这个宏的功能很好玩，可以把一個 Tiddler 制作成滑动式按键，用鼠标点击产生的按键链接，可以滑动式的展开或收缩 Tiddler 的內容。
*用法
 <<slider chkSlider '图片' '如何插入图片' '展开图片这 Tiddler'>>>

'''slider：'''这个宏的名称。
'''chkSlider：'''用来储存 slider 是展开或收缩状态的浏览器 cookie 变量名称。
'''图片：''' Tiddler 的标题。
'''如何插入图片：''' 产生的链接上显示的文字。
'''展开图片这 Tiddler：'''鼠标停在 slider 按键链接上会显示的说明文字。

==version==
*说明
这个宏的功能很简单，用来显示目前使用的 TiddlyWiki 的版本号。
*用法
 <<version>>
==list==
*说明
这个宏会依字母顺序將所有的 Tiddler 链接列出。中文的 Tiddler 标题大概是依中文字編碼顺序排序的吧。
*用法
 <<list>>
==tabs==
*说明
这个宏功能非常强大，可以让我们建立分页标签式的页面，每个分页标签负责显示一个 Tiddler 的內容。相对地，用法也比较复杂一点。(一点点而已啦！)
*用法
<pre>
<<tabs tabsClass
'什么是 WikiWord' '对 WikiWord 的介绍' WikiWord
'什么是 FreeLink' '对 FreeLink 的介绍' FreeLink
>>
</pre>

其中：

第一行

tabsClass 是用來来显示分页标签效果的 [[CSS]] 样式定义类別。可以在 StyleSheet 里自行定义。

其它行(以第二行为例说明)

'''什么是 WikiWord'''：产生的分頁页标签上的文字，当做标题使用。
'''对 WikiWord 的介绍'''：当鼠标停在分页标签上显示的说明文字。
'''FreeLink'''：这个分页标签要显示的 Tiddler 。

==Sparklines==
*说明
老实说，对 Sparklines 这个完全沒有概念。[[Google]] 了一下，在 http://sparkline.org/ 找到下面这段说明：

What Are Sparklines?Sparklines are "intense, simple, wordlike graphics" so named by Edward Tufte. In lieu of a more detailed introduction, Professor Tufte's site has an early release of a chapter on sparklines.

所以它是一种简单地、看起来像文字一样的图表。这个宏完全不需要用到任何的绘图函数库，便可以直接在 TiddlyWiki 里画出 Sparklines，只需要給他一堆数字即可。

*用法
 <<sparkline [numbers]>>

*注意
这个宏在TiddlyWiki v2.4.0 后已经从内建宏中移除，不过以通过 [http://www.tiddlywiki.com/coreplugins.html TiddlyWiki Core Plugins] 实现这个功能。

==gradient==
*说明
这个宏在不需要任何绘图函数库的情形下，可以画出水平渐变或垂直渐变背景色的文字标题。
*用法
 <<gradient vert #ffffff #ffdddd #ff8888>>垂直渐变背景色>>
 <<gradient horiz #ff8888 #ffdddd #ffffff>>水平渐变背景色>>
*效果
[[image:tiddlywikigrad.jpg|TiddlyWiki宏|link=TiddlyWiki/宏]]


除了內建宏之外，TiddlyWiki 可以让我们自己建立''自定义宏''，扩充额外的功能。

因为这里內容定位为''一般使用者''，也就是利用现成的 TiddlyWiki 功能，有关利用''自定义宏''功能的部份，请自行搜索和查阅相关网站。

==参考来源==
*http://www.twitter.com/togiga

{{TiddlyWiki}}

[[category:TiddlyWiki]]