Re: [NTG-context] Page Numbering Hell
Aditya Mahajan wrote on Friday, October 23, 2009 10:41 PM: The above solution was for MkIV. For completeness, this is how you will do the same with MkII. I don't know how to get the page numbers correct in the TOC in this case. I get correct MkII pagenumbers with this: %% MkII: \starttext \setuppagenumbering[conversion=romannumerals] \startfrontmatter \completecontent \stopfrontmatter \setuppagenumber[number=1] \setuppagenumbering[conversion=numbers] \startbodymatter \chapter{Chapter} \section{Section} \input tufte \externalfigure[cow] \chapter{Chapter 2} \section{Section} \input knuth \stopbodymatter \stoptext Thomas ___ 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 ___
Re: [NTG-context] Page Numbering Hell (SOLVED)
All- I have attached a heavily commented MKII example that implements the structure that I want. The notes identify several (IMHO) weak spots in documentation, especially some consistency issues. In order to implement this (some said simple) format, I used: * http://www.pragma-ade.com/general/manuals/cont-enp.pdf (the manual) * http://www.opensubscriber.com/message/ntg-context@ntg.nl/9815615.html * http://wiki.contextgarden.net/Biochemistry_textbook * http://texshow.contextgarden.net * http://wiki.contextgarden.net/Titles#Truly_empty_pagebreak_before_chapte rs I'm fine with that. For those (most, I imagine) who don't want to wade through the notes, here is a summary of the most (again, IMHO) issues: * startsectionblockenvironment does not appear documented, and appears to be critical for this style * setuppagenumbering documentation is hard to follow for options 'by\em{section}' and '\em{section}number' o The manual uses inconsistent italics o The texshow page doesn't use italics where it should * setupcombinedlist (through setuplist) has the same inconsistent use of italics. * setuphead is not documented completely (no reference to special 'page' formats) * definepagebreak not documented Also, the solution for 'truly empty pagebreak before chapters' does not appear to work for the last chapter in the document. I would be more than happy to contribute to the texshow documentation and wiki, assuming that I would be given an account... J The list appears to be dead again, so I hope this makes it through. Thanks, -Bryant From: ntg-context-boun...@ntg.nl [mailto:ntg-context-boun...@ntg.nl] On Behalf Of Bryant Eastham Sent: Wednesday, October 21, 2009 12:37 AM To: ntg-context@ntg.nl Subject: [NTG-context] Page Numbering Hell All- A few days ago when I first stumbled on ConTeXt I was very, very excited. I have some 500 pages of technical documentation that could benefit from this, particularly since I need Japanese font support. But it has to be real. I'm sorry if this sounds caustic, but after 12 hours of failed attempts to even get a minimal document formatted I have some serious questions for the list: 1. Is Mark IV real? I am only somewhat joking here - after spending hours searching for reasonable documentation on even the most trivial options, I am left wondering whether this is something I want to use... 2. ConTeXt looks great. But what is current? Seriously, I like the look and the support (particularly Unicode). But going over documentation I cannot make heads or tails of what to do. Mark II? Mark IV? TeTeX? LuaTeX? If I really want to use this, what should I use? 3. Having answered #2, where in the world is a reference manual!!! I mean one that actually *documents the options*. 4. Having answered #3, are there any current examples that actually work? The snippets from the mailing are great, but they are just snippets. That doesn't help me. Now, to resolve my immediate issue, and just because I will not be able to sleep well until I figure this out (yes, I am fixated on this). I want this document structure: Contents 1. Chapter 1-1 1.1 Section 1-2 2. Chapter 2 2-1 2.1 Section 2-2 Table of contents on page i. Even/odd, each chapter starts on right page. Page number (as in 2-2) in top margin. Mark IV, Lua document. I have tried hundreds of different combinations. If it cannot do this, the I will (with sadness) move on. I'm sure that it would take someone who understands this about 5 minutes to write (if that). -Bryant Panasonic Electric Works Laboratory of America - SLC Lab 4525 So. Wasatch Blvd., Suite 100, 84124 Salt Lake City, UT 84124 T 801.993.7124 F 801.993.7260 beast...@pewla.us.pewg.pansonic.com Bryant Eastham Chief Architect ***CONFIDENTIALITY NOTICE***: This e-mail and any attachments may contain information which is confidential, proprietary, trade secret, privileged or otherwise protected by law. The information is the property of Panasonic Electric Works Laboratory of America, Inc., and is solely intended for the named addressee (or a person responsible or delivering it to the addressee). If you are not the intended recipient of this message, you are not authorized to read, print, retain copy or disseminate this message or any part of it. If you have received this e-mail in error, please notify the sender and the Office of General Counsel at generalcoun...@us.pewg.panasonic.com mailto:generalcoun...@us.pewg.panasonic.com immediately by return e-mail and delete it from your computer. image001.gifimage002.pngimage004.pngimage005.gif evaluate.docb.tex Description: evaluate.docb.tex
Re: [NTG-context] Page Numbering Hell
Aditya, Luigi, others- Thank you for your responses. I appreciate the candid answers, and the time you took to provide examples. Regarding Aditya's example, I do not get any errors, running LuaTeX, MKIV, beta-0.43.0-2009091520. However, I also do not get romannumerals in the frontpart, and pagenumbers do not reset to 1 at the beginning of each section. The magic command appears to be definestructureconversionset, which is not documented that I can see on http://texshow.contextgarden.net/. A search of the wiki results in a single match, which is not a complete example. Google led me to many snippets and emails, mostly non-functional. This was leading me down the same rabbit hole that I was going into before. Given other's responses, I think to stick with MKII for now. I will do as some have suggested, and keep my eye on MKIV while it stops moving. In particular, thanks to Taco for his concise summary of the differences between texexec and context (and quick fix of my reported bug). Yes, it did answer my question. -Bryant -Original Message- From: ntg-context-boun...@ntg.nl [mailto:ntg-context-boun...@ntg.nl] On Behalf Of Aditya Mahajan Sent: Wednesday, October 21, 2009 9:49 AM To: mailing list for ConTeXt users Subject: Re: [NTG-context] Page Numbering Hell On Wed, 21 Oct 2009, Bryant Eastham wrote: 1. Is Mark IV real? I am only somewhat joking here - after spending hours searching for reasonable documentation on even the most trivial options, I am left wondering whether this is something I want to use... MKIV is still a moving target. For example, the change is the structure code (headings, pagenumbers, lists, etc) started only in April. There are still some things that are not done yet. Documentation will only make sense once the interface is stable. For structure code, the interface is not fixed yet, so the only documentation is the examples in the source file. Parts that are stable (fonts, typescripts) are documented in the new manual (see wiki). The interface for most other things has not changed, so the MKII interface works. 2. ConTeXt looks great. But what is current? Seriously, I like the look and the support (particularly Unicode). But going over documentation I cannot make heads or tails of what to do. Mark II? Mark IV? TeTeX? LuaTeX? If I really want to use this, what should I use? Use MKII. It is stable and well documented. Unless there is some feature of MKIV that you definitely need. MKII had some support for unicode and oriental languages. 3. Having answered #2, where in the world is a reference manual!!! I mean one that actually *documents the options*. See http://www.pragma-ade.com/overview.htm Most of MKII options are documented in ConTeXt the manual. Parts of MKIV are documented in mk.pdf 4. Having answered #3, are there any current examples that actually work? The snippets from the mailing are great, but they are just snippets. That doesn't help me. The wiki: http://www.contextgarden.net Now, to resolve my immediate issue, and just because I will not be able to sleep well until I figure this out (yes, I am fixated on this). A partial solution (I don't know how to set the separator between chapter number and page number) Following Alan's email: % missing setups to: % 1. frontmatter pagenumbering conversion=romannumerals \setupuserpagenumber[way=byblock] \definestructureconversionset[frontpart:pagenumber][][romannumerals] \definestructureconversionset[bodypart:pagenumber] [][numbers] \setupuserpagenumber[numberconversionset=pagenumber] % 2. bodymatter pagenumbering chapter-page % 3. reset pagenumber for each chapter % I don't know how to set the - between chapter and page number \setupuserpagenumber [way=bychapter, prefix=yes, prefixset=chapter, prefixsegments=2:2, ] % 4. add blank pages if necessary to start chapters on odd pages. % 5. Page number in top margin \setuppagenumbering[location={header,margin},alternative=doublesided] \starttext \startfrontmatter \completecontent[criterium=all] \stopfrontmatter \startbodymatter \dorecurse{4} {\chapter{Chapter} \dorecurse{8} {\section{Section} \input knuth \endgraf}} \stopbodymatter \stoptext 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 ___ ___ 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
Re: [NTG-context] Page Numbering Hell
On Fri, Oct 23, 2009 at 10:30 AM, Bryant Eastham beast...@pewla.us.pewg.panasonic.com wrote: Thomas, all: It appears that not all of the messages have been delivered in a timely manner - I just received quite a few. I suppose that is why you reference the reply I got (or didn't until just now). FYI, it appears to me that there are major issues with the ntg.nl domain name server - it sometimes seems to go non-responsive. I can fix my local machine for web access, but I cannot change my mailer. As I have already written, sorry for the caustic approach. I obviously have offended you, and apologize. Most of your points are well taken. Yes, I had looked at all the examples that I could find, I had checked the many references, and could not find documentation on most of the routines that current postings seem to indicate should be used. With the further pointers I have received I will try again, and post my results. As for my real comment, snide question begs snide response. I accept that. However, keep in mind that real to me doesn't mean cool, or full of features, or better, but rather means that it will work, day in and day out, in a commercial environment. by now 5 years on production with ConTeXt . I think Pragma is on production from 20 years. Judging by other responses, the jury is out on real (at least of mkiv). Two projects running with mkiv. I will continue to evaluate. And, my 35 documents, hundreds of pages was not meant to be multiplied! I have under 1,000 pages total. $pdfinfo pdftex.pdf : Pages: 812 : 1000 pages is not a big number even for a single doc. The problems today are opentype, colours, multilingual, multi channel ouput, automatic workflow. There are not so many tools that are programmable as ConTeXt (anyway, you can always buy expensive solutions). Thanks to others for their responses. I will try them out tomorrow, and will be sure to collect all my hundreds of attempts Tests -- that's what we need. -- luigi ___ 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 ___
Re: [NTG-context] Page Numbering Hell
On Friday 23 October 2009 10:30:09 Bryant Eastham wrote: Yes, I had looked at all the examples that I could find, I had checked the many references, and could not find documentation on most of the routines that current postings seem to indicate should be used. With the further pointers I have received I will try again, and post my results. As has been clearly pointed out by this exchange: - ConTeXt MKII is very stable and is pretty well documented. - ConTeXt MKIV is a working system, but is not quite as stable. It is under active development, and this mailing list is principally active concerning this development. It is therefore quite appropriate that current postings turn around features that are not (yet) as well documented as stable MKII. So you should not be surprised to find that the use of cutting edge technology gives many exciting new functionality, but one must be willing to put up with some rough edges. This is why, for example, the Debian project has very appropriately named its releases stable, testing and unstable (as well as experimental). Unstable sometimes breaks, but usually this lasts only a couple of hours (occasionally a couple of days for less important problems). Alan P.S. I just spent several hours using Microsoft Word to edit a bunch of administrative documents. The task would have taken 10 minutes or so using ConTeXt and my usual tools (there were many repetitive edits). This was a *horrible* experience and I simply cannot fathom how one can be satisfied with such a work tool! (Here, I had no choice.) ___ 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 ___
Re: [NTG-context] Page Numbering Hell
BoĊĦtjan Vesnicer wrote: for me it is actually very obvious an easy to understand the situation about missing documentation. In my opinion there are a couple of reasons for that: - The gurus don't have time to write the documentation since they have more important things to do, i.e. implementing features. indeed; and since we also have to make a living, sometimes demands of projects get priority - Documentation (in a form of a manual) is of the most value to the newbies, but they can't write a manual by themselves about something they dont't know much about. So they ask for the documentation on the mailing list, but they eventually find out that the up-to-date documentation is missing and they start to use other sources of information (wiki, mailing list, source code etc.). They learn slowly, but at the end (if they persist long enough) they know enough that they maybe could write a manual. However, they don't really need the manual any more so they decide not to write one. (Paradoxical situation, I know.) good point ... also, writing a manual helps oncovering inconsistencies; a variant on manuals is writing articles (e.f. for tex user group magazines) - The key is in the motivation. If you want better documentation, you have to figure out how to convince the gurus to write one. 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 | 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 : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___
Re: [NTG-context] Page Numbering Hell
On Wednesday 21 October 2009 18:52:21 Bryant Eastham wrote: 1. Should I use mkii or mkiv? If mkii, then what should I plan on as schedule for upgrading? I asked this question recently and was told that it was probably pretty safe now to use mkiv, as the developers use mkiv themselves. My experience is that mkiv is not totally stable, but almost so. I try to use it for my production as much as possible. For the core of the commands, the two are interchangable and it is simply a question of using the context script or the texexec script (but don't include a % output=pdftex line in your source file!) For specific differences, you can use \doifmodeelse{mkiv}{ }{ } This also answers 2. 3. What *reference* material exists? I do not need a user guide. Right now it has been Google. However, the solutions most recently mentioned on the mailing lists seem to dead-end. I am fine with an answer of see the source code if that is really it. Did you look at the user guide? It is a reference manual http://www.pragma-ade.com/general/manuals/cont-eni.pdf http://www.pragma-ade.com/general/manuals/cont-enp.pdf The first is a screen version, the second a paper format. (and called context-reference or contextref.pdf on the svn) A rich source is: http://www.pragma-ade.com/overview.htm ___ 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 ___
[NTG-context] Page Numbering Hell
All- A few days ago when I first stumbled on ConTeXt I was very, very excited. I have some 500 pages of technical documentation that could benefit from this, particularly since I need Japanese font support. But it has to be real. I'm sorry if this sounds caustic, but after 12 hours of failed attempts to even get a minimal document formatted I have some serious questions for the list: 1. Is Mark IV real? I am only somewhat joking here - after spending hours searching for reasonable documentation on even the most trivial options, I am left wondering whether this is something I want to use... 2. ConTeXt looks great. But what is current? Seriously, I like the look and the support (particularly Unicode). But going over documentation I cannot make heads or tails of what to do. Mark II? Mark IV? TeTeX? LuaTeX? If I really want to use this, what should I use? 3. Having answered #2, where in the world is a reference manual!!! I mean one that actually *documents the options*. 4. Having answered #3, are there any current examples that actually work? The snippets from the mailing are great, but they are just snippets. That doesn't help me. Now, to resolve my immediate issue, and just because I will not be able to sleep well until I figure this out (yes, I am fixated on this). I want this document structure: Contents 1. Chapter 1-1 1.1 Section 1-2 2. Chapter 2 2-1 2.1 Section 2-2 Table of contents on page i. Even/odd, each chapter starts on right page. Page number (as in 2-2) in top margin. Mark IV, Lua document. I have tried hundreds of different combinations. If it cannot do this, the I will (with sadness) move on. I'm sure that it would take someone who understands this about 5 minutes to write (if that). -Bryant Panasonic Electric Works Laboratory of America - SLC Lab 4525 So. Wasatch Blvd., Suite 100, 84124 Salt Lake City, UT 84124 T 801.993.7124 F 801.993.7260 beast...@pewla.us.pewg.pansonic.com Bryant Eastham Chief Architect ***CONFIDENTIALITY NOTICE***: This e-mail and any attachments may contain information which is confidential, proprietary, trade secret, privileged or otherwise protected by law. The information is the property of Panasonic Electric Works Laboratory of America, Inc., and is solely intended for the named addressee (or a person responsible or delivering it to the addressee). If you are not the intended recipient of this message, you are not authorized to read, print, retain copy or disseminate this message or any part of it. If you have received this e-mail in error, please notify the sender and the Office of General Counsel at generalcoun...@us.pewg.panasonic.com mailto:generalcoun...@us.pewg.panasonic.com immediately by return e-mail and delete it from your computer. image001.gifimage003.gifimage004.pngimage005.png___ 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 ___
Re: [NTG-context] Page Numbering Hell
Dear Bryant, Your post is slightly exaggerated. The document structure that you want to produce appears to be relatively standard. Whereas, indeed, the learning curve for ConTeXt (as for TeX) can be somewhat slow, the richness and powerfulness is well worth the effort. The documentation for ConTeXt (mkii) is quite rich, although it did take me some time to get used to the presentation and style. Some of the syntax has evolved in mkiv, mostly in an effort of simplification, but also to allow some powerful new features. The documentation is (slowly) being updated, as this is a tremendous effort. But it is a necessary effort. I believe that all of us users will appreciate the updated reference manual when it is completed! A notable change between mkii and mkiv is the handling of document structure. I, too, have had a difficult time with this evolution of such a fundamental functionality and will therefore let someone more expert reply to your request with specific examples on how to tune the style, notably page numbering; it should be a simple matter. Alan % missing setups to: % 1. frontmatter pagenumbering conversion=romannumerals % 2. bodymatter pagenumbering chapter-page % 3. reset pagenumber for each chapter % 4. add blank pages if necessary to start chapters on odd pages. \starttext \startfrontmatter \completecontent \stopfrontmatter \startbodymatter \chapter{Chapter} \section{Section} \chapter{Chapter 2} \section{Section} \stopbodymatter \stoptext On Wednesday 21 October 2009 08:36:35 Bryant Eastham wrote: All- A few days ago when I first stumbled on ConTeXt I was very, very excited. I have some 500 pages of technical documentation that could benefit from this, particularly since I need Japanese font support. But it has to be real. I'm sorry if this sounds caustic, but after 12 hours of failed attempts to even get a minimal document formatted I have some serious questions for the list: 1. Is Mark IV real? I am only somewhat joking here - after spending hours searching for reasonable documentation on even the most trivial options, I am left wondering whether this is something I want to use... 2. ConTeXt looks great. But what is current? Seriously, I like the look and the support (particularly Unicode). But going over documentation I cannot make heads or tails of what to do. Mark II? Mark IV? TeTeX? LuaTeX? If I really want to use this, what should I use? 3. Having answered #2, where in the world is a reference manual!!! I mean one that actually *documents the options*. 4. Having answered #3, are there any current examples that actually work? The snippets from the mailing are great, but they are just snippets. That doesn't help me. Now, to resolve my immediate issue, and just because I will not be able to sleep well until I figure this out (yes, I am fixated on this). I want this document structure: Contents 1. Chapter 1-1 1.1 Section 1-2 2. Chapter 2 2-1 2.1 Section 2-2 Table of contents on page i. Even/odd, each chapter starts on right page. Page number (as in 2-2) in top margin. Mark IV, Lua document. I have tried hundreds of different combinations. If it cannot do this, the I will (with sadness) move on. I'm sure that it would take someone who understands this about 5 minutes to write (if that). -Bryant ___ 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 ___
Re: [NTG-context] Page Numbering Hell
On Wed, Oct 21, 2009 at 9:13 AM, Alan BRASLAU alan.bras...@cea.fr wrote: \starttext \startfrontmatter \completecontent \stopfrontmatter \startbodymatter \chapter{Chapter} \section{Section} \chapter{Chapter 2} \section{Section} \stopbodymatter \stoptext only slightly different, just to see some pages; cow.pdf must be in the same folder of test.tex %% %% %% test.tex \setupcolors[state=start] \setupinteraction[state=start] \starttext \startfrontmatter \completecontent \stopfrontmatter \startbodymatter \chapter{Chapter} \section{Section} \input tufte \externalfigure[cow] \chapter{Chapter 2} \section{Section} \input knuth \stopbodymatter \stoptext compile with $ texexec --pdf test.tex The switch --pdf is not necessary, but actually I prefear to remember to myself that I'm doing pdf. Question x Bryant : how do you change the color of interactive elements ? -- luigi ___ 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 ___