Hi Hraban, a late reply concerning the ToCs in your book: maybe you could an two-toc-approach like in the Memoir manual? One could show only the chapters, another would contain everything.
Best, Denis > -----Ursprüngliche Nachricht----- > Von: Henning Hraban Ramm <te...@fiee.net> > Gesendet: Donnerstag, 10. August 2023 15:22 > An: mailing list for ConTeXt users <ntg-context@ntg.nl> > Betreff: [NTG-context] your opinion about list structures > > Hi, this is about my ConTeXt book again. > > [ToC] > > At the moment, my table of contents has chapters and sections and is 8 pages > long. I would probably hardly use it. > > Maybe it would be better to show only chapters (29 content + 12 appendix = 2 > pages) and include a list of sections after the chapter title (or not at all). > > [Registers] > > I split between command and topic index (9 pages each), because I find it > annoying to have the commands between the topics. > I also include the topics that are mentioned in titles in the index, because > I hate > it if I must look in two places. > (Otherwise I wouldn't think about omitting the sections from the ToC.) > > At the moment there's also an index of todo items, but that will disappear > before print. > > [Glossary] > > There's a short dictionary of technical terms in the appendix (8.5 p.). > Each lemma is also included in the index. > > Should I add a list of abbreviations? (TDS, TEI, OCG, RAL, PDF, SVG.?) They're > in the index and explained where they matter - I don't think the meaning of > many abbreviations like file types is important. > > [Other lists] > > Should I include a list of colors, like the output of \showcolor[crayola]? (I > think > it would only bloat the book, and everyone can create the list themselves.) > > I have lists of supported languages (should get checked), fonts in the > distribution and all math fonts, because these are not easily reproducible > (AFAIK). > > > So, what do you think, and how do you like to work with technical books? > What kind of information (about ConTeXt or documents/printing in > general) do you find hard to find? > > Hraban > ___________________________________________________________________ > ________________ > If your question is of interest to others as well, please add an entry to the > Wiki! > > maillist : ntg-context@ntg.nl / > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww > .ntg.nl%2Fmailman%2Flistinfo%2Fntg- > context&data=05%7C01%7Cdenis.maier%40unibe.ch%7C8c6e26b5f7a14d8 > 5386c08db99a4ef16%7Cd400387a212f43eaac7f77aa12d7977e%7C1%7C0 > %7C638272705889584734%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4 > wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000% > 7C%7C%7C&sdata=wp5lFDSJq9915y4de%2BNuNiULb09yT%2FpDr%2FWXrq > OcdVI%3D&reserved=0 > webpage : > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww > .pragma- > ade.nl%2F&data=05%7C01%7Cdenis.maier%40unibe.ch%7C8c6e26b5f7a14 > d85386c08db99a4ef16%7Cd400387a212f43eaac7f77aa12d7977e%7C1%7 > C0%7C638272705889584734%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC > 4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000 > %7C%7C%7C&sdata=TLdBrqOp1GuhmQRLiaydxRox1aeaO%2BWASrA%2FBa > OAs%2BI%3D&reserved=0 / > https://eur03.safelinks.protection.outlook.com/?url=http%3A%2F%2Fcontex > t.aanhet.net%2F&data=05%7C01%7Cdenis.maier%40unibe.ch%7C8c6e26b5 > f7a14d85386c08db99a4ef16%7Cd400387a212f43eaac7f77aa12d7977e%7 > C1%7C0%7C638272705889584734%7CUnknown%7CTWFpbGZsb3d8eyJWI > joiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C > 3000%7C%7C%7C&sdata=T%2FP42p3V5RzC%2B%2BwX5vByYtXy3LFOHce5 > Eues%2F8PPsug%3D&reserved=0 > archive : > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fbitbu > cket.org%2Fphg%2Fcontext- > mirror%2Fcommits%2F&data=05%7C01%7Cdenis.maier%40unibe.ch%7C8c6 > e26b5f7a14d85386c08db99a4ef16%7Cd400387a212f43eaac7f77aa12d79 > 77e%7C1%7C0%7C638272705889584734%7CUnknown%7CTWFpbGZsb3d > 8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0% > 3D%7C3000%7C%7C%7C&sdata=MR51GITNqb9ludzBJMwmu4AqE%2BaWw > 0%2BIPpPm76Nwv%2BE%3D&reserved=0 > wiki : > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fconte > xtgarden.net%2F&data=05%7C01%7Cdenis.maier%40unibe.ch%7C8c6e26b > 5f7a14d85386c08db99a4ef16%7Cd400387a212f43eaac7f77aa12d7977e% > 7C1%7C0%7C638272705889584734%7CUnknown%7CTWFpbGZsb3d8eyJ > WIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D > %7C3000%7C%7C%7C&sdata=ubpCSLzX4vdgb7WNlaK7ASRwd94Ugv0TtuF8 > wzDnnts%3D&reserved=0 > ___________________________________________________________________ > ________________ ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://www.ntg.nl/mailman/listinfo/ntg-context webpage : https://www.pragma-ade.nl / http://context.aanhet.net archive : https://bitbucket.org/phg/context-mirror/commits/ wiki : https://contextgarden.net ___________________________________________________________________________________
