From f00f7ec63c19c55644cbf98133dfca4d8c10b590 Mon Sep 17 00:00:00 2001 From: William Lupton Date: Wed, 11 Aug 2021 19:12:45 +0100 Subject: Clarify internal punctuation in citation keys. (#7491) Addresses a comment in #5458. --- MANUAL.txt | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'MANUAL.txt') diff --git a/MANUAL.txt b/MANUAL.txt index 3e8e6b0fd..c76505e80 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -1932,7 +1932,7 @@ ${ styles.html() } ``` (If a partial is not found in the directory of the -template and the template path is given as a relative +template and the template path is given as a relative path, it will also be sought in the `templates` subdirectory of the user data directory.) @@ -4984,13 +4984,16 @@ See the [CSL user documentation] for more information about CSL styles and how they affect rendering. Unless a citation key start with a letter, digit, or `_`, -and contains only alphanumerics and internal punctuation +and contains only alphanumerics and single internal punctuation characters (`:.#$%&-+?<>~/`), it must be surrounded by curly braces, which are not considered part of the key. -In `@Foo_bar.baz.`, the key is `Foo_bar.baz`. The final +In `@Foo_bar.baz.`, the key is `Foo_bar.baz` because the final period is not *internal* punctuation, so it is not included in the key. In `@{Foo_bar.baz.}`, the key is `Foo_bar.baz.`, including -the final period. The curly braces are recommended if you use URLs as +the final period. +In `@Foo_bar--baz`, the key is `Foo_bar` because the repeated internal +punctuation characters terminate the key. +The curly braces are recommended if you use URLs as keys: `[@{https://example.com/bib?name=foobar&date=2000}, p. 33]`. Citation items may optionally include a prefix, a locator, and @@ -6086,7 +6089,7 @@ The following fields are recognized: `rights` ~ A string value. - + `belongs-to-collection` ~ A string value. identifies the name of a collection to which the EPUB Publication belongs. -- cgit v1.2.3