Bibframe: Version: see file 'version'
Last edited: Wed Oct 30 01:00:40 1991 by tompe@diag7 (Tommy Persson)
This is the README file for the BibFrame-system written by
Tommy Persson, Linkopings University, Sweden, tpe@ida.liu.se.
The system is in the public domain.
Note that I have only tested this system on Sun-machines and the
testing has been rather rudimentary. Personally I do not use FrameMaker
so I am not going to discover obscure bugs myself. Therefore I am
grateful for every notice about bugs or suggested enhancement.
Read the ChangeLog file to see what is changed from the previous
version. I am aware that there are a lot of misspellings and
grammatical errors in the files but you have to live with that. I am
saving the carefully written english to my thesis :-)
The system consists of the following files:
MifRead Example of how to modify the original MifRead
README
ChangeLog
Xbibframe.kbm The keyboardmacros for 2.1X
bibframe.kbm2 The keyboardmacros for 2.0 (2.1 and so on I suppose)
bibframe.kbm3 The keyboardmacros for 3.0
bibframe.tex A beginning to a documentation
suffixlist Example of how to modify the original suffixlist
usebibframe.tex Short description of how to use Bibframe. This document
was written to be used internally at our department.
Modifying_bstfiles A description of how to modify a bst-file so it
produces output required by bibframe.
bin: Contains the shell-scripts and elisp code you need
if you want to use Gnu-Emacs.
alphabibframe.sh
bibframe.sh
bibframeclean.sh
draftbibframe.sh
bibfemacs Script that starts emacs
bibframe.el The elisp code you need for the Gnu-Emacs variant
getrefdir
binwithoutemacs: Contains the shell-scripts you need if you do not want
to use Gnu-Emacs. The two variant is not exactly the
same. They have probably different limitations and
bugs.
alphabibframe.sh
bibf The main shell-script
bibframe.sh
bibframeclean.sh
crvarsedscr
dgetshortcite
draftbibframe.sh
draftcrscvar
fixchar
fixfontinreflist
getbodyffamily
getbodyfontsize
getrefdir
getshortcite
mapabibframe.sh
mapacrscvar
mapacrvarsedscr
mapammlsedscr
mif2aux
mmlsedscr
tex: Contains the BibTeX style files you need
bibframebtxbst.doc
createstyles Creates the alpha, draft and plain files from
bibframebtxbst.doc.
mmlalpha.bst
mmldraft.bst
mmlmapalike.bst
mmlplain.bst
INSTALLATION:
- It must be possible to run shell-scripts from Framemaker. The simplest
way to achieve this is to modify "MifRead" and "suffixlist" according
to the example files. The suffix to be used should be sh.
Note that for version 3.0X it is not possible to import an empty
file. One solution is to use the following:
*.sh) echo "" | $5/txttomif >$2; $*;;
- Place the files mmlplain.bst, mmlalpha.bst and mmldraft.bst in
a place where bibtex finds them.
Follow the following instructions if you want to use elisp instead
of incomprehensible sed-scripts:
- Move the files under bin/ to a suitable bin-directory.
- Change the variable assignments in bibfemacs.
- Change the defvar expressions in the beginning of bibframe.el.
Follow the following instruction if you do not want to use elisp:
- Copy the files under binwithoutemacs/ to a suitable bin-directory
- Change the variable assignment in bibf. The variables bibtexbin and
framebin should be set to the correct path. The setting of framebin
uses $FMHOME so the given definition probably works on most systems.
NOTE: There seem to be a limit to the number of argument a sed comman
can take (196?). This restricts the number of references that can
be used in the document. A possible fix to that could be to use
gsed instead of sed.
USER SETUP:
To use the system the user must set three environment variables or
for two of them use the corresponding user variables in frame instead.
They are
TEXINPUTS Paths to the users files with references. Or maybe
BIBINPUTS should be used. This could be different
on different systems. It is bibtex that uses the
variable. Before bibtex is run the path to the
directory the current file is saved in is added.
Also the value of the user variable bf-refdir is
added to this variable. If BIBINPUTS is used
some changes must be done in bibfemacs or in
bibf.
BIBFRAMEREF A list of files where the reference entries are.
This is the thing you put as argument to
\bibliography in LaTeX.
The file names are separated by comma and should
not have the extension bib. If this variable is
not defined the value of the user variable
bf-reffiles is used instead. If BIBFRAMEREF is
defined and bf-reffiles is defined than the
value of bf-reffiles,$BIBFRAMEREF is used.
BFBIN Path to Bibframes bin-directory. This variable
must be defined.
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.