Macro Tabs

Tabs és una macro incorporada molt interessant alhora d'organitzar la informació de forma interactiva: permet englobar diferents Tiddlers en forma de pestanyes (tabs).

Sintaxi

tabs identificador text etiqueta tiddler

• tabs: macro tabs
• identificador: representa una classe CSS, per tant, podrem canviar l'aspecte de cada grup de pestanyes que definim canviant el CSS que l'identifica.
• text: text de la pestanya
• etiqueta: text (tooltip) que apareixerà al passar el ratolí pel damunt de la pestanya
• tiddler: Tiddler que contindrà la pestanya

Exemple bàsic

<<tabs txtMainTab
Exemple Exemple Exemple
Agenda Agenda Agenda>>

Hem creat un grup de 2 pestanyes que contindran els tiddlers Exemple i Agenda. La classe (CSS) utilitzada per definir l'aspecte que tindrà el grup es txtMainTab, aquesta classe ja està definida al StyleSheetLayout, es la que s'utilitza per les pestanyes del SideBarTabs. Té la particularitat de no ensenyar, ni els punts ni els números de les llistes: .txtMainTab .tabContents li {list-style:none;}

Exemple avançat

<<tabs txtCatCms
'Agenda 2007' 'Agenda any 2007'
'Agenda 2007'>>

Hem creat un grup d'una pestanya on, a diferència de l'anterior, s'utilitza una classe específica (txtCatCms) per tal de poder aplicar els nostres propis etils CSS, i així forçar la numeració de les llistes entre d'altres. Per tant al StyleSheet haurem creat la següent definició:

.txtCatCms .tabContents ... {...}

La pestanya inclou el Tiddler Agenda 2007 i aquest inclou un grup de 2 pestanyes amb els Tiddlers Exemple i Agenda; per tant estan anidats; la macro ens ho permet.

També cal observar que hem usat cometa simple, doncs el títol del tiddler que volem incloure a la pestanya té més d'una paraula.

Si volem organitzar el nostre TW utilitzant pestanyes feqüentment, es molt recomanable instal·lar-hi el plugin TabEditPlugin, aquest plugin permet editar pestanyes directament fent-hi doble clic al contingut.

Instal·lació de plugins

Un plugin no es més que un Tiddler que conté una "gran" macro destinada a fer una funció en concret. Per instal·lar un plugin només cal, un cop l'hem localitzat, copiar el contingut del Tiddler (plugin) al nostre TW i etiquetar-lo com a systemConfig, aquesta etiqueta és la que fa que sigui un plugin, si li treiem deixarà de ser-ho. Podrem veure quins plugins tenim, i si s'estan executant correctament, obrint el Tiddler PluginManager

Hi ha molts llocs on aconseguir plugins, només cal veure l'etiqueta tiddlywikiPlugin de del.ico.us

Normalment cada plugin conté una breu descripció del que fa, quina versió es, qui l'ha fet i sota quina llicència entre d'altres.

TiddlyWiki 2.2.4

Després d'una llarga espera provocada en part per la incorporació d'en Jeremy a BT Group, ha arrivat la nova versió 2.2.4 de TiddlyWiki. Entre les moltes novetats cal destacar-ne algunes que fan que TW sigui, a hores d'ara, una eina difícil de superar.

• ImportTiddlers s'ha millorat considerablement aquesta macro, ara permet importar Tiddlers de qualsevol tipus de servidor com MediaWiki o SocialText
• macro sync nova macro que permet sincronitzar Tiddlers d'altres TiddlyWikis
• backstage area nou menú que conté totes les funcions de sistema agrupades

I un llarg etcètera...

ToolbarMacros

Els controls d'edició Toolbar de cada Tiddler estan formats per una sèrie de macros. Les trobarem dins del Tiddler ViewTemplate. Editar el ViewTemplate ens pot servir, per exemple, per canviar l'ordre dels controls, tal com figura en el següent exemple.

<span macro='toolbar +editTiddler permalink references deleteTiddler jump closeOthers closeTiddler'></div></span>

Hem fixat el següent ordre: Editar, Enllaç permanent, Referències, Esborrar, Saltar, Tancar altres, Tancar. També hem fet visible la macro Esborrar per poder executar-la sense haver d'editar un Tiddler. El signe + indica que "Editar" s'executa amb doble clic.

Llistat de les macros d'edició:

• <<toolbar cancelTiddler>>
• <<toolbar closeOthers>>
• <<toolbar closeTiddler>>
• <<toolbar deleteTiddler>>
• <<toolbar editTiddler>>
• <<toolbar jump>>
• <<toolbar permalink>>
• <<toolbar references>>
• <<toolbar saveTiddler>>

Fins aquí hem vist les nocions bàsiques necessàries per mantenir el nostre TW (TiddlyWiki), a partir d'ara el bloc canvia de sentint orientant-se més a utilitats, notícies, actualitzacions, "tips", i com diria en Vicent Partal, "tot allò que la gent pot fer amb ell".

Macros bàsiques

TW incorpora una sèrie de macros destinades a executar funcions o instruccions automatitzades. Les més bàsiques són:

Macro	Funció
<<list>> / <<list all>>	Llista tots els Tiddlers.
<<timeline>>	Llista els Tiddlers en ordre cronològic
<<list missing>>	Llista Wikiparaules que no enllacen a cap Tiddler.
<<list orphans>>	Llista els Tiddlers que no estan enllaçats per altres Tiddlers (orfes)
<<list shadowed>>	Llista Tiddlers considerats del sistema, es a dir, Tiddlers que no hem creat nosaltres sinó que ja venen incorporats i que s'encarregen de diverses funcions: des d'especificar quin serà el text del títol fins l'ordre dels menús o el color del text. Evidentment els podem editar per tal de personalitzar el nostre TW.
<<allTags>>	Llista totes les etiquetes existents en el nostre TW en forma de botó i informant-nos també, del número de Tiddlers associats a cada etiqueta (tag). Si fem click en qualsevol d'aquestes etiquetes se'ns llistaran els Tiddlers que aquesta tingui associats; creant així, un menú interactiu.
<<tags>>	Llista, en forma de botó, l'etiqueta o etiquetes associades al tiddler que invoca la macro. També crea un menú interactiu com <<allTags>>.
<<tag Xzy>>	Crearà el botó Xyz corresponent a l'etiqueta Xyz i el corresponent menú interactiu.

Totes les macros que hem vist fins aquí, invoquen elements que TiddlyWiki (TW) llistarà en ordre alfabètic exepte <<timeline>> que ho fa en ordre cronològic (primer els més recents).

Per acabar 2 macros més: <<version>> i <<importTiddlers>>. <<version>> ens diu quina versió de TW estem utilitzant i <<importTiddlers>> és una potent macro que ens perment importar Tiddlers d'altres TiddliWikis.

Provablement no necessitarem invocar aquestes macros manualment ja que TW ja les utilitza en el seu menú.