April 2006 - dev-context - NTG Mailing Lists

Re: [NTG-context] What about dynamic documentation?
by Taco Hoekwater 20 Jul '06

20 Jul '06

Hi Jérôme, > However, this seems rather far from the pdf manuals and does not really > help a newbie as I am. Definately it could be improved. In IT, almost everything is suboptimal starting the second after it's birth. Perhaps we should continue this discussion on the developers list, dev-context(a)ntg.nl? It is likely we will spend some other mails on this subject, and perhaps it is better not to clutter the general list. Anybody willing to discuss/help out can easily subscribe to that list (even if just for a while). Is that OK? > More precisely: > > 0 - Category search is missing. It is well known that searching by > contents or by command name won't give the proper result if the search > request is not well formed a priori. > Each command should have a list of associated key words, allowing smart > navigation and filtering > For example, the sectionning commands (including toc, headers and so on) > could be gathered in one big category. That could be as simple as allowing users / viewers to attach one or two key words/categories to the current commands, I think. There can be a predefined set of those, and there will not be all that many. It could also easily be backported to the XML data. Patrick? > 1 - The examples oftenly need output to let the user really understand > the effect. > Moreover, the information available in the graphical output is more > obvious thus more efficient. Perhaps the examples could be fed through the Live ConTeXt, just like the wiki examples? > 2 - Missing code template(s) to paste into the source, copy/paste does > noot help when really needed. Of course, I can grab them from > contextgarden but it is there both hidden and not well formatted. I am not sure what you mean. > 3 - The description only concerns the command. > Each key should also have its own description. Yes. > Each predefined value should also have its own description. Also yes. (both have been discussed before but never implemented due to lack of manpower). > Then the user interface can provide a layout a la headerdoc or some kind > of rollup tooltips. > > 4 - The data storage model for a size range seems weird. The range 5pt > ... 12pt is coded with an ordered list of 3 values "5pt" '..." and > "12pt" whereas it means an unordered list of 8 values: "5pt", "6pt", > ..., "12pt". This latter data model obviously turns into a pop up button > with a list of sizes. It is even a bit weirder. "5pt ... 12pt" usually stands for "any font size that is already defined using \definebodyfont". Except on the command itself, of course. There it means: "any font size you wish to define for use in the other commands that use 5pt ... 12pt". I'm smiling as I write this :-) It really should be an abstract type, like "cd:dimension" instead of those three values. > 5 - The command variants might need specials (eg \setupinterlinespace). Yes, the current solution for that command is not very nice. But there are more than a few commands with such variant calling conventions, and it is hard to come up with a nice-looking solution. Suggestions for solutions are welcome. > 6 - Sometimes the acceptable values depend on the context (eg arguments > of \ref), it means that all the relevant information is not static and > the data model should provide some entry points. But at first glance > this is a very advanced feature which cost might be unaffordable. You mean crossover functionality with reftex/auctex style programs? Would be nice to have I assume, but hard to do portably, and not really worth the effort if it cannot be done in a portable manner. (always speaking from my point of view, of course. YMMV) > Finally, it seems that the underlying data model needs more entropy. Thermodynaics says it will probably move in the right direction, once it starts moving ;-) Cheers, Taco

3 8

Re: [dev-context] context-mirror
by Taco Hoekwater 27 Apr '06

27 Apr '06

Hi, I've just created a page for the new release (04/27), http://wiki.contextgarden.net/Context_2006.04.27 but I a bit hesitant to announce it formally. I suspect that the changes in kpse.rb/kpsefast.rb break on Mac OS X. Cheers, Taco

1 0

new release
by Taco Hoekwater 23 Apr '06

23 Apr '06

Hi Hans, I've created http://wiki.contextgarden.net/Context_2006.04.22 but not all of it makes sense to me, this time. (I've ordered "programming ruby" so hopefully I'll start understanding it better soon) Cheers, taco

3 5

Re: [dev-context] [NTG-context] beta
by Taco Hoekwater 18 Apr '06

18 Apr '06

Hans Hagen wrote: > I uploaded a beta: > > - some TABLE extensions > - a new (read: better) 'renumbering' feature (important when floats move > to top/bottom of pages) > - a small fix to itemize (bug crept in during optimization some time ago) I have not checked into depth, but also: - read ctx files in parent and grandparent directories - lots of file path conversions from win32-style \ to unix-style / in ruby scripts - small code improvement in switch.rb - that math alignment fix with a \vcenter - read (new) core-pgr.tex - core-pos reorganized - an extra \par in core-ntb.tex - a small change in core-sec.tex (todo with section numbers?) - m-streams: \starttextstreamlayer added - m-visual: \simplethesis example added - page-num: \checknumber[page] instead of \checknummer - verb-c.tex added - x-openmath.tex added - figure (resource) library changes Taco

2 1

Updated modules at contextgarden
by Taco Hoekwater 05 Apr '06

05 Apr '06

Hi all, I think I have succeeded in uploading new versions of my modules to contextgarden (thanks to Patrick for the input form and Hans for the distribution/tpm builder). http://modules.contextgarden.net/t-lettrine http://modules.contextgarden.net/bib http://modules.contextgarden.net/urwgothic For that last one I have a question for Patrick: I changed the filename in the edit form (from urwgothic-support to f-urwgothic). That did not change the existing files, just the links, so those became invalid. I expected that, so I added a new release and re-uploaded my zipfile. That worked fine, the new version now has the right filename (cool!). But it also means that there is now a set of "orphan files" on http://dl.contextgarden.net, and I do not know how you want to handle that? We also have serious duplication of information now: the info in the tpm file duplicates the info in modules interface + filesystem. It would perhaps make more sense if one or the other was auto-generated? Cheers, Taco

3 6

modules/mails
by Patrick Gundlach 05 Apr '06

05 Apr '06

Hi, I am currently working on a new modules section on contextgarden. I might finish it tomorrow. Edit and upload will be possible then. And I'll answer some mails tomorrow (many to go...) Patrick -- ConTeXt wiki and more: http://contextgarden.net

2 2

modules setup
by Taco Hoekwater 04 Apr '06

04 Apr '06

Hi all developers, FYI, here is the new t-lettrine.zip, and the tpm.dtd (from texlive). The zip has the structure we discussed over the past few days (I think so, at least). The sizes in the embedded tpm file are estimated, and just a tad higher than the actual sizes. Cheers, Taco Hans Hagen wrote: > Hi, > > In order to be able to generate new zips i'd like the modules in the > wiki to be tds compliant as soon as possible. >

1 0

latest beta (tests needed)
by Taco Hoekwater 03 Apr '06

03 Apr '06

Hi, Hans, you are almost there, afaik. A few notes still: * The new bibliography module. It would be more comfortable if the t-bib was in tex/context/bib like before. It is now in tex/context/third, like in my zipfile, but that is searched later, so I now had to delete the old one manually. And if you want to promote it to core status anyway ... * A small fix to verbatim (color) * The improved version of math substacks. (looks fine) * The xtag-mml patch. * The \dodoregister patch. Duncan, can you check if these last two items are ok now? Taco

3 8