- ntg-context - Mailing Lists

[m-database] How to properly add module arguments?
by Paul Mazaitis 04 Mar '23

04 Mar '23

Dear list, ## The Incredibly Short Version I am trying to extend m-database, and I want to add a flag to control behavior. I can get it to work, but I am having trouble understanding how to do it properly. ## The Short Version I have a project where I wish to incorporate many CSV files as Natural Tables. I want to keep the headers in the CSV files so they're useful in other contexts. The `m-database` module doesn't have a feature to suppress the header row, from what I can see. (I know `handlecsv` can do this, but I'm having troubles with that; if the `m-database` line of inquiry doesn't work out, I'll go back it, but I figure I'll focus on this solution for now.) Looking at the module sources, I can implement the functionality I need in the Lua part of the module, but: I seem to only be able to bodge in additional arguments for the commands in the module. On first try, I got the error: `tex error > tex error on line 30 in file /Users/pmazaitis/Opt/context/tex/texmf-context/tex/context/modules/mkiv/m-databaseplus.mkiv: ! Undefined control sequence` And then: `The control sequence at the end of the top line of your error message was never \def'ed.` Looking at the docs points me to a solution using `\def`, but it's not clear to me how that's working in the case of the database module (the database module seems to be initializing these values someplace else?). If I \def the settings variable in m-database.mkiv, I can get it to work, but I don't think that's the correct way to go about this. Question: how do I properly define new module arguments for the database module? ## The Long Version, With MWE ### Files Associated With the MWE Apologies for all of the file inclusions, but I want to be complete. Here's the .csv file I'm using for the MWE: --- begin database-mwe.csv --- Ref. No.,Part No.,Description,Remarks ,RD14C82E000J,Carbon 000𝝮 ±5% 1/4W, --- end database-mwe.csv --- Some notes on database-mwe.csv: I'd like to keep the header row in place to make this file useful for other tools. These are lists of electronic parts, so I'd like to include uppercase omega, lower case mu, and percent sign characters in the CSV file. Here's the .tex file I'm using for the MWE: --- begin database-mwe.tex --- \usemodule[database] \setupdatabase[quotechar={"},separator={,}] \defineseparatedlist [PartsTable] [separator=comma,left=\bTD,right=\eTD,first=\bTR,last=\eTR,before={ \bTABLE[split=repeat,option=stretch] \bTABLEhead \bTR \bTH Ref. No. \eTH \bTH Part No. \eTH \bTH Description \eTH \bTH Remarks \eTH \eTR \eTABLEhead \bTABLEbody }, after={ \eTABLEbody \eTABLE }] \starttext test \startasciimode \processdatabasefile[PartsTable][parts_list-test.csv] \stopasciimode \stoptext --- end database-mwe.tex --- Some notes on database-mwe.tex: This actually works pretty well with the distributed m-database module! Some of these lists are quite long, so I want to use a TABLEhead to replicate the headings at the top of a new page. I don't think there's a way to automate this with `m-database`, so I'm okay with hard-coding the headers. This does mean I get a double header row at the top of the table. I want to suppress the header row; I'd like to implement this behavior in the module behind a switch. (I'm using the `asciimode` environment to dodge problems with unescaped `%` characters and Greek letters. I tried adding the startasciimode/stopasciimode commands to various keys in the \defineseparatedlist command, but I didn't get anywhere with it - I got errors. A problem for another time...) I think I've got a good handle on how to do this in Lua, but I'm struggling with what to add to the switch appropriately. In attempting to add a switch, I tried the following. Based off of https://wiki.contextgarden.net/Modules#Modules_writing_guidelines, I added a stanza to the appropriate interface file: --- begin stanza added to i-database.xml --- <cd:parameter name="skipheader"> <cd:constant type="yes"/> <cd:constant type="no" default="yes"/> </cd:parameter> --- end stanza added to i-database.xml --- I modeled that after the stanza for the argument `strip`. I think that's the only thing I need to do in the interface file. Changing the i-database.xml file does not break the build. However, as soon as I add the skipheader argument to the m-database.mkiv file: --- begin definition in m-database.mkiv --- \setupdatabase [\c!separator={,}, \c!quotechar=, \c!commentchar=, \c!strip=\v!no, \c!skipheader=\v!no, % <- Added, following the pattern with strip \c!before=, \c!after=, \c!first=, \c!last=, \c!left=, \c!right=] --- end definition in m-database.mkiv --- ...the build fails (with the error from the Short Version section). If I then add the following \def to m-database.mkiv before the \setupdatabase command: \def\c!skipheader {skipheader} ...the build succeeds! I can now pass that settings value to m-database.lua and use it to modify the processing logic. My question: how do I \emph{properly} define new module arguments for the database module? Or: is adding extra \def commands the way to do it? Many, many thanks! -Paul

2 2

How to print the section number of a reference in ConTeXt?
by Joel 04 Mar '23

04 Mar '23

I've set a \pagereference in a chapter, and want to print its chapter title and page number, ex. "You can find more information in "Fish" on p. 1" (where "Fish" is the title of the chapter or section). I've tried looking all through the wiki, thinking this was a basic feature, but couldn't get anything to work. I even tried my own custom macros, see below, but strangely, it won't give me the correct title, it tells me the title of the current chapter, instead of the title in which the reference was placed: \define[1]\dropref{% \textreference[#1]{\expanded{\currentstructuretitle}} } \starttext \startchapter[title=Fish] \dropref{hello} \input knuth \stopchapter \startchapter[title=Whales] You can more information at \at{page}[hello] in \at{chapter}[hello] or \about[hello]. \stopchapter \stoptext Strangely both at commands give the correct information, but \about doesn't. How do I place a reference somewhere in a text, then later tell which chapter title and page number that reference appeared in? --Joel

1 1

Bug with \startnarrow?
by denis.maier＠unibe.ch 04 Mar '23

04 Mar '23

Hi, While doing some more tests with my example from yesterday (tables in \startnarrow), I've realized that the example from the wiki doesn't seem to quite work as expected: %%%%%%%%%%%%%%%%%% \starttext Some text before \startnarrow[left=2cm,right=1cm,before={\blank[2*line]},after={\blank[halfline]}] narrower text \stopnarrow some text after \stoptext %%%%%%%%%%%%%%%%%% Already here, the extra margins on both sides seem to be equal. Changing the size of the left extra margin has no effect at all. %%%%%%%%%%%%%%%%%% \starttext \startnarrow[left=10cm,right=2cm] \input ward \stopnarrow but: \setupnarrower[left=5cm, right=2cm] \startnarrower[left,right] \input ward \stopnarrower \stoptext %%%%%%%%%%%%%%%%%% Is this a bug or intended behaviour ? Best, Denis

2 2

Disappearing footnote in figure / tabulate
by denis.maier＠unibe.ch 02 Mar '23

02 Mar '23

Hi, I have a strange case where a footnote in a tabulate disappears. Strangely, I *cannot* reproduce the behaviour in the MWE below. At first, I thought it must have something to do with \startpostponingnotes, but it seems that this currently isnt't necessary anymore, or at least only for extreme tables. Is that correct? I'll try to narrow it down. Any hints how I could debug that issue? As I'm again working with XML files: Is it possible that this behaviour is caused by some sort of nested setups which makes the footnotes not bubble up? Best, Denis \startbuffer[test] <?xml version='1.0' standalone='yes?> <document> <figure> <table> <tr> <td>a<footnote>2</footnote></td> <td>b</td> </tr> </table> </figure> <figure> <table-wrap> <table> <tr> <td>a<footnote>2</footnote></td> <td>b</td> </tr> </table> </table-wrap> </figure> </document> \stopbuffer \startxmlsetups xml:test \xmlsetsetup{\xmldocument}{document|table-wrap|table|figure|p|footnote}{xml:*} \stopxmlsetups \xmlregistersetup{xml:test} \startxmlsetups xml:document \xmlflush{#1} \stopxmlsetups \startxmlsetups xml:p \xmlflush{#1}\par \stopxmlsetups \startxmlsetups xml:footnote \footnote{\xmlflush{#1}} \stopxmlsetups \startxmlsetups xml:figure \startplacefigure[title={Test},location={force,split}] \xmlflush{#1} \stopplacefigure \stopxmlsetups \startxmlsetups xml:table-wrap \startpostponingnotes \xmlflush{#1} \stoppostponingnotes \stopxmlsetups \startxmlsetups xml:table \startpostponingnotes \starttabulate[|p|p|] \xmlfilter{#1}{/tr/command(xml:table:tr)} \stoptabulate \stoppostponingnotes \stopxmlsetups \startxmlsetups xml:table:tr \xmlfilter{#1}{/td/command(xml:table:tr:td)}\NC\NR \stopxmlsetups \startxmlsetups xml:table:tr:td \NC \xmlflush{#1} \stopxmlsetups \starttext \xmlprocessbuffer{test}{test}{} \startplacetable \starttabulate[|p|p|] \NC a\footnote{3}\NC b\NC\NR \stoptabulate \stopplacetable \startplacetable \bTABLE \bTR \bTD One\footnote{4} \eTD \bTD two \eTD \eTR \bTR \bTD One \eTD \bTD two \eTD \eTR \eTABLE \stopplacetable % \startpostponingnotes \startplacetable \startxtable \startxrow \startxcell a\footnote{5}\stopxcell \startxcell b\footnote{6}\stopxcell \stopxrow \stopxtable \stopplacetable % \stoppostponingnotes \stoptext

2 2

Float control
by denis.maier＠unibe.ch 02 Mar '23

02 Mar '23

Hi everyone, I've recently had to typeset a document that gave me some headaches with the floats. The floats where jumping around, appearing in a different order than in the source file, tables ended up split up at weird points, some positioning keys had not the intended effect (e.g. top), <page> moved the float more than seemed necessary for me... I know, TeX's float positioning algorithm should be rather reliable and stable, and it's quite possible that I'm messing things up in my setups-especially since my source files are XML. Anyway, I'd like to learn more about the whole float issue. Is there anything particular I could read to learn more about the whole thing? Maybe I'm missing out on something fundamental... Best, Denis

5 5

How to place a page reference multiple times?
by Joel 02 Mar '23

02 Mar '23

I need to report every chapter that a particular macro appeared. I would do this by placing `\pagereference[sample]` inside the macro definition, so whenever it is called, it marks the reference info. But I can't seem to get references to work with multiple reference locations marked, example: \starttext You can find it at \at{page}[sample] in \at{chapter}[sample]. \chapter{Fish} \pagereference[sample] \input knuth \input knuth \pagebreak \chapter{Whales} \input knuth \pagereference[sample] \stoptext (you can see in this example, it only finds `\pagereference[sample]` on page 1 and ignores the second appearance. Ideally, I need to be able to output something like, "See examples in Chapter 3, 8, 19" (because those chapters contain a particular macro that I marked with \pagereference. Or, if even possible, see chapters 3 (p. 22), 8 (p. 40), and 20 (though the first example is fine. Is there a way to place a page reference multiple times, so multiple pages or chapter details will appear? --Joel

1 0

/CropBox overflows /MediaBox
by Pablo Rodriguez 01 Mar '23

01 Mar '23

Dear list, I have the following source: \nopdfcompression \setupinteractionscreen [width=max] \setuplayout [standard] [backspace=.7\textwidth, cutspace=\cutspace, width=middle] \starttext \startmakeup[page] \null \stopmakeup \startmakeup[standard] \null \stopmakeup \stoptext Boxes are defined in the following objects: 3 0 obj [ 0 0 595.275590072 841.88975789 ] endobj 5 0 obj [ 0 0 595.27559 841.889758 ] endobj 8 0 obj [ 0 0 968.199847 841.889758 ] endobj Page 1 has /MediaBox redirected to object 3 and /CropBox redirected to object 5. Page 2 has /MediaBox redirected to object 3 and /CropBox redirected to object 8. I’m not sure whether the oversized /CropBox in the sample above is a bug triggered by the use of "\setupinteractionscreen[width=fit]". >From the PDF–1.7 specification (https://opensource.adobe.com/dc-acrobat-sdk-docs/standards/pdfstandards/pdf…) The crop, bleed, trim, and art boxes shall not ordinarily extend beyond the boundaries of the media box. If they do, they are effectively reduced to their intersection with the media box. https://wiki.contextgarden.net/PDF_Boxes displays an image of (what I guess) the ordinary case: /CropBox fits inside /MediaBox. Could anyone be so kind to confirm the issue or to explain the rationale behind the oversized /CropBox? Many thanks for your help, Pablo

2 2

\setupparagraphs - can they run over two pages?
by jbf 27 Feb '23

27 Feb '23

I have the following setup for side-by-side paras. \defineparagraphs[Two][n=2] \setupparagraphs[Two][1][width=.1\textwidth,style=\bfx,align=tolerant] \setupparagraphs[Two][2][width=.9\textwidth,style=normal,align=tolerant] My difficulty is that while there is only ever just a couple of numbers in the left-hand 'column', the right-hand 'column' may have several lengthy paragraphs. If I have one relatively short \startTwo followed by one that is much longer, it will be forced to start on the next page, leaving too much empty space on the previous page. It is probable that getting this environment to split across pages is not possible. I can try very different approaches (columns, tables) to solve my problem, but I thought I would at least ask first. Julian

3 3

Can ConTeXt display a simple itemized list as a comma-separated list?
by Joel 27 Feb '23

27 Feb '23

I have a list like this: \startitemize[1]\item fish\item eggs\item milk\stopitemize Is there any command in ConTeXt to make this display the items as a comma-separated list, like this: fish, eggs, milk Or a semi-colon-separated list? fish; eggs; milk --Joel

5 6

Aaligned numbers in a matrix?
by Bruce Horrocks 27 Feb '23

27 Feb '23

I'm using the following MWE to produce a matrix: \definemathmatrix[bmatrix] [matrix:brackets] [simplecommand=bmatrix] \starttext $ a \rightarrow \bmatrix{1, 2, 3, 4; 2, 1, 4, 3; 3,-4, 1,-2; 4,-3, 2,-1} $ \stoptext The columns with negative numbers in are centred and I would rather have them right-aligned so that the digits stack up above each other and the negative signs stick out to the left, so to speak. Is there an easy way to achieve this? — Bruce Horrocks Hampshire, UK

3 2