mailing-list for TeXmacs Users

Text archives Help


Re: facilities to comment documents


Chronological Thread 
  • From: Frank <address@hidden>
  • To: marc lalaude-labayle <address@hidden>,Massimiliano Gubinelli <address@hidden>
  • Cc: texmacs-users <address@hidden>
  • Subject: Re: facilities to comment documents
  • Date: Fri, 04 Dec 2020 09:10:21 +0000

Hi max and all,

Joris answered my question before. This could be implemented by a macro like

(show-comment "body") = body
(hide-comment "body") = empty

and use an if branch to detect whether the boolean variable draft-mode is
true or not, and then return show-comment or hide-comment macro.

There is a disadvantage of this implement: when I set draft-mode to be false,
there will be an extra empty line. I don't know how to suppress it.

Meanwhile, you can add comments to
http://forum.texmacs.cn/t/tricks-for-drafts/199/4
then somehow export it to wiki.

Best,
Frank

于 December 4, 2020 9:04:00 AM UTC, marc lalaude-labayle <address@hidden> 写到:
>To be precise, since I just used it : what I use is called "etiquette"
>in
>the french texmacs version ; these are obtained with Alt+! on my ubuntu
>machine.
>
>Marc
>
>Le ven. 4 déc. 2020 à 09:58, marc lalaude-labayle
><address@hidden>
>a écrit :
>
>> Hi.
>>
>> I do need some of these features for my files. I use the label flags
>and
>> write what I need, which is barely longer than 10 words. I do like to
>have
>> the comments accessible within my file : these files are for my
>teaching
>> and I keep tracks of their origins.
>>
>> I don't use the versioning markup, but the possibility to open a
>small
>> window with all the texmacs features by a simple click on a flag (for
>> example) could be really helpful when I do share my files for
>exercise or
>> exams with my colleagues.
>>
>> So I do really prefer your first proposal too.
>>
>> Marc
>>
>> Le ven. 4 déc. 2020 à 08:08, Massimiliano Gubinelli
><address@hidden>
>> a écrit :
>>
>>> Dear all,
>>> discussing with some friends I became aware of some advantage of
>>> unstructured editing for which we should provide some alternative.
>This is
>>> the possibility (common in programming, but also in some research
>workflow)
>>> to add comments on a document which will not appear in the final
>version
>>> (i.e. in the PDF, on in the HTML or LaTeX export -- In some sense,
>the dual
>>> of literate programming, maybe we can call it co-literate editing
>:)).
>>>
>>> These comments can be parts of the document one do not want to make
>to
>>> the final version, or just reminders to explore some directions, or
>parts
>>> one has to cut because of editorial constraints or referees
>comments, but
>>> anyway one wants to keep in place and not just delete them (because
>maybe
>>> the paper has a short and long versions). These comments can also be
>simply
>>> discussion between various co-authors, so it would be nice if they
>carry
>>> tags, like the name of the author. And then have a macro facility to
>view
>>> only certain subclasses of comments and make them invisible (i.e.
>just
>>> leave a flag or some other indicator which do not modify the
>typesetting)
>>> if the user wants. This should not be difficult to code, is
>something
>>> similar to the versioning markup we already have, but I think it
>would be a
>>> useful addition to everyday workflows.
>>> It could also be a way to edit the metadata in the document.
>>>
>>> Of course one has (at least) two options to design such a facility:
>make
>>> the additional content editable as part of the document (as in the
>proposal
>>> above), or keep it in the document as always invisible and make it
>editable
>>> only via some separate GUI element, i.e. a dialog with an embedded
>editor
>>> (like we have now for search and replace, for example, or for the
>macro
>>> editor). I think I would prefer the first approach, though.
>>>
>>> Thoughts, ideas, comments, on such a facility?
>>>
>>> Max
>>>
>>> ps: on a similar direction a document can have a "draft" mode where
>>> markups like \todo or these comments are visible and a "final" mode,
>where
>>> they are invisible.
>>>
>>>

--
使用 K-9 Mail 发送自我的Android设备。



Archive powered by MHonArc 2.6.19.

Top of page