[NTG-context] Re: Wiki - test/proposal to further clarify documentation
> On 17/04/2024, at 7:11 AM, Henning Hraban Ramm wrote: > > In my poster (still WIP) I wrote: > … Excellent ___ 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
It would be great if the main page actually said what Context does. > On 15/04/2024, at 2:18 AM, Henning Hraban Ramm wrote: > > Hi Garulfo, > > I’m not against the “new order”, but I’d keep the colorful subject tiles. > Different accesses are good IMO (as long as it doesn’t get to convoluted). > > I’d say updating, sorting, restructuring pages is more important than a new > start page. > > Yes, please sort out reference vs. tutorials! > > Often examples make sense in the reference pages, so the distinction is a bit > fuzzy, but there are enough where a subject/tutorial page would make more > sense than examples spread over several single command pages. > > We could also define if the “main” reference page (with examples) is > \definestuff, \setupstuff, or \stuff – IMO \setupstuff makes the most sense, > since usually the others inherit from it. > > Often enough, parameters aren’t explained in the reference pages; sometimes > you can find examples using them, but there are too many holes. I tried to > fix that where I could, but too often I don’t understand enough of the > sources to make sense of some setting. > > For wiki contributors, it might make sense to combine the markup pages – in > many pages e.g. is used where would make more > sense; often \starttext … \stoptext is not necessary and just blows up > examples; markup is generally somewhat chaotic (e.g. , , or ``?). > > Hraban > >> Am 14.04.24 um 13:21 schrieb garu...@azules.eu: >> I just discover the Diátaxis documentation framework : >> - 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. >> Garulfo >> ___ >> 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 > ___ ___ 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: An announcement of my new book.
Thank you Sir Coleman. I’m a Context beginner and I’d love a good book introducing me to Context. I’ve wasted many hours trying to figure out how to do things that turned out to be simple. The answer is often/sometimes buried in the documentation, and what would really help me is a book that is more of an index to the existing documentation that is not out of date, with perhaps some simple examples. One case that comes to mind is to pass a couple of numbers to Lua, have it do a calculation and use the result in Context. Regards, Peter > On 14/02/2024, at 9:03 AM, Sir Coleman via ntg-context > wrote: > > Acknowledged. > > However, this does reinforce my point, that the documentation needs to be > updated. The examples on the wiki still use \getcounter, and naturally they > all fail to compile. Hence, my ambition to create a book to serve as the > documentation, which I find is a better medium for communication rather than > wikis. > > Now, as to my question, to understand the low level TeX programming language, > will the manuals "Low Level TeX" be enough? > > Thanks. > ___ > 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 ___
Re: [NTG-context] Float control
Yes, me too. I found the best thing is to post on LaTeX stack exchange a short piece of context that shows one problem you are having. Tag it #context. Someone will kindly help. Repeat for your other problems. I use layers a lot to avoid floats. Good luck, Peter > On 28/02/2023, at 11:47 PM, Denis Maier via ntg-context > wrote: > > > 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 > ___ > If your question is of interest to others as well, please add an entry to the > Wiki! > > maillist : ntg-context@ntg.nl / > https://www.ntg.nl/mailman/listinfo/ntg-context > webpage : https://www.pragma-ade.nl / http://context.aanhet.net > archive : https://bitbucket.org/phg/context-mirror/commits/ > wiki : https://contextgarden.net > ___ ___ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / https://www.ntg.nl/mailman/listinfo/ntg-context webpage : https://www.pragma-ade.nl / http://context.aanhet.net archive : https://bitbucket.org/phg/context-mirror/commits/ wiki : https://contextgarden.net ___