TiddlyWiki: Document Macros

 28th August 2020 at 11:52am

TiddlyWiki 文档宏

TiddlyWiki 的官方文档引入了一些文档宏,它们有助于表达。我把它的宏文件下载下来,放到了 Dropbox/Journey/Wiki/tiddlers/system/ 中,分别是 doc-macros.tiddoc-styles.tid 文件。

对于其他 tiddlywiki 想使用这个功能的,可以把下面两个链接拖到自己的 wiki 网页上 import 进去:

可以在 官方文档 查看 Documentation Macros 一节,有详细的描述。复制了里面常用的文档宏说明过来。

General

MacroUsed forExample
.defthe defining instance of a termwidget
.emminor emphasis within a sentencenot
.placea placeholder for the user to fill intagname
.strongmajor emphasis within a tiddlerImportant!
.worda mention of an ordinary word or phrase"hello world"

Advice

MacroUsed forExample
.tiphints and tips
Turn your screen on, otherwise
you won't be able to see much.
.warningwarning advice
Make a backup of your file
before you upgrade.
.infoimportant stuffs
Don't tell your password
to anyone.

.info 是我自己加的,用来作强调的作用。

注意这里有一些奇怪的问题,用这种方法排版,后面的那段文字会截断并错乱:

<<.tip "content"

用这种方式就不会:

<$macrocall $name=".tip" _="""content"""

会产生这个问题的文字:

这篇 tiddler 用了 list-before 宏,并赋给它一个空值,用于使它在 <<list-links "[tag[TiddlyWiki]]">> 中置于首位。

怀疑是各种符号转义带来的问题,暂时不想去深究。

Blocks

MacroUsed for
.preamblean introductory sentence that stands apart from the rest of the tiddler
这是一块开场白。