68

Where would be a good place to start learning ConTeXt if you haven't got a lot of experience under your belt yet? Any place online or in a bookstore is welcome, provided that the reading is well-structured, well-written and beginner-friendly.

I know there is quite a heap of "official documentation", including "ConTeXt, an excursion", the official handbook and the contextgarden.net Wiki.

Still, often ConTeXt novices find it very difficult to get a good start with the documentation provided -- the command syntax seems to work sometimes, sometimes not; some commands work well with each other, others only in a specific order (which isn't documented anywhere) and some don't work with each other at all etc. The consequence is that there is a lot of experimenting with the code while the focus should be on the topic to be published itself.

This question would love to get RTFM answers, so please point out any Ms which should TF be R.

doncherry
  • 54,637
Olfan
  • 783
  • 2
    "ConTeXt, an excursion" is what I'd recommend to a beginner. I had troubles with fonts, the internal state of the Context system, and trying to use not very well documented features early on, but not the command syntax or conflicts between commands: do you anything in particular in mind? – Charles Stewart Sep 07 '10 at 13:17
  • That's one of my points: There are commands which have nothing in terms of documentation but a syntax statement with names to the possible arguments. I find these syntax statements to be hard to read because this format is quite unique to ConTeXt. Maybe it would be easier to read for me were it in GNU syntax or something. – Olfan Sep 07 '10 at 15:31
  • As for conflicts: One of my first tries was to set up a page layout, and the various possible options to define all those areas and margins and headers and footers turned out to work only in a certain sequence and some of them seemed to disable or undo others even though there was no hint in the handbook in this regard and they were not related in any logical manner. – Olfan Sep 07 '10 at 15:34
  • 1
    What is GNU syntax? – TH. Oct 11 '10 at 10:51
  • 2
    What I referred to as GNU syntax is the notation style which you typically get when viewing the synopsis sections in Un*x man or info pages, like in command [optional] choice-a|choice-b. You can easily see which options are mandatory and which are optional, which exclude each other etc. This may not be an officially correct name for what I mean, I just got to know that notation concept by that term. – Olfan Oct 11 '10 at 15:21
  • @HenriMenke: It will be helpful if you could explain what you find missing from the official list of manuals on prama ade's website. MkIV is explained in the latter manuals. Are you looking for a single manual that contains all the information, like the LaTeX Companion? If so, no such exhaustive manual is available in ConTeXt. But the individual manuals do cover most of the details. I would also like to know what you (or other new users) find missing in the documentation. I use to write documentation targeted towards new users, but it was not clear if anyone was even reading those articles. – Aditya Jun 08 '16 at 18:28
  • @Aditya I'm looking for a full reference manual either in the spirit of the TeXbook or interface3.pdf. When I have used ConTeXt in the past, I noticed, that it is hard to find a documentation of all the accepted keys in the \setup...[...] commands. The ConTeXt reference manual comes close, but I'm unsure which constructs should/shouldn't be used in MkIV. – Henri Menke Jun 09 '16 at 14:55
  • @HenriMenke: All keys accepted in \setup...[...] are described in setups-overview. This is just a listing of all the keys; you need to understand the context convention of writing commands to understand that. The other place where this information is given is the Command section in the wiki; it is less complete (some keys are missing), but there is explanation for most commands. This is what comes close to interfaces3.pdf. – Aditya Jun 09 '16 at 16:42
  • @Aditya Could you please extend your answer below by these items, so I can award the bounty to you? – Henri Menke Jun 10 '16 at 21:57

8 Answers8

30

Shameless plug: I write a regular (rather semi-regular) article series in tugboat on specific ConTeXt topics aimed at beginners. Articles so far:

Community
  • 1
Aditya
  • 62,301
  • Thank you a lot for these links, Aditya, even though a paid tugboat membership may not seem very attractive to the typesetting neophyte. For those who don't want to wait until the article is old enough to be available to the public, the article about conditional processing is available to non-members in printed format for $12 worldwide, so you don't have to be an active member to get just that. I don't have enough reputation yet to add this to your answer myself, though. – Olfan Sep 10 '10 at 11:17
  • 4
    The article sources are here: http://github.com/adityam/context-articles. I also try to merge these with the ConTeXt wiki. The articles on conditional processing is at http://wiki.contextgarden.net/Modes – Aditya Sep 10 '10 at 15:12
  • Thanks Aditya. Just read your article in recent TUGboat, on including images . I like these "beginner" articles since I am a "beginner" – Eric Brown Apr 24 '13 at 05:43
28

The PRAGMA Advanced Document Engineering site has a lot of documentation and examples on the finer details of how to use ConTeXt for particular applications and effects. I discovered it during a search for documentation on how to use Layers for cover layouts, which lead me to the excellent PDF It's in the details.

SevenSidedDie
  • 706
  • 5
  • 11
  • This is indeed a great compilation of documentation. Accepted, because a) it covers a very wide range of topics, b) is fairly recent and updated, c) is less obvious to find than the Wiki and mailing list, and d) to promote it to the top of the list for easier finding even though it came very late and has only few upvotes (yet). – Olfan Nov 30 '10 at 10:17
19

The context reference manual is somewhat outdated, but we are (slowly) working on improving and extending it. It is a community project, and three chapters have already been improved:

Taco Hoekwater
  • 13,724
  • 43
  • 67
  • 1
    Thank you for linking to these, they're actually a lot friendlier than my local copies already. Especially useful (for me) in the page design manual are the parts that warn about options which don't have an effect on paper documents or which do have an effect but not actually alter the paper layout. Creating layouts according to lectorate's demands has become much easier now. – Olfan Sep 08 '10 at 11:33
12

Generally I first check for an answer in the wiki, if I can't find, I just ask in the mailing list.

خالد حسني
  • 22,859
  • 1
    So do I. There are a lot of people however who shy away from asking beginners questions in a mailing list. Still, of course, the Wiki and mailing list are important sources of information -- thank you for pointing them out. – Olfan Sep 08 '10 at 11:49
11

ConTEXt Reference Manual by Hans Hagen, Taco Hoekwater. (Source: contextgarden manual page - see for updated chapters)

enter image description here

Andriy Drozdyuk
  • 5,304
  • This is an excellent reference. Note that it is a work in progress and has been for a long time: Taco has slowly been adding very high-quality content for some years now. There is no comparable source, e.g., for the content on fonts in chapters 5 and 6. – Charles Stewart Mar 07 '13 at 13:27
10

The list of all options to various commands are described in

This list is auto-generated and only lists the options without any description. It is also available for the different language interfaces: Dutch, German, Czech, Italian.

The Command Reference on the ConTeXt wiki contains a similar list. This list is not exhaustive, but the options for most of the common commands are explained in detailed.

Aditya
  • 62,301
10

For beginners, the top 10 guide is really great!

https://www.ctan.org/tex-archive/info/context-top-ten

Aditya
  • 62,301
Tomas
  • 5,441
3

For folks stumbling over this question: Henri wrote a guide to the ConTeXt documentation available at the moment (September 2018): The definitive guide to ConTeXt MkIV documentation.

meliade
  • 349