all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Ihor Radchenko <yantar92@gmail.com>
To: "András Simonyi" <andras.simonyi@gmail.com>
Cc: emacs-orgmode list <emacs-orgmode@gnu.org>
Subject: Re: [PATCH] oc-csl: Add support for sub-bibliographies
Date: Sun, 24 Jul 2022 15:42:08 +0800	[thread overview]
Message-ID: <874jz7dkj3.fsf@localhost> (raw)
In-Reply-To: <CAOWRwxBe+AJaGy-57s44_0vYTUP-_P4=r+mJ2eDZP2NmAUGERQ@mail.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 587 bytes --]

András Simonyi <andras.simonyi@gmail.com> writes:

> Dear Ihor, thanks a lot for your comments, I've attached a new version
> in which I tried to implement your suggestions.

Thanks!

I have made some changes to the patch, mostly fixing grammar issues (the
ones I can notice). I also changed the sub-section from "Bibliography
options" to "Bibliography options in "biblatex" and "csl" export processors"

See the attached.

Reading through the patch, I noticed that :title option is not
documented. Does it mean :title is not supported by csl processor?

Best,
Ihor


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-org-manual.org-Document-PRINT_BIBLIOGRAPHY-optio.patch --]
[-- Type: text/x-patch, Size: 3448 bytes --]

From f0217cc4dafa9dbb2eaa3fd22c1270d34aac109d Mon Sep 17 00:00:00 2001
Message-Id: <f0217cc4dafa9dbb2eaa3fd22c1270d34aac109d.1658648142.git.yantar92@gmail.com>
From: =?UTF-8?q?Andr=C3=A1s=20Simonyi?= <andras.simonyi@gmail.com>
Date: Wed, 20 Jul 2022 23:54:32 +0200
Subject: [PATCH] * doc/org-manual.org: Document "PRINT_BIBLIOGRAPHY" options

---
 doc/org-manual.org | 58 +++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index d5bd9092f..1e08c316b 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -16818,11 +16818,67 @@ ** Citation export processors
 Wolkers-Kluwer publisher; since it relies on the ~bibtex~ processor of
 your LaTeX installation, it won't export to anything but PDF.
 
+** Printing bibliography
+
 The =PRINT_BIBLIOGRAPHY= keyword specifies where the bibliography
-should print.
+should be printed (note the colon):
 
 : #+print_bibliography:
 
+A document may contain more than one =PRINT_BIBLIOGRAPHY= keywords.
+Each of the keywords will trigger printing the bibliography.
+
+The keywords can be used with or without additional options.  Options
+can be used, for example, to print only entries that belong to a
+certain category or to control formatting.  The set of supported
+=PRINT_BIBLIOGRAPHY= options and their interpretation varies between
+the different citation export processors.  Some export processors do
+not support passing options.
+
+*** Bibliography options in "biblatex" and "csl" export processors
+
+The "biblatex" and "csl" export processors support bibliography
+options through a property list attached to the =PRINT_BIBLIOGRAPHY=
+keyword.  For example,
+
+: #+print_bibliography: :type book :keyword algebra
+
+Values including spaces must be surrounded with double quotes.  If you
+need to use a key multiple times, you can separate its values with
+commas, but without any space in-between:
+
+: #+print_bibliography: :keyword algebra,logic :title "Primary Sources"
+
+The "biblatex" export processor accepts all options supported by
+BibLaTeX's ~\printbibliography~ command, while the "csl" processor
+accepts the following ones:
+
+- =:keyword <keyword(,keyword2...)>= :: Print only entries whose
+  keyword field contains all given keywords.
+
+- =:notkeyword <keyword(,keyword2...)>= :: Print only entries whose
+  keyword field does not contain any of the given keywords.
+
+- =:type <entrytype>= :: Print only entries whose type is
+  =<entrytype>=.  Entry type is the BibTeX/BibLaTeX entry type if this
+  information is available (the entry was read from a BibTeX/BibLaTeX
+  bibliography) and the CSL entry type otherwise.
+
+- =:nottype <entrytype(,entrytype2...)>= :: Print only entries whose
+  type is not among the given entry types.  Entry type is determined
+  as in the case of =:type=.
+
+- =:csltype <entrytype>= :: Print only entries whose CSL entry type
+  (possibly based on a conversion from BibTeX/BibLaTeX to CSL) is
+  =<entrytype>=.
+
+- =:notcsltype <entrytype(,entrytype2...)>= :: Print only entries whose
+  CSL entry type (possibly based on a conversion from BibTeX/BibLaTeX
+  to CSL) is not among the listed entry types.
+
+- =:filter <predicate>= :: Print only entries for which the given
+  Emacs Lisp predicate returns a non-~nil~ value.
+
 * Working with Source Code
 :PROPERTIES:
 :DESCRIPTION: Export, evaluate, and tangle code blocks.
-- 
2.35.1


  reply	other threads:[~2022-07-24  7:43 UTC|newest]

Thread overview: 17+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-07-11 22:13 [PATCH] oc-csl: Add support for sub-bibliographies András Simonyi
2022-07-16  8:44 ` Ihor Radchenko
2022-07-20 22:03   ` András Simonyi
2022-07-21  6:06     ` András Simonyi
2022-07-23  4:00       ` Ihor Radchenko
2022-07-23 20:10         ` András Simonyi
2022-07-24  7:42           ` Ihor Radchenko [this message]
2022-07-25 18:18             ` András Simonyi
2022-07-25 18:44               ` Bruce D'Arcus
2022-07-26  6:23                 ` Fraga, Eric
2022-07-26  5:38               ` Ihor Radchenko
2022-07-28 21:36                 ` András Simonyi
2022-07-29  1:33                   ` Ihor Radchenko
2022-07-29 19:51                     ` András Simonyi
2022-07-31  2:33                       ` Ihor Radchenko
2022-08-02 10:53                         ` András Simonyi
2022-07-31  2:28 ` Ihor Radchenko

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=874jz7dkj3.fsf@localhost \
    --to=yantar92@gmail.com \
    --cc=andras.simonyi@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.