The latest version of the docs with the breadcrumbs macros is live now: Start with Filter and Filter Syntax
The macros are developed with the tiddlywiki-com default CSS settings.
The macros are now named. .breadcrumbs and .breadcrumbsField … Do not miss the -dot- at the beginning ![]()
temporary docs
\define .breadcrumbs(start, stop, exclude, label, field, sort)
stop … (required) tiddler title to stop … Needs to be a tiddler, otherwise there is an error message
start … (optional) tiddler title to start with. defaults to currentTiddler
exclude … (optional) tiddler list of titles to be excluded. eg: title [[title with spaces]]
label … (optional) label to be shown in front of the breadcrumbs nav
sort … (optional) defaults to yes. In TW tags are usually sorted
\define .breadcrumbsField(start, exclude, label, field:"list")
start … (optional) tiddler title which contains the “list” field. defaults to currentTiddler
exclude … (optional) tiddler list of titles to be excluded. eg: title [[title with spaces]]
label … (optional) label to be shown in front of the breadcrumbs nav
field … (optional) defaults to “list”. Field name that contains a title-list that should be shown as breadcrumbs
The “field” verions can be used to create “out of order” breadcrumbs as shown in Filter Operators
More info
see: Can Hierarchical Navigation Benefit TW Documentation? - #21 by pmario
ToDo
- Optimize CSS for small screens (I know what I want, but I didn’t have the time yet, no suggestions needed atm)
- Dynamically calculate hardcoded pixel values
- Check existing colour palettes … most of them don’t play well with the macro atm
Help needed
Many existing color palettes do not contain valid settings for the <<colour message-background>>; which is used for the breadcrumb background.
The railroad-plugin CSS uses those palette values too.
So the railroad-plugin and breadcrumbs macros will need improved palettes to work well with all palettes.
You can use the Palette Manager Edition to globally improve existing palettes. The edition contains the palette-manager-plugin-beta that can be imported into your wiki.
The INTRO for the palette-manager edition can be found at:
have fun!
Mario