685
edits
Changes
Jump to navigation
Jump to search
= Modules::documentation=
Modules as name come from <code>modules</code> switch in <br/><code>texexec --pdf --modules ''module name''</code><br/>or<br/><code>texmfstart texexec --pdf --modules ''module name''</code><br/> or<br/> <code> texmfstart texexec --luatex --modules ''module name'' </codeh1>The database<br/h1>
* firstNormally in a document you will use only one bibliographic database, whether or not distributed over multiple files. Nevertheless we support multiple databases as well which is why we talk of datasets instead. A dataset is loaded with the <tt style="color:rgb(0, see ''Inside_ConTeXt'' 102,102);font-size:100%;" >\usebtxdataset</tt> command. Although currently it is not necessary to define a (default) dataset you can best do this because in the future we might provide more options. Here are some examples: <pre style="color:rgb(102,0,102);font-size:100%">\definebtxdataset[standard]\usebtxdataset[standard][tugboat.bib]\usebtxdataset[http:standard][mtx-bibtex-output.xml]\usebtxdataset[standard][test-001-btx-standard.lua]</pre><p></sandboxp>These three suffixes are understood by the loader.contextgardenHere the dataset has the name <tt style="color:rgb(0,102,102);font-size:100%;" >standard</tt> and the three database files are merged, where later entries having the same tag overload previous ones.netDefinitions in the document source (coded in <span tag="MKIV" style="font-style:sans;">TEX</Inside_ConTeXt]; * span> speak) are alsoadded, see ''CONTEXT System Macros'' and they are saved for successive runs. This means that if you load and define entries, they will be known at [httpa next run beforehand, so that references to them are independent of when loading and definitions take place.<div style="border:thin solid black;" ><span style="font-style:oblique;" > setup definition setupbtxdataset </span ></tex.aanhet.netdiv><div style="border:thin solid black;" ><span style="font-style:oblique;" > setup definition definebtxdataset </contextspan ></systdiv><div style="border:thin solid black;" ><span style="font-genstyle:oblique;" > setup definition usebtxdataset </span ></div><p></p>In this document we use some example databases, so let’s load one of them now: <pre style="color:rgb(102,0,102);font-doc.pdfsize:100%">\definebtxdataset[example]* \usebtxdataset[example][User:Luigimkiv-publications.scarsobib]</pre><p></modules.pdf]] p>You can ask for an overview of entries in a comprensive set of pdfdataset with: <pre style="color:rgb(102,0,102);font-size:100%">\showbtxdatasetfields[example]</pre>this gives: <table><tr><td>tag</td><td>category</td><td>fields</td></tr><tr><td>demo-001</td><td>book</td><td>author index title year</td></tr><tr><td>demo-002</td><td>book</td><td>crossref index year</td></tr><tr><td>demo-003</td><td>book</td><td>author comment index title year</td></tr><tr><td>demo-004</td><td>book</td><td>author comment index title year</td></tr><tr><td>demo-005</td><td>book</td><td>author doi index pages serial title url year</td></tr></table>
*AutoSize<p></p><tt style="color: see supprgb(102,0,102);font-fun.tex. Some stuff heresize: http100%;" >setupbtxlistvariant :author</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >no specific settings</wiki.contextgarden.nettt></User:Luigi.scarsotd><td></td></tr></autosizetable>
* Two SRA3 papers labels here http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxlistvariant :editor</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >no specific settings</tt></wiki.contextgarden.nettd><td></td></Image:SRA3.jpg tr><!--[[Image:SRA3.jpg]] --/table>
*I have download preprint <p></p>The exact rendering of list entries is determined by the <tt style="color:rgb(0,102,102);font-size:100%;" >alternative</tt> key and defaults to <tt style="color:rgb(0,102,102);font-size:100%;" >apa</tt> which uses definitions from <tt style="color:rgb(0,102,102);font-size:100%;" >publ-imp-apa.mkiv</tt>. If you look at that file you will see that each category has its own setup. You may also notice that additional tests are needed to make sure that empty fields don’t trigger separators and such.<p></p>There are a couple of EUROTEX 2005 [httpaccessors and helpers to get the job done. When you want to fetch a field from the current entry you use <tt style="color:rgb(0,102,102);font-size:100%;" >\btxfield</tt>. In most cases you want to make sure this field has a value, for instance because you don’t want fences or punctuation that belongs to a field. <pre style="color:rgb(102,0,102);font-size:100%">\btxdoif {title} { \bold{\btxfield{title}},}</pre><p></p>There are three test macros: <pre style="color:rgb(102,0,102);font-size:100%">\btxdoifelse{fieldname}{action when found}{action when not found}\btxdoif {fieldname}{action when found}\btxdoifnot {fieldname} {action when not found}</pre><p></p>An extra conditional is available for testing interactivity: <pre style="color:rgb(102,0,102);font-size:100%">\btxdoifelseinteraction{action when true}{action when false}</pre><p></p>In addition there is also a conditional <tt style="color:rgb(0,102,102);font-size:100%;" >\btxinteractive</wwwtt> which is more efficient, although in practice efficiency is not so important here.gutenberg<p></p>There are three commands to flush data: <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxfield</tt></td><td>fetch a explicit field (e.eug.org<tt style="color:rgb(0,102,102);font-size:100%;" >year</EuroTeX2005tt>)</] It's very interestingtd></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxdetail</tt></td><td>fetch a derived field (e.g.<brtt style="color:rgb(0,102,102);font-size:100%;" >short</tt>)</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxflush</tt></td><td>fetch a derived or explicit field</td></tr></table>
*For EUROTEX 2006<p></p>Normally you can use <tt style="color:rgb(0, see slides here102,102);font-size:100%;" >\btxfield</tt> or <tt style="color:httprgb(0,102,102);font-size:100%;" >\btxflush</tt> as derived fields just like analyzed author fields are flushed in a special way.<p></wwwp>You can improve readability by using setups, for instance: <pre style="color:rgb(102,0,102);font-size:100%">\btxdoifelse {author} { \btxsetup{btx:apa:author:yes}} { \btxsetup{btx:apa:author:nop}}</pre><p></p>Keep in mind that normally you don’t need to mess with definitions like this because standard rendering styles are provided.matexhuThese styles use a few helpers that inject symbols but also take care of leading and trailing spaces: <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxspace</tt></td><td>before after</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxperiod</tt></td><td>before.orgafter</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxcomma</tt></td><td>before, after</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxlparent</tt></td><td>before (after</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxrparent</tt></td><td>before) after</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxlbracket</tt></td><td>before [after</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >\btxrbracket</tt></td><td>before] after</eurotex2006td></lecturestr></table>
---- *Is Indesign CS2 better than ConTeXt ? ----<h1>Citations</h1>
*http<p></p>For reasons of backward compatibility the <tt style="color:rgb(0,102,102);font-size:100%;" >\cite</tt> command is a bit picky about spaces between the two arguments, of which the first is optional. This is a consequence of allowing its use with the key specified between curly brackets as is the traditional practice. (We do encourage users to adopt the more coherent <span tag="MKIV" style="font-style:sans;">ConTEXt</pdfeditspan> syntax by using square brackets for keywords and reserving curly brackets to regroup text to be typeset.petricek)<p></p>The <tt style="color:rgb(0,102,102);font-size:100%;" >\citation</tt> command is synonymous but is more flexible with respect to spacing of its arguments: <pre style="color:rgb(102,0,102);font-size:100%">\citation[author] [example::demo-004,demo-003]\citation[authoryear] [example::demo-004,demo-003]\citation[authoryears][example::demo-004,demo-003]</pre><p></p>There is a whole bunch of cite options and more can be easily defined.net <table><tr><td>key</td><td>rendering</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >author</tt></td><td>(author)</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >authornum</tt></td><td>[author [btx error 1]]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >authoryear</tt></td><td>(author (year))</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >authoryears</tt></td><td>(author, year)</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >doi</tt></td><td>[todo: doi]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >key</tt></td><td>[demo-005]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >none</tt></td><td></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >num</tt></td><td>[[btx error 1]]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >page</tt></td><td>pages</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >serial</tt></td><td>[5]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >short</tt></td><td>[aut00]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >type</tt></td><td>[book]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >url</tt></td><td>[todo: url]</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >year</tt></td><td>(year)</td></tr></ pdfeditor table>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : authornum</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></www.mailtd><td><tt style="color:rgb(0,102,102);font-archive.comsize:100%;" >]</poppler@lists.freedesktop.orgtt></msg00334.html There is a Ruby bindingtd></tr><tr><td><tt style="color:rgb(0, Ruby102,102);font-size:100%;" >middle</Popplertt></td><td><tt style="color:rgb(0, in Ruby102,102);font-size:100%;" >, </tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-GNOME2 project.size:100%;" >[</tt></td></tr></table>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : authoryears</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >compress</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >yes</tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >inbetween</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >, </tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >)</tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >middle</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >, </tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >(</tt></td></podofo.sourceforge.nettr></ PDF parsing librarytable>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : doi</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >]</tt></td></search.cpan.orgtr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</disttt></CAMtd><td><tt style="color:rgb(0,102,102);font-PDFsize:100%;" >[</tt></td></tr></ PDF manipulation librarytable>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : none</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >no specific settings</tt></td><td></www.coherentgraphics.co.uktd></camlpdf.html `` an OCaml library for reading, writing and manipulating Adobe portable document files``tr></table>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant :page</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >inbetween</hackage.haskell.orgtt></cgitd><td><tt style="color:rgb(0,102,102);font-binsize:100%;" >–</tt></hackage-scriptstd></packagetr></HPDF-1.3table>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : type</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >]</tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</poppler.freedesktop.orgtt></ td><td><tt style="color:rgb(waiting for a python binding..0,102,102);font-size:100%;" >[</tt></td></tr></table>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : url</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >]</tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >[</tt></pybrary.nettd></pyPdftr></ table>
*http<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : year</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >)</tt></td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</www.boddie.org.uktt></davidtd><td><tt style="color:rgb(0,102,102);font-size:100%;" >(</Projectstt></Pythontd></pdftoolstr></.table>
* httpBecause we manage data at the <span tag="MKIV" style="font-style:sans;">Lua</span> end it is tempting to access it there for other purposes. This is fine as long as you keep in mind that aspects of the implementation may change over time, although this is unlikely once the modules become stable.<p></p>The entries are collected in datasets and each set has a unique name. In this document we have the set named <tt style="color:rgb(0,102,102);font-size:100%;" >example</tt>. A dataset table has several fields, and probably the one of most interest is the <tt style="color:rgb(0,102,102);font-size:100%;" >luadata</tt> field. Each entry in this table describes a publication: <pre style="color:rgb(102,0,102);font-size:100%">t={ ["author"]="Hans Hagen", ["category"]="book", ["index"]=1, ["tag"]="demo-001", ["title"]="\\btxcmd{BIBTEX}, the \\btxcmd{CONTEXT}\\ way", ["year"]="2013", } </pre>This is <tt style="color:rgb(0,102,102);font-size:100%;" >publications.datasets.example.luadata["demo-001"]</tt>. There can be a companion entry in the parallel <tt style="color:rgb(0,102,102);font-size:100%;" >details</tt> table. <pre style="color:rgb(102,0,102);font-size:100%">t={ ["author"]={ { ["firstnames"]={ "Hans" }, ["initials"]={ "H" }, ["original"]="Hans Hagen", ["surnames"]={ "Hagen" }, ["vons"]={}, }, }, ["short"]="Hag13", } </wwwpre>These details are accessed as <tt style="color:rgb(0,102,102);font-size:100%;" >publications.fpdfdatasets.orgexample.details["demo-001"]</ tt> and by using a separate table we can overload fields in the original entry without losing the original.<p></p>You can loop over the entries using regular <span tag="MKIV" style="font-style:sans;">Lua</span> code combined with <span tag="MKIV" style="font-style:sans;">MkIV</span> helpers: <pre style="color:rgb(PHP102,0,102);font-size:100%">local dataset = publications.datasets.examplecontext.starttabulate { "|l|l|l|" }for tag, entry in table.sortedhash(dataset.luadata) do local detail = dataset.details[tag] or { } context.NC() context.type(tag) context.NC() context(detail.short) context.NC() context(entry.title) context.NC() context.NR()endcontext.stoptabulate()</pre><p></p>This results in: <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >demo-001</tt></td><td>Hag13</td><td><span tag="MKIV" style="font-style:sans;">bibTEX</span>, the <span tag="MKIV" style="font-style:sans;">ConTEXt</span> way</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >demo-002</tt></td><td>Hag14</td><td><span tag="MKIV" style="font-style:sans;">bibTEX</span>, the <span tag="MKIV" style="font-style:sans;">ConTEXt</span> way</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >demo-003</tt></td><td>HO96</td><td>Typesetting education documents</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >demo-004</tt></td><td>Sca21</td><td>Designing high speed trains</td></tr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >demo-005</tt></td><td>aut00</td><td>title</td></tr></table>
\stopluacode\low{2} into Hex.
% a pair of random hexadecimals
Perform logical AND, OR and XOR under the following pair of hexadecimal numbers:
\startluacode
n = math.random(10,255)
m = math.random(10,255)
tex.print(string.format("%X, %X", n, m))
\def\TestC{%<p></p>\directlua0{%require('python')python.execute('nThe original data is stored in a <span tag=1')n"MKIV" style=python.eval('n')print("PYTHONfont-style:sans;">Lua</span> table, hashed by tag..n)%% --[[ --]]python.execute('sStarting with <span tag="XYZMKIV"')sstyle=python.eval('s')print("PYTHONfont-style:sans;">Lua</span> 5..s,",lenght2 each run of <span tag="..\letterhash s)%% --[[ --]]python.execute('d={"Boo":1}')python.execute('d["FOOMKIV"]=2')dstyle=python.eval('d')print("PYTHON:",d)print("PYTHONfont-style:sans;",d.Boo,d["Boo"],d.FOO,d["FOO"])%% --[[ --]]python.execute('>Lua</span> gets a=[1,3,2,5,9]')different ordering of such a=pythonhash.eval('a')print("PYTHON:"In older versions,when you looped over a)print("PYTHON:"hash,a[0]the order was undefined,a[1])pythonbut the same as long as you used the same binary.execute('aThis had the advantage that successive runs, something we often have in document processing gave consistent results.append(In today’s <span tag="XMKIV")')python.execute('a.sort()')astyle=python.eval('a')print("PYTHON:",a)print("PYTHONfont-style:sans;">Lua</span> we need to do much more sorting of hashes before we loop,a[0],a[1])%% especially when we save multi--[[ --]]apass data. It is for this reason that the <span tag=python.eval('[0,3,8,2,-1]')print("PYTHON:MKIV",a[3])print(style="PYTHONfont-style:sans;",a,type>xml</span> tree is sorted by hash key by default. That way lookups (especially the first of aset))give consistent outcomes. %% }}<h1>Standards</h1>
%%-- testD.lua %% require('python')%% print("BEGIN PYTHON")%% pycode=[[%% class Test(object):%% def __init__(self):%% selfThe rendering of bibliographic entries is often standardized and prescribed by the publisher.If you submit an article to a=[0,3,81,2journal,normally it will be reformatted (or even re-1]%% self.b=self.a[:]%% self.a.sort(keyed)%% %% def get(self): %% return selfand the rendering will happen at the publishers end.aIn that case it may not matter how entries were rendered when writing the publication,selfbecause the publisher will do it his or her way.b%% ]]%% python.execute(pycode)%% python.execute("tThis means that most users probably will stick to the standard <span tag=Test()")%% print(python.eval("t.get()MKIV"))%% tstyle=python.eval("Test()font-style:sans;")%% print(t>apa</span> rules and for them we provide some configuration.get())%% print(tBecause we use setups it is easy to overload specifics.get()[0])%% print(tIf you really want to tweak, best look in the files that deal with it.get()[0][0])%% print(TeX)<p></p>%% print("END PYTHON")\def\TestD#1{%\directlua0{%TeX='#1'dofile('testDMany standards exist and support for other renderings may be added to the core.lua')}%} %% -- testG.lua%% require('python')%% tex.print("\\ruledvbox{testG}\\blank")%% tex.print("\\ruledvbox{BEGIN PYTHON}\\blank")%% pyg = pythonInterested users are invited to develop and to test alternate standard renderings according to their needs.globals()%% pycode=[[<p></p>%% class Test(object)Todo:%% def __init__(self,tex):%% selfmaybe a list of categories and fields.tex=tex%% %% def getbboxpage(self): %% return self.tex['hsize'],self.tex['vsize']%% %% ]]%% python.execute(pycode)%% --%% pyg.tex = tex%% python.execute("test=Test(tex)")%% test=python.eval("test")%% bboxpage = test.getbboxpage()%% tex.print(tostring(bboxpage))%% tex.print("\\blank\\ruledvbox{END PYTHON}")\def\TestG{\directlua0{dofile('testG.lua')}}<h1>Cleaning up</h1>
=Future ConTeXt Users=
[[Future_ConTeXt_Users]]
no edit summary
__TOC__
The <span tag="MKIV" style="font-style:sans;">bibTEX</span> format is rather popular in the <span tag="MKIV" style="font-style:sans;">TEX</span> community and even with its shortcomings it will stay around for a while. Many publication websites can export and many tools are available to work with this database format. It is rather simple and looks a bit like <span tag="MKIV" style="font-style:sans;">Lua</span> tables. Unfortunately the content can be polluted with non-standardized <span tag="MKIV" style="font-style:sans;">TEX</span> commands which complicates pre- or postprocessing outside <span tag="MKIV" style="font-style:sans;">TEX</span>. In that sense a <span tag="MKIV" style="font-style:sans;">bibTEX</span> database is often not coded neutrally. Some limitations, like the use of commands to encode accented characters root in the <span tag="MKIV" style="font-style:sans;">ascii</span> world and can be bypassed by using <span tag="MKIV" style="font-style:sans;">utf</span> instead (as handled somewhat in <span tag="MKIV" style="font-style:sans;">LATEX</span> through extensions such as <tt style="color:rgb(0,102,102);font-size:100%;" >bibtex8</tt>).<p></p>The normal way to deal with a bibliography is to refer to entries using a unique tag or key. When a list of entries is typeset, this reference can be used for linking purposes. The typeset list can be processed and sorted using the <tt style="color:rgb(0,102,102);font-size:100%;" >bibtex</tt> program that converts the database into something more <span tag="MKIV" style="font-style:sans;">TEX</span> friendly (a <tt style="color:rgb(0,102,102);font-size:100%;" >.bbl</tt> file). I never used the program myself (nor bibliographies) so I will not go into too much detail here, if only because all I say can be wrong.<p></p>In <span tag="MKIV" style="font-style:sans;">ConTEXt</span> we no longer use the <tt style="color:rgb(0,102,102);font-size:100%;" >bibtex</tt> program: we just use database files and deal with the necessary manipulations directly in <span tag="MKIV" style="font-style:sans;">ConTEXt</span>. One or more such databases can be used and combined with additional entries defined within the document. We can have several such datasets active at the same time.<p></p>A <span tag="MKIV" style="font-style:sans;">bibTEX</span> file looks like this: <pre style="color:rgb(102,0,102);font-size:100%">@Article{sometag, author = "An Author and Another One", title = "A hopefully meaningful title", journal = maps, volume = "25", number = "2", pages = "5--9", month = mar, year = "2013", ISSN = "1234-5678",}</pre><p></p>Normally a value is given between quotes (or curly brackets) but single words are also OK (there is no real benefit in not using quotes, so we advise to always use them). There can be many more fields and instead of strings one can use predefined shortcuts. The title for example quite often contains <span tag="MKIV" style="font-style:sans;">TEX</span> macros. Some fields, like <tt style="color:rgb(0,102,102);font-size:100%;" >pages</tt> have funny characters such as the endash (typically as <tt style="color:rgb(0,102,102);font-size:100%;" >--</tt>) so we have a mixture of data and typesetting directives. If you are covering non--english references, you often need characters that are not in the <span tag="MKIV" style="font-style:sans;">ascii</span> subset but <span tag="MKIV" style="font-style:sans;">ConTEXt</span> is quite happy with <span tag="MKIV" style="font-style:sans;">utf</span>. If your database file uses old-fashioned <span tag="MKIV" style="font-style:sans;">TEX</span> accent commands then these will be internally converted automatically to <span tag="MKIV" style="font-style:sans;">utf</span>. Commands (macros) are converted to an indirect call, which is quite robust.<p></p>The <span tag="MKIV" style="font-style:sans;">bibTEX</span> files are loaded in memory as <span tag="MKIV" style="font-style:sans;">Lua</span> table but can be converted to <span tag="MKIV" style="font-style:sans;">xml</span> so that we can access them in a more flexible way to make pdf , but that is a subject for specialists.<p></p>In the old <span tag="MKIV" style="font-style:sans;">MkII</span> setup we have two kinds of entries: the ones that come from the <span tag="MKIV" style="font-style:sans;">bibTEX</span> run and user supplied ones. We no longer rely on <span tag="MKIV" style="font-style:sans;">bibTEX</span> output but we do still support the user supplied definitions. These were in fact prepared in a way that suits the processing of <span tag="MKIV" style="font-style:sans;">bibTEX</span> generated entries. The next variant reflects the <span tag="MKIV" style="font-style:sans;">ConTEXt</span> recoding of the old <span tag="MKIV" style="font-style:sans;">bibTEX</span> output. <pre style="color:rgb(102,0,102);font-size:100%">\startpublication[k=Hagen:Second,t=article,a={Hans Hagen},y=2013,s=HH01] \artauthor[]{Hans}[H.]{}{Hagen} \arttitle{Who knows more?} \journal{MyJournal} \pubyear{2013} \month{8} \volume{1} \issue{3} \issn{1234-5678} \pages{123--126}\stoppublication</pre><p></p>The split <tt style="color:rgb(0,102,102);font-size:100%;" >\artauthor</tt> fields are collapsed into a single <tt style="color:rgb(0,102,102);font-size:100%;" >author</tt> field as we deal with the splitting later when it gets parsed in <span tag="MKIV" style="font-style:sans;">Lua</span>. The <tt style="color:rgb(0,102,102);font-size:100%;" >\artauthor</tt> syntax is only kept around for backward compatibility with the previous use of documentation <span tag="MKIV" style="font-style:sans;">bibTEX</span>.<p></p>In the new setup we support these variants as well: <pre style="color:rgb(102,0,102);font-size:100%">\startpublication[k=Hagen:Third,t=article] \author{Hans Hagen} \title{Who knows who?} ...\stoppublication</pre><p></p>and code <pre style="color:rgb(102,0,102);font-size:100%">\startpublication[tag=Hagen:Third,category=article] \author{Hans Hagen} \title{Who knows who?} ...\stoppublication</pre><p></p>and <pre style="color:rgb(102,0,102);font-size:100%">\startpublication \tag{Hagen:Third} \category{article} \author{Hans Hagen} \title{Who knows who?} ...\stoppublication</pre><p></p>Because internally the entries are <span tag="MKIV" style="font-style:sans;">Lua</span> tables, we also support loading of ''module <span tag="MKIV" style="font-style:sans;">Lua</span> based definitions: <pre style="color:rgb(102,0,102);font-size:100%">return { ["Hagen:First"] = { author = "Hans Hagen", category = "article", issn = "1234-5678", issue = "3", journal = "MyJournal", month = "8", pages = "123--126", tag = "Hagen:First", title = "Who knows nothing?", volume = "1", year = "2013", },}</pre><p></p>Files set up like this can be loaded too. The following <span tag="MKIV" style="font-style:sans;">xml</span> input is rather close to this, and is also accepted as input. <pre style="color:rgb(102,0,102);font-size:100%"><?xml version="2.0" standalone="yes" ?><bibtex> <entry tag="Hagen:First" category="article"> <field name="author">Hans Hagen</field> <field name="category">article</field> <field name="issn">1234-5678</field> <field name="issue">3</field> <field name="journal">MyJournal</field> <field name="month">8</field> <field name="pages">123--126</field> <field name="tag">Hagen:First</field> <field name="title">Who knows nothing?</field> <field name="volume">1</field> <field name'' ="year">2013</field> </entry></bibtex></pre><p></p>Todo: Add some remarks about loading EndNote and RIS formats, but first we need to complete the tag mapping (on Alan’s plate).<p></p>So the user has a rather wide choice of formatting style for bibliography database files. You can load more data than you actually need. Only entries that are referred to explicitly through the <tt style="color:rgb(0,102,102);font-size:100%;" >\cite</tt> and <tt style="color:rgb(0,102,102);font-size:100%;" >\nocite</tt> commands will be shown in lists. We will cover these details later. <h1>Commands in entries</h1>
One unfortunate aspect commonly found in <span tag="MKIV" style="font-style:sans;">bibTEX</span> files is that they often contain <span tag="MKIV" style="font-style:sans;">TEX</span> commands. Even worse is that there is no standard on what these commands can be and what they mean, at least not formally, as <span tag="MKIV" style="font-style:sans;">bibTEX</span> is a program intended to be used with many variants of <span tag="MKIV" style="font-style:sans;">TEX</span> style: plain, <span tag="MKIV" style="font-style:sans;">LATEX</span>, and others. This means that we need to define our use of these typesetting commands. However, in most cases, they are just abbreviations or font switches and these are often known. Therefore, <span tag="MKIV" style="font-style:sans;">ConTEXt</span> will try to resolve them before reporting an issue. In the log file there is a list of commands that has been seen in the loaded databases. For lua codeinstance, loading <tt style="color:rgb(0,102,102);font-size:100%;" >tugboat.bib</tt> gives a long list of commands of which we show a small set here: <pre style="color:rgb(102, I've found convenient0,102);font-size:100%">publications > start used btx commandspublications > standard CONTEXT 1 knownpublications > standard ConTeXt 4 knownpublications > standard TeXLive 3 KNOWNpublications > standard eTeX 1 knownpublications > standard hbox 6 knownpublications > standard sltt 1 unknownpublications > stop used btxcommands<br/pre><codep></p>mtxrun You can define unknown commands, or overload existing definitions in the following way: <pre style="color:rgb(102,0,102);font-size:100%">\definebtxcommand\TUB {TUGboat}\definebtxcommand\sltt{\tt}\definebtxcommand\<#1>{\type{#1}}</pre><p></p>Unknown commands do not stall processing, but their names are then typeset in a mono-internal xspaced font so they probably stand out for proofreading. You can access the commands with <tt style="color:rgb(0,102,102);font-ldx ''modulesize:100%;" >\btxcommand{.lua'' ..}<br/tt>, as in: texmfstart texexec --use <pre style=x"color:rgb(102,0,102);font-ldx --forcexml ''modulesize:100%">commands like \btxcommand{MySpecialCommand} are handled in an indirect way</pre><p></p>As this is an undefined command we get: “commands like MySpecialCommand are handled in an indirect way”.ldx''<p></codep>?? <h1>Datasets<br/h1>
<p></p>You can set the current active dataset with <pre style="color:rgb(102,0,102);font-- Maybe you are searching for [size:100%">\setbtxdataset[Modulesstandard]], ie extensions </pre><p></p>but most publication-related commands accept optional arguments that denote the dataset and references to ConTeXt's core functionsentries can be prefixed with a dataset identifier.--. More about that later. <h1>Renderings</h1>
A list of publications can be rendered at any place in the document. A database can be much larger than needed for a document. The same is true for the fields that make up an entry. Here is the list of fields that are currently handled, but of course there can be additional ones:<p></p><tt style= Other stuffs"color:rgb(0,102,102);font-size:100%;" >abstract</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >address</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >annotate</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >assignee</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >author</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >bibnumber</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >booktitle</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >chapter</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >comment</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >country</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >day</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >dayfiled</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >doi</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >edition</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >editor</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >eprint</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >howpublished</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >institution</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >isbn</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >issn</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >journal</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >key</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >keyword</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >keywords</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >language</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >lastchecked</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >month</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >monthfiled</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >names</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >nationality</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >note</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >notes</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >number</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >organization</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >pages</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >publisher</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >revision</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >school</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >series</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >size</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >title</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >type</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >url</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >volume</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >year</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >yearfiled</tt><p></p>If you want to see what publications are in the database, the easiest way is to ask for a complete list: <pre style="color:rgb(102,0,102);font-size:100%">\definebtxrendering [example] [dataset=example, method=local, alternative=apa]\placelistofpublications % \placebtxrendering [example] [criterium=all]</pre><p></p>This gives:1 Hagen, H. and Otten, T. (1996). Typesetting education documents.2 Scarso, L. (2021). Designing high speed trains.3 author (year). title. pages p.<p></p>The rendering itself is somewhat complex to set up because we have not only many different standards but also many fields that can be set up. This means that there are several commands involved. Often there is a prescribed style to render bibliographic descriptions, for example <tt style="color:rgb(0,102,102);font-size:100%;" >apa</tt>. A rendering is setup and defined with:<div style="border:thin solid black;" ><span style="font-style:oblique;" > setup definition setupbtxrendering </span ></div><div style="border:thin solid black;" ><span style="font-style:oblique;" > setup definition definebtxrendering </span ></div><p></p>And a list of such descriptions is generated with:<div style="border:thin solid black;" ><span style="font-style:oblique;" > setup definition placebtxrendering </span ></div><p></p>A dataset can have all kind of entries:<p></p><tt style="color:rgb(0,102,102);font-size:100%;" >article</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >book</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >booklet</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >conference</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >inbook</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >incollection</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >inproceedings</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >manual</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >mastersthesis</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >misc</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >phdthesis</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >proceedings</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >techreport</tt>, <tt style="color:rgb(0,102,102);font-size:100%;" >unpublished</tt><p></p>Each has its own rendering variant. To keep things simple we have their settings separated. However, these settings are shared for all rendering alternatives. In practice this is seldom a problem in a publication as only one rendering alternative will be active. If this be not sufficient, you can always group local settings in a setup and hook that into the specific rendering.<div style="border:thin solid black;" ><span style="font-style:oblique;" > setup definition setupbtxlistvariant </span ></div><div style="border:thin solid black;" ><span style="font-style:oblique;" > setup definition definebtxlistvariant </span ></div><p></p>Examples of list variants are:<p></p><tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxlistvariant : artauthor</tt> <table><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >no specific settings</tt></td><td></td></tr></table>
<!p></p>So, the previous example setup can be rewritten as: <pre style="color:rgb(102,0,102);font-size:100%">\btxdoif {title} { \bold{\btxfield{title}} \btxcomma}</pre><p></p>There is a special command for rendering a (combination) of authors: <pre style="color:rgb(102,0,102);font-* For EUROTEX 2007size:100%">\btxflushauthor{author}\btxflushauthor{editor}\btxflushauthor[inverted]{editor}</pre><p></p>Instead of the last one you can also use: <pre style="color:rgb(102, see some slides here0,102);font-size: http100%">\btxflushauthorinverted{editor}</pre><p></p>You can use a (configurable) default or pass directives:Valid directives are <table><tr><td>conversion</td><td>rendering</www.logosrl.ittd></contexttr><tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >inverted</tt></EuroTeX2007td><td>the Frog jr, Kermit</ td></tr><tr><td><tt style="color:rgb(0,102,102);font--size:100%;" >invertedshort</tt></td><td>the Frog jr, K</td></tr>*Also very interesting are colors <tr><td><tt style="color:rgb(here [http0,102,102);font-size:100%;" >normal</tt></contextgarden.nettd><td>Kermit, the Frog, jr</index.php?titletd></tr><tr><td><tt style=Colors]"color:rgb(0,102,102);font-size:100%;" >normalshort</tt></td><td>K, the Frog, jr</td></tr></table>
Citations are references to bibliographic entries that normally show up in lists someplace in the document: at the end of a chapter, in an appendix, at the end of an article, etc. We discussed the rendering of these lists in the previous chapter. A citation is normally pretty short as its main purpose is to refer uniquely to a more detailed description. But, there are several ways to refer, which is why the citation subsystem is configurable and extensible. Just look at the following commands: <pre style=Cool links="color:rgb(102,0,102);font-size:100%">\cite[author][example::demo-003]\cite[authoryear][example::demo-003]\cite[authoryears][example::demo-003]\cite[author][example::demo-003,demo-004]\cite[authoryear][example::demo-003,demo-004]\cite[authoryears][example::demo-003,demo-004]\cite[author][example::demo-004,demo-003]\cite[authoryear][example::demo-004,demo-003]*http\cite[authoryears][example::demo-004,demo-003]</pre> <div>:(Hans Hagen and Ton Otten):(Hans Hagen and Ton Otten (1996)):(Hans Hagen and Ton Otten, 1996):(Hans Hagen and Ton Otten, Luigi Scarso):(Hans Hagen and Ton Otten (1996), Luigi Scarso (2021)):(Hans Hagen and Ton Otten, 1996, Luigi Scarso, 2021):(Luigi Scarso, Hans Hagen and Ton Otten):(Luigi Scarso (2021), Hans Hagen and Ton Otten (1996)):(Luigi Scarso, 2021, Hans Hagen and Ton Otten, 1996)</gnupdf.orgdiv>
<p></p>
The first argument is optional.
<div style="border:thin solid black;" >
<span style="font-style:oblique;" > setup definition cite </span >
</div>
<p></p>
You can tune the way a citation shows up:
<pre style="color:rgb(102,0,102);font-size:100%">\setupbtxcitevariant[author] [sorttype=author,color=darkyellow]
\setupbtxcitevariant[authoryear] [sorttype=author,color=darkyellow]
\setupbtxcitevariant[authoryears][sorttype=author,color=darkyellow]
\cite[author][example::demo-004,demo-003]
\cite[authoryear][example::demo-004,demo-003]
\cite[authoryears][example::demo-004,demo-003]
</pre>
<p></p>
Here we sort the authors and color the citation:
<div>
:(Hans Hagen and Ton Otten, Luigi Scarso)
:(Hans Hagen and Ton Otten (1996), Luigi Scarso (2021))
:(Hans Hagen and Ton Otten, 1996, Luigi Scarso, 2021)
</div>
<p></p>
Because we are dealing with database input and because we generally need to manipulate entries, much of the work is delegated to <span tag="MKIV" style="font-style:sans;">Lua</span>. This makes it easier to maintain and extend the code. Of course <span tag="MKIV" style="font-style:sans;">TEX</span> still does the rendering. The typographic details are controlled by parameters but not all are used in all variants. As with most <span tag="MKIV" style="font-style:sans;">ConTEXt</span> commands, it starts out with a general setup command:
<div style="border:thin solid black;" >
<span style="font-style:oblique;" > setup definition setupbtxcitevariant </span >
</div>
<p></p>
On top of that we can define instances that inherit either from a given parent or from the topmost setup.
<div style="border:thin solid black;" >
<span style="font-style:oblique;" > setup definition definebtxcitevariant </span >
</div>
<p></p>
But, specific variants can have them overloaded:
<p></p>
<tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : author</tt>
<table>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >)</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >middle</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >, </tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >(</tt></td></tr>
</table>
<p></p>
<tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : authoryear</tt>
<table>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >compress</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >yes</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >inbetween</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >, </tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >)</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >middle</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >, </tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >(</tt></td></tr>
</table>
<p></p>
<tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : key</tt>
<table>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >]</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >[</tt></td></tr>
</table>
<p></p>
<tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : num</tt>
<table>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >compress</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >yes</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >inbetween</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >--</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >]</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >[</tt></td></tr>
</table>
<p></p>
<tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : serial</tt>
<table>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >]</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >[</tt></td></tr>
</table>
<p></p>
<tt style="color:rgb(102,0,102);font-size:100%;" >setupbtxcitevariant : short</tt>
<table>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >right</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >]</tt></td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >left</tt></td><td><tt style="color:rgb(0,102,102);font-size:100%;" >[</tt></td></tr>
</table>
A citation variant is defined in several steps and if you really want to know the dirty details, you should look into the <tt style="color:rgb(0,102,102);font-size:100%;" >publ-imp-*.mkiv</tt> files. Here we stick to the concept.
<pre style="color:rgb(102,0,102);font-size:100%">\startsetups btx:cite:author
\btxcitevariant{author}
\stopsetups
</pre>
<p></p>
You can overload such setups if needed, but that only makes sense when you cannot configure the rendering with parameters. The <tt style="color:rgb(0,102,102);font-size:100%;" >\btxcitevariant</tt> command is one of the build in accessors and it calls out to <span tag="MKIV" style="font-style:sans;">Lua</span> where more complex manipulation takes place if needed. If no manipulation is known, the field with the same name (if found) will be flushed. A command like <tt style="color:rgb(0,102,102);font-size:100%;" >\btxcitevariant</tt> assumes that a dataset and specific tag has been set. This is normally done in the wrapper macros, like <tt style="color:rgb(0,102,102);font-size:100%;" >\cite</tt>. For special purposes you can use these commands
<pre style="color:rgb(102,0,102);font-size:100%">\setbtxdataset[example]
\setbtxentry[hh2013]
</pre>
<p></p>
But don’t expect too much support for such low level rendering control.
<p></p>
Unless you use <tt style="color:rgb(0,102,102);font-size:100%;" >criterium=all</tt> only publications that are cited will end up in the lists. You can force a citation into a list using <tt style="color:rgb(0,102,102);font-size:100%;" >\usecitation</tt>, for example:
<pre style="color:rgb(102,0,102);font-size:100%">\usecitation[example::demo-004,demo-003]
</pre>
<p></p>
This command has two synonyms: <tt style="color:rgb(0,102,102);font-size:100%;" >\nocite</tt> and <tt style="color:rgb(0,102,102);font-size:100%;" >\nocitation</tt> so you can choose whatever fits you best.
<div style="border:thin solid black;" >
<span style="font-style:oblique;" > setup definition nocite </span >
</div>
<h1>The LUA view</h1>
<p></p>*http://wwwYou can manipulate a dataset after loading.ghostscript.com With a bit Of course this assumes that you know what kind of hacking, using ctypes (default from python 2content you have and what you need for rendering.5) one can make As example we load a rapid binding to libgs.so or gssmall dataset.dll * http<pre style="color://ccxvii.net/apparition/rgb(102,0,102);font-size:100%">\definebtxdataset[drumming] * http://portablesigner.sourceforge\usebtxdataset[drumming][mkiv-publications.net/ (sign PDFslua] *http:<//wiki.contextgarden.net/HTML_and_ConTeXtpre> *http:<p><//www.fauskes.net/ pgf and so.p> *http://context.aanhet.net/svn Because we’re going to do some sources <span tag= Luatex examples "MKIV" style=Examples from <tt>Vyatcheslav Yatskovsky <yatskovsky at gmail.com"font-style:sans;"> Lua</ttspan>, we could also have loaded the dataset with: *Say you needed to prepare about twenty test papers with 10 questions per a paper<pre style="color:rgb(102, that is0, 200 questions. Examples102);font-size: 100%"1>publications. convert Dec 36 into Hexload("drumming", "2mkiv-publications. convert Bin 10010101 into Declua", etc. "lua")</pre><p></p>The wording of every question should remain the samedataset has three entries:<p></p>As you can see, only figures we can have to be changed through papersa subtitle. Instead of inventing 200 numbers, you can write simple Lua scripts that generate random values We will combine the title and put them inside your question textsubtitle into one: <pre>% random decimal numberConvert\ctxlua{nstyle=math.random"color:rgb(30102,0,60102); tex.print(n);}font-size:100%">\low{10}startluacodeinto Binfor tag, entry in next, publications.datasets.drumming.luadata do if entry.subtitle then% random binary number if entry.title thenConvert entry.title = entry.title .. ", " .. entry.subtitle\startluacode elsefor c entry.title = 1, 16 doentry.subtitle endn entry.subtitle = mathnil logs.randomreport(0"btx","combining title and subtitle of entry tagged %a",1tag)tex.sprint(n) end
end
\stopluacode
</pre>
<p></p>
We can now typeset the entries with:
<pre style="color:rgb(102,0,102);font-size:100%">\definebtxrendering[drumming][dataset=drumming,method=dataset]
\placebtxrendering[drumming]
</pre>
<p></p>
Because we just want to show the entries, and have no citations that force them to be shown, we have to the <tt style="color:rgb(0,102,102);font-size:100%;" >method</tt> to <tt style="color:rgb(0,102,102);font-size:100%;" >dataset</tt>.1
<h1>The XML view</h1>
The <tt style="color:rgb(0,102,102);font-size:100% random word;" >luadata</tt> table can be converted into an <span tag="MKIV" style="font-style:sans;">xml</span> representation. This is a follow up on earlier experiments with an <span tag="MKIV" style="font-style:sans;">xml</span>-only approach. I decided in the end to stick to a <span tag="MKIV" style="font-style:sans;">Lua</span> approach and provide some simple <span tag="MKIV" style="font-style:sans;">xml</span> support in addition.<p></p>Encode your full name Once a dataset is accessible as <span tag="MKIV" style="font-style:sans;">xml</span> tree, you can use the regular <tt style="color:rgb(0,102,102);font-size:100%;" >\xml...</tt> commands. We start with loading a dataset, in this case from just one file. <pre style="color:rgb(102,0,102);font-size:100%">\startluacodeusebtxdataset[tugboat][tugboat.bib]a </pre><p></p>The dataset has to be converted to <span tag="MKIV" style="font-style:sans;">xml</span>: <pre style= {'null"color:rgb(102,0,102);font-terminated'size:100%">\convertbtxdatasettoxml[tugboat]</pre><p></p>The tree is now accessible by its root reference <tt style="color:rgb(0,102, 'dollar102);font-terminated'size:100%;" >btx:tugboat</tt>. If we want simple field access we can use a few setups: <pre style="color:rgb(102,0, 'Pascal shortstring'102);font-size:100%">\startxmlsetups btx:initialize \xmlsetsetup{#1}{bibtex|entry|field}{btx:*} \xmlmain{#1}\stopxmlsetups\startxmlsetups btx:field \xmlflushcontext{#1}\stopxmlsetups\xmlsetup{btx:tugboat}{btx:initialize}tex</pre><p></p>The two setups are predefined in the core already, but you might want to change them.printThey are applied in for instance: <pre style="color:rgb( 102,0,102);font-size:100%">\starttabulate[|||] \NC \type {tag} \NC \xmlfirst {btx:tugboat} {/bibtex/entry[string.formatfind(@tag,'%s string.Hagen')]/attribute('tag', a)} \NC \NR \NC \type {title} \NC \xmlfirst {btx:tugboat} {/bibtex/entry[mathstring.randomfind(1@tag,3'Hagen')]) );/field[@name='title']} \NC \NR\stopluacodestoptabulate
</pre>
<table>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >tag</tt></td><td>Hagen:TB17-1-54</td></tr>
<tr><td><tt style="color:rgb(0,102,102);font-size:100%;" >title</tt></td><td>PPCHTEX: typesetting chemical formulas in TEX</td></tr>
</table>
<pre style= Luatex hosts python ="color:rgb(102,0,102);font-size:100%">\startxmlsetups btx:demo \xmlcommand {#1}Following [http: {/bibtex/labixentry[string.orgfind(@tag,'Hagen')][1]}{btx:table}\stopxmlsetups\startxmlsetups btx:table\starttabulate[|||] \NC \type {tag} \NC \xmlatt{#1}{tag} \NC \NR \NC \type {title} \NC \xmlfirst{#1}{/lunatic-pythonfield[@name='title'] I was able} \NC \NR\stoptabulate\stopxmlsetups\xmlsetup{btx:tugboat}{btx:demo}</pre> <table><tr><td><tt style="color:rgb(0, in a linux box102, to modify luatex102);font-snapshot-20070820.tar.bz2 so that size:100%;" >tag</tt>luatex --luaonly</tttd> can host python. Of course <tttd>\directlua0{....}Hagen:TB17-1-54</tttd> also works.<br/tr><tr><td><tt style="color:rgb(also http0,102,102);font-size:100%;" >title</tt></rubyluabridge.rubyforge.orgtd><br/td>httpPPCHTEX://lua-users.org/wiki/LibrariesAndBindings)typesetting chemical formulas in TEX<br/td>'''WARNING: these modifications break security and portability''' <br/tr>'''WARNING: these are not examples of proprer context mkiv code''' <br/table>
<p></p>Here is another example: <prestyle="color:rgb(102,0,102);font-size:100%">\startxmlsetups btx:row% engine=luatex \NC \xmlatt{#1}{tag} \defNC \TestAxmlfirst{#1}{%/field[@name='title']} \NC \NR\stopxmlsetups\startxmlsetups btx:demo \directlua0xmlfilter {%#1} { /bibtexrequire( /entry[@category='pythonarticle')]re /field[@name= python.import'author' and (find(text("re")pattern = re.compile,'Knuth') or find(".*text(TeX).*",'DEK'))]match = pattern /..match/command("#btx:row) }\stopxmlsetups\starttabulate[|||] \xmlsetup{btx:tugboat}{btx:demo}\stoptabulate</pre> <table><tr><td>Knuth:TB10-1-31</td><td>Typesetting Concrete Mathematics</td></tr><tr><td>Knuth:TB10-1")-8</td><td>TEX would find it difficult …</td></tr>if match<tr><td>Knuth:TB10-3-325</td><td>The new versions of TEX and MF</td></tr>then<tr><td>Knuth:TB10-4-529</td><td>The errors of TEX</td></tr> print( 'match.group(<tr><td>Knuth:TB11-1)===-13</td><td>Virtual Fonts: More Fun for Grand Wizards</td></tr><tr><td>Knuth:TB11-2-165</td><td>Exercises for TEX: The Program</td></tr><tr><td>Knuth:TB11-4-489</td><td>The future of TEX and MF</td></tr><tr><td>Knuth:TB11-4-497</td><td>'Arthur Lee Samuel,match1901--1990</td></tr><tr><td>Knuth:TB11-4-499</td><td>Answers to Exercises for TEX: The Program</td></tr><tr><td>Knuth:TB12-2-313</td><td>Fixed-point glue setting: Errata</td></tr><tr><td>Knuth:TB14-4-387</td><td>Icons for TEX and MF</td></tr><tr><td>Knuth:TB17-1-29</td><td>Important message regarding CM fonts</td></tr><tr><td>Knuth:TB2-3-5</td><td>The current state of things</td></tr><tr><td>Knuth:TB3-1-10</td><td>Fixed-point glue settingDash an example of WEB</td></tr><tr><td>Knuth:TB31-2-121</td><td>An Earthshaking Announcement</td></tr><tr><td>Knuth:TB4-2-64</td><td>A note on hyphenation</td></tr><tr><td>Knuth:TB5-1-4</td><td>TEX incunabula</td></tr><tr><td>Knuth:TB5-1-67</td><td>Comments on quality in publishing</td></tr><tr><td>Knuth:TB5-2-105</td><td>A course on MF programming</td></tr><tr><td>Knuth:TB6-1-36</td><td>Recipes and fractions</td></tr><tr><td>Knuth:TB7-2-101</td><td>The TEX logo in various fonts</td></tr><tr><td>Knuth:TB7-2-95</td><td>Remarks to celebrate the publication of Computers & Typesetting</td></tr><tr><td>Knuth:TB8-1-14</td><td>Mixing right-to-left texts with left-to-right texts</td></tr><tr><td>Knuth:TB8-1-6</td><td>It happened: announcement of TEX 2.group(1))</td></tr><tr><td>Knuth:TB8-1-73</td><td>Problem for a Saturday afternoon</td></tr><tr><td>Knuth:TB8-2-135</td><td>Fonts for digital halftones</td></tr><tr><td>Knuth:TB8-2-210</td><td>Saturday morning problemDash solution</td></tr>else<tr><td>Knuth:TB8-2-217</td><td>Reply: Printing out selected pages</td></tr> print ('#1 no match')<tr><td>Knuth:TB8-3-309</td><td>Macros for Jill</td></tr>end<tr><td>Knuth:TB9-2-152</td><td>A Punk Meta-Font</td></tr>}}</table>
<p></p>A more extensive example is the following. Of course this assumes that you know what <span tag="MKIV" style="font-style:sans;">xml</span> support mechanisms and macros are available. <pre style="color:rgb(102,0,102);font-size:100%">\defstartxmlsetups btx:getkeys \TestBxmladdsortentry{btx}{#1}{%\directlua1xmlfilter{#1}{%require(/field[@name='pythonauthor')re = python.import]/text("re")}}pattern \xmladdsortentry{btx}{#1}{\xmlfilter{#1}{/field[@name= re.compile(".*'year' ]/text(TeX).*")}}match = pattern.match(" \xmladdsortentry{btx}{#1}{\xmlatt{#1")}{tag}}\stopxmlsetupsif match\startxmlsetups btx:sorterthen \xmlresetsorter{btx} print( 'match.group% \xmlfilter{#1}{entry/command(btx:getkeys)} \xmlfilter{#1)}{ /bibtex /entry[@category='article'] /field[@name==>'author' and find(text(),match'Knuth')] /..group/command(1)btx:getkeys)} \xmlsortentries{btx} \starttabulate[||||] \xmlflushsorter{btx}{btx:entry:flush} \stoptabulate\stopxmlsetupselse\startxmlsetups btx:entry:flush \NC \xmlfilter{#1}{/field[@name='year' print ]/context(')} \NC \xmlatt{#1}{tag} \NC \xmlfilter{#1 no match}{/field[@name='author']/context()}end \NC \NR\stopxmlsetups\xmlsetup{btx:tugboat}{btx:sorter}</pre> <table><tr><td>1984</td><td>Knuth:TB5-1-67</td><td>Don Knuth</td></tr><tr><td>1984</td><td>Knuth:TB5-1-4</td><td>Donald E. Knuth</td></tr><tr><td>1984</td><td>Knuth:TB5-2-105</td><td>Donald E. Knuth</td></tr><tr><td>1985</td><td>Knuth:TB6-1-36</td><td>Donald E. Knuth</td></tr><tr><td>1986</td><td>Knuth:TB7-2-101</td><td>Donald E. Knuth</td></tr><tr><td>1987</td><td>Knuth:TB8-2-135</td><td>Donald E. Knuth</td></tr><tr><td>1987</td><td>Knuth:TB8-3-309</td><td>Donald E. Knuth</td></tr><tr><td>1988</td><td>Knuth:TB9-2-152</td><td>Donald E. Knuth</td></tr><tr><td>1989</td><td>Knuth:TB10-3-325</td><td>Donald E. Knuth</td></tr><tr><td>1989</td><td>Knuth:TB10-4-529</td><td>Donald E. Knuth</td></tr><tr><td>1990</td><td>Knuth:TB11-4-489</td><td>Donald E. Knuth</td></tr><tr><td>1993</td><td>Knuth:TB14-4-387</td><td>Donald E. Knuth</td></tr><tr><td>1996</td><td>Knuth:TB17-1-29</td><td>Donald E. Knuth</td></tr><tr><td>1987</td><td>Knuth:TB8-1-14</td><td>Donald Knuth and Pierre MacKay</td></tr><tr><td>1981</td><td>Knuth:TB2-3-5</td><td>Donald Knuth</td></tr><tr><td>1982</td><td>Knuth:TB3-1-10</td><td>Donald Knuth</td></tr><tr><td>1983</td><td>Knuth:TB4-2-64</td><td>Donald Knuth</td></tr><tr><td>1986</td><td>Knuth:TB7-2-95</td><td>Donald Knuth</td></tr><tr><td>1987</td><td>Knuth:TB8-1-6</td><td>Donald Knuth</td></tr><tr><td>1987</td><td>Knuth:TB8-1-73</td><td>Donald Knuth</td></tr><tr><td>1987</td><td>Knuth:TB8-2-210</td><td>Donald Knuth</td></tr><tr><td>1987</td><td>Knuth:TB8-2-217</td><td>Donald Knuth</td></tr><tr><td>1989</td><td>Knuth:TB10-1-8</td><td>Donald Knuth</td></tr><tr><td>1989</td><td>Knuth:TB10-1-31</td><td>Donald Knuth</td></tr><tr><td>1990</td><td>Knuth:TB11-1-13</td><td>Donald Knuth</td></tr><tr><td>1990</td><td>Knuth:TB11-2-165</td><td>Donald Knuth</td></tr><tr><td>1990</td><td>Knuth:TB11-4-497</td><td>Donald Knuth</td></tr><tr><td>1990</td><td>Knuth:TB11-4-499</td><td>Donald Knuth</td></tr><tr><td>1991</td><td>Knuth:TB12-2-313</td><td>Donald Knuth</td></tr><tr><td>2010</td><td>Knuth:TB31-2-121</td><td>Donald Knuth</td></tr></table>
Although the <span tag="MKIV" style="font-style:sans;">bibTEX</span> format is reasonably well defined, in practice there are many ways to organize the data. For instance, one can use predefined string constants that get used (either or not combined with other strings) later on. A string can be enclosed in curly braces or double quotes. The strings can contain <span tag="MKIV" style="font-style:sans;">TEX</span> commands but these are not standardized. The databases often have somewhat complex ways to deal with special characters and the use of braces in their definition is also not normalized.
<p></p>
The most complex to deal with are the fields that contain names of people. At some point it might be needed to split a combination of names into individual ones that then get split into title, first name, optional inbetweens, surname(s) and additional: <tt style="color:rgb(0,102,102);font-size:100%;" >Prof. Dr. Alfred B. C. von Kwik Kwak Jr. II and P. Q. Olet</tt> is just one example of this. The convention seems to be not to use commas but <tt style="color:rgb(0,102,102);font-size:100%;" >and</tt> to separate names (often each name will be specified as lastname, firstname).
<p></p>
We don’t see it as challenge nor as a duty to support all kinds of messy definitions. Of course we try to be somewhat tolerant, but you will be sure to get better results if you use nicely setup, consistent databases.
<p></p>
Todo: maybe some examples of bad.
<h1>Transition</h1>
In the original bibliography support module usage was as follows (example taken from the contextgarden wiki):
<pre style="color:rgb(102,0,102);font-size:100%">% engine=pdftex
\usemodule[bib]
\usemodule[bibltx]
\setupbibtex
[database=xampl]
\setuppublications
[numbering=yes]
\starttext
As \cite [article-full] already indicated, bibtex is a \LATEX||centric
program.
\completepublications
\stoptext
</pre>
<p></p>
For <span tag="MKIV" style="font-style:sans;">MkIV</span> the modules were partly rewritten and ended up in the core so the two commands were no longer needed. The overhead associated with the automatic loading of the bibliography macros can be neglected these days, so standardized modules such as <tt style="color:rgb(0,102,102);font-size:100%;" >bib</tt> are all being moved to the core and do not need to be explicitly loaded.
<p></p>
The first <tt style="color:rgb(0,102,102);font-size:100%;" >\setupbibtex</tt> command in this example is needed to bootstrap the process: it tells what database has to be processed by <span tag="MKIV" style="font-style:sans;">bibTEX</span> between runs. The second <tt style="color:rgb(0,102,102);font-size:100%;" >\setuppublications</tt> command is optional. Each citation (tagged with <tt style="color:rgb(0,102,102);font-size:100%;" >\cite</tt>) ends up in the list of publications.
<p></p>
In the new approach we no longer use <span tag="MKIV" style="font-style:sans;">bibTEX</span>so we don’t need to setup <span tag="MKIV" style="font-style:sans;">bibTEX</span>. Instead we define dataset(s). We also no longer set up publications with one command, but have split that up in rendering-, list-, and cite-variants. The basic <tt style="color:rgb(0,102,102);font-size:100%;" >\cite</tt> command remains. The above example becomes:
<pre style="color:rgb(102,0,102);font-size:100%">\definebtxdataset
[document]
\usebtxdataset
[document]
[mybibfile.bib]
\definebtxrendering
[document]
\setupbtxrendering
[document]
[numbering=yes]
\starttext
As \cite [article-full] already indicated, bibtex is a \LATEX||centric program. \TestDcompletebtxrendering[document]
\stoptext
</pre>
<p></p>
So, we have a few more commands to set up things. If you intend to use just a single dataset and rendering, the above preamble can be simplified to:
<pre style="color:rgb(102,0,102);font-size:100%">\usebtxdataset
[mybibfile.bib]
\setupbtxrendering
[numbering=yes]
</pre>
<p></p>
But keep in mind that compared to the old <span tag="MKIV" style="font-style:sans;">MkII</span> derived method we have moved some of the options to the rendering, list and cite setup variants.
<p></p>
Another difference is now the use of lists. When you define a rendering, you also define a list. However, all entries are collected in a common list tagged <tt style="color:rgb(0,102,102);font-size:100%;" >btx</tt>. Although you will normally configure a rendering you can still set some properties of lists, but in that case you need to prefix the list identifier. In the case of the above example this is <tt style="color:rgb(0,102,102);font-size:100%;" >btx:document</tt>.
<h1>MLBIBTEX</h1>
Todo: how to plug in <span tag="MKIV" style="font-style:sans;">MLbibTEX</span> for sorting and other advanced operations.
<h1>Extensions</h1>
As <span tag="MKIV" style="font-style:sans;">TEX</span> and <span tag="MKIV" style="font-style:sans;">Lua</span> are both open and accessible in <span tag="MKIV" style="font-style:sans;">ConTEXt</span> it is possible to extend the functionality of the bibliography related code. For instance, you can add extra loaders.
<pre style="color:rgb(102,0,102);font-size:100%">function publications.loaders.myformat(dataset,filename)
local t = { }
-- Load data from 'filename' and convert it to a Lua table 't' with
-- the key as hash entry and fields conforming the luadata table
-- format.
loaders.lua(dataset,t)
end
</pre>
<p></p>
This then permits loading a database (into a dataset) with the command:
<pre style="color:rgb(102,0,102);font-size:100%">\usebtxdataset[standard][myfile.myformat]
</pre>
<p></p>
The <tt style="color:rgb(0,102,102);font-size:100%;" >myformat</tt> suffix is recognized automatically. If you want to use another suffix, you can do this:
<pre style="color:rgb(102,0,102);font-size:100%">\usebtxdataset[standard][myformat::myfile.txt]
</pre>
