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@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@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 -----------------------------------------------------------------