Markup for comments

Markup for comments would help me remember some mundane details, without distracting the page visitors.

Two kinds:

• Comments that are limited to the page source
  • for development notes to myself
• Comments that are carried into HTML as comments
  • for clarification, credits and copyright notices

I suppose this should be two separate feature requests, as you want to solve two different problems here. Personally I like how wiki markup is almost WYSIWYG – that is, the rendered text is very similar to its source markup, differing only in some special characters that are normally not read aloud anyways. That's why I would like to avoid introducing comments if possible, and look for different ways of solving those two problems.

Notes to yourself can be probably just marked up differently, for example using the quotations markup

like this

or just by making the text italic or [putting it in square brackets]. The last two ways are the standard way of adding editor notes, by the way. Alternatively, if you really don't want them to show up on the page, you could maybe put them on a separate page?

The second case is easier: you can add any HTML to the wiki's header using configuration options, so you can put any required copyright notices and meta tags in there. I hope this helps. – Radomir Dopieralski

Another use case for comments is 'Vim modelines'.

Previously I had been automatically enabling Hatta highlights within Vim, based upon filename extension, i.e. xxx.hat. I've refactored all file and page names to drop the '.hat', which is more Wiki-like.

Hatta highlights are now enabled by 'Vim modelines', i.e.
modeline vim: filetype=hat :
is placed near the bottom of every page. I'd like to wrap it within a Markup comment to prevent it from being displayed and confusing visitors.

Question: is there a preferred markup syntax for comments? I might try hacking it myself. – Randy

This is a tough one, as Creole used up all the cool ones. Maybe you could put it inside a macro, and have it hidden with CSS? – Radomir Dopieralski

Thanks ! That was just the hint I needed. It works great.

I've never used Hatta macros nor html <DIV> before. I'm learning more than I really wanted to about CSS, HTML, etc. but the pain has been tolerable and the results are good.

Step-by-step notes will be in my Hatta help pages. – Randy