Template2 icon indicating copy to clipboard operation
Template2 copied to clipboard

Add English synonyms in the manual to increase googlability

Open petdance opened this issue 5 years ago • 4 comments

I was searching for info about the [%~ in TT and was googling for things like "template toolkit tilde" but was coming up empty.

This page had the info was looking for, but I couldn't find it via searching.

If instead of

To remove all whitespace including any number of newlines, use the '~' character instead.

it had said, for example,

To remove all whitespace including any number of newlines, use the tilde '~' character instead.

then I bet it would have come up in my search results.

Other examples:

To collapse all whitespace to a single space, use the '=' character.

Say "equals"

you can use '+' to disable any chomping options

Say "plus sign"

splitting paths only on ':' characters that aren't followed by a '/'.

Say "colon" and "slash".

To be clear, I'm saying that both the sign and the English word for the sign should be included.

petdance avatar Jan 20 '20 20:01 petdance

sounds a good idea @petdance would you like to submit a patch for these changes?

atoomic avatar Jan 27 '20 16:01 atoomic

Let me take a look and see what I can do.

Where's the repo for the website?

petdance avatar Jan 27 '20 16:01 petdance

I think the website is generated from the pods from this repo the sentence you were pointing at for example is here: https://github.com/abw/Template2/blob/master/lib/Template/Manual/Config.pod#L202

We would then have to refresh the website, but this is something else lol

atoomic avatar Jan 27 '20 16:01 atoomic

I think this was solved by the PR and this issue can be closed. The change is also live on http://template-toolkit.org/docs/manual/Config.html

dboehmer avatar Sep 04 '23 10:09 dboehmer