Re: [NTG-context] Best source of ConTeXt documentation?

2004-08-02 Thread Hans Hagen
Paulo Ney de Souza wrote:
This is one of the sore points of ConTeXt and of the development
 

i addition to patricks remarks:
- it would take a lot of effort to keep such a source code repository up 
to date and in sync (else too many questions) with the pdf repositoty
- we only publish documented sources
- i want to stimulate users to writ etheir own styles not to mimick 
existing ones (i.e. avoid the 'all tex files look the same' problem)
- also: most examples in manuals are typeset using

\startbuffer
...
\stopbuffer
\typebuffer \getbuffer
so ... there are no hidden tricks (unless it would bother/confuse 
users); and .. things like cover designs i wanna keep for myself if only 
to avoid cutting and pasting

in due time, probably more sources will go on line, but only when i have 
a system/method of keeping things in sync; i don't like the idea to go 
on-line for each change that i want to make (we only have dsl for half a 
year, before that i had to do all on 64 lines which is no fun)

Hans
___
ntg-context mailing list
[EMAIL PROTECTED]
http://www.ntg.nl/mailman/listinfo/ntg-context


Re: [NTG-context] Best source of ConTeXt documentation?

2004-08-02 Thread Paulo Ney de Souza

From [EMAIL PROTECTED]  Mon Aug  2 09:08:22 2004
From: Hans Hagen [EMAIL PROTECTED]
To: mailing list for ConTeXt users [EMAIL PROTECTED]
Subject: Re: [NTG-context] Best source of ConTeXt documentation?
Cc: 

- it would take a lot of effort to keep such a source code repository up 
to date and in sync (else too many questions) with the pdf repositoty

If we are talking about examples, ones does not need to have the latest
manual and the latest source in sync. Just one copy of the manual (that
will eventually go old) and one copy of the source.

For example, the Calculator, mixing TeX and JavaScript

http://www.tug.org/applications/pdftex/calculat.pdf

has NOT changed in many years now, so there is no problem maitaining the
PDF and the source in sync...

- we only publish documented sources

That is an important point ... and the only one I can give credit to, 
but I still think the abundance of examples, even without documentation,
is better than the short of examples.

- i want to stimulate users to writ etheir own styles not to mimick 
existing ones (i.e. avoid the 'all tex files look the same' problem)

so ... there are no hidden tricks (unless it would bother/confuse 
users); and .. things like cover designs i wanna keep for myself if only 
to avoid cutting and pasting
Hans

Hans: Imitation is indeed the truest form of flattery!

Paulo Ney

___
ntg-context mailing list
[EMAIL PROTECTED]
http://www.ntg.nl/mailman/listinfo/ntg-context


Re: [NTG-context] Best source of ConTeXt documentation?

2004-08-02 Thread skhilji
Adding to this thread (I don't mean a reply to Paulo, but rather a reply to what Hans 
was saying earlier)...The problem with normal users cooking up new styles is the 
lack of artistic abilities in some people (like me).  One can, obviously go thru the 
manual cover the cover, but if one does not have creative thinking, then creating 
professional looking styles would be hard.  That is why, users like me really do not 
care if our documents look like everybody else's (just as long as they look 
professional).

Its kind of like learning Photoshop and knowing what each toolbar button doesbut 
not knowing how to mix all the available tools create a professional looking graphic.

And of course, once we learn the tool, then making small changes here and there to 
make it look slightly different is no big deal.

Salman

___
ntg-context mailing list
[EMAIL PROTECTED]
http://www.ntg.nl/mailman/listinfo/ntg-context


[NTG-context] Best source of ConTeXt documentation?

2004-08-01 Thread Brooks Moses
In my efforts to learn ConTeXt, I'm continually getting stuck by a lack of 
having complete documentation.  For example, consider the \definestartstop 
command, which I was recently looking at.

* In the cont-enp.pdf manual, it's not mentioned.
* In the mp-cp-en.pdf manual, there's an example of it, but it's not really 
very clear what the difference is between what the commands= and 
before= options do.  In addition, there's no indication whether these are 
all the possible options or not, or whether there's any way to define a 
start/stop pair that takes an argument.

* In the source, I can find the definitions, but for that particular one 
there seems to be very little commentary, and I also suspect I'd need to be 
rather familiar with the ConTeXt core before I could understand it -- I 
certainly can't see where the before= goes in, for instance.

And that's about all I know about, other than doing a Google search on the 
mailing-list archives, which rarely addresses the general stuff.

Is this all due to an actual lack of documentation for ConTeXt itself, or 
is there something large and important that I'm missing?

Thanks,
- Brooks
___
ntg-context mailing list
[EMAIL PROTECTED]
http://www.ntg.nl/mailman/listinfo/ntg-context


Re: [NTG-context] Best source of ConTeXt documentation?

2004-08-01 Thread Gary Pajer
I would guess that it boils down to the fact that Hans, despite a
staggeringly remarkable likeness in appearance, is not Superman.

But I, and others, share your pain.The efforts of Hans and the regulars
on this group make up for it in large measure.  (BTW,  Thank You to all the
regulars) and the Wiki and Texshow-web have great potential to help ... if
they really catch fire.

-gary


- Original Message - 
From: Brooks Moses [EMAIL PROTECTED]
To: ConTeXt users list [EMAIL PROTECTED]
Sent: Sunday, August 01, 2004 6:23 PM
Subject: [NTG-context] Best source of ConTeXt documentation?


 In my efforts to learn ConTeXt, I'm continually getting stuck by a lack of
 having complete documentation.  For example, consider the \definestartstop
 command, which I was recently looking at.

 * In the cont-enp.pdf manual, it's not mentioned.

 * In the mp-cp-en.pdf manual, there's an example of it, but it's not
really
 very clear what the difference is between what the commands= and
 before= options do.  In addition, there's no indication whether these
are
 all the possible options or not, or whether there's any way to define a
 start/stop pair that takes an argument.

 * In the source, I can find the definitions, but for that particular one
 there seems to be very little commentary, and I also suspect I'd need to
be
 rather familiar with the ConTeXt core before I could understand it -- I
 certainly can't see where the before= goes in, for instance.

 And that's about all I know about, other than doing a Google search on the
 mailing-list archives, which rarely addresses the general stuff.

 Is this all due to an actual lack of documentation for ConTeXt itself, or
 is there something large and important that I'm missing?

 Thanks,
 - Brooks

 ___
 ntg-context mailing list
 [EMAIL PROTECTED]
 http://www.ntg.nl/mailman/listinfo/ntg-context

___
ntg-context mailing list
[EMAIL PROTECTED]
http://www.ntg.nl/mailman/listinfo/ntg-context


Re: [NTG-context] Best source of ConTeXt documentation?

2004-08-01 Thread skhilji
I'd like to see the sources of all the PDF files available at pragma-ade.  Its much 
easier to look at examples and learn from it than to ask for complete documentation.

Salman


___
ntg-context mailing list
[EMAIL PROTECTED]
http://www.ntg.nl/mailman/listinfo/ntg-context