Command/ comment

From Wiki
< Command(Redirected from Command/comment)
Jump to navigation Jump to search


\comment

Summary

The instances of \comment create PDF annotations: little balloon or text icons that one can click to reveal the comment.

Instances

\comment

Settings instance

\COMMENT[...][...=...,...]{...}
[...]text
...=...,...inherits from \setupcomment
{...}text

Description

There is also an environment form: \startcomment

These comments don’t mark any content, therefore it makes sense to move them into the margin.

\setupcomment[
  author=Editor,
  color=pdfhighlight:Editor,
  location=rightmargin,
  symbol=Comment,
]

Examples

text markup comments

So far, text markup annotations (like a text marker with or without a comment) weren’t possible. In 2024-09 we got \PDFhighlight:

\setupinteraction[state=start]

\enabledirectives[backend.pdf.fixhighlight]

\definecolor[pdfhighlight:Hraban][r=.8,g=1,b=1]
\definecolor[pdfhighlight:Hans]  [r=1,g=.8,b=1]
\definecolor[pdfhighlight:Ton]   [r=1,g=1,b=.8]

\starttext

test \PDFhighlight[Hraban][My comment]{\samplefile{tufte}} test \blank

test \PDFhighlight[Hans]{what a mess} test \page

test \PDFhighlight[Ton][I would prefer the other one.]{\samplefile{ward}} test \page

\stoptext

The directive backend.pdf.fixhighlight works around an error in PDF viewer implementations (esp. Adobe’s) that exchanged the coordinates of two corners of the highlight box, contradicting the PDF specifications. Most PDF viewers (that show annotations at all) can cope with the “fixed wrong” version, only a few adhere to the specs.

Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: