suggestions for context documentation
The important thing is: is there _ever_ going to be a manual? I want to try Context, but I've been putting it off for years because it's not really practical without documentation. There must be many others in the same situation.
On Thu, Mar 4, 2010 at 10:31 PM, Michael Saunders
The important thing is: is there _ever_ going to be a manual? I want to try Context, but I've been putting it off for years because it's not really practical without documentation. There must be many others in the same situation. For mkii there are cont-en and metafun plus some other articles. It's a bit outdate, but still valid in general.
For mkiv : are you sure ? If yes, mk.pdf , luatexref-t.pdf , the code. For both : wiki and mailing list -- luigi
On Thu, 4 Mar 2010, Michael Saunders wrote:
The important thing is: is there _ever_ going to be a manual? I
You mean like the beginner's manual http://www.pragma-ade.com/general/manuals/ms-cb-en.pdf and the user manual http://www.pragma-ade.com/general/manuals/cont-eni.pdf
want to try Context, but I've been putting it off for years because it's not really practical without documentation.
Things that have changed in MKIV http://www.pragma-ade.com/general/manuals/mk.pdf Integrating metafun graphics http://www.pragma-ade.com/general/manuals/metafun-s.pdf On typography http://www.pragma-ade.com/general/manuals/style.pdf XML http://pragma-ade.com/general/manuals/xml-mkiv.pdf amongst 46 others by Pragma http://pragma-ade.com/show-man-1.htm http://wiki.contextgarden.net/This_Way and other user written documents http://wiki.contextgarden.net/MyWay and then there is the wiki. I agree that some of these are outdated, some are not complete, but documentation does exist. What is missing in the documentation that prevented you from even starting using ConTeXt for *years*. Aditya
A bit of a diversion here, but two questions about the plethora of PDF docs:
* Where are the TeX sources of all these manuals kept?
* What are the licenses on all these various things? In particular the
Pragma documents. Would I be *allowed*, if I so wanted, to embark on a
collated version of all of this -- i.e., are derivative works allowed?
James
On Thu, Mar 4, 2010 at 9:40 PM, Aditya Mahajan
On Thu, 4 Mar 2010, Michael Saunders wrote:
The important thing is: is there _ever_ going to be a manual? I
You mean like the beginner's manual
http://www.pragma-ade.com/general/manuals/ms-cb-en.pdf
and the user manual
http://www.pragma-ade.com/general/manuals/cont-eni.pdf
want to try Context, but I've been putting it off for years because
it's not really practical without documentation.
Things that have changed in MKIV http://www.pragma-ade.com/general/manuals/mk.pdf
Integrating metafun graphics http://www.pragma-ade.com/general/manuals/metafun-s.pdf
On typography http://www.pragma-ade.com/general/manuals/style.pdf
XML http://pragma-ade.com/general/manuals/xml-mkiv.pdf
amongst 46 others by Pragma
http://pragma-ade.com/show-man-1.htm http://wiki.contextgarden.net/This_Way
and other user written documents
http://wiki.contextgarden.net/MyWay
and then there is the wiki.
I agree that some of these are outdated, some are not complete, but documentation does exist. What is missing in the documentation that prevented you from even starting using ConTeXt for *years*.
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 : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net
___________________________________________________________________________________
On Thu, 4 Mar 2010, James Fisher wrote:
A bit of a diversion here, but two questions about the plethora of PDF docs:
* Where are the TeX sources of all these manuals kept?
svn://ctx.pragma-ade.nl/manuals (seems to be down at the moment) browsable at http://context.aanhet.net/svn/ This information is also available on the wiki (http://wiki.contextgarden.net/Official_ConTeXt_Documentation)
* What are the licenses on all these various things? In particular the Pragma documents. Would I be *allowed*, if I so wanted, to embark on a collated version of all of this -- i.e., are derivative works allowed?
The program code (i.e. anything not under the /doc subtree) is distributed under the GNU GPL; the documentation is provided under Creative Commons Attribution NonCommercial ShareAlike license. So, derivative work is allowed, provided you do not sell your work. The new user manaul http://foundry.supelec.fr/gf/project/contextman/scmsvn/?action=browse&path=%2Fcontext-reference%2F is a attempt to be a collected version of all the documents, and it is under GNU Free Documentation License, so if you copy from there, your result should have the same license. Aditya
Good news on both counts, then. (Is there a reason that the source and
license of the documents aren't included in the docs themselves?)
On Thu, Mar 4, 2010 at 11:05 PM, Aditya Mahajan
On Thu, 4 Mar 2010, James Fisher wrote:
A bit of a diversion here, but two questions about the plethora of PDF
docs:
* Where are the TeX sources of all these manuals kept?
svn://ctx.pragma-ade.nl/manuals (seems to be down at the moment)
browsable at
http://context.aanhet.net/svn/
This information is also available on the wiki ( http://wiki.contextgarden.net/Official_ConTeXt_Documentation)
* What are the licenses on all these various things? In particular the
Pragma documents. Would I be *allowed*, if I so wanted, to embark on a collated version of all of this -- i.e., are derivative works allowed?
The program code (i.e. anything not under the /doc subtree) is distributed under the GNU GPL; the documentation is provided under Creative Commons Attribution NonCommercial ShareAlike license.
So, derivative work is allowed, provided you do not sell your work.
The new user manaul http://foundry.supelec.fr/gf/project/contextman/scmsvn/?action=browse&path=%2Fcontext-reference%2F is a attempt to be a collected version of all the documents, and it is under GNU Free Documentation License, so if you copy from there, your result should have the same license.
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 : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net
___________________________________________________________________________________
On Thu, 4 Mar 2010, James Fisher wrote:
Good news on both counts, then. (Is there a reason that the source and license of the documents aren't included in the docs themselves?)
All the docs refer to the readme file which states the license http://wiki.contextgarden.net/Read_Me Aditya
participants (4)
-
Aditya Mahajan -
James Fisher -
luigi scarso -
Michael Saunders