As a part of a greater "Learning TW" project (if "project" is the right 
word?), here is an introductory run through of the identified Concepts 
<http://tiddlywiki.com/prerelease/#Concepts> in TW. 

Please help to improve it - not only the factual errors that I *for sure* am 
making, but also to make it generally to make it a valuable list for 
newcomers.


It is intended as a "priority list" that newcomers can reference. And that 
*we* can reference newcomers *to*.

I have selected the "concepts" as a good starting point (...after the 
newcomer has read the very introductory material, and played around a bit) 
as opposed to, say, a listing like the Definitions 
<http://tiddlywiki.com/prerelease/#Definitions> or Features 
<http://tiddlywiki.com/prerelease/#Features> because learning about the 
Concepts is more close to *mastering* TW. It is also not as specific as, 
say, a study in FilterOperators 
<http://tiddlywiki.com/prerelease/#Filter%20Operators>. BTW, listings such 
as FilterOperators serve more as a reference than as learning material but 
I'm very happy to note that this list has added notes about which are the 
most common operators.

Apropos "Reference material" vs "Learning material"; Note that the listed 
comments below are intentionally NOT presented a perfect structure but 
instead in a semi-verbose style that convey *relative* importance *better* 
than a strict factual format does. This is a typical major difference 
between official reference material and e.g learning in a more live 
context. But of course, it must not be factually false.


I will update this post with your input.


*A subjective Good to Start With list*

*Target audience*:
New to TW and not particularly competent coder. (I'm limited to this 
audience because of my own competence on the matter. With your help I hope 
the target audience can widen.)

Recommended reading for beginners are marked with *Beginner.* Concepts with 
*Fundamental* or *Useful* can also be good to study but perhaps at other 
levels. The comments typically refer to *the topic of* the listed tiddler, 
not the tiddler itself... even if the tiddler itself probably is the best 
starting point for closer study.


   - ColourPalettes <http://tiddlywiki.com/prerelease/#ColourPalettes> - 
   Advanced. Limited use (but of course the term ColorPalette and its end-use 
   are basic)
   - Commands <http://tiddlywiki.com/prerelease/#Commands> - Advanced. 
   Concerns the node.js version, and probably fundamental there.
   - Current Tiddler <http://tiddlywiki.com/prerelease/#Current%20Tiddler> - 
   Intermediate. Useful. For the special, but frequent, case when code needs 
   to refer to "this" tiddler
   - DataTiddlers <http://tiddlywiki.com/prerelease/#DataTiddlers> - 
   Advanced. Probably very useful.
   - Date Fields <http://tiddlywiki.com/prerelease/#Date%20Fields> - 
   Intermediate. Limited use. In addition to the three default fields 
   "title","tags" and "text", you can add a date field specialized for showing 
   dates. 
   - DictionaryTiddlers 
   <http://tiddlywiki.com/prerelease/#DictionaryTiddlers> - Advanced. 
   General use. Tiddlers listing "name:value" pairs.
   - Dominant Append <http://tiddlywiki.com/prerelease/#Dominant%20Append> - 
   Advanced kink. Specific filter technique.
   - ExternalImages <http://tiddlywiki.com/prerelease/#ExternalImages> - 
   Beginner. Useful. Note it's a concept, not just a term for using external 
   images.
   - Filter Operators <http://tiddlywiki.com/prerelease/#Filter%20Operators> - 
   Fundamental. The "actions" used in filters.
   - Filters <http://tiddlywiki.com/prerelease/#Filters> - Fundamental. 
   Beginner-Advanced.
   - Hard and Soft Links 
   <http://tiddlywiki.com/prerelease/#Hard%20and%20Soft%20Links> - 
   Intermediate. Limited use. Refers to hard coded links vs links that are 
   constructed.
   - InfoPanel <http://tiddlywiki.com/prerelease/#InfoPanel> - Beginner. 
   It's just the name for a panel you see via the toolbar. ("Toolbar", btw, is 
   a more important Concept.)
   - JSONTiddlers <http://tiddlywiki.com/prerelease/#JSONTiddlers> - 
   Beginner. Good to know about even if you might not use right away. 
   - Macros <http://tiddlywiki.com/prerelease/#Macros> - Intermediate. 
   "Miniprograms" to perform otherwise repetitive tasks.
   - Messages <http://tiddlywiki.com/prerelease/#Messages> - Advanced. 
   Widgets send messages in the system to e.g trigger stuff.
   - Modules <http://tiddlywiki.com/prerelease/#Modules> - Advanced. 
   JavaScript tiddlers.
   - ModuleType <http://tiddlywiki.com/prerelease/#ModuleType> - Advanced. 
   Specific for when building modules. Unsure how to describe.
   - Order of Tagged Tiddlers 
   <http://tiddlywiki.com/prerelease/#Order%20of%20Tagged%20Tiddlers> - 
   Beginner. Not sure I'd classify this as a "concept", but OK.
   - PermaLinks <http://tiddlywiki.com/prerelease/#PermaLinks> ...and 
   PermaView - Beginner. "Permanent links", i.e the URL to open a TW with 
   specific tiddlers open. 
   - Plugins <http://tiddlywiki.com/prerelease/#Plugins> - Fundamental. 
   Beginner to use, Intermediate with Andreas Hahns project. Consists of 
   several tiddlers bundled into one.
   - Pragma <http://tiddlywiki.com/prerelease/#Pragma> - Advanced. Special 
   term.
   - Selection Constructors 
   <http://tiddlywiki.com/prerelease/#Selection%20Constructors> - Advanced. 
   Possibly useful to know.
   - ShadowTiddlers <http://tiddlywiki.com/prerelease/#ShadowTiddlers> - 
   Advanced. But fundamental to know that it means "Plugin tiddlers" 
   - SystemTags <http://tiddlywiki.com/prerelease/#SystemTags> - 
   Fundamental. The tiddler has a good rundown list not unlike this one!
   - SystemTiddlers <http://tiddlywiki.com/prerelease/#SystemTiddlers> - 
   Fundamental. Possibly *defined as* (?) tiddlers starting with "$:/" (or 
   is it defined as tiddlers building up the system?)
   - Tagging <http://tiddlywiki.com/prerelease/#Tagging> - Absolute 
   beginner. Tag to categorize things.  
   - TagTiddlers <http://tiddlywiki.com/prerelease/#TagTiddlers> - 
   Fundamental but practically just a term. (There is no official term for the 
   "opposite", but I'd call it a "pure tag")
   - TemplateTiddlers <http://tiddlywiki.com/prerelease/#TemplateTiddlers> - 
   Intermediate. Very useful if you want to reuse content.
   - TextReference <http://tiddlywiki.com/prerelease/#TextReference> - 
   Unsure of what this is/means.
   - TiddlerFields <http://tiddlywiki.com/prerelease/#TiddlerFields> - 
   Beginner. Fundamental. The parts which make up a tiddler, e.g the title 
   field, the text field, etc.
   - TiddlerLinks <http://tiddlywiki.com/prerelease/#TiddlerLinks> - 
   Beginner. It's the titles you can click on.
   - Tiddlers <http://tiddlywiki.com/prerelease/#Tiddlers> - Fundamental. 
   Beginner.
   - TiddlyWiki <http://tiddlywiki.com/prerelease/#TiddlyWiki> - Shared 
   term for TW classic and TW5
   - TiddlyWiki5 <http://tiddlywiki.com/prerelease/#TiddlyWiki5> - The 
   modern version of TW. Not compatible with "TW classic" (a.k.a TW2.x)
   - Title List <http://tiddlywiki.com/prerelease/#Title%20List> - list of 
   tiddler titles
   - Title Selection <http://tiddlywiki.com/prerelease/#Title%20Selection> - 
   Term of limited use.
   - Transclusion <http://tiddlywiki.com/prerelease/#Transclusion> - 
   Beginner. Fundamental. Watch another place like through a TV. 
   - Variables <http://tiddlywiki.com/prerelease/#Variables> - 
   Intermediate. Fundamental. (I have no easy sentence to comment on this.)
   - Widgets <http://tiddlywiki.com/prerelease/#Widgets> - Fundamental. 
   Beginner/Intermediate. The "html-elements of TW".
   - Wiki <http://tiddlywiki.com/prerelease/#Wiki> - Say what? Hickey 
   <http://en.wikipedia.org/wiki/Hickey>?
   - WikiText <http://tiddlywiki.com/prerelease/#WikiText> - Fundamental. 
   Simplified commands in edit view for formatting text and running widgets.



BTW, that list in the tiddler Concepts 
<http://tiddlywiki.com/prerelease/#Concepts> would be more informative if 
there really was a brief description next to each item a bit like here 
(...but more formal). The description could be a transclusion of the 
summative introductory paragraph that typically exist in those tiddlers, or 
if they have a summary field or such. I posted a github isse 
<https://github.com/Jermolene/TiddlyWiki5/issues/1717>.

Another proposal is a* themed Hangout*, dedicated to the Concepts, with Big 
J and the wizards talking about the concepts in a general sense. (I could 
pretend to NOT be an expert grandmaster hacker and ask the dumb questions, 
almost as if I didn't know how to code. I can be a very convincing actor in 
this role.)


<:-)

-- 
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 post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/9d2e66a3-e6d2-445e-8dd0-d22b3c376f35%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to