search

yesodweb / yesodweb.com-content

Content for the www.yesodweb.com site
http://www.yesodweb.com/
Other
67 stars 112 forks source link

add to shakespeare chapter notes about in-line comments #141

Open wolftune opened 9 years ago

wolftune commented 9 years ago

There's no reference in the chapter about recommended comment syntax for the shakespeare languages

wolftune commented 9 years ago

Is it $# for hamlet and /* comment */ for cassius/lucius/julius? I'm not clear on this myself, otherwise I might have put in a PR for this item… I know <!-- comment --> works in hamlet, but, hmm… am I missing anything? Any points here?

chreekat commented 9 years ago

$# for hamlet apparently: code, tests.

That's just in addition to the comments that exist for the languages being templated, which pass through unmolested. CSS and JavaScript use /* ... */, JS also uses // ..., and HTML uses <!-- .... -->

wolftune commented 9 years ago

@chreekat by my tests, the html comment doesn't exactly pass through in that the comment is not present in the rendered HTML… perhaps it would be ideal if there were a way to include the comment in the rendered HTML…

benjamingoldstein commented 5 years ago

I discovered that the way to have the comment rendered in the end HTML is to write:

\<!-- This will show up -->

A lot of these great tips are here in open issues, how can we help contribute them to the book so that Michael (et al?) doesn't have to schlep through it all, to extract the summary to include it in the book content?