Want to take part in these discussions? Sign in if you have an account, or apply for one below
Vanilla 1.1.10 is a product of Lussumo. More Information: Documentation, Community Support.
Is there a syntax for comments in the Instiki source code? Some way to include text into an nLab entry source that gets completely ignored when rendering the page?
Following the suggestion in this Stack Overflow answer, it looks like comments of the form
[//]: # (This syntax works like a comment, and won't appear in any output.)
do the job.
There is no general way for including arbitrary comment text that won’t be processed by Instiki and won’t be displayed.
I recall finding (but I can’t find now) some discussion about putting stuff on the very first line that will be ignored by Instiki.
If you just want text (which will be processed but won’t display) you could wrap a paragraph in something like +-- {: .Comment}
and alter the CSS to make that class display none
.
I just tried using +-- {: .hide}
but either I did something wrong or the CSS that makes .hide
work for TOCs doesn’t apply there.
Thanks for the help!
Now I remembered that once there was somebody who tried to equip all nLab entries that describe certain categories with standardized data describing that category. You can see this for instance at the bottom of ncatlab.org/nlab/source/Set. The code he used to do that is
{:data
...
}
{:data
Hmm. I can’t find mention that Instiki actually parses that. It looks like :data
is unknown and probably shows up in the error log. I tested using {:piffle
.
It appears Instiki skips over everything until it finds a matching }
though not one escaped as \}
. I didn’t check if all parsing, such as escaping into math mode, is suppressed.
I see, thanks.
Is there any chance we could get LaTeX-style comments? Even just for lines starting with %, this would be very convenient. I would like to paste the LaTeX output of quiver into pages, which includes a link to edit the diagram in a comment. It’s a bit inconvenient to replace this comment with the syntax suggested in #2 each time.
Since recently we have available major funding and were now looking into finally hiring a company to rewrite the nLab software. This would allow to request features like this one.
However, for the moment I am stuck with how to proceed. The small German company which was involved with us previously decided a full rewrite is beyond their possibilities. Now I am not sure what next step to take.
1 to 8 of 8