Now, about documentation, in my case the problem is that Github is equally confusing to me. Branching? Cloning? I avoid it like the plague, and in my TiddlyWiki toolmap I only link to demos, not to Github, if I can avoid it. (I should mention that one or two others also update the toolmap, and I don't know what they do).
So to help others overcome the learning curve for TiddlyWiki I have to navigate the equally confusing (to this non-coder, anyway) learning curve for GitHub? Forget it. Too many other things on my plate. On Monday, September 16, 2019 at 4:40:12 AM UTC-5, [email protected] wrote: > > 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/1b7bc194-917e-4c79-8d6f-b490422695fe%40googlegroups.com.
