I would consider generating static sites to be more of an advanced thing, rather than a beginner's thing.
After visiting the search bar on tiddlywiki.com, my next step is usually: The Tiddly Toolmap <https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM> It's currently the most comprehensive listing of TW solutions outside of TiddlyWiki.com Then, if that doesn't work, for searching for existing solutions to TW problems there is Scripts in TiddlyWiki <https://kookma.github.io/TW-Scripts/> The problem with writing a better guide for TW is that TW is a many-headed hydra, and it's hard to know where to start. Also, without Jeremy's blessing, anything you write will be an "also ran.", along with various other stabs that ran out of steam because the scope was too big. Back on the TW menu you can find many resources under the "Learning" you'll see that there have been many aspects of TW that have been documented to one degree or another. So it's like we have all the pieces of the clock, but still haven't figured out what time it is. On Monday, April 20, 2020 at 3:55:32 PM UTC-7, Anne-Laure Le Cunff wrote: > > @Mark - good point, I do tend to use google a lot and should use the > native search function more often. My point still stands: I was initially > looking for a way to generate a static website with TW, and I knew I had to > use the Node version because its been a week I've been playing with it, but > that wasn't clear from the documentation. Anyway my point is not to pick it > apart as I think it's an amazing resource, just think there could be an > easier "get started guide" or FAQ for beginners focusing on the main strong > points of TW. > > (Github drives me crazy at least 3 times a week so I'm not the right > person to comment on the second part) > > On Monday, April 20, 2020 at 9:20:35 PM UTC+1, Mark S. wrote: >> >> I notice all the links you include here are for the static site. That >> makes me wonder if you're >> using Google to look up info about TW. The search box on TiddlyWiki.com >> is very effective. >> For instance, if you had typed "node install" into the box, you would >> have gotten only 3 >> links in the top part of the search, including "Installing TiddlyWiki on >> node.js". >> >> For sharing those links, you can use the permalink option from the >> specified tiddler. >> >> The problem with updating documents on TW is that the process is so drawn >> out. You >> have to install github, fork tiddlywiki.com, clone the fork locally. >> Then make a branch >> with the right name structure (which, ironically, is unclear in the >> documentation), >> then make your changes, then push your changes, then >> make a pull request. Then wait while a variety of people who have never >> been >> concerned enough to make a PR themselves on the topic try to pick apart >> everything >> you've written. It's not exactly Wordpress or Wikipedia convenience. On >> the last part, >> where you're text is being flame grilled over a hot fire, my feeling is >> that documentation is >> not code and doesn't need the same level of scrutiny. It should be >> submitted rapid-fire, >> and if someone doesn't like it, they can submit their own PR to amend it. >> >> Two years ago, if I had seen your mention of the missing part of the >> commands, I probably would >> have been submitting a PR within a half hour. Now, not so much. >> >> >> On Monday, April 20, 2020 at 11:14:32 AM UTC-7, Anne-Laure Le Cunff wrote: >>> >>> Hi everyone. >>> >>> Just want to illustrate how hard it is to get started with an example >>> that just happened to me. Someone asked me how to generate a static website >>> with TiddlyWiki. >>> >>> I'm still working on my tutorial, so I looked in the documentation for >>> something to send them and here are the pages I stumbled upon in order: >>> >>> 1. Generating Static Sites with TiddlyWiki >>> >>> <https://tiddlywiki.com/static/Generating%2520Static%2520Sites%2520with%2520TiddlyWiki.html> >>> - >>> this doesn't mention Node.js anywhere except vaguely in a tag, so I need >>> to >>> also tell them how to run the Node.js version first >>> 2. Awesome, there's a page about TiddlyWiki on Node.js >>> <https://tiddlywiki.com/static/TiddlyWiki%2520on%2520Node.js.html>! >>> Ha doesn't say how to install it. It says "for more information, check >>> one >>> of these 21 links" >>> 3. Maybe Using TiddlyWiki on Node.js >>> >>> <https://tiddlywiki.com/static/Using%2520TiddlyWiki%2520on%2520Node.js.html>? >>> >>> No luck, going back to TiddlyWiki on Node.js >>> <https://tiddlywiki.com/static/TiddlyWiki%2520on%2520Node.js.html>... >>> 4. Clicking on the very generic link called "Node.js" actually >>> brings me to the page Installing TiddlyWiki on Node.js >>> >>> <https://tiddlywiki.com/static/Installing%2520TiddlyWiki%2520on%2520Node.js.html>, >>> >>> hooray! >>> 5. Now back to Generating Static Sites with TiddlyWiki >>> >>> <https://tiddlywiki.com/static/Generating%2520Static%2520Sites%2520with%2520TiddlyWiki.html>... >>> >>> Let's try these commands. Why don't they work? Ha, I need to add >>> "tiddlywiki" in front of each of them, but it doesn't say. >>> >>> Going to publish a tutorial to answer that specific query soon but I >>> think it shows how hard it is to navigate for a beginner and how a proper >>> landing page may be able to address some of the most common questions :) >>> >>> On Monday, April 20, 2020 at 5:37:57 PM UTC+1, Anne-Laure Le Cunff wrote: >>>> >>>> Hi Jeremy, do you have an example of what such a full-screen Tiddler >>>> would look like? >>>> >>>> On Monday, April 20, 2020 at 5:10:22 PM UTC+1, Jeremy Ruston wrote: >>>>> >>>>> Hi Peter >>>>> >>>>> On 20 Apr 2020, at 16:42, 'Peter Buyze' via TiddlyWiki < >>>>> [email protected]> wrote: >>>>> >>>>> It's not just that the visual presentation is overly complex. Using TW >>>>> is also complex for non-programming newbies, i.e the learning curve is >>>>> pretty steep. >>>>> >>>>> >>>>> This is in the context of the question of whether the homepage at >>>>> https://tiddlywiki.com should appear to be the standard TiddlyWiki >>>>> interface, or should look more like https://notion.so. >>>>> >>>>> Best wishes >>>>> >>>>> Jeremy >>>>> >>>> -- 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/7f688262-cd21-4ec7-a633-90b6046c02f5%40googlegroups.com.
