Hi, I love TiddlyWiki but I hate its documentation.
Let me give you an example. I want to export my tiddlywiki to a static HTML web site, I spent an hour without success. Google gives me https://tiddlywiki.com/static/Generating%2520Static%2520Sites%2520with%2520TiddlyWiki.html which tells me to use --rendertiddlers Note that if I click on a link to the command I go to https://tiddlywiki.com/static/RenderTiddlersCommand.html where it is said I should not use `--rendertiddlers` but `--render`. If so, why don't the first page use `--render`? Whatever, what confuse me is how to use `--rendertiddlers`, I mean where to type the code? It looks like an option of some command from my Unix point of view but maybe there is some place in my tiddlywiki I should type that command which starts with `--`. So I searched if I could change the type of a tiddler to be executable, if there is a special tiddler hidden to run that command, but without success. Then I looked for `commands` in TiddlyWiki and I see "A command is one of the following words, written with a -- prefix and used as a command-line option under Node.js," Argh, does it means I have to learn how to use Node.js? There is no other way to export my pages? Hopefully there is a link to "Using TiddlyWiki on Node.js". Here I find that indeed `--render` is an option of a command and not a command itself and that the main command is `tiddlywiki`. What the hell is the program tiddlywiki? For years I thought that tiddlywiki was the empty.html file. So there is a tiddlywiki program. How do I download it? Is there is a version for Linux? When I search in Debian packages I cannot find it. So I am stuck and I lost a lot of time. A good documentation would have given me the command line from the beginning (at least in an exemple) and of course it would have explain me how to download the tiddlywiki program. Of course it would not suggest to use --rendertiddlers and somewhere else says that it is deprecated. One example does not make a documentation to be bad, but I must say it happened to me more than once that I had to find help on the Internet to understand the documentation. That's a pity because TiddlyWiki is great. Olivier. ps: I have no idea why that mail changes the fonts from paragraph to another. I guess it is a cursed day. -- You received this message because you are subscribed to the Google Groups "TiddlyWiki" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/45146179-2683-4935-ade1-4f20a1c20ca1%40googlegroups.com.
