[tw] Re: [docs] Introduction to Lists

2017-12-12 Thread Mat
[Sorry for deleted post above]

Jeremy,

Big thanks, the result looks terrific!

<:-)

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/2ed57177-f550-4c8a-ae59-aaa16e24ba24%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-12 Thread Mat
Jeremy,

Big thanks, the result looks terrific!
 

> * Style tweaks
> [etc]
>

@Jeremy but also @TonyM:

These are no doubt high standards with *great* results - but few can live 
up to these standards. It sparks an idea - or maybe it's what Tony has been 
talking about; It would be useful with an *unofficial but still publicly 
viewable *place for "potential docs"! Drafts and rough documents that could 
be polished collectively until ready for PR. As many have pointed out; in a 
wiki, even bad information is better than no information - also because it 
provokes others to improve upon it.

An URL like " https://unofficial.tiddlywiki.com " should prevent anyone 
from thinking it is official stuff and I imagine it would be easy for you 
to hand out moderation rights. BTW, does anybody know if such a subdomain 
could have a separate github Issue and PR area?

  <:-)

  

>
> Taken together with the discussion in this thread, it serves to illustrate 
> that maintaining documentation is difficult, intricate work requiring 
> attention to detail and exhaustive knowledge of what is already there. It's 
> going to be a group effort to get things up to the standard we'd all like 
> to see.
>
> Best wishes
>
> Jeremy
>
>
> On Tuesday, December 5, 2017 at 3:04:14 AM UTC, Dave Gifford - 
> http://www.giffmex.org/ wrote:
>>
>> Hi all
>>
>> I like this description. Great idea.
>>
>> I think the section on filtered transclusion could be improved, however. 
>> Here is my best attempt, for what it's worth:
>>
>> Wrapping a filter (for example `[tag[HelloThere]]`) with triple brackets 
>> (`{{{ [tag[HelloThere]] }}}`) produces a linked list of the titles of all 
>> relevant tiddlers. You can also apply a template 
>>  
>> to the filter, for example `{{{ [tag[HelloThere]] || 
>> $:/core/ui/TagTemplate }}}`, which renders like:
>>
>> I hope this is helpful. I wish I had more time for helping with 
>> documentation, but my employment and other personal projects are taking up 
>> most of my time. Blessings to all.
>>
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/2fb38e72-c048-4ec3-9126-5b911af0f257%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-12 Thread Jeremy Ruston
Thanks, Mat, I've committed the changes, and they are visible now in the 
prerelease:

https://tiddlywiki.com/prerelease/#Introduction%20to%20Lists

Your PR is merged here:

https://github.com/Jermolene/TiddlyWiki5/commit/2b21b74c500421423a543a2f5061e54d3d4f1c73

It's worth noting that I had to do a bit of cleaning up that you can see 
here: 
https://github.com/Jermolene/TiddlyWiki5/commit/49b3ed4770e8669b448a097e14ff0f17d7fb9abe

* Style tweaks
** Spaces after the "!" of titles
** Blank line after titles
** Sentence Case for Heading Text
* Make use of wikitext-example-without-html macro for the examples
* Make use of .tip macro for tip
* Some phrasing improvements and clarifications

Taken together with the discussion in this thread, it serves to illustrate 
that maintaining documentation is difficult, intricate work requiring 
attention to detail and exhaustive knowledge of what is already there. It's 
going to be a group effort to get things up to the standard we'd all like 
to see.

Best wishes

Jeremy


On Tuesday, December 5, 2017 at 3:04:14 AM UTC, Dave Gifford - 
http://www.giffmex.org/ wrote:
>
> Hi all
>
> I like this description. Great idea.
>
> I think the section on filtered transclusion could be improved, however. 
> Here is my best attempt, for what it's worth:
>
> Wrapping a filter (for example `[tag[HelloThere]]`) with triple brackets 
> (`{{{ [tag[HelloThere]] }}}`) produces a linked list of the titles of all 
> relevant tiddlers. You can also apply a template 
>  
> to the filter, for example `{{{ [tag[HelloThere]] || 
> $:/core/ui/TagTemplate }}}`, which renders like:
>
> I hope this is helpful. I wish I had more time for helping with 
> documentation, but my employment and other personal projects are taking up 
> most of my time. Blessings to all.
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/44345d22-9039-4eaf-a50d-0453b94d6755%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Dave Gifford - http://www.giffmex.org/
Hi all

I like this description. Great idea.

I think the section on filtered transclusion could be improved, however. 
Here is my best attempt, for what it's worth:

Wrapping a filter (for example `[tag[HelloThere]]`) with triple brackets 
(`{{{ [tag[HelloThere]] }}}`) produces a linked list of the titles of all 
relevant tiddlers. You can also apply a template 
 
to the filter, for example `{{{ [tag[HelloThere]] || $:/core/ui/TagTemplate 
}}}`, which renders like:

I hope this is helpful. I wish I had more time for helping with 
documentation, but my employment and other personal projects are taking up 
most of my time. Blessings to all.

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/fa0f99aa-2866-42f6-8ac2-b79bff18c8c5%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


Re: [tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Mat
@Diego / Måns / Eric - kindly take the MissingManuals matters in a thread 
separate from this one. 


@tony wrote (and @tobaisch concurred) 
>Can I suggest full code examples that a user can copy and past into an 
*empty*.html 

Well, no. Using *empty*.html to demo generated lists is a bad idea because 
the it would have to be with shadow tids. Not very educational for newbies, 
IMO.

I opted to use tiddlers that show up when this "Intro to Lists" is in the 
context I aim for, i.e on tiddlywiki.com. The idea is not really that users 
copy this tiddler into their own TWs.


@tobaisch - this thread is about the document that I/we are writing and 
while it is (only) intended to be an "Introduction to Lists" it is not an 
actual attempt at real teaching. The links are in the doc should lead you 
to more detailed explanations. If you don't understand those explanations, 
the best thing is for you to clearly explain what it is you want to achieve 
or in more detail what it is about something that you don't understand so 
that we can explain it. Just saying "I don't understand" makes it very 
difficult for someone to explain because it is not clear WHAT you don't 
understand. Be specific, please.

<:-)

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/1cdcdc94-2ad1-4b3e-bd30-3429f1cb4cc8%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Diego Mesa
Hey tob,

I’m pretty much a newb myself. I’m happy to help you some more offline (I’ll 
email you directly)

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/eb25c25a-7266-4e6c-b066-b4a0a541bcf6%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread tobaisch

>
> So I provided a link to 
> https://tiddlywiki.com/#list-links%20Macro%20(Examples) 
> 
>  
> which shows how to use list-links.


Thats the problem.
*You think* you show me how to use list-links.
But I do not understand what you showed me.
Only you understand this explanation.
Everything is super easy and understandable for you.
You refer to a link on tiidlywiki.com and everything is fine.
It does not help if you keep showing it.
That's why I'm asking for examples.
We are spinning in a circle.
Thank you for your effort.
Regards
Tob

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/d8f1c054-336d-42c4-98e2-c1983175ed9b%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread 'Mark S.' via TiddlyWiki
There's 2 different topics. 

You asked about "behind the scenes" so I explained how the <> 
macro works. I don't know if that is ever useful, but you asked.

The other topic seems to be about how to *use *list-links. So I provided a 
link to https://tiddlywiki.com/#list-links%20Macro%20(Examples) 

 
which shows how to use list-links.

You seem to have some other question.  Post your question clearly and I'm 
sure someone can help.

Mark 

On Monday, December 4, 2017 at 10:30:36 AM UTC-8, tobaisch wrote:
>
> The website https://tiddlywiki.com is known to me.
> I also know all the examples there.
> If I search here in the forum I have already searched on 
> https://tiddlywiki.com before and found NOT a solution
> I just do not understand the explanations there.
> I can not find an answer to my questions there.
> That's why I ask here in the forum and hope for new explanations or 
> examples.
> Your Link: https://tiddlywiki.com/#list-links%20Macro%20(Examples)  d 
> oesnt
>  
> help.
>
> i mean how i used:
> type:"ul"
> subtype:"li"
> class:""
> *<$list filter="$filter$">?*
> <$subtype$>?
> <$link to={{!!title}}?
> the example: "<>" is everytime the same 
> example.
> Regards
> Tob
>
>
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/30fc67d5-e9dd-49b2-9840-3b9932769226%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


Re: [tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Måns Mårtensson
Hi Eric

I remember at one of the TiddlyWiki hangouts you told that a friend of
yours asked if he could get an empty version of your InsideTW document.

I'd love to see your InsideTW published as a TW-edition in its own right.

Is there any hope that you will publish it as a document we can use from
scratch?


Cheers Måns

2017-12-03 16:36 GMT+01:00 Eric Shulman :

> On Sunday, December 3, 2017 at 6:38:52 AM UTC-8, Diego Mesa wrote:
>>
>> I just came across Eric Shulman's impressive "Inside TiddlyWiki: The
>> Missing Manual"!
>>
>> https://github.com/ericshulman/InsideTiddlyWiki
>>
>> I know there has been a lot of discussions recently about the best new
>> user experience and a bit of a refresh of tw.com centered on new users,
>> and I thought this contributes much to the discussion!
>>
>
> Thanks... it should be noted, however, that although the "TiddlyBook"
> framework and *outline* for topics is there, and some of the introductory
> materials have been written, much of the actual instructional content is
> still incomplete.  Unfortunately, while I have a clear idea of what I
> intend to write, progress on actually completing the book has been at a
> virtual standstill for quite some time due to personal circumstances
> outside of my control (primarily health-related problems).  I still plan to
> complete the work, but it's not there yet.  Thus, the "Missing Manuals" tag
> line in my signature.
>
> Also, the URL you provided is a link to the github repository for the
> book, but there is also a direct "GitHub Pages" URL that allows you to
> directly view and interact with the document online:
>
> http://tiddlytools.github.io/InsideTW/
>
> enjoy,
> -e
> Eric Shulman
> TiddlyTools.com: "Small Tools for Big Ideas!" (tm)
> InsideTiddlyWiki: The Missing Manuals
>
> --
> 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 post to this group, send email to tiddlywiki@googlegroups.com.
> Visit this group at https://groups.google.com/group/tiddlywiki.
> To view this discussion on the web visit https://groups.google.com/d/
> msgid/tiddlywiki/f73cf084-32d1-4490-b167-4e6517116f8a%40googlegroups.com
> 
> .
>
> For more options, visit https://groups.google.com/d/optout.
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/CAK3VnJR4fmXRw-76yMZyW-QdOOpigPhtrLwHt_AqrXU8%3DRfDRw%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread tobaisch

The website https://tiddlywiki.com is known to me.
I also know all the examples there.
If I search here in the forum I have already searched on 
https://tiddlywiki.com before and found NOT a solution
I just do not understand the explanations there.
I can not find an answer to my questions there.
That's why I ask here in the forum and hope for new explanations or 
examples.
Your Link: https://tiddlywiki.com/#list-links%20Macro%20(Examples)  d 
oesnt
 
help.

i mean how i used:
type:"ul"
subtype:"li"
class:""
*<$list filter="$filter$">?*
<$subtype$>?
<$link to={{!!title}}?
the example: "<>" is everytime the same 
example.
Regards
Tob


-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/80802c34-38bf-4d91-b373-7b8e77c0b2f1%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Mat
@tobaisch

is there a example-tiddler to understand how it works in "real life"
>

Note that  http://introductiontolists.tiddlyspot.com/ does contain examples 
BUT because they list tiddlers that are missing in that TW, nothing is 
seen. The tiddler is however intended for tiddlywiki.com where you will see 
the actual output in the examples.

You can drag the tiddler or manually copy its contents into a new tiddler 
on tiddlywiki.com to see the real output examples.

<:-)

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/e219c9e4-65a8-410e-8f94-86771ba73895%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread 'Mark S.' via TiddlyWiki
You mean how it's used?

https://tiddlywiki.com/#list-links%20Macro%20(Examples)

Good luck
-- Mark

On Monday, December 4, 2017 at 9:39:07 AM UTC-8, tobaisch wrote:
>
> thx mark,
> that looks not so clear to me.
> is there a example-tiddler to understand how it works in "real life"
>
> Regard
> Tob
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/942c5080-f9cc-4350-8b7c-b4f12fdbf117%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread tobaisch
thx mark,
that looks not so clear to me.
is there a example-tiddler to understand how it works in "real life"

Regard
Tob

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/f3aa3222-9d32-4486-ab61-b7a973fdd3b5%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread 'Mark S.' via TiddlyWiki
Yes, in the actual macro it looks like this:

\define list-links(filter,type:"ul",subtype:"li",class:"")
> <$type$ class="$class$">
> *<$list filter="$filter$">*
> <$subtype$>
> <$link to={{!!title}}>
> <$transclude field="caption">
> <$view field="title"/>
> 
> 
> 
> **
> 
> \end
>

You can see that it's just a <$list> listwidget with additional stuff added.

-- Mark

On Monday, December 4, 2017 at 8:57:41 AM UTC-8, tobaisch wrote:
>
>
>
> Am Sonntag, 3. Dezember 2017 01:49:25 UTC+1 schrieb Mat:
>>
>> Behind the scenes it really is a ListWidget with some styling.
>
>
>  Behind the scenes??
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/f269cf39-1821-4b33-aa3b-1c46b724bb24%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread tobaisch


Am Sonntag, 3. Dezember 2017 02:31:36 UTC+1 schrieb TonyM:
>
> Mat,
>
> Good work, Can I suggest full code examples that a user can copy and past 
> into an empty.html to see it working, in addition I hope we may include 
> examples that refer to the current tiddler using its title, tags or fields.
> Most people learn by doing.
>

Exactly Toby, that's my opinion too.
That's exactly how I learn. 

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/fbc26568-dd6d-49c6-93fc-ce18d9e2b8b4%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Jed Carty
The extra ~ are just because the wiki has camel case linking turned off so 
the ~ to suppress the wikification of camel case show up. They won't be 
visible on tiddlywiki.com.

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/3e48cc63-2889-483e-a1c7-72b350cf05ac%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread tobaisch


Am Sonntag, 3. Dezember 2017 03:27:25 UTC+1 schrieb Mark S.:
>
> Hi Mat,
>
>
> I think without examples that show at least the output, it will be 
> confusing to newbies. 
>

Exactly my opinion. 

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/8d081402-9023-453b-8960-416b4156206f%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread tobaisch


Am Sonntag, 3. Dezember 2017 01:49:25 UTC+1 schrieb Mat:
>
> Behind the scenes it really is a ListWidget with some styling.


 Behind the scenes??

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/8539a10e-0cd8-40d4-87cb-36a632515354%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Mat
On Monday, December 4, 2017 at 4:26:40 PM UTC+1, Mark S. wrote:
>
> On my browser, WikiText and ListWidget (headlines) have tildes (~) 
> appearing in front of them. They don't show that when transferred to 
> tiddlywiki.com. Odd.
>

I guess you're talking about when you view it on my temporary site, i.e 
http://introductiontolists.tiddlyspot.com/ - i.e not on a TW of your own.

Yeah, it's probably something I've messed up in my TW template. This of 
course doesn't affect the issue we're dealing with. I just put up that site 
to share the end result of the document.

Thanks for your help.

<:-)

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/b47a69b9-b853-4ae6-86cd-169765074889%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread 'Mark S.' via TiddlyWiki
On my browser, WikiText and ListWidget (headlines) have tildes (~) 
appearing in front of them. They don't show that when transferred to 
tiddlywiki.com. Odd.

Mark 

On Monday, December 4, 2017 at 3:36:53 AM UTC-8, Mat wrote:
>
> @everybody
>
> I've filed a PR 
>  
> and you 
> can see the final(?) version  here 
> . Note that the links are 
> dead and the lists don't render because the doc is intended for 
> tiddlywiki.com that has the required data.
>
> Thanks to everyone who contributed!
>
> <:-)
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/cc4fc4b0-4ae2-40df-b15a-7fdfa871e41a%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-04 Thread Mat
@everybody

I've filed a PR 
 
and you 
can see the final(?) version  here 
. Note that the links are dead 
and the lists don't render because the doc is intended for tiddlywiki.com 
that has the required data.

Thanks to everyone who contributed!

<:-)

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/8a9ba08e-48ba-4b6d-b2a6-1c8ec2780f07%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-03 Thread Eric Shulman
On Sunday, December 3, 2017 at 6:38:52 AM UTC-8, Diego Mesa wrote:
>
> I just came across Eric Shulman's impressive "Inside TiddlyWiki: The 
> Missing Manual"! 
>
> https://github.com/ericshulman/InsideTiddlyWiki
>
> I know there has been a lot of discussions recently about the best new 
> user experience and a bit of a refresh of tw.com centered on new users, 
> and I thought this contributes much to the discussion!
>

Thanks... it should be noted, however, that although the "TiddlyBook" 
framework and *outline* for topics is there, and some of the introductory 
materials have been written, much of the actual instructional content is 
still incomplete.  Unfortunately, while I have a clear idea of what I 
intend to write, progress on actually completing the book has been at a 
virtual standstill for quite some time due to personal circumstances 
outside of my control (primarily health-related problems).  I still plan to 
complete the work, but it's not there yet.  Thus, the "Missing Manuals" tag 
line in my signature.

Also, the URL you provided is a link to the github repository for the book, 
but there is also a direct "GitHub Pages" URL that allows you to directly 
view and interact with the document online:

http://tiddlytools.github.io/InsideTW/

enjoy,
-e
Eric Shulman
TiddlyTools.com: "Small Tools for Big Ideas!" (tm)
InsideTiddlyWiki: The Missing Manuals

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/f73cf084-32d1-4490-b167-4e6517116f8a%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-03 Thread Diego Mesa
Hey all,

I just came across Eric Shulman's impressive "Inside TiddlyWiki: The 
Missing Manual"! 

https://github.com/ericshulman/InsideTiddlyWiki

I know there has been a lot of discussions recently about the best new user 
experience and a bit of a refresh of tw.com centered on new users, and I 
thought this contributes much to the discussion!

Diego

On Sunday, December 3, 2017 at 5:11:27 AM UTC-6, Mat wrote:
>
> OK, OK -  @Mark, @Tony and everyone else - let's see what we collectively 
> can come up with.
>
> Here is a public and fully editable document 
> .
>  
> Do make improvements but note that any change is seen by everyone.
>
> Keep in mind that @Jermolene is the one deciding if it cuts it for 
> tiddlywiki.com so stick to the Documentation Style Guide 
> .
>
> <:-)
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/e894e13f-2d23-4e6c-9197-919f39f67401%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-03 Thread Mat
OK, OK -  @Mark, @Tony and everyone else - let's see what we collectively 
can come up with.

Here is a public and fully editable document 

.

Keep in mind that @Jermolene is the one deciding if it cuts it for 
tiddlywiki.com so stick to the Documentation Style Guide 
.

<:-)

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/7779c89c-c429-4b24-a1da-5239644653f9%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-02 Thread TonyM
Mat,

I agree but elsewhere I pointed out what I ask for is often not available 
in existing documentation. Ideally such examples will be right next to the 
guidance that mentions it.

If I prepare some how do I contribute?

Regards
Tony


On Sunday, 3 December 2017 13:05:45 UTC+11, Mat wrote:
>
> Thanks guys.
>
> @Tony
>
> Can I suggest full code examples that a user can copy and past into an 
>> empty.html to see it working,
>>
>
> Well, the idea is for this to be included in the docs on tiddlywiki.com . 
> This is why I link to each topic there, i.e their detailed docs, where 
> examples typically are included also.
>
> <:-)
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/6dc7aa3a-4623-4c6e-9ebc-5b2358d94a24%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-02 Thread 'Mark S.' via TiddlyWiki
Hi Mat,

Nice work!

I think without examples that show at least the output, it will be 
confusing to newbies. That is, they won't immediately grasp what the power 
of the tool is that is being discussed. 

You might call "Static" something like "Static/Manual Lists" to convey that 
it's being done by hand.

Good luck!
Mark

On Saturday, December 2, 2017 at 6:05:45 PM UTC-8, Mat wrote:
>
> Thanks guys.
>
> @Tony
>
> Can I suggest full code examples that a user can copy and past into an 
>> empty.html to see it working,
>>
>
> Well, the idea is for this to be included in the docs on tiddlywiki.com . 
> This is why I link to each topic there, i.e their detailed docs, where 
> examples typically are included also.
>
> <:-)
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/8fc33de3-0a01-47fe-bdb3-9bc8dcd2773e%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-02 Thread TonyM
Mat,

Good work, Can I suggest full code examples that a user can copy and past 
into an empty.html to see it working, in addition I hope we may include 
examples that refer to the current tiddler using its title, tags or fields.
Most people learn by doing.

Thaks
Tony

On Sunday, 3 December 2017 11:49:25 UTC+11, Mat wrote:
>
> I hope to get the following "Introductions to Lists" into tiddlywiki.com. 
> The text is intentionally brief - it is just an overview of the relevant 
> concepts collect in one place.
>
> This could/should perhaps be posted on TiddlyWikiDocs 
> ... but I figured 
> this forum is more likely to give feedback, especially from noobs. I'm also 
> hoping the Wizards here will point out if anything is missing or wrong.
>
> Note: If you don't like the wikitext formatting below, you can paste the 
> text right into a tiddler on tiddlywiki.com to read it more easily and 
> with working links.
>
> <:-)
>
> ---
>
> title: Introduction to Lists
>
>
> tags: Learning
>
>
> text:
>
> Lists play a central role in TiddlyWiki and there are several aspects of 
> lists worth understanding. The following is a brief run-through of some of 
> the more common techniques associated with lists.
>
> Note that lists often don’t have the typical one-item-per-row appearance. 
> This is especially true for //generated// lists (see below).
>
> !Static lists
>
> !!~WikiText
>
> WikiText lists are explicitly typed lists where special characters are 
> parsed to show special styling. Examples include bullet lists created with 
> asterisks (*) and numbered lists (#). Behind the scenes, WikiText lists are 
> based on the simple `` and `` html-elements. For more, see [[Lists 
> in WikiText]]
>
> !Generated lists
>
> Generated lists center around [[filters|Filters]] in which [[filter 
> operators|Filter Operators]] define which are the concerned tiddlers and 
> which parts of these tiddlers, such as their titles or their texts, that 
> are desired for the output. 
>
> !!~ListWidget
>
> This widget is the most powerful tool for creating lists. It allows the 
> filter output to be manipulated and styled within the ListWidget - also 
> into many forms that don't resemble lists at all, for example tables or 
> complex texts.
>
> ''Side note'': Even tiddlers themselves are made with a ListWidget. The 
> [[tiddler template|$:/core/ui/ViewTemplate]] lists the templates for each 
> constituting field of the tiddler such as the title, the tags, the text and 
> more. 
>
> !!Filtered transclusion
>
> The short form for filtered transclusion (`{{{...}}}`) takes a filter as 
> argument and outputs a line-broken but otherwise unstyled list, unless a 
> template is applied to the output. For example `{{{ [tag[HelloThere]] || 
> $:/core/ui/TagTemplate }}}` lists all tiddlers tagged HelloThere and 
> presents them as tags. 
>
> !!list-links Macro
>
> The [[list-links|list-links Macro]] macro was created to let you quickly 
> and easily get a preformatted list, typically a bullet list. Behind the 
> scenes it really is a ListWidget with some styling.
>
> !Other “list related” commands
>
> [[list|ListField]], [[list-before|Order of Tagged Tiddlers]] and 
> [[list-after|Order of Tagged Tiddlers]] are all //field names// to control 
> the position of tiddlers in a list.
>
> [[list|list Operator]] and [[listed|listed Operator]] are //filter 
> operators// that operate on the [[list field|ListField]]. ([[listed|listed 
> Operator]] can also operator on other fields.)
>
>
>
>
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/2edde2eb-2228-4842-b44d-a733e8bc85b6%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[tw] Re: [docs] Introduction to Lists

2017-12-02 Thread Diego Mesa
Thanks for this Mat! Its very helpful and I think essential to the new user 
experience! 

On Saturday, December 2, 2017 at 6:49:25 PM UTC-6, Mat wrote:
>
> I hope to get the following "Introductions to Lists" into tiddlywiki.com. 
> The text is intentionally brief - it is just an overview of the relevant 
> concepts collect in one place.
>
> This could/should perhaps be posted on TiddlyWikiDocs 
> ... but I figured 
> this forum is more likely to give feedback, especially from noobs. I'm also 
> hoping the Wizards here will point out if anything is missing or wrong.
>
> Note: If you don't like the wikitext formatting below, you can paste the 
> text right into a tiddler on tiddlywiki.com to read it more easily and 
> with working links.
>
> <:-)
>
> ---
>
> title: Introduction to Lists
>
>
> tags: Learning
>
>
> text:
>
> Lists play a central role in TiddlyWiki and there are several aspects of 
> lists worth understanding. The following is a brief run-through of some of 
> the more common techniques associated with lists.
>
> Note that lists often don’t have the typical one-item-per-row appearance. 
> This is especially true for //generated// lists (see below).
>
> !Static lists
>
> !!~WikiText
>
> WikiText lists are explicitly typed lists where special characters are 
> parsed to show special styling. Examples include bullet lists created with 
> asterisks (*) and numbered lists (#). Behind the scenes, WikiText lists are 
> based on the simple `` and `` html-elements. For more, see [[Lists 
> in WikiText]]
>
> !Generated lists
>
> Generated lists center around [[filters|Filters]] in which [[filter 
> operators|Filter Operators]] define which are the concerned tiddlers and 
> which parts of these tiddlers, such as their titles or their texts, that 
> are desired for the output. 
>
> !!~ListWidget
>
> This widget is the most powerful tool for creating lists. It allows the 
> filter output to be manipulated and styled within the ListWidget - also 
> into many forms that don't resemble lists at all, for example tables or 
> complex texts.
>
> ''Side note'': Even tiddlers themselves are made with a ListWidget. The 
> [[tiddler template|$:/core/ui/ViewTemplate]] lists the templates for each 
> constituting field of the tiddler such as the title, the tags, the text and 
> more. 
>
> !!Filtered transclusion
>
> The short form for filtered transclusion (`{{{...}}}`) takes a filter as 
> argument and outputs a line-broken but otherwise unstyled list, unless a 
> template is applied to the output. For example `{{{ [tag[HelloThere]] || 
> $:/core/ui/TagTemplate }}}` lists all tiddlers tagged HelloThere and 
> presents them as tags. 
>
> !!list-links Macro
>
> The [[list-links|list-links Macro]] macro was created to let you quickly 
> and easily get a preformatted list, typically a bullet list. Behind the 
> scenes it really is a ListWidget with some styling.
>
> !Other “list related” commands
>
> [[list|ListField]], [[list-before|Order of Tagged Tiddlers]] and 
> [[list-after|Order of Tagged Tiddlers]] are all //field names// to control 
> the position of tiddlers in a list.
>
> [[list|list Operator]] and [[listed|listed Operator]] are //filter 
> operators// that operate on the [[list field|ListField]]. ([[listed|listed 
> Operator]] can also operator on other fields.)
>
>
>
>
>

-- 
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 post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/12145cc8-8e41-4457-b90f-5d1d9ab84a78%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.