Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document colon, comma, semicolon #107

Open
wants to merge 6 commits into
base: v1.1
Choose a base branch
from
Open

Document colon, comma, semicolon #107

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
c7f76d1
Document colon, comma, semicolon terms
bwiernik Jul 6, 2020
54b411f
Add addendum to comma, etc. doc
bwiernik Jul 6, 2020
4d73edf
Clarify attributes affected by punctuation terms.
bwiernik Jul 7, 2020
7d5bf7f
Fix typo and add title-delimiter to whitespace-preserving attributes
bwiernik Jul 7, 2020
6146aa0
Add title-sub-delimiter to puncutation attribute list
bwiernik Jul 8, 2020
6c39789
Update punctuation spec
bwiernik Jul 30, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 29 additions & 2 deletions specification.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,8 +64,10 @@ is intended for output:
- range-delimiter
- sort-separator
- suffix
- title-delimiter
- title-sub-delimiter
- year-suffix-delimiter
-value
- value

File Types
----------
Expand Down Expand Up @@ -394,7 +396,7 @@ set to an `xsd:language locale code
<http://books.xmlschemata.org/relaxng/ch19-77191.html>`_, determines which
languages or language dialects are affected (see `Locale Fallback`_).

See `Terms`_, `Localized Date Formats`_ and `Localized Options`_ for further
See `Terms`_, `Localized Date Formats`_, `Localized Punctuation`_, and `Localized Options`_ for further
details on the use of ``cs:locale``.

An example of ``cs:locale`` in a style:
Expand Down Expand Up @@ -686,6 +688,31 @@ a localized date format:
<date variable="issued" form="numeric" prefix="(" suffix=")"/>
</macro>

Localized Punctuation
~~~~~~~~~~~~~~~~~~~~~

The terms ``colon``, ``comma``, and ``semicolon`` define locale-specific punctuation marks.
All instances of the ":" (``colon``), "," (``comma``), and ";" (``semicolon``) characters specified in the style in the follow attributes are replaced with their corresponding terms:

- after-collapse-delimiter
- cite-group-delimiter
- delimiter
- initialize-with
- name-delimiter
- names-delimiter
- prefix
- range-delimiter
- sort-separator
- suffix
- title-delimiter
- title-sub-delimiter
- year-suffix-delimiter
- value

If the term contains whitespace character(s) before or after ":", ",", or ";" whitespace characters specified in the respective positions in affected attributes are removed (replaced by the whitespace in the term).
Any ":", ",", or ";" characters contained in item data are unchanged.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well, but what about titles? With the new title-split feature this would be no longer true.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think including title-delimiter in this list makes the behavior clear enough? What do you think @bdarcus?

Other characters included in affected attributes aside from ":", ",", or ";" and affected whitespace are unchanged.

Localized Options
~~~~~~~~~~~~~~~~~

Expand Down