Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-06 Thread Joachim Kreimer-de Fries
- hartelik dankseggen! -

What a beatific surprise when I opened my Mail in the late morning  
for the first time: all my yesterdays problems with marginal notes in  
ConTeXt and Hans' Code resolved, almost all used commands and  
elements explained, so that I have won confidence that I shall make  
it to configure the marginalia in the wanted format and to learn and  
use ConTeXt.

I'm really impressed of your helpfullness!

Thank you, Hans, for the improved code and expanation, thank you,  
Tobias and Aditya for the explanations and the links, also for the  
correction of the code regarding \plusone (that was the reason for  
the typeset accent signs ´ instead of superscript numbers in the body  
text)!

Despite your extended help, I have still acquire a lot to build my  
first little document in ConTeXt - I postponed this learning process  
to have more certainty that the marginalia question can be resolved  
and confidence that I can make it.

Am 06.06.2008 um 00:24 schrieb Hans Hagen:
 concerning documentation ... if i had 60 hours in a day   
 keeping up
 with user demands, developments, my work etc etc takes time too

I understand this very well, the more I'm happy for the help.

 the best resource for special
 cases is still this mailing list since others may have needed you
 rfeature before

As was demonstrated... I'll come back to this, when certainly needed  
again.

Prachtig wiekenende!
Goutgaun!
joachim
--
Kreimer-de Fries



___
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://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-05 Thread Hans Hagen
Joachim Kreimer-de Fries wrote:
 Hey friendly helpers,
 
 I see, this list is one for experts and programmers, less for simple 
 users. But given that there is no list for beginners of ConTeXt, I make 
 my last attempt to get help in the following problem:
 
 How to create _numbered_ margin notes in ConTeXt?

quick and dirty command (instead one can use enumerations and do some 
complex setup)

\def\mnote{\dosingleempty\domnote}

\def\domnote[#1]#2%
   {\doglobal\increment\MyMarginalNote\plusone
\inmargin
  {\MyMarginalNote:
   \doifsomething{#1}
 {\expanded{\textreference[#1]{\MyMarginalNote}}}%
   #2}}

\setupinmargin[stack=yes]

\starttext

bla bla bla \mnote{xxx} bla bla bla bla bla bla bla bla bla bla bla bla 
bla bla bla bla bla bla bla bla bla
bla bla bla \mnote[foo]{xxx} bla bla bla bla bla bla bla bla bla bla bla 
bla bla bla bla bla bla bla bla bla bla
bla bla bla \mnote{xxx} bla \mnote{xxx} bla bla bla bla bla bla bla bla 
bla bla bla bla bla bla bla bla bla bla bla bla

in \in {note} [foo]

\stoptext


-
   Hans Hagen | PRAGMA ADE
   Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
  tel: 038 477 53 69 | fax: 038 477 53 74 | www.pragma-ade.com
  | www.pragma-pod.nl
-
___
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://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-05 Thread Taco Hoekwater

Hi,

Joachim Kreimer-de Fries wrote:
 Hey friendly helpers,
 
 I see, this list is one for experts and programmers, less for simple 
 users. But given that there is no list for beginners of ConTeXt, I make 
 my last attempt to get help in the following problem:
 
 How to create _numbered_ margin notes in ConTeXt?

This may be possible, but if it is, I do not know how. I reply
just to let you know that I have read your message.

Best wishes,
Taco
___
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://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-05 Thread Joachim Kreimer-de Fries

In friendly and helpfully answering to my late night question

 How to create _numbered_ margin notes in ConTeXt?

Hans Hagen wrote 05.06.2008 at 10:04:
 quick and dirty command (instead one can use enumerations and do some
 complex setup)

Before ending this day, I want to thank you for your endeavour (also  
for Taco's attentive regret).

Dear Hans, you know what your code produces:

- indeed, the marginal notes are numbered (I can live with the fact  
that this is not the kind numbering of notes (cf. footnotes) one -  
the reader - expects);

- indeed the notes are no longer printed one over the other.

BUT:

- the accent sign ( ´ ) placed in the text body before the next word  
following that wich is explained in the marginal note will not be  
accepted and understood by the readers. It must, of course, be a  
superscripts number (the same number as in the referencing marginal  
note).

AND:

You won't really expect that someone outside the circle of you  
programmers who have developed ConTeXt, i. e. a simple (beginning)  
user of ConTeXt - even if highly willing to learn, is able to change  
this code in a way to get the wanted results (which I had illustrated  
with the pdf-file produced under extremly frustrating formating  
effort with OpenOffice Writer).

With two exceptions (\def and \setupinmargin) I did not find any of  
the used commands documented in ConTEXt - the manual or the  
commands quick reference of 2001. I could not verify in the http:// 
texshow.contextgarden.net/
because not available - as almost everytime. But from my last  
remember, when it - for once - was available, they are not in there,  
neither.

On the one hand I have still the impression, that ConTeXt is a highly  
adaptable and flexible typesetting system within TeX (probably my  
intents with marginal notes as help for understanding texts could  
find a solution),

on the other hand I'm almost giving up with my intention, because the  
only program/system with wich I a had hope to resolve this problem is  
not configurable for me, because ... I'm not a programmer or software  
developer, because you ConTeXt-developers don't care enough about  
usable, applicable documentation, because the cultural, didactical  
value of the old (hand-)  typesetting technique of marginal notes has  
come out of fashion, what ever...

N. B. I recommend the provision in ConTeXt for marginal notes in my  
intented sense warmly to you: they are an acquirement of civilization  
with big possibilities for the future and no other - at least no word  
processing program - is able to handle them yet in a acceptable manner!

Nevertheless, be it pure curiousness or still persistant hope in  
acquiring the skills for ConTeXt, I would like to know:

1.
in your sample code, Hans:
between \starttext and \stoptext you write once (the first time of  
occurrence):
 bla bla bla \mnote{xxx} bla bla

but in the second time:
 bla bla bla \mnote[foo]{xxx} bla bla bla

and then again:

 bla bla bla \mnote{xxx}

Has the [foo] after the first \mnote any relevance and which?

2.
the last row of your document text is:

 in \in {note} [foo]

in my pdf-output this appears as :

in note 2

This is not reasonable and desired (it should not appear). Was it a  
slip of the pen on your side or any purpose, if yes, which one?

All the best and
Goutgaun!
joachim
--
Kreimer-de Fries



___
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://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-05 Thread Tobias Burnus
Hi Joachim,

Joachim Kreimer-de Fries wrote:
 bla bla bla \mnote[foo]{xxx} bla bla bla
 
 Has the [foo] after the first \mnote any relevance and which?
   
Preremark: Usually, in ConTeXt, text in curly braces is printed and in 
brackets is not.

In this case, \mnote{xxx} and \mnote[foo]{xxx} print the same, but you 
defined a label foo, which you can access later like in See in my 
margin note 1 on page 22.

 in \in {note} [foo]
 
 in my pdf-output this appears as :

 in note 2
Well, this is exactly the purpose, if you want to refer to a previous 
margin note, you can access it again. \in[foo] prints the margin-note 
number. And \in{note}[foo] prefixes it with the word note. If you 
have an setup interactivity, you can click on note 2 and jump to the note.

It might well be that you do not need that feature, but sometimes it 
might becomes handy.

Tobias
___
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://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-05 Thread Hans Hagen
Joachim Kreimer-de Fries wrote:

 - indeed, the marginal notes are numbered (I can live with the fact  
 that this is not the kind numbering of notes (cf. footnotes) one -  
 the reader - expects);

you can put anything there the way you want

 - indeed the notes are no longer printed one over the other.
 
 BUT:
 
 - the accent sign ( ´ ) placed in the text body before the next word  
 following that wich is explained in the marginal note will not be  
 accepted and understood by the readers. It must, of course, be a  
 superscripts number (the same number as in the referencing marginal  
 note).

i'm not sure what accent you mean, anyhow,

\def\domnote[#1]#2%
{\doglobal\increment\MyMarginalNote\plusone
 \inmargin
   {\MyMarginalNote:
\doifsomething{#1}
  {\expanded{\textreference[#1]{\MyMarginalNote}}}%
#2}%
 \high{\MyMarginalNote}}

this will put a footnote like number in the text

 AND:
 
 You won't really expect that someone outside the circle of you  
 programmers who have developed ConTeXt, i. e. a simple (beginning)  
 user of ConTeXt - even if highly willing to learn, is able to change  
 this code in a way to get the wanted results (which I had illustrated  
 with the pdf-file produced under extremly frustrating formating  
 effort with OpenOffice Writer).

well, there are quite some users here who change code -)

it takes a while but at somepoint any user can define simple macros; 
maybe the #1 is confusing but that's just the argument

 With two exceptions (\def and \setupinmargin) I did not find any of  
 the used commands documented in ConTEXt - the manual or the  
 commands quick reference of 2001. I could not verify in the http:// 
 texshow.contextgarden.net/
 because not available - as almost everytime. But from my last  
 remember, when it - for once - was available, they are not in there,  
 neither.

i could have used \definenumber or \definelabel but the shown code was a 
quicky; the advantage of the other approach is that you can influence 
their rendering

 On the one hand I have still the impression, that ConTeXt is a highly  
 adaptable and flexible typesetting system within TeX (probably my  
 intents with marginal notes as help for understanding texts could  
 find a solution),

sure; the main probem is that everyone wants something slightly 
different and we end up with many commands that need examples and 
documentation and then get overseen ... the best resource for special 
cases is still this mailing list since others may have needed you 
rfeature before

 on the other hand I'm almost giving up with my intention, because the  
 only program/system with wich I a had hope to resolve this problem is  
 not configurable for me, because ... I'm not a programmer or software  
 developer, because you ConTeXt-developers don't care enough about  
 usable, applicable documentation, because the cultural, didactical  
 value of the old (hand-)  typesetting technique of marginal notes has  
 come out of fashion, what ever...

well, there's actually quite some marginal stuff in context (you don't 
wanna know what we need context for ourselves)

you should keep one thing in mind: tex is a 30 year old system (ok it 
gets updated now) and some things are simply non trivial and marginal 
notes are one of them (the stacking code is quite tricky)

concerning documentation ... if i had 60 hours in a day  keeping up 
with user demands, developments, my work etc etc takes time too

 N. B. I recommend the provision in ConTeXt for marginal notes in my  
 intented sense warmly to you: they are an acquirement of civilization  
 with big possibilities for the future and no other - at least no word  
 processing program - is able to handle them yet in a acceptable manner!
 
 Nevertheless, be it pure curiousness or still persistant hope in  
 acquiring the skills for ConTeXt, I would like to know:
 
 1.
 in your sample code, Hans:
 between \starttext and \stoptext you write once (the first time of  
 occurrence):
 bla bla bla \mnote{xxx} bla bla
 
 but in the second time:
 bla bla bla \mnote[foo]{xxx} bla bla bla

the [foo] is the optional cross reference; i thought that you might need 
that

 and then again:
 
 bla bla bla \mnote{xxx}
 
 Has the [foo] after the first \mnote any relevance and which?
 
 2.
 the last row of your document text is:
 
 in \in {note} [foo]
 
 in my pdf-output this appears as :
 
 in note 2
 
 This is not reasonable and desired (it should not appear). Was it a  
 slip of the pen on your side or any purpose, if yes, which one?

huh? if you don't want it, just delete it; that;s the problem with 
example code ... all users have different demands -)

Hans

-
   Hans Hagen | PRAGMA ADE
   Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
  tel: 038 477 53 69 | fax: 038 477 53 74 | www.pragma-ade.com
 

Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-05 Thread Aditya Mahajan

On Thu, 5 Jun 2008, Joachim Kreimer-de Fries wrote:



In friendly and helpfully answering to my late night question


How to create _numbered_ margin notes in ConTeXt?


Hans Hagen wrote 05.06.2008 at 10:04:

quick and dirty command (instead one can use enumerations and do some
complex setup)


Before ending this day, I want to thank you for your endeavour (also
for Taco's attentive regret).

Dear Hans, you know what your code produces:

- indeed, the marginal notes are numbered (I can live with the fact
that this is not the kind numbering of notes (cf. footnotes) one -
the reader - expects);

- indeed the notes are no longer printed one over the other.

BUT:

- the accent sign ( ´ ) placed in the text body before the next word
following that wich is explained in the marginal note will not be
accepted and understood by the readers. It must, of course, be a
superscripts number (the same number as in the referencing marginal
note).


A slight bug in Hans's code. See below.


AND:

You won't really expect that someone outside the circle of you
programmers who have developed ConTeXt, i. e. a simple (beginning)
user of ConTeXt - even if highly willing to learn, is able to change
this code in a way to get the wanted results (which I had illustrated
with the pdf-file produced under extremly frustrating formating
effort with OpenOffice Writer).


With two exceptions (\def and \setupinmargin) I did not find any of
the used commands documented in ConTEXt - the manual or the
commands quick reference of 2001. I could not verify in the http://
texshow.contextgarden.net/
because not available - as almost everytime. But from my last
remember, when it - for once - was available, they are not in there,
neither.


The user manual is for already existing features. In order to understand 
how to *extend* context, you need to know how the internals work. See

http://wiki.contextgarden.net/Inside_ConTeXt


Let me try to explain the code (slightly adapted). First the adapted code:

\newcounter\MyMarginalNote

\def\mnote{\dosingleempty\domnote}

\def\domnote[#1]#2%
  {\doglobal\increment\MyMarginalNote
   \high{\MyMarginalNote}%
   \inmargin
  {\MyMarginalNote:
   \doifsomething{#1}
{\expanded{\textreference[#1]{\MyMarginalNote}}}#2}}



Now the explaination:

\newcounter\MyMarginalNote

Defines a new counter called MyMarginalNode. Hans did not use this because 
he knows how \increment works internally, but explicitly stating this 
helps in understanding.


\def\mnote{\dosingleempty\domnote}

This is the standard method in context of dealing with optimal arguments. 
See http://wiki.contextgarden.net/Commands_with_optional_arguments


\def\domnote[#1]#2%

#1 is the optional argument (in square brackets), and #2 is the required 
arugment (in curly brackets)


  {\doglobal\increment\MyMarginalNote

Increment the counter MyMaginalNote. The \doglobal is there so that the 
counter is incremented even when the mnote occurs inside a group, for 
example, something like


\startframedtext
  blah blah\mnote{abc}
\stopfamedtext

   \high{\MyMarginalNote}%

Place the number as a superscript.

   \inmargin

Place the contents in the margin

  {\MyMarginalNote:

Place margin note number followed by colon

   \doifsomething{#1}
{\expanded{\textreference[#1]{\MyMarginalNote}}}

if #1 is something (that is, #1 is not empty) create a textreference #1 
with the text \MyMarginNote. The expanded is there so that the reference 
is to the value of MyMarginNote when the margin note was created and not 
want the value of text reference was asked.


   #2}}

Place #2, that is the contents of the note.



On the one hand I have still the impression, that ConTeXt is a highly
adaptable and flexible typesetting system within TeX (probably my
intents with marginal notes as help for understanding texts could
find a solution),

on the other hand I'm almost giving up with my intention, because the
only program/system with wich I a had hope to resolve this problem is
not configurable for me, because ... I'm not a programmer or software
developer, because you ConTeXt-developers don't care enough about
usable, applicable documentation, because the cultural, didactical
value of the old (hand-)  typesetting technique of marginal notes has
come out of fashion, what ever...


This is not configurable because it was more like a proof of concept 
solution. There is no documentation because of the same reason.



N. B. I recommend the provision in ConTeXt for marginal notes in my
intented sense warmly to you: they are an acquirement of civilization
with big possibilities for the future and no other - at least no word
processing program - is able to handle them yet in a acceptable manner!


Hans, would it be too difficult to incorporate marginal notes in the core, 
so that one could define \definenote[mnote][location=margin]. Most of the 
pieces are already there.



Nevertheless, be it pure curiousness or still persistant hope in

Re: [NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-05 Thread Aditya Mahajan
On Fri, 6 Jun 2008, Hans Hagen wrote:

 \def\domnote[#1]#2%
{\doglobal\increment\MyMarginalNote\plusone
 \inmargin
   {\MyMarginalNote:
\doifsomething{#1}
  {\expanded{\textreference[#1]{\MyMarginalNote}}}%
#2}%
 \high{\MyMarginalNote}}


There should not be a \plusone in the first line. Read the documentation 
of \increment in syst-ext ;)

Aditya
___
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://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


[NTG-context] Last attempt: numbered margin notes in ConTeXt?

2008-06-04 Thread Joachim Kreimer-de Fries

Hey friendly helpers,

I see, this list is one for experts and programmers, less for simple  
users. But given that there is no list for beginners of ConTeXt, I  
make my last attempt to get help in the following problem:


How to create _numbered_ margin notes in ConTeXt?

I have already spent some week of my disposable time to that problem  
without success. I attach an example file as pdf, created in several  
attempts with OpenOffice-writer, with spare success and giving up  
after the 14th note on this half-page. But it can illustrate what I  
want and need:


- Margin(al) notes, numbered/referenced like footnotes, preferably in  
the wider right margin of the page.


- Each margin note possibly on the same line with the referenced word/ 
expression in the text body which shall be translated/explained = if  
possible, i. e. if this place is not yet occupied by a foregoing  
margin note for a word or phrase in the same or a former line.


- In the latter case, the margin note shall be typeset _below_ the  
former margin note (without printing one note on the other).


Is there a way to setup/define the inmargin in the preamble of a  
ConTeXt document but then getting this result with a normal or  
(foregoing defined) command?


Any other advice for to get this result?

Or is it - for TeXnical reasons - not possible to achieve this result  
with reasonable effort in ConTeXt neither?


I would be happy to get assistance (best the necessary commands/setup  
text) or any other advice to get the wanted result.


Hopefully,

Joachim Kreimer-de Fries

Am 23.05.2008 um 09:23 schrieb Wolfgang Schuster:


3. How to setup page/layout dimensions?

\setuplayout
  [backspace=2cm,
   width=10cm,
   rightmargin=8cm,
   ...]


This worked immediatly. Thank you very much, Wolfgang,  for your
swift help!


Text from 1844 by F. W. Lyra in the Westphalian language:



lyra-test.pdf
Description: Adobe PDF document
___
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://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___