X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=lib%2Fciteengines%2Fbasic.citeengine;h=5bccaf767e56bd2d775759d43d4354d7f0bed941;hb=d4e30ad88f2967a2e464fd3a54a52feeb25e72f1;hp=685e524300d238f12515b5c2fa8899e31550b22d;hpb=bd1b5d580b44089ae239f6c49eb75639aa752627;p=lyx.git

diff --git a/lib/citeengines/basic.citeengine b/lib/citeengines/basic.citeengine
index 685e524300..5bccaf767e 100644
--- a/lib/citeengines/basic.citeengine
+++ b/lib/citeengines/basic.citeengine
@@ -3,52 +3,93 @@
 #   The basic citation capabilities provided by BibTeX.
 #   Mainly simple numeric styles primarily suitable for science and maths.
 # DescriptionEnd
-# Excludes: jurabib | natbib | biblatex
 
 # Author: Julien Rioux <jrioux@lyx.org>
 
-Format 62
+Format 64
 
+# The framework (biblatex|bibtex)
 CiteFramework bibtex
+
+# Cite style variants (default|authoryear|natbib)
+# We provide only default citations
 CiteEngineType default
+
+# Default style file
 DefaultBiblio  plain
 
+#
+# CITE COMMAND DEFINITIONS for either engine type
+#
+# (cf. natbib.citeengine for a decription of the syntax)
+
 CiteEngine default
 	cite[]
 	nocite
+	keyonly
 End
 
+
+#
+# CITE FORMAT
+#
+
+# Input standard format definitions for the bibliography
+Input stdciteformats.inc
+
+# The following defines how the commands are represented in the GUI
+# (inset button and citation dialog) as well as in XHTML, docbook and
+# plain text output.
+#
 CiteFormat default
-	# Translatable bits
+	#
+	# MACROS
+	#
+	# 1. Translatable bits (need to be marked by _ prefix)
+	#    Note that preceding and trailing spaces matter.
+	#
 	_notcited not cited
 	_addtobib Add to bibliography only.
+	_keyonly Key only.
+	_key Key
 
-	# Macros
+	#
+	# 2. Macros re-used in the style definitions
+	#
 	!open [
 	!sep ,
 	!close ]
+	# Modify scheme of the first author in the bibliography
+	!firstnameform %prename% {%prefix%[[%prefix% ]]}%surname%{%suffix%[[, %suffix%]]}
+	# Modify scheme of other authors in the bibliography
+	!othernameform %prename% {%prefix%[[%prefix% ]]}%surname%{%suffix%[[, %suffix%]]}
 
 	# A link that lets us jump to the bibliography entry in LyXHTML
 	# %clean:key% will be substituted by the cite key to give a unique id
 	!startlink {!<a href='#LyXCite-%clean:key%'>!}
 	!endlink {!</a>!}
 
-	# Start citation: ID...
+	# "ID..."
 	!makecite %!startlink%{%label%[[%label%]][[{%numericallabel%[[%numericallabel%]][[#%key%]]}]]}%!endlink%%!nextcite%
 
-	# Follow-up citations: ..., NextID...
+	# "..., NextID..."
 	!nextcite {%next%[[%!sep% %!makecite%]]}
 	# FIXME: what is this?
 	!nexthashkey {%next%[[%!sep% #%key%%!nexthashkey%]]}
-	# Simply the cite key(s): Key, NextKey, ...
+	# "..., NextKey..."
 	!nextkey {%next%[[%!sep% %key%%!nextkey%]]}
 
-	# Postnote: ", p. xx"
+	# ", postnote"
 	!textafter {%textafter%[[, %textafter%]]}
 
-	## The actual cite styles ##
-	# \cite: [ID, NextID, ..., p. xx]
+	#
+	# ACTUAL STYLE DEFINITIONS
+	#
+
+	# "[ID, NextID, ..., p. xx]"
 	cite %!open%{%dialog%[[#ID]][[%!makecite%]]}%!textafter%%!close%
-	# \nocite: "Add to bibliography only." (dialog) / "Key, Nextkey (not cited)" (inset)
+	# "Add to bibliography only." (dialog) / "[ID] (not cited)" (button)
 	nocite {%dialog%[[%_addtobib%]][[%key%%!nextkey% (%_notcited%)]]}
+	# Output only the key
+	keyonly {%dialog%[[%_keyonly%]][[%_key%: %key%%!nextkey%]]}
 End