Difference between revisions of "Quotes"

From Wiki
Jump to navigation Jump to search
(moved Sanjoys example for blockquotes)
(Modified the example setting in small type.)
(6 intermediate revisions by 4 users not shown)
Line 6: Line 6:
 
Quotation marks and formatting are language dependent.
 
Quotation marks and formatting are language dependent.
  
; single quotes : <cmd>quote</cmd><tt>{some text}</tt>
+
; single quotes : {{cmd|quote|{some text}}}
; double quotes : <cmd>quotation</cmd><tt>{some text}</tt>
+
; double quotes : {{cmd|quotation|{some text}}}
; long quote sections : try <cmd>startquote</cmd> or <cmd>startquotation</cmd> etc.
+
; long quote sections : try {{cmd|startquote}} or {{cmd|startquotation}} etc.
  
  
Line 15: Line 15:
 
The following commands can be used to automatically nest double and single quotes.
 
The following commands can be used to automatically nest double and single quotes.
  
<texcode>
+
<context source="yes">
 +
\setuppapersize[A5]
 +
 
 
\setupdelimitedtext
 
\setupdelimitedtext
 
   [quotation]
 
   [quotation]
Line 33: Line 35:
 
   [left={\symbol[leftquotation]},
 
   [left={\symbol[leftquotation]},
 
   right={\symbol[rightquotation]}]
 
   right={\symbol[rightquotation]}]
</texcode>
 
  
<texcode>
+
\quotation{A long quotation in which one character says,
Testing, \quotation{A long quotation in which one character says,
 
 
\quotation{Eh? What am I supposed to say? Something like, \quotation
 
\quotation{Eh? What am I supposed to say? Something like, \quotation
{Quotations in this sentence are nested}?}} testing, 1, 2, 3.
+
{Quotations in this sentance are nested}?}}
</texcode>
+
</context>
 +
 
 +
 
 +
==Nested quotations in MkIV==
 +
 
 +
<context source="yes">
 +
\enableregime[utf]
 +
 
 +
\setuplanguage[cz]
 +
[leftquotation=„,
 +
rightquotation=“,
 +
leftquote=‚,
 +
rightquote=‘]
 +
 
 +
\mainlanguage[cz]
 +
 
 +
\starttext
 +
Following example is not correct. Typography rules for Czech language
 +
for quotes \quotation{of text in quotes define \quotation{nested inner} quotes}.
 +
 
 +
And now correct version. Typography rules for Czech language for quotes
 +
\quotation{of text in quotes define to \quote{nested inner} quotes}.
  
<context>
+
\setupdelimitedtext[quotation:1][left={\symbol[leftquotation]},right={\symbol[rightquotation]}]
\setupdelimitedtext
+
\setupdelimitedtext[quotation:2][left={\symbol[leftquote]}, right={\symbol[rightquote]}]
  [quotation]
+
 
  [1]
+
Automatic nesting. Typography rules for Czech language for quotes \quotation{of
  [left={\symbol[leftquotation]},
+
text in quotes define to \quotation{nested inner} quotes}.
  right={\symbol[rightquotation]}]
 
  
\setupdelimitedtext
+
\setupdelimitedtext[quotation:1][left=»,right=«]
  [quotation]
+
\setupdelimitedtext[quotation:2][left=,right=]
  [2]
 
  [left={\symbol[leftquote]},
 
  right={\symbol[rightquote]}]
 
  
\setupdelimitedtext
+
Another type of quotes now. Typography rules for Czech language for French quotes
  [quotation]
+
\quotation{of text in quotes define to \quotation{nested inner} quotes}.
  [3]
+
\stoptext
  [left={\symbol[leftquotation]},
 
  right={\symbol[rightquotation]}]
 
  
Testing, \quotation{A long quotation in which one character says,
 
\quotation{Eh? What am I supposed to say? Something like, \quotation
 
{Quotations in this sentance are nested}?}} testing, 1, 2, 3.
 
 
</context>
 
</context>
 
  
 
==Long quotations and extracts==
 
==Long quotations and extracts==
  
 
The following may serve as a guide to others in formatting long quotations or extracts:
 
The following may serve as a guide to others in formatting long quotations or extracts:
 +
 +
===Long quotations defined with {{cmd|definestartstop}}===
 +
 +
In body text:
 +
 +
<texcode>
 +
\defineblank[extractdistance][3pt]
 +
 +
\definestartstop[extract][
 +
    before={\blank[extractdistance]  % [extractdistance,force] causes spurious
 +
                                      % overfull \hbox warnings
 +
    \setupnarrower[left=1.5pc,right=1.5pc]
 +
    \startnarrower[left,right]
 +
\noindent},
 +
      after={\stopnarrower
 +
  \blank[extractdistance]
 +
\indenting[yes]}]
 +
</texcode>
 +
 +
In footnotes:
 +
 +
<texcode>
 +
\defineblank[footenoteextractdistance][2.7pt]
 +
 +
\definestartstop[fnextract][
 +
      before={\blank[footenoteextractdistance]
 +
    \setupnarrower[left=1.5pc,right=1.5pc]
 +
    \startnarrower[left,right]
 +
\noindent},
 +
      after={\stopnarrower
 +
  \blank[footenoteextractdistance]
 +
\indenting[yes]}]
 +
</texcode>
 +
 +
===Long quotations defined with {{cmd|definedelimitedtext}} ===
  
 
In body text:
 
In body text:
Line 98: Line 144:
 
</texcode>
 
</texcode>
  
==Example using <cmd>setupdelimitedtext</cmd>==
+
==Example using {{cmd|setupdelimitedtext}}==
  
 
Here is how to get indented quotations set in small type:
 
Here is how to get indented quotations set in small type:
<texcode>
+
<context source="yes">
\setupdelimitedtext[blockquote][style={\setupbodyfont[9pt]}]
+
%\setupdelimitedtext[blockquote][style={\setupbodyfont[small]}]
 +
\setupdelimitedtext[blockquote][style=\slx,before={\setupinterlinespace[line=2.4ex]}]
 
Hello
 
Hello
 
\startblockquote
 
\startblockquote
 
\input knuth
 
\input knuth
\par
+
%\par
 
\stopblockquote
 
\stopblockquote
 
Hello
 
Hello
</texcode>
+
</context>
 +
 
 +
The {{cmd|par}} inside the block quotation keeps TeX's paragraph builder happy.  Otherwise the last paragraph in the block quotation gets the wider linespacing of the outside environment rather than the narrower linespacing appropriate to the smaller text; Alternately, one can add <code>before={\setupinterlinespace}</code>, as shown above.
  
The <cmd>par</cmd> inside the block quotation keeps TeX's paragraph builder happy.  Otherwise the last paragraph in the block quotation gets the wider linespacing of the outside environment rather than the narrower linespacing appropriate to nine-point text.
+
Using {{code|1=style=small}} does not work as well as <code>style={\setupbodyfont[small]}</code> or <code>style={\setupbodyfont[9pt]}</code>, because {{code|small}} shrinks only the font size but not the linespacing. Alternately, by using <code>before={\setupinterlinespace}</code>, one can then use commands such as <code>style=\tfx</code>, setting the size relatively rather than absolutely, advantageous for nestling and for inclusion in footnotes, for example.
  
Using <code>style=small</code> does not work as well as <code>style={\setupbodyfont[9pt]}</code> or <code>style={\setupbodyfont[10pt]}</code>, because <code>small</code> shrinks only the font size but not the linespacing.
+
{{Getting started navbox}}

Revision as of 19:01, 24 March 2013

< Visuals

Basic commands

Don't try to type quotation marks, but use logical markup! Quotation marks and formatting are language dependent.

single quotes 
\quote{some text}
double quotes 
\quotation{some text}
long quote sections 
try \startquote or \startquotation etc.


Nested quotations

The following commands can be used to automatically nest double and single quotes.

\setuppapersize[A5]

\setupdelimitedtext
  [quotation]
  [1]
  [left={\symbol[leftquotation]},
   right={\symbol[rightquotation]}]

\setupdelimitedtext
  [quotation]
  [2]
  [left={\symbol[leftquote]},
   right={\symbol[rightquote]}]

\setupdelimitedtext
  [quotation]
  [3]
  [left={\symbol[leftquotation]},
   right={\symbol[rightquotation]}]

\quotation{A long quotation in which one character says,
\quotation{Eh? What am I supposed to say? Something like, \quotation
{Quotations in this sentance are nested}?}}


Nested quotations in MkIV

\enableregime[utf]

\setuplanguage[cz]
[leftquotation=„,
 rightquotation=“,
 leftquote=‚,
 rightquote=]
  
\mainlanguage[cz]

\starttext
Following example is not correct. Typography rules for Czech language 
for quotes \quotation{of text in quotes define \quotation{nested inner} quotes}.
  
And now correct version. Typography rules for Czech language for quotes
\quotation{of text in quotes define to \quote{nested inner} quotes}.

\setupdelimitedtext[quotation:1][left={\symbol[leftquotation]},right={\symbol[rightquotation]}]
\setupdelimitedtext[quotation:2][left={\symbol[leftquote]}, right={\symbol[rightquote]}]
  
Automatic nesting. Typography rules for Czech language for quotes \quotation{of 
text in quotes define to \quotation{nested inner} quotes}.

\setupdelimitedtext[quotation:1][left=»,right=«]
\setupdelimitedtext[quotation:2][left=›,right=]

Another type of quotes now. Typography rules for Czech language for French quotes 
\quotation{of text in quotes define to \quotation{nested inner} quotes}.
\stoptext 

Long quotations and extracts

The following may serve as a guide to others in formatting long quotations or extracts:

Long quotations defined with \definestartstop

In body text:

\defineblank[extractdistance][3pt]

\definestartstop[extract][
     before={\blank[extractdistance]  % [extractdistance,force] causes spurious 
                                      % overfull \hbox warnings
    	\setupnarrower[left=1.5pc,right=1.5pc]
    	\startnarrower[left,right]
	\noindent},
      after={\stopnarrower
   	\blank[extractdistance]
	\indenting[yes]}]

In footnotes:

\defineblank[footenoteextractdistance][2.7pt]

\definestartstop[fnextract][
      before={\blank[footenoteextractdistance]
    	\setupnarrower[left=1.5pc,right=1.5pc]
    	\startnarrower[left,right]
	\noindent},
      after={\stopnarrower
   	\blank[footenoteextractdistance]
	\indenting[yes]}]

Long quotations defined with \definedelimitedtext

In body text:

\defineblank[extractdistance][3pt]

\definedelimitedtext[extract][blockquote]

\setupdelimitedtext
  [extract]
  [spacebefore=extractdistance,
   leftmargin=1.5pc,
   before={\setupindenting[next]}]

In footnotes:

\defineblank[footenoteextractdistance][2.7pt]

\definedelimitedtext[fnextract][blockquote]

\setupdelimitedtext
  [fnextract]
  [spacebefore=footenoteextractdistance,
   leftmargin=1.5pc,
   before={\setupindenting[next]}]

Example using \setupdelimitedtext

Here is how to get indented quotations set in small type:

%\setupdelimitedtext[blockquote][style={\setupbodyfont[small]}]
\setupdelimitedtext[blockquote][style=\slx,before={\setupinterlinespace[line=2.4ex]}]
Hello
\startblockquote
\input knuth
%\par
\stopblockquote
Hello

The \par inside the block quotation keeps TeX's paragraph builder happy. Otherwise the last paragraph in the block quotation gets the wider linespacing of the outside environment rather than the narrower linespacing appropriate to the smaller text; Alternately, one can add before={\setupinterlinespace}, as shown above.

Using style=small does not work as well as style={\setupbodyfont[small]} or style={\setupbodyfont[9pt]}, because small shrinks only the font size but not the linespacing. Alternately, by using before={\setupinterlinespace}, one can then use commands such as style=\tfx, setting the size relatively rather than absolutely, advantageous for nestling and for inclusion in footnotes, for example.

Template:Getting started navbox