Documentation of change / Evolving documents
Hi, I often have documents that are not finished but need to change over time. A client changes their mind, laws are changed, … While working with the document, I want to see the changes. When the document is finally finished, I only want to see the change history. I came up with the following. When the mode is „change“ the date (or version) is shown in the margin and the change is printed in red. Without mode „change“ only the change history is printed. What I want now is to change the layout of the register. Adding some vspace around the date and printing the date in bold. Is there a way to achieve this or am I on the wrong way? (Should the date be the indicator, thus giving me the layout I want?) \enablemode[change] \setuppapersize [A4][A4] \setuplayout [width=middle, backspace=1.5in, cutspace=1.5in, height=middle, topspace=0.75in, bottomspace=0.75in] \setupbodyfont[11pt] \defineregister [change] \setupregister [change] [ indicator=no %% no letter style=sansbold, %% headings textstyle=slanted, %% entries pagestyle=bolditalic, %% page refs n=1, %% columns ] \def\ChangeV#1#2{\change{#1+#2}\doifmode{change}{\inmargin{\tx #1}{\red #2\par}}} \def\ChangeD#1#2{\change{#1+#2}\doifmode{change}{\inmargin{\tx #1}{\red #2\par}}} \starttext \ChangeV{V. 1.0}{Fertig!} \input knuth \ChangeD{2018-12-22}{Fertig!} \ChangeD{2018-12-23}{Letzter Fehler beseitigt.} \input knuth \ChangeD{2018-12-23}{Allerletzter Fehler beseitigt.} Ende \startsection[title={History}] \placechange \stopsection \stoptext
Am 19.01.2019 um 09:06 schrieb Axel Kielhorn
:
Earlier this year I wrote a first attempt to document evolving documents. In the meantime this document has evolved and I included the current version here. There is only one thing I don’t like: Currently I write: \ChangeA{V. 2.0}{Mit den Befehlen \type{\Changea}, \type{\Changer} und \type{\Changec} werden hinzugefügte, gelöschte oder geänderte Satzteile gekennzeichnet. Der Befehl \type{\Changec} hat zwei Argumente: alter Text und neuer Text.} But I would prefer to write \startChangeA{V. 2.0} Mit den Befehlen \type{\Changea}, \type{\Changer} und \type{\Changec} werden hinzugefügte, gelöschte oder geänderte Satzteile gekennzeichnet. Der Befehl \type{\Changec} hat zwei Argumente: alter Text und neuer Text. \stopChangeA Or maybe: \startChangeA[version={V. 2.0}] Once this is fixed I’d like to translate it to english and put it into the Wiki. Greetings Axel
Am 2019-09-29 um 08:59 schrieb Axel Kielhorn
: But I would prefer to write
\startChangeA{V. 2.0} Mit den Befehlen \type{\Changea}, \type{\Changer} und \type{\Changec} werden hinzugefügte, gelöschte oder geänderte Satzteile gekennzeichnet. Der Befehl \type{\Changec} hat zwei Argumente: alter Text und neuer Text. \stopChangeA
See https://wiki.contextgarden.net/Command/definestartstop
Or maybe: \startChangeA[version={V. 2.0}]
This could help: https://wiki.contextgarden.net/System_Macros/Handling_Arguments
Once this is fixed I’d like to translate it to english and put it into the Wiki.
Looking forward to it. Grüßlinge, Hraban --- https://www.fiee.net http://wiki.contextgarden.net https://www.dreiviertelhaus.de GPG Key ID 1C9B22FD
Henning Hraban Ramm schrieb am 29.09.2019 um 10:36:
Am 2019-09-29 um 08:59 schrieb Axel Kielhorn
: But I would prefer to write
\startChangeA{V. 2.0} Mit den Befehlen \type{\Changea}, \type{\Changer} und \type{\Changec} werden hinzugefügte, gelöschte oder geänderte Satzteile gekennzeichnet. Der Befehl \type{\Changec} hat zwei Argumente: alter Text und neuer Text. \stopChangeA See https://wiki.contextgarden.net/Command/definestartstop
Another option: https://wiki.contextgarden.net/Command/startuserdata Wolfgang
Am 29.09.2019 um 10:50 schrieb Wolfgang Schuster
: Henning Hraban Ramm schrieb am 29.09.2019 um 10:36:
Am 2019-09-29 um 08:59 schrieb Axel Kielhorn
: But I would prefer to write
\startChangeA{V. 2.0} Mit den Befehlen \type{\Changea}, \type{\Changer} und \type{\Changec} werden hinzugefügte, gelöschte oder geänderte Satzteile gekennzeichnet. Der Befehl \type{\Changec} hat zwei Argumente: alter Text und neuer Text. \stopChangeA See https://wiki.contextgarden.net/Command/definestartstop
Another option: https://wiki.contextgarden.net/Command/startuserdata
Wolfgang
Thanks! I’ll look into next weekend. Greetings Axel
Hello! I have added my document about evolving documents to the Wiki at: https://wiki.contextgarden.net/Changes_Evolution and included it into the list of sample documents. Share and enjoy Axel
participants (3)
-
Axel Kielhorn
-
Henning Hraban Ramm
-
Wolfgang Schuster