* Documentation of change / Evolving documents
@ 2019-01-19 8:06 Axel Kielhorn
2019-09-29 6:59 ` Axel Kielhorn
0 siblings, 1 reply; 6+ messages in thread
From: Axel Kielhorn @ 2019-01-19 8:06 UTC (permalink / raw)
To: ntg-context
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
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!
maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage : http://www.pragma-ade.nl / http://context.aanhet.net
archive : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___________________________________________________________________________________
^ permalink raw reply [flat|nested] 6+ messages in thread* Re: Documentation of change / Evolving documents 2019-01-19 8:06 Documentation of change / Evolving documents Axel Kielhorn @ 2019-09-29 6:59 ` Axel Kielhorn 2019-09-29 8:36 ` Henning Hraban Ramm 0 siblings, 1 reply; 6+ messages in thread From: Axel Kielhorn @ 2019-09-29 6:59 UTC (permalink / raw) To: ntg-context [-- Attachment #1: Type: text/plain, Size: 982 bytes --] > Am 19.01.2019 um 09:06 schrieb Axel Kielhorn <tex@axelkielhorn.de>: 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 [-- Attachment #2: context_change.tex --] [-- Type: application/octet-stream, Size: 2823 bytes --] % !TEX TS-program = ConTeXt (LuaTeX 1.0.9) % !TEX encoding = UTF-8 Unicode % Copyright 2018 - 2019 Axel Kielhorn % Lizenz: CC-BY-SA 4.0 Unported http://creativecommons.org/licenses/by-sa/4.0/deed.de \enablemode[change] \setuphyphenation[method=expanded] \language[de] \mainlanguage[de] \setbreakpoints[compound] \setuppapersize [A4][A4] \setuplayout [width=middle, backspace=1.5in, cutspace=1.5in, height=middle, topspace=0.75in, bottomspace=0.75in] \setupbodyfont[11pt] % Register für Version \defineregister [changev] \setupregister [changev] [ indicator=no %% no letter style=sansbold, %% headings textstyle=slanted, %% entries pagestyle=bolditalic, %% page refs n=1, %% columns ] % Register für Datum \defineregister [changed] \setupregister [changed] [ indicator=no %% no letter style=sansbold, %% headings textstyle=slanted, %% entries pagestyle=bolditalic, %% page refs n=1, %% columns ] \def\ChangeV#1#2{\changev{#1+#2}\doifmode{change}{\inmargin{\tx #1}{\blue #2\par}}} \def\ChangeD#1#2{\changed{#1+#2}\doifmode{change}{\inmargin{\tx #1}{\blue #2\par}}} % Paragraph added \def\ChangeA#1#2{\doifmode{change}{\inmargin{\tx #1}\startsidebar[rulecolor=darkgreen]}#2\doifmode{change}{\stopsidebar}} % Paragraph removed \def\ChangeR#1#2{\doifmode{change}{\inmargin{\tx #1}\startsidebar[rulecolor=red]#2\stopsidebar}} \def\Changer#1{{\doifmode{change}{\red #1}}} \def\Changea#1{{\doifmode{change}{\darkgreen}#1}} \def\Changec#1#2{{\doifmode{change}{\red #1\darkgreen}#2}} \starttext \ChangeV{V. 1.0}{Fertig!} \ChangeR{V. 2.0}{\input knuth} \ChangeD{2018-12-22}{Fertig!} \ChangeD{2018-12-23}{Letzter Fehler beseitigt.} \ChangeA{V. 2.0}{\input knuth} \ChangeD{2018-12-23}{Allerletzter Fehler beseitigt.} In diesem Satz war ein \Changec{Fähler}{Fehler}. \ChangeV{V. 2.0}{Farben geändert} \ChangeA{V. 2.0}{Die Änderungskommentare werden jetzt in {\blue blau} ausgegeben, da {\red rot} für gelöschte Texte und {\darkgreen grün} für hinzugefügte Texte verwendet wird.} \ChangeV{V. 2.0}{Neue Befehle \type{ChangeA}, \type{ChangeR}, \type{Changea}, \type{Changer} und \type{Changec}} \ChangeA{V. 2.0}{Mit den Befehlen \type{\ChangeA} und \type{\ChangeR} werden hinzugefügte bzw. gelöschte Absätze gekennzeichnet.} \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.} Ende \startsection[title={History}] Nach Versionsnummer: \placechangev \blank[big] Nach Datum: \placechanged \stopsection \stoptext [-- Attachment #3: Type: text/plain, Size: 3 bytes --] [-- Attachment #4: Type: text/plain, Size: 493 bytes --] ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://context.aanhet.net archive : https://bitbucket.org/phg/context-mirror/commits/ wiki : http://contextgarden.net ___________________________________________________________________________________ ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Documentation of change / Evolving documents 2019-09-29 6:59 ` Axel Kielhorn @ 2019-09-29 8:36 ` Henning Hraban Ramm 2019-09-29 8:50 ` Wolfgang Schuster 0 siblings, 1 reply; 6+ messages in thread From: Henning Hraban Ramm @ 2019-09-29 8:36 UTC (permalink / raw) To: mailing list for ConTeXt users > Am 2019-09-29 um 08:59 schrieb Axel Kielhorn <tex@axelkielhorn.de>: > > 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 ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://context.aanhet.net archive : https://bitbucket.org/phg/context-mirror/commits/ wiki : http://contextgarden.net ___________________________________________________________________________________ ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Documentation of change / Evolving documents 2019-09-29 8:36 ` Henning Hraban Ramm @ 2019-09-29 8:50 ` Wolfgang Schuster 2019-09-29 12:34 ` Axel Kielhorn 0 siblings, 1 reply; 6+ messages in thread From: Wolfgang Schuster @ 2019-09-29 8:50 UTC (permalink / raw) To: mailing list for ConTeXt users, Henning Hraban Ramm Henning Hraban Ramm schrieb am 29.09.2019 um 10:36: >> Am 2019-09-29 um 08:59 schrieb Axel Kielhorn <tex@axelkielhorn.de>: >> >> 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 ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://context.aanhet.net archive : https://bitbucket.org/phg/context-mirror/commits/ wiki : http://contextgarden.net ___________________________________________________________________________________ ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Documentation of change / Evolving documents 2019-09-29 8:50 ` Wolfgang Schuster @ 2019-09-29 12:34 ` Axel Kielhorn 2019-10-11 8:18 ` Axel Kielhorn 0 siblings, 1 reply; 6+ messages in thread From: Axel Kielhorn @ 2019-09-29 12:34 UTC (permalink / raw) To: ntg-context > Am 29.09.2019 um 10:50 schrieb Wolfgang Schuster <wolfgang.schuster.lists@gmail.com>: > > Henning Hraban Ramm schrieb am 29.09.2019 um 10:36: >>> Am 2019-09-29 um 08:59 schrieb Axel Kielhorn <tex@axelkielhorn.de>: >>> >>> 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 ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://context.aanhet.net archive : https://bitbucket.org/phg/context-mirror/commits/ wiki : http://contextgarden.net ___________________________________________________________________________________ ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Documentation of change / Evolving documents 2019-09-29 12:34 ` Axel Kielhorn @ 2019-10-11 8:18 ` Axel Kielhorn 0 siblings, 0 replies; 6+ messages in thread From: Axel Kielhorn @ 2019-10-11 8:18 UTC (permalink / raw) To: ntg-context 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 ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://context.aanhet.net archive : https://bitbucket.org/phg/context-mirror/commits/ wiki : http://contextgarden.net ___________________________________________________________________________________ ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2019-10-11 8:18 UTC | newest] Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2019-01-19 8:06 Documentation of change / Evolving documents Axel Kielhorn 2019-09-29 6:59 ` Axel Kielhorn 2019-09-29 8:36 ` Henning Hraban Ramm 2019-09-29 8:50 ` Wolfgang Schuster 2019-09-29 12:34 ` Axel Kielhorn 2019-10-11 8:18 ` Axel Kielhorn
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).