[NTG-context] texdoc in ConTeXt standalone

Hans Hagen j.hagen at xs4all.nl
Thu Apr 5 02:06:31 CEST 2018


On 4/5/2018 1:28 AM, Henri Menke wrote:
> On Thu, 2018-04-05 at 01:18 +0200, Hans Hagen wrote:
>> On 4/5/2018 12:43 AM, Henri Menke wrote:
>>>
>>> Dear list,
>>>
>>> I'm sure you aware of the very useful "texdoc" command line utility in TeX
>>> live
>>> which brings up the PDF documentation for packages.  ConTeXt standalone also
>>> comes with documentation in
>>>
>>>       /opt/context/tex/texmf-context/doc/context
>>>
>>> However, I find it tedious to always search for the correct subfolder to get
>>> to
>>> the document I need.  It would be great if there was something like
>>>
>>>       mtxrun --script doc metafun
>>>
>>> which would open the MetaFun manual.  Similarly "mtxrun --script doc
>>> gnuplot"
>>> would open the manual of the gnuplot module, etc.
>> this is one of these magic features that suddenly is available on your
>> system
>>
>> mtxrun --launch metafun*.pdf
>> mtxrun --launch cld-mkiv.pdf
>> mtxrun --all --launch "*-mkiv.pdf"
> 
> Hm, that requires that I know enough about the name of the document.  A list
> would be quite nice in the sense that I could just type "metafun" and then
> select from "metafun-p.pdf" and "metafun-s.pdf" instead of opening both
> documents.

on my machine opening the lot is fast enough but anyway it's a trivial 
extension, so i've added --list

 >mtxrun --launch --list *-mkiv.pdf
mtxrun          |   1:  charts-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |   2:  cld-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |   3:  colors-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |   4:  epub-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |   5:  fonts-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/fonts
mtxrun          |   6:  languages-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |   7:  libraries-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |   8:  lua-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |   9:  mag-0000-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  10:  mag-0002-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  11:  mag-0006-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  12:  mag-0007-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  13:  mag-0010-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  14:  mag-1101-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  15:  mag-1102-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  16:  mag-1103-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines
mtxrun          |  17:  math-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  18:  rules-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  19:  spacing-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  20:  spreadsheets-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  21:  sql-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  22:  steps-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  23:  swiglib-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  24:  templates-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  25:  tools-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  26:  units-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  27:  workflows-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  28:  xml-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals
mtxrun          |  29:  xtables-mkiv.pdf 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals


[select number]

 >> 4

mtxrun          | launching: 
c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals/epub-mkiv.pdf

>>
>> features like that have always been present in the context suite of
>> programs (i bet even before texdoc) but it might be that i don't call
>> the right thing on todays linux:
>>
>> local launchers={
>>     windows="start %s",
>>     macosx="open %s",
>>     unix="$BROWSER %s &> /dev/null &",
>> }
> 
> I'm quite sure it should be xdg-open (or $PDFVIEWER if it is set and the file is
> PDF) on Linux.  For me $BROWSER is unset.
> https://linux.die.net/man/1/xdg-open
> 
> $ mtxrun --launch metafun*.pdf
> resolvers       | resolving | forcing filetype 'tex'
> resolvers       | resolving | checking wildcard 'metafun*.pdf'
> resolvers       | methods | resolving, method 'concatinators', how 'tag', tag
> 'file'
> resolvers       | methods | resolving, method 'concatinators', how 'tag', tag
> 'file'
> mtxrun          | launching /opt/context/tex/texmf-
> context/doc/context/documents/general/manuals/metafun-p.pdf
> sh: 1: /opt/context/tex/texmf-
> context/doc/context/documents/general/manuals/metafun-p.pdf: Permission denied
> 
>> there's also
>>
>> mtxrun --edit kpse:cld-mkiv.tex
>>
>> we can of course extend this feature with some listing but then i'd
>> rather consult the descriptive files xml but i'm not sure if i
>> distribute them yet
>>
>>>
>>> See attached for my shitty prototype.
>>>
>>> Cheers, Henri
>>>
>>>
>>>
>>> ____________________________________________________________________________
>>> _______
>>> If your question is of interest to others as well, please add an entry to
>>> the Wiki!
>>>
>>> maillist : ntg-context at ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-conte
>>> xt
>>> webpage  : http://www.pragma-ade.nl / http://context.aanhet.net
>>> archive  : https://bitbucket.org/phg/context-mirror/commits/
>>> wiki     : http://contextgarden.net
>>> ____________________________________________________________________________
>>> _______
>>>
>>
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to the Wiki!
> 
> maillist : ntg-context at ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
> webpage  : http://www.pragma-ade.nl / http://context.aanhet.net
> archive  : https://bitbucket.org/phg/context-mirror/commits/
> wiki     : http://contextgarden.net
> ___________________________________________________________________________________
> 


-- 

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
        tel: 038 477 53 69 | www.pragma-ade.nl | www.pragma-pod.nl
-----------------------------------------------------------------


More information about the ntg-context mailing list