Agreed generating a static website may not be a beginner thing, but it is a massive differentiator of TW — you can use the same thing for your notes/thinking tool and blog/publishing tool, with bi-directional linking, transclusion, and lots of great plugins. That's pretty unique. And it's not hard to do once you have the detailed steps.
The Tiddly Toolmap is amazing and absolutely overwhelming. Same for Scripts in TiddlyWiki. My point is not about the specifics of achieving a very particular outcome e.g. static website or something else—it's about creating a more welcoming experience for newcomers. To your point, we do have all the pieces, we just need to arrange them in a friendlier way. A simple page with a beginner-friendly guide would go a long way. I'd be super happy to help! On Tuesday, April 21, 2020 at 12:09:10 AM UTC+1, Mark S. wrote: > > 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/3b59a4f7-8d69-4ca0-9d28-cda669de0b42%40googlegroups.com.
