Mark S. Good practical post.
My take on it: we need a consolidated search mechanism better honed to finding things over the major source materials. TT On Monday, 16 September 2019 16:08:40 UTC+2, Mark S. wrote: > > Not that I would disagree about the documentation, but a small bit of your > problem was Google search. It lead you to a static > page that limited your other search options. In the upper right hand > portion of the page it was tagged "TiddlyWiki on Node.js" > which was meant to tip you off to the context. > > If you had gone to tiddlywiki.com, and typed "static" into the search, > you would have seen the same tiddler listed. But you would also have > seen hundreds of other possibilities including > > "How to export tiddlers" > > which is probably what you really wanted. > > When I'm looking for something about TiddlyWiki, and I think it's likely > part of the core, my first stop is TiddlyWiki.com. > > If I'm looking for something about TiddlyWiki, and I think it's likely a > 3rd party resource, my second stop is David Gifford's TiddlyWiki Toolmap > <https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM#q=search>. > > If it was easy to do, I would modify "Generating Static Sites with > TiddlyWiki" to include a link at the top to the exporting files option. > However, all the documentation is done through GitHub and the methodology > was changed without, ironically, a clear explanation > of how to implement that change. Working this way is like building a ship > in a bottle or mining a mountain with a tooth pick. > > Like others, I had started my own documentation for TW, but then realized > that it would be an enormous amount of work, and > would only have whatever visibility it happened to gain via Google. > > Good luck! > > On Monday, September 16, 2019 at 2:40:12 AM UTC-7, un.o...@gmail.com > 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 tiddlywiki+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/9e876507-16b6-4db9-a7d4-6da68e37b117%40googlegroups.com.
