[NTG-context] How to isolate serious errors from warnings?
I'm about to have a lengthy (2,000+ page) document published. Normally if it compiles and looks okay, I regard that as meaning no errors appeared, but I've noticed that sometimes ConTeXt will still compile, even if something isn't displayed on screen as it should: (1) I tried placing a table inside a startitemize environment, as instead of it not compiling, it left a message in the document warning that wasn't supported. (2) In another case, I had an image that ConTeXt couldn't find, as I mispelled the filenmame, and it fully compiled and made a PDF, without me noticing. (3) Or maybe in some case, a font couldn't be found for a specific character, so a single character in the file isn't displaying. Those are just some examples; I intended for something to be printed on the PDF, but it isn't showing there. Since a document of this size will have a lot of messages, is there a way to adjust the settings, from "show everything" to "show some" to "show only serious errors"? Or maybe to use > to send the errors to another file for careful study? (using Linux if that matters) --Joel ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
Le 17/04/2024 à 13:57, Bruce Horrocks a écrit : On 14 Apr 2024, at 12:21, garu...@azules.eu wrote: Hi all, I just discover the Diátaxis documentation framework : I'd be more confident if you had started by saying "I've been using the Diátaxis for the last ten years and have used it on multiple projects". ;-) - https://www.diataxis.fr/ - 30min video : "What nobody tells you about documentation", https://www.youtube.com/watch?v=t4vKPhjcMZg , from Daniele Procida at PyCon 2017 As I understand it, it can help both readers and writers of the documentation by clarifying the purpose of each element. So I started a potential new "welcome page" : https://wiki.contextgarden.net/Main_Page2 The main lines would be : - Tutorials: installation pages, step by step examples - How-to guides: most of the existing wiki pages which are not https://wiki.contextgarden.net/Commands/ ... - Discussions and manuals: most of the existing manuals - Reference : the pages dedicated to commands which already include link to mailing list, stack exchange, ConTeXt's source - https://wiki.contextgarden.net/Category:Commands - https://wiki.contextgarden.net/Special:PrefixIndex?prefix=Command%2F To match the logic of Diátaxis, maybe some material from command pages should be moved from "Reference" to "How-to guides", for example, when the examples go beyond "pure description" and begin to deal with "how-to" cases, e.g. : - Reference for setuphead: https://wiki.contextgarden.net/Command/setuphead - How-to guides for headings: https://wiki.contextgarden.net/Titles If it make sense, and according to your feedbacks, I can continue to reallocate existing contents. Thanks for your feedback and thoughts. I'm going to be devil's advocate and say that the Context documentation is *already* in the Diátaxis framework - just not in one place on the Wiki. - There are at least two books, and a third being written but not yet released: these fit into the Tutorials and Explanation quadrants. - There are "My Way" guides linked from the Wiki and the PragmaADE website that fit into the "How-To Guides" quadrant. - thank you for these reminders - And the wiki itself is the "Reference" quadrant. Clearly these can always be better but they are there already. My recommendation would be to use the wiki as the reference quadrant and, apart from the first few "main pages" for people who land there from a web search, it should focus on being the reference manual. Beginners should be directed to the books. - Thanks again, the comments are helping to identify a robust method of distributing content across the quadrants. - exactly, it's not a question of proposing new documents, but of proposing another complementary way of accessing and browsing existing ones. - Actually, the wiki is (or can be) a hub for the 4 needs: - "Reference" like https://wiki.contextgarden.net/Command/setuphead - "How-To Guides" like https://wiki.contextgarden.net/Titles - "Tutorials": - hosted https://wiki.contextgarden.net/Detailed_Example - linked https://github.com/mpsmath/stepbystep - "Explanation" : mostly linked manuals and books https://wiki.contextgarden.net/Command/setuphead and https://wiki.contextgarden.net/Titles are examples of how difficult it can be to understand where to find a particular information. It might be worth keeping only the key examples on reference pages like https://wiki.contextgarden.net/Command/*** and moving the "how-to" examples to a separate page (or pages). Regards, — Bruce Horrocks Hampshire, UK ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___ ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Customize citation format of a bibliography (use the short form as reference format)
Hi, > The APS style is an example of a number-based citation system. As you > are looking for a tag-based citation, it might be better to start with > something like the APA style. I'm kind of satisfied with the publication-list layout of the APS style so I chose this as a base. If it is simpler to start with the APA style, I can do that. My hope is that it is possible to just change the "label" that is used for referencing and keep everything else as is. > Is there some specification for your short tag-based citation style? biblatex implements this with the "alphabetic" style. I'm not aware of a specification, though. Does the "short" form in ConTeXt exist for a specific reason? :) Gerion > On Tue, 16 Apr 2024 06:04:35 +0200 > Gerion Entrup wrote: > > > Hi, > > > > I'm trying to customize a cite format in a bibliography. Currently, > > I'm using the aps style which fits so far, except of the plain number > > as reference. In concrete, I want to change the following: > > - Use the first letter of the last name and the year as reference > > (this should be exactly the short form). It is more less also > > described here [1]. > > - Highlight publications of a certain author with an extra char (e.g. > > '>') > > > > Here is a minimal example (lets assume, every occurrence of Knuth > > should be highlighted): ``` > > \setupinteraction[state=start] > > > > \startbuffer[testdata] > > @Book{knuth1, > > author = {Donald E. Knuth}, > > title = {TEX and METAFONT. New directions in typesetting}, > > year = {1979}, > > publisher = {Addison-Wesley}, > > } > > @Article{someother, > > author = {Some Person and Some Otherperson}, > > title = {Another title}, > > year = {1900}, > > } > > \stopbuffer > > > > % enable tracing > > \enabletrackers[publications, publications.crossref, > > publications.details, publications.cite, publications.strings] > > > > \usebtxdataset[main][testdata.buffer] > > \usebtxdefinitions[aps] > > \setupbtx[dataset=main] > > \definebtxrendering[bibrendering][aps][dataset=main] > > > > % this seems to have no effect? > > \setupbtx[alternative=short] > > > > \starttext > > > > Knuth developed \TeX \cite[knuth1]. > > Several persons said something \cite[someother]. > > > > \placelistofpublications[bibrendering] > > > > \stoptext > > ``` > > > > It should be rendered as: > > ``` > > Knuth developed TeX [>Knu79]. > > Several persons said something [PO00]. > > > > [Knu79] D.E. Knuth, TEX and METAFONT. New directions in > > typesetting (Addison-Wesley, 1979). [PO00] S. Person and S. > > Otherperson, Another title, (1900). ``` > > > > How can I achieve that \cite[something] always renders in the short > > form by default? How can I customize that references to Knuth contain > > this extra '>'? How can I customize the APS style to also use the > > short form in the list of publications instead of numbers? > > > > Best > > Gerion > > > > [1] > > https://tex.stackexchange.com/questions/295444/citation-style-with-first-letters-of-authors-lastname signature.asc Description: This is a digitally signed message part. ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Customize citation format of a bibliography (use the short form as reference format)
Hello, The APS style is an example of a number-based citation system. As you are looking for a tag-based citation, it might be better to start with something like the APA style. Is there some specification for your short tag-based citation style? Alan On Tue, 16 Apr 2024 06:04:35 +0200 Gerion Entrup wrote: > Hi, > > I'm trying to customize a cite format in a bibliography. Currently, > I'm using the aps style which fits so far, except of the plain number > as reference. In concrete, I want to change the following: > - Use the first letter of the last name and the year as reference > (this should be exactly the short form). It is more less also > described here [1]. > - Highlight publications of a certain author with an extra char (e.g. > '>') > > Here is a minimal example (lets assume, every occurrence of Knuth > should be highlighted): ``` > \setupinteraction[state=start] > > \startbuffer[testdata] > @Book{knuth1, > author = {Donald E. Knuth}, > title = {TEX and METAFONT. New directions in typesetting}, > year = {1979}, > publisher = {Addison-Wesley}, > } > @Article{someother, > author = {Some Person and Some Otherperson}, > title = {Another title}, > year = {1900}, > } > \stopbuffer > > % enable tracing > \enabletrackers[publications, publications.crossref, > publications.details, publications.cite, publications.strings] > > \usebtxdataset[main][testdata.buffer] > \usebtxdefinitions[aps] > \setupbtx[dataset=main] > \definebtxrendering[bibrendering][aps][dataset=main] > > % this seems to have no effect? > \setupbtx[alternative=short] > > \starttext > > Knuth developed \TeX \cite[knuth1]. > Several persons said something \cite[someother]. > > \placelistofpublications[bibrendering] > > \stoptext > ``` > > It should be rendered as: > ``` > Knuth developed TeX [>Knu79]. > Several persons said something [PO00]. > > [Knu79] D.E. Knuth, TEX and METAFONT. New directions in > typesetting (Addison-Wesley, 1979). [PO00] S. Person and S. > Otherperson, Another title, (1900). ``` > > How can I achieve that \cite[something] always renders in the short > form by default? How can I customize that references to Knuth contain > this extra '>'? How can I customize the APS style to also use the > short form in the list of publications instead of numbers? > > Best > Gerion > > [1] > https://tex.stackexchange.com/questions/295444/citation-style-with-first-letters-of-authors-lastname -- Alan Braslau 816 West Mountain Avenue Fort Collins, CO 80521 USA mobile: (970) 237-0957 Conserve energy! ;-) ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
Am 17.04.24 um 13:57 schrieb Bruce Horrocks: - There are at least two books, and a third being written but not yet released: these fit into the Tutorials and Explanation quadrants. Which published books do you mean? I know of Alan Braslau’s book, AFAIK that will be published in French “soon” and probably later in English. My German book is still not ready, while I work on it regularly. Of course there are a lot of PDFs (most with sources), not only in the distribution, but also in https://github.com/contextgarden/not-so-short-introduction-to-context Hraban ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
> On 14 Apr 2024, at 12:21, garu...@azules.eu wrote: > > Hi all, > > I just discover the Diátaxis documentation framework : I'd be more confident if you had started by saying "I've been using the Diátaxis for the last ten years and have used it on multiple projects". ;-) > - https://www.diataxis.fr/ > - 30min video : "What nobody tells you about documentation", > https://www.youtube.com/watch?v=t4vKPhjcMZg , from Daniele Procida at PyCon > 2017 > > As I understand it, it can help both readers and writers of the documentation > by clarifying the purpose of each element. > > So I started a potential new "welcome page" : > https://wiki.contextgarden.net/Main_Page2 > > The main lines would be : > - Tutorials: installation pages, step by step examples > - How-to guides: most of the existing wiki pages which are not > https://wiki.contextgarden.net/Commands/ ... > - Discussions and manuals: most of the existing manuals > - Reference : the pages dedicated to commands which already include link to > mailing list, stack exchange, ConTeXt's source > - https://wiki.contextgarden.net/Category:Commands > - https://wiki.contextgarden.net/Special:PrefixIndex?prefix=Command%2F > > To match the logic of Diátaxis, maybe some material from command pages should > be moved from "Reference" to "How-to guides", > for example, when the examples go beyond "pure description" and begin to deal > with "how-to" cases, e.g. : > - Reference for setuphead: https://wiki.contextgarden.net/Command/setuphead > - How-to guides for headings: https://wiki.contextgarden.net/Titles > > If it make sense, and according to your feedbacks, I can continue to > reallocate existing contents. > > Thanks for your feedback and thoughts. I'm going to be devil's advocate and say that the Context documentation is *already* in the Diátaxis framework - just not in one place on the Wiki. - There are at least two books, and a third being written but not yet released: these fit into the Tutorials and Explanation quadrants. - There are "My Way" guides linked from the Wiki and the PragmaADE website that fit into the "How-To Guides" quadrant. - And the wiki itself is the "Reference" quadrant. Clearly these can always be better but they are there already. My recommendation would be to use the wiki as the reference quadrant and, apart from the first few "main pages" for people who land there from a web search, it should focus on being the reference manual. Beginners should be directed to the books. Regards, — Bruce Horrocks Hampshire, UK ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
Unfortunately, despite all that has been said, we have to realise what words actually mean in English, and 'infamous' has a negative connotation. So I recommend rephrasing this and perhaps the entire paragraph so that it presents a positive perspective on ConTeXt. But if you mean 'less known' then simply say that: ConTeXt is the less known alternative to LaTeX. and rather than 'growing minority', say 'growing number'. We do not say 'ambitioned enthusiasts' in English, but we could say 'ambitious enthusiasts'. Julian On 17/4/24 19:10, Joaquín Ataz López wrote: I used “infamous” as a funny way to say “not famous, but somewhat known” (and yes, I know Latin and what the words really mean). That was my understanding. Infamous=Not famous; that is, not as well known as others. A slight play on words. ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
I used “infamous” as a funny way to say “not famous, but somewhat known” (and yes, I know Latin and what the words really mean). That was my understanding. Infamous=Not famous; that is, not as well known as others. A slight play on words. -- Joaquín Ataz López Departamento de Derecho civil Universidad de Murcia - España ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
Am 17.04.24 um 10:36 schrieb Hans Hagen: On 4/17/2024 8:32 AM, Thomas A. Schmitz wrote: On 16. Apr 2024, at 21:56, Peter Hopcroft via ntg-context wrote: On 17/04/2024, at 7:11 AM, Henning Hraban Ramm wrote: In my poster (still WIP) I wrote: … Excellent No, I must admit I don’t like the first two paragraphs. The question is “what is ConTeXt,” and the answer is “we’re not LaTeX.” And why “infamous”? I agree. It sounds the same as "we're not msword" or "we're not google docs". (In the end the only thing that latex and context have in common is that they use the tex language / ecosystem.) In my experience, most people interested in ConTeXt know LaTeX, so it makes sense to compare. And I actually just say “LaTeX is the most known command-based typesetting system” (that’s just true) to shortcut explaining what a cbts might be. Your critique applies to JUH’s quote, though. I used “infamous” as a funny way to say “not famous, but somewhat known” (and yes, I know Latin and what the words really mean). Hraban ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
On 4/17/2024 8:32 AM, Thomas A. Schmitz wrote: On 16. Apr 2024, at 21:56, Peter Hopcroft via ntg-context wrote: On 17/04/2024, at 7:11 AM, Henning Hraban Ramm wrote: In my poster (still WIP) I wrote: … Excellent No, I must admit I don’t like the first two paragraphs. The question is “what is ConTeXt,” and the answer is “we’re not LaTeX.” And why “infamous”? I agree. It sounds the same as "we're not msword" or "we're not google docs". (In the end the only thing that latex and context have in common is that they use the tex language / ecosystem.) Hans - Hans Hagen | PRAGMA ADE Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: 038 477 53 69 | www.pragma-ade.nl | 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 / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___
[NTG-context] Re: Wiki - test/proposal to further clarify documentation
> On 16. Apr 2024, at 21:56, Peter Hopcroft via ntg-context > wrote: > > > >> On 17/04/2024, at 7:11 AM, Henning Hraban Ramm wrote: >> >> In my poster (still WIP) I wrote: >> … > > Excellent No, I must admit I don’t like the first two paragraphs. The question is “what is ConTeXt,” and the answer is “we’re not LaTeX.” And why “infamous”? Thomas ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror) archive : https://github.com/contextgarden/context wiki : https://wiki.contextgarden.net ___