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, 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, 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)
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
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