TiddlyWiki Style

１．はじめに

Tue, 28 Nov 2006 22:42:56 GMT

説明

TiddlyWikiは、サーバを必要としないローカルWikiシステムです。最大の特長は、「単一のファイルだけでできている」という点にあり、ロジックもユーザインタフェースもコンテンツも、すべてたったひとつのファイルに含まれています。
そのためTiddlyWikiは、テキストファイルの気軽さと、Wikiサーバの便利さの両方を兼ね備えています。

ローカルWikiとはいうものの、そのファイルをサーバにアップロードして、インターネット経由で見ることもできます（書き込みは不可）。このサイトもTiddlyWikiで作られています。

オープンソースライセンスのソフトウェアであり、誰でも自由にダウンロードして使うことができます。

公式サイト

TiddlyWiki a reusable non-linear personal web notebook
http://www.tiddlywiki.com/

公式サイトの紹介文

公式サイトに載っている作者自身による紹介文を翻訳してみました。

TiddlyWikiとは
TiddlyWikiはブログに似て、小さな独立した記事から構成されています。しかしそれは時系列的に読むよりもハイパーリンクをたどって読むのに適しています。いうなれば個々のコンテンツが有機的にリンクした非連続的なブログです。
私はTiddlyWikiが新しい記述メディアとなり、独自の記述スタイルを形成することを望んでいます。

主な機能
初期状態のTiddlyWikiには以下のような機能があります。
Windows、Mac、Linux上のほとんどのブラウザで表示が可能
以下のブラウザでは保存機能の使用が可能
Firefox (Windows, OS X)
InternetExplorer (Windows)
Opera (全OS)
Safari、Camino (OS X)
Minimo (Nokia 770)
各種書式整形機能（等幅フォント表示、文字装飾、非Wikiワードのリンク、Wikiワードのエスケープ、明示的リンク、見出し、並列リスト、順序付リスト、テーブル、引用文、水平線、およびスタイルシート設定）
多くのインタフェースオプション（RSSフィード生成、バックアップ、オートセーブ等）
ショートカットキー機能（Ctrl-Enterで編集終了、ESCでキャンセル等）
インラインHTML
画像の貼り付け
マクロ機能による豊富な表現力（グラデーション、スパークライン等）
利用しやすいオープンソースライセンス
カスタムスタイルシートによりCSSレイアウトの変更が可能
URLに起動パラメータを指定することにより起動時の処理を制御可能
各国語への翻訳版（中国語、フランス語、ドイツ語、スペイン語、ポルトガル語等）
TiddlyWikiのコミュニティは、各種プラグインや改変によってこれらの基本機能の拡張をおこなってきました。

次：２．TiddlyWikiのできることできないこと

JapaneseTranslation

Tue, 21 Nov 2006 17:02:00 GMT

Name:	JapaneseTranslation
Description:	Japanese translation of TiddlyWiki messages based on here
Version:	1.0.1
Date:	Nov 15, 2006
Source:	http://www.geocities.jp/wikistyle/#JapaneseTranslation
Author:	style
License:	BSD open source license
CoreVersion:	2.1.0
Browser:

if (config.options.txtUserName == "YourName")
	merge(config.options,{txtUserName: "名無しさん"});

merge(config.messages,{
	customConfigError: "プラグインロード中にエラーが発生しました。PluginManagerを参照してください",
	pluginError: "Error: %0",
	pluginDisabled: "'systemConfigDisable'タグにより無効に設定されています",
	pluginForced: "'systemConfigForce'タグにより強制的に有効になっています",
	pluginVersionError: "このプラグインを実行するためには新しいバージョンのTiddlyWikiが必要です",
	nothingSelected: "先に対象を選択してください",
	savedSnapshotError: "このTiddlyWikiファイルは正しく保存されていません。http://www.tiddlywiki.com/#DownloadSoftware を参照してください",
	subtitleUnknown: "(不明)",
	undefinedTiddlerToolTip: "'%0'という記事はありません",
	shadowedTiddlerToolTip: "'%0'という記事はありませんが、システム用に予約されています",
	tiddlerLinkTooltip: "%0 - %1, %2",
	externalLinkTooltip: "(外部リンク) %0",
	noTags: "タグの設定されていない記事",
	notFileUrlError: "セーブ機能はローカルのTiddlyWikiファイルに対してのみ使用できます",
	cantSaveError: "セーブに失敗しました。このブラウザが対応していないか（Firefox推奨）、ファイルのパス名に使用できない文字が含まれています",
	invalidFileError: "元のファイル '%0' は正常なTiddlyWikiのファイルではありません",
	backupSaved: "バックアップファイルを保存しました",
	backupFailed: "バックアップファイルの保存に失敗しました",
	rssSaved: "RSSフィードを保存しまし",
	rssFailed: "RSSフィードの保存に失敗しました",
	emptySaved: "空のテンプレートファイルを保存しました",
	emptyFailed: "空のテンプレートファイルの保存に失敗しました",
	mainSaved: "TiddlyWikiファイルを保存しました",
	mainFailed: "TiddlyWikiファイルの保存に失敗しました。修正内容は保存されていません",
	macroError: "マクロ実行時エラー： <<%0>>",
	macroErrorDetails: "マクロ実行中にエラーが発生しました。<<%0>>:\n%1",
	missingMacro: "そのようなマクロはありません",
	overwriteWarning: "'%0'という記事はすでに存在します。OKを選択すると上書きします",
	unsavedChangesWarning: "警告！ 保存されていない変更が存在します。\n\nOKを選択：保存\nCancelを選択：編集内容を破棄",
	confirmExit: "--------------------------------\n\n変更が保存されていません。このまま終了すると変更内容が失われます\n\n--------------------------------",
	saveInstructions: "SaveChanges",		// このタイトルのtiddlerを用意しておくと保存失敗時に自動的に表示される
	unsupportedTWFormat: "TiddlyWikiでサポートされていないフォーマットです '%0'",
	tiddlerSaveError: "セーブ時にエラーが発生しました '%0'",
	tiddlerLoadError: "ロード時にエラーが発生しました '%0'",
	wrongSaveFormat: "ストレージフォーマットはセーブできません '%0'. 標準フォーマットを使用してください",
	invalidFieldName: "不正なフィールド名です %0",
	fieldCannotBeChanged: "フィールド '%0' は変更できません"});

merge(config.messages.messageClose,{
	text: "閉じる",
	tooltip: "このメッセージエリアを閉じます"});

config.messages.dates.months = ["1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月","12月"];
config.messages.dates.days = ["日", "月", "火", "水", "木", "金", "土"];
config.messages.dates.shortMonths = ["1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月","12月"];
config.messages.dates.shortDays = ["日", "月", "火", "水", "木", "金", "土"];

merge(config.views.wikified.tag,{
	labelNoTags: "タグはありません",
	labelTags: "タグ: ",
	openTag: "タグ '%0' を開く",
	tooltip: "タグ'%0'の関連記事を表示します",
	openAllText: "全て開く",
	openAllTooltip: "これらの記事をすべて開きます",
	popupNone: "タグ'%0'はこれ以外の記事には設定されていません"});

merge(config.views.wikified,{
	defaultText: "'%0'は存在しません。ダブルクリックで作成できます",
	defaultModifier: "(未定義)",
	shadowModifier: "(システム)",
	createdPrompt: "作成日"});

merge(config.views.editor,{
	tagPrompt: "下段にはスペース区切りでタグ名を入力します。スペースを含むタグ名は[[括弧で 囲みます]]。また、既存タグ名からの選択も可能です。»",
	defaultText: "'%0'の内容を入力してください"});

merge(config.views.editor.tagChooser,{
	text: "タグ",
	tooltip: "既存のタグから追加するものを選択してください",
	popupNone: "タグが設定されていません",
	tagTooltip: "タグ'%0'を追加します"});

merge(config.macros.search,{
	label: "検索",
	prompt: "このTiddlyWiki内を検索します",
	accessKey: "F",
	successMsg: "%0 件見つかりました。- %1",
	failureMsg: "%0 に該当する記事はありません"});

merge(config.macros.tagging,{
	label: "タグ",
	labelNotTag: "タグなし",
	tooltip: "タグ'%0'のついた記事一覧"});

merge(config.macros.timeline,{
	dateFormat: "YYYY年MM月DD日"});

merge(config.macros.allTags,{
	tooltip: "タグ'%0'のついた記事を全て表示します",
	noTags: "タグが設定されていません"});

config.macros.list.all.prompt = "アルファベット順の記事一覧";
config.macros.list.missing.prompt = "存在しない記事一覧";
config.macros.list.orphans.prompt = "リンクされていない記事一覧";
config.macros.list.shadowed.prompt = "システム設定用記事一覧";

merge(config.macros.closeAll,{
	label: "全て閉じる",
	prompt: "編集中以外の全ての記事を閉じます"});

merge(config.macros.permaview,{
	label: "ビューのURL",
	prompt: "現在の表示状態を示すURLをアドレス欄に表示します"});

merge(config.macros.saveChanges,{
	label: "保存",
	prompt: "すべての記事を保存します",
	accessKey: "S"});

merge(config.macros.newTiddler,{
	label: "新規作成",
	prompt: "新しい記事を作成します",
	title: "新規記事",
	accessKey: "N"});

merge(config.macros.newJournal,{
	label: "新規日記",
	prompt: "新しい記事を現在の日付をタイトルとして作成します",
	accessKey: "J"});

merge(config.macros.plugins,{
	skippedText: "（無効：追加後にリロードされていません）",
	noPluginText: "プラグインがひとつもインストールされていません",
	confirmDeleteText: "本当にこれらの記事を削除しますか？:\n\n%0",
	listViewTemplate : {
		columns: [
			{name: 'Selected', field: 'Selected', rowName: 'title', type: 'Selector'},
			{name: 'Title', field: 'title', tiddlerLink: 'title', title: "タイトル", type: 'TiddlerLink'},
			{name: 'Forced', field: 'forced', title: "強制ロード", tag: 'systemConfigForce', type: 'TagCheckbox'},
			{name: 'Disabled', field: 'disabled', title: "無効", tag: 'systemConfigDisable', type: 'TagCheckbox'},
			{name: 'Executed', field: 'executed', title: "ロード", type: 'Boolean', trueText: "済", falseText: "未"},
			{name: 'Error', field: 'error', title: "ロード結果", type: 'Boolean', trueText: "Error", falseText: "OK"},
			{name: 'Log', field: 'log', title: "説明", type: 'StringList'}
			],
		rowClasses: [
			{className: 'error', field: 'error'},
			{className: 'warning', field: 'warning'}
			],
		actions: [
			{caption: "（処理の選択）", name: ''},
			{caption: "指定記事からsystemConfigタグを削除", name: 'remove'},
			{caption: "指定記事を永久に削除", name: 'delete'}
			]}
	});

merge(config.macros.refreshDisplay,{
	label: "再描画",
	prompt: "TiddlyWiki画面を再描画します"
	});

merge(config.macros.importTiddlers,{
	defaultPath: "http://www.tiddlywiki.com/index.html",
	fetchLabel: "記事一覧取得",
	fetchPrompt: "指定したTiddlyWikiファイルから記事一覧を取得します",
	fetchError: "記事一覧取得処理中にエラーが発生しました",
	confirmOverwriteText: "記事の内容を上書きしますか？:\n\n%0",
	wizardTitle: "記事のインポート",
	step1: "ステップ１: インポート元TiddlyWikiファイルの指定",
	step1prompt: "URLまたはパス名の入力: ",
	step1promptFile: "またはファイル参照: ",
	step1promptFeeds: "または定義済フィードから選択: ",
	step1feedPrompt: "（選択）",
	step2: "ステップ２: TiddlyWikiファイルの読み込み",
	step2Text: "ファイルを読み込んでいます。しばらくお待ちください: %0",
	step3: "ステップ３: インポート対象記事の選択",
	step4: "%0 個の記事がインポートされました",
	step5: "インポート完了",
	listViewTemplate: {
		columns: [
			{name: 'Selected', field: 'Selected', rowName: 'title', type: 'Selector'},
			{name: 'Title', field: 'title', title: "タイトル", type: 'String'},
			{name: 'Snippet', field: 'text', title: "内容", type: 'String'},
			{name: 'Tags', field: 'tags', title: "タグ", type: 'Tags'}
			],
		rowClasses: [
			],
		actions: [
			{caption: "（処理の選択）", name: ''},
			{caption: "マークした記事をインポートする", name: 'import'}
			]}
	});

merge(config.commands.closeTiddler,{
	text: "閉じる",
	tooltip: "この記事を閉じます"});

merge(config.commands.closeOthers,{
	text: "他を閉じる",
	tooltip: "この記事以外を全て閉じます"});

merge(config.commands.editTiddler,{
	text: "編集",
	tooltip: "この記事を編集します",
	readOnlyText: "表示",
	readOnlyTooltip: "この記事のソースを表示します"});

merge(config.commands.saveTiddler,{
	text: "決定",
	tooltip: "編集内容を確定します"});

merge(config.commands.cancelTiddler,{
	text: "取消",
	tooltip: "編集内容を破棄します",
	warning: "編集内容を破棄しますか '%0'?",
	readOnlyText: "終了",
	readOnlyTooltip: "通常表示に戻ります"});

merge(config.commands.deleteTiddler,{
	text: "削除",
	tooltip: "この記事を削除します",
	warning: "本当にこの記事を削除しますか '%0'?"});

merge(config.commands.permalink,{
	text: "記事のURL",
	tooltip: "この記事を示すURLをアドレス欄に表示します"});

merge(config.commands.references,{
	text: "リンク元",
	tooltip: "この記事にリンクしている記事一覧を表示します",
	popupNone: "リンクされていません"});

merge(config.commands.jump,{
	text: "ジャンプ",
	tooltip: "表示中の他の記事へ移動します"});

merge(config.shadowTiddlers,{
	DefaultTiddlers: "GettingStarted",
	MainMenu: "GettingStarted",
	SiteTitle: "My TiddlyWiki",
	SiteSubtitle: "a reusable non-linear personal web notebook",
	SiteUrl: "http://www.tiddlywiki.com/",
	GettingStarted: "TiddlyWikiを開始するためには、まず以下のシステム設定用記事を編集してください:\n*SiteTitleとSiteSubtitle: このページのタイトル、サブタイトル。また、セーブ後はブラウザのタイトルバーにも表示されます。\n*MainMenu: 通常左側に表示されるメインメニュー\n*DefaultTiddlers: このTiddlyWikiを開いたときに最初に表示する記事。\n署名として使用するあなたの名前を入力してください:<<option txtUserName>>",
	SideBarOptions: "<<search>><<closeAll>><<permaview>><<newTiddler>><<newJournal 'YYYY年MM月DD日'>><<saveChanges>><<slider chkSliderOptionsPanel OptionsPanel '設定 »' 'Change TiddlyWiki advanced options'>>",
	OptionsPanel: "これらのインタフェース設定はご使用のブラウザ内に保存されます。\n\n署名として使用するあなたの名前をWikiWord形式(例 JoeBloggs)で入力してください。\n\n<<option txtUserName>>\n<<option chkSaveBackups>> バックアップ取得\n<<option chkAutoSave>> 自動保存\n<<option chkRegExpSearch>> 正規表現による検索\n<<option chkCaseSensitiveSearch>> 英文字大小区別検索\n<<option chkAnimate>> アニメーション\n\n----\n[[詳細設定|AdvancedOptions]]\n[[プラグインマネージャ|PluginManager]]\n[[記事のインポート|ImportTiddlers]]",
	AdvancedOptions: "<<option chkGenerateAnRssFeed>> RSSフィード生成\n<<option chkOpenInNewWindow>> 新しいウィンドウでリンクを開く\n<<option chkSaveEmptyTemplate>> 空のテンプレートファイル(empty.html)を保存する\n<<option chkToggleLinks>> 既に開いている記事をクリックした時に閉じる\n^^(Ctrl+クリック等のキーアサインを変更します)^^\n<<option chkHttpReadOnly>> HTTP経由でのアクセス時に編集機能を隠す\n<<option chkForceMinorUpdate>> マイナーチェンジモードをデフォルトとする\n^^(Shift+'決定'やCtrl-Shift-Enterのキーアサインを変更します)^^\n<<option chkConfirmDelete>> 削除前に確認する\n記事編集エディットボックスの高さ: <<option txtMaxEditRows>>\nバックアップ保存用フォルダ: <<option txtBackupFolder>>\n<<option chkInsertTabs>> タブキーをタブ文字入力用に使用する（デフォルトではフィールド移動）",
	SideBarTabs: "<<tabs txtMainTab '更新順' '更新順に表示する' TabTimeline '全て' '全ての記事一覧' TabAll 'タグ' 'タグ一覧' TabTags 'その他' 'その他の記事' TabMore>>",
	TabTimeline: "<<timeline>>",
	TabAll: "<<list all>>",
	TabTags: "<<allTags>>",
	TabMore: "<<tabs txtMoreTab '未定義' 'リンクされているが存在しない記事一覧' TabMoreMissing '未参照' 'どこからもリンクされていない記事一覧' TabMoreOrphans 'システム' 'システム設定用記事一覧' TabMoreShadowed>>",
	TabMoreMissing: "<<list missing>>",
	TabMoreOrphans: "<<list orphans>>",
	TabMoreShadowed: "<<list shadowed>>",
	PluginManager: "<<plugins>>",
	ImportTiddlers: "<<importTiddlers>>"});

//-----------------------------------------

merge(config.shadowTiddlers, {
	ViewTemplate: "<!--{{{-->\n<div class='toolbar' macro='toolbar closeTiddler closeOthers +editTiddler permalink references jump'></div>\n<div class='title' macro='view title'></div>\n<div class='subtitle'><span macro='view modifier link'></span>, <span macro='view modified date [[YYYY年0MM月0DD日]]'></span> (<span macro='message views.wikified.createdPrompt'></span> <span macro='view created date [[YYYY年0MM月0DD日]]'></span>)</div>\n<div class='tagging' macro='tagging'></div>\n<div class='tagged' macro='tags'></div>\n<div class='viewer' macro='view text wikified'></div>\n<div class='tagClear'></div>\n<!--}}}-->"});

Link

Tue, 21 Nov 2006 17:02:00 GMT

公式サイト（英語）

（一般）
TiddlyWiki
　http://www.tiddlywiki.com/
TiddlyWiki Google Group
　http://groups-beta.google.com/group/TiddlyWiki
（開発）
TiddlyWiki.org
　http://trac.tiddlywiki.org/tiddlywiki
TiddlyWikiDev Google Group
　http://groups-beta.google.com/group/TiddlyWikiDev

Tips（英語）

TiddlyWikiTips.com
　http://tiddlywikitips.com/

日本語解説サイト

TiddlyWikiのススメ
　http://hsj.jp/junknews/archives/tiddlywiki_susume.html
MemoWiki
　http://flow.dip.jp/mt/archives/u/twmemo.html
TiddlyWiki
　http://watcher.moe-nifty.com/memo/2005/09/tiddlywiki__f8c6.html
素敵なTiddlyWiki - カスタマイズノート第２版
　http://www.potto.client.jp/
TiddlyWiki関連リンク集:パンパでガウチョ
　http://blog.livedoor.jp/kyorecoba/archives/26481931.html
各種メモ - tsupo の第5のメモ
　http://www.na.rim.or.jp/~tsupo/wiki/
WikiSample
　http://www1.tcnet.ne.jp/leo/Files/TiddlyWiki/TiddlyWiki.html

その他

フリー画像素材 EyesPic
　http://eyes-art.com/pic/
　このサイトの画像はこちらの素材を使用させていただいています。

TopPage

Thu, 05 Oct 2006 23:01:00 GMT

TiddlyWikiについていろいろ書いていきます。

本サイトで使用する用語は、できるだけ分かりやすい日本語に訳すようにしています。tiddlerのことは「記事」、tagは文脈によって「タグ」または「カテゴリー」と表記しています。

2006.10.6
ver2.1.xにアップグレードしました。内容も2.1.x対応に更新しています。

2006.7.2
TiddlyWikiでGTDを実装してみました。
　GTD Style Wiki
　LifeHackLife(blog)

2006.6.21

TodayMacro - 日付表示

Thu, 05 Oct 2006 07:37:00 GMT

概要

今日の日付を表示します。

書式

<<today>>または<<today 日付書式>>

日付書式	意味
YYYY	西暦の4桁表記
YY	西暦の2桁表記
wYYYY	ISO-8601対応週ベース年の4桁表記
wYY	ISO-8601対応週ベース年の2桁表記
MMM	月名（本サイトでは和名にカスタマイズ）
mmm	月名の短縮表記（本サイトでは和名でMMMと同じ表記）
0MM	月の2桁数字表記
MM	月の1～2桁数字表記
DDD	曜日（本サイトでは和名にカスタマイズ）
ddd	曜日の短縮表記（本サイトでは和名でDDDと同じ表記）
0DD	日の2桁数字表記
DDth	日を1st, 2nd, 3rd, 4th,……形式で表記
DD	日の1～2桁数字表記
0hh	時の2桁表記
hh	時の1～2桁表記
0hh12	時の2桁表記(12時間制)
hh12	時の1～2桁表記(12時間制)
AM PM	午前/午後表記(大文字)
am pm	午前/午後表記(小文字)
0mm	分の2桁表記
mm	分の1～2桁表記
0ss	秒の2桁表記
ss	秒の1～2桁表記

使用例

<<today>>
<<today "YYYY年0MM月0DD日(DDD)">>
<<today "YY/MM/DD 0hh:0mm:0ss">>
<<today "YYYY MMM DDth">>
<<today "hh12:0mm am">>

2006年11月29日 7:42:57
2006年11月29日(水)
06/11/29 07:42:57
2006 11月 29th
7:42 am

起動パラメータ一覧

Thu, 05 Oct 2006 05:52:00 GMT

URLの後ろにパラメータを与えることでTiddlyWiki起動時の動作を指定することができます。

書式

URL#記事タイトル
URL#cmd:arg
URL#cmd1:arg1 cmd2:arg2 ...

※2、3の書式はVer2.0.7以降のみ有効です
※日本語のパラメータはブラウザによっては使用できません

例

http://www.geocities.jp/wikistyle/#SiteTitle
http://www.geocities.jp/wikistyle/#open:SiteTitle
http://www.geocities.jp/wikistyle/#open:SiteTitle open:SiteSubtitle
http://www.geocities.jp/wikistyle/#open:SiteTitle%20open:SiteSubtitle

コマンド一覧

コマンド	引数	意味
（省略）	記事タイトル	指定されたタイトルの記事を開きます
open	記事タイトル	指定されたタイトルの記事を開きます
story	記事リストタイトル	指定されたタイトルの記事リストに書かれた各記事を開きます
search	検索キー	検索キーにマッチする記事を表示します
searchRegExp	検索キー	正規表現の検索キーにマッチする記事を表示します
tag	タグ名	指定されたタグ名がついた記事を表示します
newJournal	日付書式	指定された日付書式で日記を新規作成します
newTiddler	タイトル	指定されたタイトルで記事を新規作成します
start	safe	TiddlyWikiをセーフモードで起動します

TDumpMacro - 指定tiddlerのHTMLソース表示

Wed, 04 Oct 2006 05:43:00 GMT

// TDump (Tiddler Dump)
// 指定tiddlerのHTMLソース表示
config.macros.tdump = {};
config.macros.tdump.handler = function(place,macroName,params)
{
	var w = document.createElement('span');
	config.macros.tiddler.handler(w, 'tiddler', [params[0]], null, params[0]);

	var text = w.firstChild.innerHTML;
	text = text.replace(/</g,"\n<");
	text = text.replace(/>/g,">\n");
	text = text.replace(/^\n+/gm,"");
	if(config.browser.isIE)
		text = text.replace(/\n/gm,"\r");

	createTiddlyElement(place,"pre",null,null,text);
}

書式：コメント文

Wed, 04 Oct 2006 03:19:00 GMT

Wikiコメント

文字列を/% ～ %/で囲むと、その内側にある文はコメント行として閲覧画面に表示されません。編集画面では表示されるので、ちょっとしたメモや作成中の文章を書いておくのに便利です。

記述例

ここに/% コメントが %/あります

表示例

ここにあります

プラグインコメント

プラグインやマクロ定義に説明文等を書く場合、JavaScriptのコメント文（/*、//）にしてプログラムとして解釈されないようにする必要があります。このときコメント指定文字列として/*** ～ ***/を使うと、コメント指定文字列が表示上隠されて読みやすくなります。コメント文にはWiki記法が使用できます。

記述例

/***
|!マクロ名|~SampleMacro|
|!説明|サンプルのソースです|
***/
//{{{
config.macros.sample = {};
//}}}

表示例

マクロ名	SampleMacro
説明	サンプルのソースです

config.macros.sample = {};

テンプレートコメント

テンプレート定義に説明文等を書く場合、HTMLのコメント文（）にしてHTMLとして解釈されないようにする必要があります。このときのようにハイフンを３個書いて、さらにコメント指定文字列を独立した行にすると、コメント指定文字列が表示上隠されて読みやすくなります。コメント文にはWiki記法が使用できます。

記述例

<!---
|!テンプレート名|~EditTemplate|
|!説明|編集用テンプレートのサンプルです|
--->
<!--{{{-->
<div class='toolbar' macro='toolbar +saveTiddler'></div>
<div class='title' macro='view title'></div>
<!--}}}-->

表示例

テンプレート名	EditTemplate
説明	編集用テンプレートのサンプルです

<div class='toolbar' macro='toolbar +saveTiddler'></div>
<div class='title' macro='view title'></div>

TiddlyWikiの記法をPukiWikiっぽくするプラグイン

Wed, 04 Oct 2006 03:14:00 GMT

　　TiddlyWikiの記法をPukiWikiっぽくするプラグイン　2006.10.04 Version 0.91

説明
TiddlyWikiとサーバ型Wikiの両方を使用する場合、両者の記法の違いによって混乱する人が多いようです。そのため、TiddlyWikiの記法をPukiWiki( http://pukiwiki.sourceforge.jp/ )っぽくするプラグインを作ってみました。
細かい部分は全然違うので、まったく違和感なく使用できるというわけにはいきませんが、少しでも混乱が減るのではないでしょうか。

注
他の表示系プラグインを併用している場合、表示が乱れることがあります。

対応済み記法

要素	書式	本来のTiddlyWiki書式^*1
見出し	`, , **`	`!, !!, !!!`
並列リスト	`-, --, ---`	`, , **`
番号付リスト	`+, ++, +++`	`#, ##, ###`
リンク	`[[URL]]`	(同じ)
別名リンク	`[[サイト名:URL]]`	`[[サイト名\|URL]]`
画像	`&ref(画像URL)`	`[img[画像URL]]`
引用	`>, >>, >>>`	(同じ)
水平線	`----`	(同じ)
強調	`''強調''`	(同じ)
斜体	`'''斜体'''`	`//斜体//`
取消線	`%%取消線%%`	`--取消線--`
文字色	`&color(文字色){文字列}`	`@@color:文字色;文字列@@`
背景色	`&color(文字色,背景色){文字列}`	`@@color:文字色;background-color:背景色;文字列@@`
文字サイズ	`&size(サイズ){文字列}`	`@@font-size:サイズ;文字列@@`
コメント	`//コメント`	`/%コメント%/`
改行^*2	`&br;`	(ソースで改行)
段落^*3	`空行`	(なし)

*1 本来の書式も有効のまま残しているものもあります
*2 システム設定用記事の表示が乱れるのを避けるためShadowTiddlerには本来の改行ルールが適用されます
*3 改行文字を２個出力することで代用しています

未対応記法

要素	書式
((注釈))	未対応。TiddlyWikiに対応する機能がありません
テーブル	TiddlyWiki記法に従います

インストール
　この内容をTIddlyWikiの新規記事にペースト。systemConfigタグをつけて保存。リロード。

var pukiFormatters = [
{
	name: "heading",
	match: "^\\*{1,5}"
},
{
	name: "list",
	match: "^(?:(?:\\-{1,3})|(?:\\++))",
	lookahead: "^(?:(\\-{1,3})|(\\++))"
},
{
	name: "prettyLink",
	match: "\\[\\[",
	lookahead: "\\[\\[([^\\|\\]]*?)(?:(\\]\\])|(:(.*?)\\]\\]))",
	terminator: ":"
},
{
	name: "strikeByChar",
	match: "%%",
	terminator: "%%"
},
{
	name: "boldByChar",
	match: "''",
	lookahead: "''[^'].*''",
	terminator: "''"
},
{
	name: "italicByChar",
	match: "'''",
	terminator: "'''"
},
{
	name: "htmlEntitiesEncoding",
	match: "&#?[a-zA-Z0-9]{2,8};",
	handler: function(w)
		{
			if (w.matchText == "&br;") {
				createTiddlyElement(w.output,"br");
			} else {
				var e = createTiddlyElement(w.output,"span");
				e.innerHTML = w.matchText ;
			}
		}
},
{
	name: "lineBreak",
	match: "\\n\\n",
	handler: function(w)
	{
		createTiddlyElement(w.output,"br");
		createTiddlyElement(w.output,"br");
	}
}
];


var additionalPukiFormatters = [
{
	name: "lineBreak2",
	match: "\\n",
	handler: function(w)
	{
		if (store.isShadowTiddler(w.tiddler.title))
			createTiddlyElement(w.output,"br");
	}
},
{
	name: "commentByLine",
	match: "//",
	lookahead: "//.*\\n",
	handler: function(w)
	{
		var lookaheadRegExp = new RegExp(this.lookahead,"g");
		lookaheadRegExp.lastIndex = w.matchStart;
		var lookaheadMatch = lookaheadRegExp.exec(w.source)
		if(lookaheadMatch && lookaheadMatch.index == w.matchStart)
			w.nextMatch = lookaheadMatch.index + lookaheadMatch[0].length;
	}
},
{
	name: "pukiImage",
	match: "&ref\\(",
	lookahead: "&ref\\(([^\\)]+)\\)",
	handler: function(w)
	{
		var lookaheadRegExp = new RegExp(this.lookahead,"g");
		lookaheadRegExp.lastIndex = w.matchStart;
		var lookaheadMatch = lookaheadRegExp.exec(w.source)
		if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
			var e = createTiddlyElement(w.output,"img");
			e.src = lookaheadMatch[1];
			w.nextMatch = lookaheadMatch.index + lookaheadMatch[0].length;
		}
	}
},
{
	name: "pukiColor",
	match: "&color\\(",
	lookahead: "&color\\(([^\\)]+)\\)\\{((?:.|\\n)*?)\\}",
	terminator: "\\}",
	handler: function(w)
	{
		var lookaheadRegExp = new RegExp(this.lookahead,"mg");
		lookaheadRegExp.lastIndex = w.matchStart;
		var lookaheadMatch = lookaheadRegExp.exec(w.source)
		if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
			var e = createTiddlyElement(w.output,"span");
			var col =  lookaheadMatch[1].split(/\s*,\s*/);
			e.style.color = col[0];
			if (col.length >= 2)
				e.style.background = col[1];
			w.nextMatch += lookaheadMatch[1].length + 2;
			w.subWikify(e,this.terminator);
		}
	}
},
{
	name: "pukiSize",
	match: "&size\\(",
	lookahead: "&size\\(([^\\)]+)\\)\\{((?:.|\\n)*?)\\}",
	terminator: "\\}",
	handler: function(w)
	{
		var lookaheadRegExp = new RegExp(this.lookahead,"mg");
		lookaheadRegExp.lastIndex = w.matchStart;
		var lookaheadMatch = lookaheadRegExp.exec(w.source)
		if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
			var e = createTiddlyElement(w.output,"span");
			e.style.fontSize = lookaheadMatch[1];
			w.nextMatch += lookaheadMatch[1].length + 2;
			w.subWikify(e,this.terminator);
		}
	}
}
];

// config.formatter配列の記法変更
var posBold;
var posItalic;
for (var i=0; i<config.formatters.length; i++) {
	for (var j=0; j<pukiFormatters.length; j++) {
		if (config.formatters[i].name == "boldByChar")
			posBold = i;
		if (config.formatters[i].name == "italicByChar")
			posItalic = i;
		if (config.formatters[i].name == pukiFormatters[j].name) {
			config.formatters[i].match = pukiFormatters[j].match;
			if (pukiFormatters[j]["lookahead"] != undefined)
				config.formatters[i].lookahead = pukiFormatters[j].lookahead;
			if (pukiFormatters[j]["terminator"] != undefined)
				config.formatters[i].terminator = pukiFormatters[j].terminator;
			if (pukiFormatters[j]["handler"] != undefined)
				config.formatters[i].handler = pukiFormatters[j].handler;
		}
	}
}

// boldとitalicの優先度入れ替え
var w = config.formatters[posBold];
config.formatters[posBold] = config.formatters[posItalic];
config.formatters[posItalic] = w;

// config.formatter配列へ記法追加
for (var i=0; i<additionalPukiFormatters.length; i++)
	config.formatters.push(additionalPukiFormatters[i]);

書式：文字装飾

Wed, 04 Oct 2006 03:13:00 GMT

以下のような文字装飾が使用できます。

効果	書式
ボールド	`''ボールド''`
~~取り消し線~~	`--取り消し線--`
アンダーライン	`__アンダーライン__` (_を2個ずつ両側に書く)
イタリック	`//イタリック//`
上付き文字: 2³=8	`2^^3^^=8`
下付き文字: a_ij = -a_ji	`a~~ij~~ = -a~~ji~~`
ハイライト	`@@ハイライト@@`

CSS直接指定

ハイライトと同様の書式でCSSのスタイル定義を書くこともできます。

@@color:green;文字緑@@
@@background-color:#ff0000;color:#ffffff;背景赤@@
@@text-shadow:black 3px 3px 8px;font-size:18pt;display:block;margin:1em 1em 1em 1em;padding: 0.3em 1em 0em 1em;border:1px solid black;CSS スタイルが指定できます@@

文字緑
背景赤
CSS スタイルが指定できます

旧バージョンの互換性のために以下の書式も受け付けます。

@@bgcolor(#ff0000):color(#ffffff):背景赤@@

背景赤

更新内容が保存できない（IEその１）

Wed, 04 Oct 2006 03:06:00 GMT

JavaScriptは言語仕様としてファイルへの出力機能を持っておらず、TiddlyWikiではかなり裏技的な実装で保存機能を実現しています。そのため様々な条件によって保存できない場合があります。

※以下はWindows（2000/XP）でのみ確認しています。Macの事情は分かりません。

原因：ファイルアクセスブロック

ファイルのアイコンを右クリックしてプロパティを表示すると、下の方に以下のような表示が出ることがあります。このようなブロックされたTiddlyWikiファイルは保存できません。

セキュリティ：
このファイルは他のコンピュータから取得したものです。このコンピュータを保護するため、このファイルへのアクセスはブロックされる可能性があります。

解決法

公式サイトからダウンロードした等、ファイルが信頼できるものであれば、プロパティ画面の「ブロックの解除」ボタンを押してブロックを解除します。
「ブロックの解除」を実行すると、今度はファイルを開くたびに「This page requires JavaScript to function properly」という警告画面が出ることがあります。その場合「ツール」→「インターネットオプション」→「詳細設定」→「セキュリティ」→「マイコンピュータのファイルでのアクティブコンテンツの実行を許可する」にチェックすると警告画面は出なくなります。

書式一覧

Wed, 04 Oct 2006 03:03:00 GMT

一般

項目	記法
リンク	`WikiWord` `file:\|http:\|https:\|mailto:\|ftp:` `[[リンク先]]` `[[表示文字列\|リンク先]]`
リンク抑止	`~WikiWord`
リスト	`、、**`
番号付リスト	`#、##、###`
定義型リスト	`;定義` `:説明`
見出し	`!見出し１、!!見出し２、!!!見出し３`
水平線	`----`
等幅表示	{{{ ～ }}} ソース表示用 /{{{/ ～ /}}}/ CSS用 //{{{ ～ //}}} プラグイン用 <!---{{{---> ～ <!---}}}---> テンプレート用
引用	`>、>>、>>>` `<<< ～ <<<`
画像	`[img[title\|filename]]` `[img[filename]]` `[img[title\|filename][link]]` `[img[filename][link]]` `[<img[filename]]` 左フローティング `[>img[filename]]` 右フローティング
埋め込みHTML	`<html> ～ </html>`
コメント	`/% ～ %/`
プラグイン用コメント	`/* ～ */`
テンプレート用コメント	`<!--- ～ --->`

文字装飾

項目	記法
ボールド	`''ボールド''`
~~取り消し線~~	`--取り消し線--` (Ver2.1.0以降`==テキスト==`形式は廃止)
アンダーライン	`__アンダーライン__` (_を2個ずつ両側に書く)
イタリック	`//イタリック//`
上付き文字: 2³=8	`2^^3^^=8`
下付き文字: a_ij = -a_ji	`a~~ij~~ = -a~~ji~~`
ハイライト	`@@ハイライト@@`
CSS直接指定: 例：文字緑	`@@color:green;例：文字緑@@`
CSSクラス名指定: 例：markedクラス指定	{marked{例：markedクラス指定}}}

テーブル

項目	記法
通常項目	｜項目｜
タイトル	｜！タイトル｜
右結合	｜＞｜
上結合	｜～｜
位置指定	右、左、または両方にスペース
キャプション	｜c
ヘッダ	｜h
フッタ	｜f
スタイル指定	｜k
背景色	｜bgcolor(#88FFFF):項目｜

箇条書きやテーブルで改行がしたい

Wed, 04 Oct 2006 02:44:00 GMT

箇条書きやテーブルで改行する場合は<br>タグを使用します。Version2.1.0より前のバージョンではBrマクロが使用されていましたが、現在では推奨されていません。

使用例

*箇条書きで
普通に改行した場合
*Brタグで<br>改行した場合

箇条書きで

普通に改行した場合

Brタグで
改行した場合

書式：各種エスケープ

Wed, 04 Oct 2006 02:40:00 GMT

WikiWordの自動リンク抑止

自動リンクされてしまう文字列は先頭に~をつけることでリンクを抑止できます。

~WikiWord

WikiWord

{{{ }}}によるエスケープ

{{{ }}}で囲むとWiki整形機能の一部を無効にすることができます。

{{{ [[リンクの抑止]] }}｝

[[リンクの抑止]]

HTMLタグによるエスケープ

<HTML></HTML>で囲むことでもWiki整形機能の一部を無効にすることができます。

<html>[[リンクの抑止]]</html>

[[リンクの抑止]]

文字コード指定によるエスケープ

一番強力なエスケープ方法は、文字コードで記号を書くことです。

&#91;&#91;リンクの抑止&#93;&#93;

[[リンクの抑止]]

記号	文字コード表記
!	!
#	#
&	&
'	'
*	*
-	-
/	/
<	<
>	>
[	[
]	]
{	{
}	}
~	~

書式：等幅フォント表示

Wed, 04 Oct 2006 02:40:00 GMT

{{{と}}}で囲むと等幅フォント（<pre>タグ）で表示されるのでソースコードを示すような場合に便利です。またWikiの整形も抑止されます。

単語指定

行の中で使用するとその部分だけ等幅で表示されます。
記述例

行の中で{{{Monospaced Text}}}のように使用します。

表示例
行の中でMonospaced Textのように使用します。

ブロック指定

以下のようにブロック単位で指定すると枠で囲まれて表示されます。
記述例

{{{
    printf("Hello, world!");
    return 0;
}}}

表示例

    printf("Hello, world!");
    return 0;

ブロック指定（CSS用）

StyleSheetColorsのようなCSS定義記事も{{{ }}}で囲むと見やすく表示されますが、このとき以下のようにCSSのコメント形式/* */を使ってブロック指定をCSSとして解釈されないようにする必要があります。
記述例

/*{{{*/
.title {
    color: #fff;
    background: #084;
}
/*}}}*/

表示例

.title {
    color: #fff;
    background: #084;
}

ブロック指定（プラグイン用）

プラグインやマクロ定義の記事も同様に、JavaScriptのコメント形式//を使ってブロック指定をJavaScriptとして解釈されないようにする必要があります。
記述例

//{{{
config.macros.list.tag = {};
config.macros.list.tag.handler = function(params)
{ return store.getTaggedTiddlers(params[1], "title"); }
//}}}

表示例

config.macros.list.tag = {};
config.macros.list.tag.handler = function(params)
{ return store.getTaggedTiddlers(params[1], "title"); }

※CSS用のブロック指定（ /*{{{*/ ）も、JavaScriptのコメント形式なので、こちらを使うこともできます。

ブロック指定（テンプレート用）

ViewTemplateのようなレイアウト定義テンプレート記事も同様に、HTMLのコメント形式を使ってブロック指定をHTMLとして解釈されないようにする必要があります。
記述例

<!--{{{-->
<div class='tagging' macro='tagging'></div>
<div class='tagged' macro='tags'></div>
<div class='viewer' macro='view text wikified'></div>
<div class='tagClear'></div>
<!--}}}-->

表示例

<div class='tagging' macro='tagging'></div>
<div class='tagged' macro='tags'></div>
<div class='viewer' macro='view text wikified'></div>
<div class='tagClear'></div>

注

{{{ }}}自身を等幅ブロックの中に表示する場合は、//{{{ //}}}など別のブロック指定記号を使います。

BrMacro - 改行

Wed, 04 Oct 2006 02:31:00 GMT

箇条書きやテーブルの中で改行するための<<br>>マクロはVersion2.1.0以降推奨されなくなりました。以下のように<br>タグを使用してください。

書式

<br>

使用例

*箇条書きの<br>改行

箇条書きの
改行

定義型リスト
は使えないの？

Wed, 04 Oct 2006 02:25:00 GMT

Version2.1.0以降のTiddlyWikiでは定義型リストがサポートされました。
記述例

;定義型リスト
:このように「項目名」と「説明」からなるリストが定義型リストです

表示例

定義型リスト: このように「項目名」と「説明」からなるリストが定義型リストです

マクロとプラグインの違いは？

Wed, 04 Oct 2006 02:22:00 GMT

マクロとプラグインは、どちらもTiddlyWikiを拡張するための機能であり、JavaScriptで記述されて、systemConfigタグが付加された特殊な記事のことです。

マクロの方は、記事の中に<<マクロ名引数>>という形式で記述することで呼び出されます。そのためマクロは規定に従ったインタフェースを実装した一種のプラグインといえます。

一方、プラグインの中には既存処理のパッチのようにユーザが特に呼び出しを意識しなくても機能するように作られているものもあります。

ShowMyTiddlersPlugin - 自分の作成した記事のみ表示

Mon, 25 Sep 2006 22:40:00 GMT

ShowMyTiddlersPlugin - 自分の作成した記事のみ表示
　　　　2006.09.26 Version 1.0

説明
プラグインを多く導入していると、更新順表示タブ等でそれらと自分の作成した記事が混ざって視認性が悪くなってしまいます。そのため、修正者名が「設定」の署名と同じ記事のみ一覧表示するプラグインを作成しました。これにより表示が変わる箇所は以下の通りです。

更新順タブ
全てタブ
タグタブ
その他-未定義タブ
その他-見参照タブ

インストール
この内容をTIddlyWikiの新規記事にペースト。systemConfigタグをつけて保存。リロード。

lookupMyTiddlers = function(list)
{
	var newList = [];

	for (var i = 0; i < list.length; i++)
		if (list[i].modifier == config.options.txtUserName)
			newList.push(list[i]);
	return newList;

}

// 全て
config.macros.list.all.handler = function(params)
{
	var tiddlers = store.reverseLookup("tags","excludeLists",false,"title");
	tiddlers = lookupMyTiddlers(tiddlers);
	return tiddlers;
}

// その他 - 未定義
TiddlyWiki.prototype.getMissingLinks = function(sortField)
{
	var results = [];
	this.forEachTiddler(function (title,tiddler) {
		if (tiddler.modifier != config.options.txtUserName)
			return;
		if(tiddler.tags.find("systemConfig") == null && tiddler.tags.find("excludeMissing") == null)
			for(var n=0; n<tiddler.links.length;n++)
				{
				var link = tiddler.links[n];
				if(this.fetchTiddler(link) == null && !this.isShadowTiddler(link))
					results.pushUnique(link);
				}
		});
	results.sort();
	return results;
}

// その他 - 未参照
TiddlyWiki.prototype.getOrphans = function()
{
	var results = [];
	this.forEachTiddler(function (title,tiddler) {
		if (tiddler.modifier != config.options.txtUserName)
			return;
		if(this.getReferringTiddlers(title).length == 0 && !tiddler.isTagged("excludeLists"))
			results.push(title);
		});
	results.sort();
	return results;
}

// 更新順
config.macros.timeline.handler = function(place,macroName,params)
{
	var field = params[0] ? params[0] : "modified";
	var tiddlers = store.reverseLookup("tags","excludeLists",false,field);

	tiddlers = lookupMyTiddlers(tiddlers);

	var lastDay = "";
	var last = params[1] ? tiddlers.length-Math.min(tiddlers.length,parseInt(params[1])) : 0;
	for(var t=tiddlers.length-1; t>=last; t--)
		{
		var tiddler = tiddlers[t];
		var theDay = tiddler[field].convertToLocalYYYYMMDDHHMM().substr(0,8);
		if(theDay != lastDay)
			{
			var theDateList = document.createElement("ul");
			place.appendChild(theDateList);
			createTiddlyElement(theDateList,"li",null,"listTitle",tiddler[field].formatString(this.dateFormat));
			lastDay = theDay;
			}
		var theDateListItem = createTiddlyElement(theDateList,"li",null,"listLink",null);
		theDateListItem.appendChild(createTiddlyLink(place,tiddler.title,true));
		}
}

// タグ
config.macros.allTags.handler = function(place,macroName,params)
{
	var tags = store.myGetTags();
	var theDateList = createTiddlyElement(place,"ul",null,null,null);
	if(tags.length == 0)
		createTiddlyElement(theDateList,"li",null,"listTitle",this.noTags);
	for(var t=0; t<tags.length; t++)
		{
		var theListItem =createTiddlyElement(theDateList,"li",null,null,null);
		var theTag = createTiddlyButton(theListItem,tags[t][0] + " (" + tags[t][1] + ")",this.tooltip.format([tags[t][0]]),myOnClickTag);
		theTag.setAttribute("tag",tags[t][0]);
		}
}

TiddlyWiki.prototype.myGetTags = function()
{
	var results = [];
	this.forEachTiddler(function(title,tiddler) {
		if (tiddler.modifier != config.options.txtUserName)
			return;
		for(var g=0; g<tiddler.tags.length; g++)
			{
			var tag = tiddler.tags[g];
			var f = false;
			for(var c=0; c<results.length; c++)
				if(results[c][0] == tag)
					{
					f = true;
					results[c][1]++;
					}
			if(!f)
				results.push([tag,1]);
			}
		});
	results.sort(function (a,b) {if(a[0].toLowerCase() == b[0].toLowerCase()) return(0); else return (a[0].toLowerCase() < b[0].toLowerCase()) ? -1 : +1; });
	return results;
}

// Event handler for clicking on a tiddler tag
function myOnClickTag(e)
{
	if (!e) var e = window.event;
	var theTarget = resolveTarget(e);
	var popup = Popup.create(this);
	var tag = this.getAttribute("tag");
	var title = this.getAttribute("tiddler");
	if(popup && tag)
		{
		var tagged = store.getTaggedTiddlers(tag);
		tagged = lookupMyTiddlers(tagged);
		var titles = [];
		var li,r;
		for(r=0;r<tagged.length;r++)
			if(tagged[r].title != title)
				titles.push(tagged[r].title);
		var lingo = config.views.wikified.tag;
		if(titles.length > 0)
			{
			var openAll = createTiddlyButton(createTiddlyElement(popup,"li"),lingo.openAllText.format([tag]),lingo.openAllTooltip,onClickTagOpenAll);
			openAll.setAttribute("tag",tag);
			createTiddlyElement(createTiddlyElement(popup,"li"),"hr");
			for(r=0; r<titles.length; r++)
				{
				createTiddlyLink(createTiddlyElement(popup,"li"),titles[r],true);
				}
			}
		else
			createTiddlyText(createTiddlyElement(popup,"li",null,"disabled"),lingo.popupNone.format([tag]));
		createTiddlyElement(createTiddlyElement(popup,"li"),"hr");
		var h = createTiddlyLink(createTiddlyElement(popup,"li"),tag,false);
		createTiddlyText(h,lingo.openTag.format([tag]));
		}
	Popup.show(popup,false);
	e.cancelBubble = true;
	if (e.stopPropagation) e.stopPropagation();
	return(false);
}

SiteUrlの設定は何のために必要なの？

Tue, 11 Jul 2006 18:46:00 GMT

SiteUrlにはTiddlyWiki自身のURLを指定しますが、このURLはRSSフィードを出力したときにその中に埋め込まれます。それ以外の処理ではまったく使用されないので、RSSフィード出力機能を利用しないのであれば、とくに設定する必要はありません。

デフォルトでは、http://www.tiddlywiki.com/ になっているため、TiddlyWikiをRSSフィード付でサーバ上に公開する場合は必ず設定するようにしてください。