Skip to content

Commit 825df74

Browse files
fantasaifantasai
committed
[css-content-3] Editorial clean-up of quotes section
1 parent 11dde0f commit 825df74

File tree

1 file changed

+55
-54
lines changed

1 file changed

+55
-54
lines changed

‎css-content-3/Overview.bs

+55-54
Original file line numberDiff line numberDiff line change
@@ -378,17 +378,16 @@ Element Content</h3>
378378
<h3 id="quotes">
379379
Quotes</h3>
380380

381-
HTML has long had the <code>q</code> element,
382-
used to delimit quotations.
383-
The ''quotes'' property,
381+
The ''quotes'' property, which defines the [=quotation mark system=] of an
382+
element,
384383
in conjunction with the various ''*-quote'' values of the 'content' property,
385-
can be used to properly style such quotations.
386-
384+
which insert corresponding quotation marks as generated content,
385+
can be used to automatically insert opening and closing quotation marks,
386+
such as for the HTML <{q}> element.
387387

388388
<h4 id="quotes-property">
389389
Specifying quotes with the 'quotes' property</h4>
390390

391-
392391
<pre class='propdef'>
393392
Name: quotes
394393
Value: auto | none | [ <<string>> <<string>> ]+
@@ -402,7 +401,11 @@ Specifying quotes with the 'quotes' property</h4>
402401

403402
<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
404403

405-
This property specifies quotation marks for any number of embedded quotations. Values have the following meanings:
404+
This property specifies the <dfn>quotation mark system</dfn> for the element,
405+
defining how the 'content' property’s
406+
''content/open-quote'' and ''content/close-quote'' values behave.
407+
See [[#quote-values]].
408+
Values have the following meanings:
406409

407410
<dl dfn-type=value dfn-for=quotes>
408411
<dt><dfn>none</dfn>
@@ -413,10 +416,9 @@ Specifying quotes with the 'quotes' property</h4>
413416

414417
<dt><dfn>auto</dfn>
415418
<dd>
416-
A typographically appropriate [=used value=] for 'quotes'
419+
A typographically appropriate [=quotation mark system=]
417420
is automatically chosen by the UA
418-
based on the [=content language=]
419-
of the parent
421+
based on the [=content language=] of the parent
420422
(or, if there is no parent, of the element itself).
421423

422424
Note: The Unicode Common Locale Data Repository [[CLDR]]
@@ -428,14 +430,15 @@ Specifying quotes with the 'quotes' property</h4>
428430

429431
<dt>[ <<string>> <<string>> ]+
430432
<dd>
431-
Values for the ''open-quote'' and ''close-quote'' values of the 'content' property
432-
are taken from this list of pairs of quotation marks (opening and closing).
433-
The first (leftmost) pair represents the outermost level of quotation,
434-
the second pair the first level of embedding, etc.
435-
The user agent must apply the appropriate pair of quotation marks according to the level of embedding.
433+
The [=quotation mark system=] is defined as
434+
the specified list of pairs of quotation marks (opening and closing).
435+
The first pair represents the outermost level of quotation,
436+
the second pair the next level of embedding, etc.
437+
Within a pair,
438+
the ''open-quote'' value refers to the first <<string>>,
439+
''close-quote'' refers to the second.
436440
</dl>
437441

438-
439442
<h4 id="quote-values">
440443
The *-quote values of the content property</h4>
441444

@@ -447,28 +450,28 @@ The *-quote values of the content property</h4>
447450
<dt><dfn>open-quote</dfn>
448451
<dt><dfn>close-quote</dfn>
449452
<dd>
450-
These values are replaced by the appropriate string from the 'quotes' property,
451-
and increments (decrements) the level of nesting for quotes.
452-
See [[#quotes-property]] for more information.
453+
These values are replaced by the appropriate string
454+
as defined by the 'quotes' property,
455+
and increments (for ''no-open-quote'')
456+
or decrements (for ''no-close-quote'')
457+
the level of nesting for quotes.
453458

454459
<dt><dfn>no-open-quote</dfn>
455460
<dt><dfn>no-close-quote</dfn>
456461
<dd>
457462
Inserts nothing (as in ''content/none''),
458-
but increments (decrements) the level of nesting for quotes.
459-
See [[#quotes-property]] for more information.
463+
but increments (for ''no-open-quote'')
464+
or decrements (for ''no-close-quote'')
465+
the level of nesting for quotes.
460466
</dl>
461467

462-
463-
464-
Quotation marks are inserted in appropriate places in a document
468+
Quotation marks can be inserted in appropriate places in a document
465469
with the ''open-quote'' and ''close-quote'' values of the 'content' property.
466470
Each occurrence of ''open-quote'' or ''close-quote''
467-
is replaced by one of the strings from the value of 'quotes',
471+
is replaced by a quotation mark string
472+
as defined by the [=quotation mark system=] specified by the 'quotes' property,
468473
based on the depth of nesting.
469474

470-
''open-quote'' refers to the first of a pair of quotes,
471-
''close-quote'' refers to the second.
472475
Which pair of quotes is used depends on the nesting level of quotes:
473476
the number of occurrences of ''open-quote'' in all generated text before the current occurrence,
474477
minus the number of occurrences of ''close-quote''.
@@ -477,34 +480,33 @@ The *-quote values of the content property</h4>
477480
If the depth is greater than the number of pairs,
478481
the last pair is repeated.
479482

480-
Note that this quoting depth is independent of
483+
Note: Quote depth is independent of
481484
the nesting of the source document or the formatting structure.
482-
483-
Note: Quote nesting, like [[css-lists-3#inheriting-counters|counter inheritance]],
484-
operates on the “flattened element tree”
485+
Also, like [[css-lists-3#inheriting-counters|counter inheritance]],
486+
it operates on the “flattened element tree”
485487
in the context of the [[DOM]].
486488

487-
Some typographic styles require open quotation marks to be repeated
488-
before every paragraph of a quote spanning several paragraphs,
489-
but only the last paragraph ends with a closing quotation mark.
490-
In CSS, this can be achieved by inserting "phantom" closing quotes.
491-
The keyword ''no-close-quote'' decrements the quoting level,
492-
but does not insert a quotation mark.
493-
494-
495489
<div class="example">
496-
The following style sheet puts opening quotation marks on every paragraph in a <code>blockquote</code>, and inserts a single closing quote at the end:
490+
Some typographic styles require open quotation marks to be repeated
491+
before every paragraph of a quote spanning several paragraphs,
492+
but only the last paragraph ends with a closing quotation mark.
493+
In CSS, this can be achieved by inserting "phantom" closing quotes.
494+
The keyword ''no-close-quote'' decrements the quoting level,
495+
but does not insert a quotation mark.
496+
497+
The following style sheet puts opening quotation marks on every paragraph in a <code>blockquote</code>,
498+
and inserts a single closing quote at the end:
497499

498500
<pre>
499-
blockquote p:before { content: open-quote }
500-
blockquote p:after { content: no-close-quote }
501+
blockquote p::before { content: open-quote }
502+
blockquote p::after { content: no-close-quote }
501503
blockquote p:last-child::after { content: close-quote }
502504
</pre>
503-
</div>
504505

505-
For symmetry, there is also a ''no-open-quote'' keyword,
506-
which inserts nothing,
507-
but increments the quotation depth by one.
506+
For symmetry, there is also a ''no-open-quote'' keyword,
507+
which inserts nothing,
508+
but increments the quotation depth by one.
509+
</div>
508510

509511
Note: If a quotation is in a different language than the surrounding text,
510512
it is customary to quote the text with the quote marks of the language of the surrounding text,
@@ -597,9 +599,6 @@ The *-quote values of the content property</h4>
597599
</div>
598600

599601

600-
601-
602-
603602
<h3 id="leaders">
604603
Leaders</h3>
605604

@@ -1327,17 +1326,19 @@ bookmark-state</h3>
13271326
* what ::outside::before matches in this case
13281327
-->
13291328

1330-
<h2 id="changes">Changes since the 2 June 2016 Working Draft</h2>
1329+
<h2 id="changes">Changes</h2>
13311330

1332-
Significant changes since the <a href="https://www.w3.org/TR/2016/WD-css-content-3-20160602/">2 June 2016 Working Draft</a>
1331+
Significant changes since the <a href="https://www.w3.org/TR/2019/WD-css-content-3-20190802/">2 August 2019 Working Draft</a>
13331332
consist primarily of:
13341333

13351334
<ul>
1336-
<li>Adding ''quotes/auto'' as the initial value of 'quotes'.
1337-
<li>Lots of miscellaneous spec clean up: errors, cross-references, overly-loose or sloppy definitions, etc.
1335+
<li>Updated ''quotes/auto'' to reference the <em>parent</em> [=content language=]
1336+
rather than the [=content language=] of the element itself.
1337+
(<a href="https://github.com/w3c/csswg-drafts/issues/5478">Issue 5478</a>)
1338+
<li>Miscellaneous editorial spec clean up.
13381339
</ul>
13391340

1340-
See also <a href="https://www.w3.org/TR/2016/WD-css-content-3-20160602/#changes">previous changes</a>.
1341+
See also <a href="https://www.w3.org/TR/2019/WD-css-content-3-20190802/#changes">previous changes</a>.
13411342

13421343
<h2 class="no-num" id="acknowledgements">Acknowledgements</h2>
13431344

0 commit comments

Comments
 (0)