[OS X TeX] OT: low-tech bibliographic hyperlinking

[Peter Frings]

On May 3, 2007, at 15:08, Roussanka Loukanova wrote:

> roussankas-computer:/usr/local rosi$ find . -name "*biblatex*" -print
> ./texlive/2007/texmf-doc/doc/english/catalogue/entries/biblatex.html
>
> And then, I copied + pasted
>
> /usr/local/texlive/2007/texmf-doc/doc/english/catalogue/entries/ 
> biblatex.html
>
> the browser's address sub-window: File > Open Location...

or simply use the 'open' command in the command line:
% open ./texlive/2007/texmf-doc/doc/english/catalogue/entries/ 
biblatex.html

To make in independent of the current directory, use '/usr/local'  
instead of '.'. And you don't need the '-print' option, that's the  
default action:
% find /usr/local -name '*biblatex*'

You can combine the two using the back-tick trick:
% open `find /usr/local -name '*biblatex*'`

or use the -exec option, or pipe the result from find (or anything  
else) to 'xargs':
% find /usr/local -name '*biblatex*' | xargs -n 1 open


> Isn't there an easier way to get to the TeX catalogue online  
> straight from the Terminal's command line?

Yes. Use 'texdoc'

% texdoc jurabib
-> opens /usr/local/teTex/share/texmf.tetex/doc/help/Catalogue/ 
entries/jurabib.html

texdoc normally looks into the proper locations, and you can  
configure it a bit with environment variables (e.g. which viewer to  
use).

  % man texdoc
Usage: texdoc [OPTION]... [NAME]...
   Search for NAME in the TeX documentation and start a viewer.

   --help        show this help
   -v            verbose mode: show viewer command
   -l            just list all matching files. Do not start a viewer.
   -s            search the disk. remaining arguments will be passed
                 as egrep patterns to filter the find output.

It work reasonably well if the name of the package and the filename  
of the documentation are equal. If not you may need the '-s' option  
(or use locate and grep):
% texdoc -l beamer
/usr/local/teTex/share/texmf.tetex/doc/help/Catalogue/entries/ 
beamer.html
% locate beamer | grep guide
/usr/local/teTeX/share/texmf.gwtex/doc/latex/beamer/beamerug- 
guidelines.tex
/usr/local/teTeX/share/texmf.gwtex/doc/latex/beamer/beameruserguide.pdf
/usr/local/teTeX/share/texmf.gwtex/doc/latex/beamer/beameruserguide.tex
/usr/local/teTeX/share/texmf.tetex/doc/latex/beamer/beameruserguide.pdf
% texdoc -s beamer | grep guide
/usr/local/teTex/share/texmf.gwtex/doc/latex/beamer/beamerug- 
guidelines.tex
/usr/local/teTex/share/texmf.gwtex/doc/latex/beamer/beameruserguide.pdf
/usr/local/teTex/share/texmf.gwtex/doc/latex/beamer/beameruserguide.tex
/usr/local/teTex/share/texmf.tetex/doc/latex/beamer/beameruserguide.pdf

Or use google :-)

Cheers,
Peter.

------------------------- Helpful Info -------------------------
Mac-TeX Website: http://www.esm.psu.edu/mac-tex/
TeX FAQ: http://www.tex.ac.uk/faq
List Archive: http://tug.org/pipermail/macostex-archives/
List Reminders & Etiquette: http://www.esm.psu.edu/mac-tex/list/