diff options
author | Karl Berry <karl@freefriends.org> | 2007-04-11 23:09:15 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2007-04-11 23:09:15 +0000 |
commit | 7410502d1d3c16f11d788b7d082770e45b421b12 (patch) | |
tree | 66a4a2503b15635b27b00bf8c4868c38c2069a5e /Master/texmf-dist/doc/bibtex/abstyles/README | |
parent | 6858df01ea6ebb32f4be0f68e4b2e03d8713f38f (diff) |
abstyles fix/update (Juan Torrens mail to mactex-support, 9 Apr 2007 15:42:42)
git-svn-id: svn://tug.org/texlive/trunk@4150 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/abstyles/README')
-rw-r--r-- | Master/texmf-dist/doc/bibtex/abstyles/README | 140 |
1 files changed, 140 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/bibtex/abstyles/README b/Master/texmf-dist/doc/bibtex/abstyles/README new file mode 100644 index 00000000000..fdaf3133569 --- /dev/null +++ b/Master/texmf-dist/doc/bibtex/abstyles/README @@ -0,0 +1,140 @@ + -*-Text-*- +This is the BibTeX `adaptable' family of style files, version 1.10 as of +April 1992, derived from the `plain' family by Hans-Hermann Bode. It allows +setting of certain style parameters and definition of phrases without +changing the style files, thus a multiple-language support is provided and +the user may adapt the bibliography layout to his or her requirements within +some limits. + +Send suggestions and bug reports to HHBODE@DOSUNI1.BITNET. + +This directory contains the following files: + +./README this file +./btxabst.doc master file for creating the bst files +./aplain.bst adaptable style, `plain' version +./aabbrv.bst adaptable style, `abbreviated' version +./aunsrt.bst adaptable style, `unsorted' version +./aalpha.bst adaptable style, `alphanumeric' version +./anotit.bst adaptable style, `no titles' version +./aunsnot.bst adaptable style, `unsorted/no titles' version +./apreambl.doc preamble file, documentation +./apreambl.tex preamble file, to be input at the beginning of the bibliography +./jourabbr.bib journal names, abbreviated version +./jourfull.bib journal names, full version +./acompat.bib compatibility definitions for use with standard styles +./abstdok.tex documentation of the adaptable family (in German) +./abstdok.bbl bibliography for abstdok +./a4c.sty definition of length parameters for DIN-A4 paper, LaTeX version +./a4c.tex definition of length parameters for DIN-A4 paper, WEB version +./docmac.doc documentation of documentation macros (indeed!) +./docmac.tex documentation macros + +*** Installation ------------------------------------------------------------- + +To get a working adaptable-styles system you have to copy the following +files into special directories. + +-- Copy all *.bst files into a directory where BibTeX looks for style files. +This will usually be a directory in the TEXINPUT(S) path, i.e., in the same +path where TeX looks for its input files. + +-- Copy apreambl.tex into a directory where TeX looks for its input files, +see above. + +-- Copy all *.bib files into a directory where BibTeX looks for bibliography +databases. This will usually be a directory in the BIBINPUT(S) path. + +Optionally, you may copy a4c.* and docmac.tex into a directory in the +TEXINPUT(S) path. These files will be needed when printing the +documentation; they may be useful, however, for other applications as well. + +*** Printing the documentation ----------------------------------------------- + +The main documentation is a LaTeX source in abstdok.tex. Run LaTeX on this +file twice (for resolving cross references) and make sure that apreambl.tex, +abstdok.bbl, and a4c.sty can be loaded. In addition, the file german.sty is +required; it is not included in this distribution, since you should be able +to get it from every good TeX server (at least in Germany). The style file +a4c.sty will set up length parameters so that the document will come out +centered with margins of 2 cm on each side of a DIN-A4 sheet; if this +doesn't fit to your paper format, you may want to edit this file first. +Unfortunately, this documentation is written in German (which is due to the +fact that European people sometimes get nostalgic and switch to their native +language); if you feel the need to translate this into English, don't +hesitate to do so (and send me the file, so I can include it into the next +distribution). + +The definition of the adaptable parameters is discussed in apreambl.doc (in +English, yes). Run this through TeX (not LaTeX, and don't forget the .doc +extension!) and make sure that a4c.tex and docmac.tex can be loaded. The +file a4c.tex corresponds to a4c.sty above, and docmac.tex contains macros +for typesetting a WEB-style documentation. In fact, apreambl.tex is derived +from apreambl.doc by means of Joachim Schrod's MAKEPROG system, which is a +general documentation tool much similar to the WEB system of structured +documentation; docmac.tex is an enhancement of MAKEPROG's macro package +progdoc.tex which makes the documentation layout more ``WEB-like''. If you +want to change some of the adaptable parameters, the best way to do it is to +get MAKEPROG (it should be available from the same source as the adaptable +style files) and write a changefile to apreambl.doc. Then there is a good +chance that you can apply your changes to future versions of this +distribution without major modifications. Moreover, you can use MAKEPROG and +docmac.tex for your own developments, it's worth a try! (In this case you may +want to look at docmac's documentation: just run TeX on docmac.doc and make +sure that docmac.tex is loadable.) + +Further documentation is provided in plain-text form in the files +jourabbr.bib, jourfull.bib, and acompat.bib. You may want to edit the first +two of them to add more journal names or other general stuff that should be +defined at the beginning of your bibliographies. + +*** Usage hints (VERY brief) ------------------------------------------------- + +It is assumed that you are familiar with the BibTeX philosophy and the +standard style files, so here is a short description what you have to do in +addition to use the adaptable styles. + +Choose one of the styles aplain, aabbrv, aunsrt, aalpha, anotit, or aunsnot +(the first four are the adaptable versions of the corresponding standard +styles, anotit is like aabbrv but omits titles of articles and some other +redundant information, aunsnot is like anotit but doesn't sort the +bibliography) and put a statement like + + \bibliographystyle{aplain} + +somewhere into your document. + +Make sure that apreambl.tex is input before the \bibliography command is +executed. The easiest way to do so is to include jourfull or jourabbr at the +beginning of your \bibliography list. The file apreambl.tex carries out all +parameter settings and switches between `full' and `abbreviated' as well as +English and German versions of phrases automatically. The version it selects +depends on the bibliography style and on the fact whether german.sty is +loaded or not. The databases jourfull.bib and jourabbr.bib will load +apreambl.tex and, furthermore, will define all strings that are lacking in +the adaptable styles in comparison with the standard styles; hence, with +this files you can use your old databases without changes, and---as +mentioned above---this is the right place to add your own general +definitions. So, a typical \bibliography command should look like + + \bibliography{jourfull,user1,user2,user3} + +where user1, user2, and user3 are your private bibliography databases. + +If you ever feel the need to use one of the standard styles again, your +databases---due to the use of special features of the adaptable styles---may +not be compatible any more. The compatibility can be restored by means of +acompat.bib, which defines all additional strings of the adaptable styles +and should be included at the very beginning of the \bibliography list, e.g., + + \bibliography{acompat,jourfull,user1,user2,user3}\bibliographystyle{plain} + +Of course, acompat is not required for use with the adaptable styles alone. + +*** Correction --------------------------------------------------------------- + +In parts of the documentation, the files apreambl.doc and apreambl.tex are +referred to as apreamble.doc and apreamble.tex. The names were shortened to +avoid difficulties with some operating systems with low-length file names. + + --H2B |