On 05/12/11 14:10, Dag Wieers wrote:
On Mon, 5 Dec 2011, Lex Trotman wrote:
I have to disagree about this, comment blocks are meant to not
generate output, we should not change that in a backward incompatible
way. Using the same markup in different ways in different backends is
a "bad thing" (tm).
I wasn't talking about comment blocks, but commented lines.
Comments have two common functions: for temporarily excluding content and for
notes that are *not* intended to be read buy the document consumer.
An annotation on the other hand is meant to be read by the document consumer.
lowriter uses an 'Insert->Comment' command to insert an office:annotation
element which is readable if you open the document with lowriter, but it is not
readable from a printed version of the document. Kind of confusing, but I guess
the rationale is that odf source documents are for document creators, printed
outputs are for consumers -- in this respect they are comments not annotations.
Here's my question: if you are are authoring a document using asciidoc (i.e. not
lowriter) what is the point of passing comments through to ODF?
Cheers, Stuart
However adding a new block output type as Stuart suggested should be
ok. But the terminology needs to be clear. It should be easy to make
it clear that you are talking about a comment block which doesn't
produce output or comment xxx that does.
That's why I called it an annotation block.
It looks to me to be another form of annotation with author and date
options. So long as you can suggest backends for html and docbook
that generate the same look as ODT then it should be ok to be added to
standard asciidoc. A comment annotation should be sufficiently
different from a comment block to be easy to distinguish.
But for working with AsciiDoc files, comments are a lot more convenient than
annotation blocks as proposed by Stuart IMNSHO.
However I did implement it now, updated the README and added examples to the
test-odt.txt. Annotations are also described in the DocBook syntax.
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
