gardener, Interface administrators, Administrators
1,544
edits
Changes
Jump to navigation
Jump to search
Here is some text.
Meaning of "method"
<cd:commandgroup name="setupinitial" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc>Initials (also known as drop caps, dropped caps, or versals) can be made in ConTeXt using the \{{cmd|placeinitial }} command.
The command <code>\{{cmd|setupinitial</code> }} detailed here is used to customize this decorative or ornate first letter(s) to prose at the start of chapters, sections, paragraphs, and so forth.
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:parameter name="n">
<cd:paramdoc>the number of lines in the paragraph that the initial should occupy. It defaults to 3. Another description The size of the initial is adapted accordingly, but it can be "line where footline of dropcapital"changed with font parameter.</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
<cd:parameter name="m">
<cd:paramdoc>number of letters to capitalize(gets ignored if you set `text`)</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="distance">
<cd:paramdoc>is the horizontal distance which initial line(s) of the paragraph should be indented beyond the space needed for the letter. It defaults to 0pt<code>.125\emwidth</code>, and it can be negative. Another description can be "offsets the following text", or "distance to the following text"</cd:paramdoc>
<cd:constant type="cd:dimension"></cd:constant>
</cd:parameter>
<cd:parameter name="hoffset">
<cd:paramdoc>is the distance to the left (into the left margin) , or to the right, that the initial should be shifted from its default position. This defaults to 0pt. Another description can be "shift the initial horizontally, on the left (positive value) or on the right (negative value)"</cd:paramdoc>
<cd:constant type="cd:dimension"></cd:constant>
</cd:parameter>
<cd:parameter name="voffset">
<cd:paramdoc>is the distance downward , or upward (negative value), from its default position that the initial should be shifted. This defaults to 0pt. Another description can be "shift the initial vertically, down (positive value) or up (negative value).
Value 0pt gives a "top" alignment, i.e. corresponding with the first line of the paragraph.</cd:paramdoc>
<cd:constant default="yes" type="line"></cd:constant>
<cd:constant type="cd:dimension"></cd:constant>
</cd:parameter>
<cd:parameter name="style">
<cd:paramdoc>style of the initial, for example <code>style=\tex{bfd}it</code> for large bolditalic.</cd:paramdoc>
<cd:constant type="cd:style"></cd:constant>
<cd:constant type="cd:command"></cd:constant>
</cd:parameter>
<cd:parameter name="color">
<cd:paramdoc>which defaults to the current color, for example <code>color=darkred</code>. It defaults to the current color.</cd:paramdoc>
<cd:constant type="cd:color"></cd:constant>
</cd:parameter>
<cd:parameter name="font">
<cd:paramdoc>font specification which . It defaults to boldface scaled to the number of text lines that the initial occupies, but can be customized, for example : <code>font=Bold at 32pt</code>.</cd:paramdoc>
<cd:constant type="cd:font"></cd:constant>
</cd:parameter>
<cd:parameter name="text">
<cd:paramdoc>the text specified will be used as initial, instead of the letter following the <code>\placeinitial</code> command; `m` gets ignored.</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="method">
<cd:paramdoc>no ideaAffects the handling of quotation marks at the beginning.Doesn’t work with all languages, this is probably an oversight/bug.Under most circumstances, a leading quotation mark will get used as initial.</cd:paramdoc>
<cd:constant type="first"></cd:constant>
<cd:constant type="last"></cd:constant>
<cd:constant type="auto">The first letter after the quotation mark is included in the initial.</cd:constant>
<cd:constant default="yes" type="none"></cd:constant>
</cd:parameter>
</cd:variants>
<cd:description></cd:description>
<cd:examples><cd:example title="color, distance, before + variations on n, m , location"><context mode="mkiv" source="yes">The following example produces an awful-looking initial, but it illustrates how some of these parameters work.
<context mode="mkiv" source="yes">\definepapersize[sheet][width=120mm,height=200mm]\setuppapersize[sheet]\setuppagenumbering[location=]\setupinitialsetuplayout[colorwidth=100mm,backspace=15mm,topspace=red0mm, distanceheader=24pt0mm, nheaderdistance=40mm, hoffsetfooter=-16pt0mm, beforefooterdistance={\blank[2*big]}0mm]
\starttext
\setupinitial
[color=darkred,
distance=10mm,
before={\blank[big]\hairline\blank[big]}]
\type[option=context]{\setupinitial[color=darkred,distance=10mm,before={\blank[big]\hairline\blank[big]}]}
and
\type[option=context]{\setupinitial[n=2, m=2]}
\setupinitial[n=2, m=2]
\placeinitial
\input knuth
\blank[big]
or \type[option=context]{\setupinitial[n=3, m=4]}
\setupinitial[n=3, m=4]
\placeinitial
\input knuth
\blank[big]
or \type[option=context]{\setupinitial[location=margin,n=3, m=1,distance=5mm]}
\setupinitial[location=margin,n=3, m=1,distance=5mm]
\placeinitial
\input knuth
\stoptext
</context></cd:example><cd:example title="hoffset"><context mode="mkiv" source="yes">
\definepapersize[sheet][width=120mm,height=200mm]
\setuppapersize[sheet]
\setuppagenumbering[location=]
\setuplayout[width=100mm,backspace=15mm,topspace=0mm,header=0mm,headerdistance=0mm,footer=0mm,footerdistance=0mm]
\starttext
Here is some text 1.
\setupinitial[color=darkred]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[hoffset=0mm]}
\setupinitial[hoffset=0mm]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[hoffset=5mm]}
\setupinitial[hoffset=5mm]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[hoffset=-5mm]}
\setupinitial[hoffset=-5mm]
\placeinitial
\input knuth
\stoptext
</context></cd:example><cd:example title="voffset"><context mode="mkiv" source="yes">
\definepapersize[sheet][width=120mm,height=200mm]
\setuppapersize[sheet]
\setuppagenumbering[location=]
\setuplayout[width=100mm,backspace=15mm,topspace=0mm,header=0mm,headerdistance=0mm,footer=0mm,footerdistance=0mm]
\starttext
Here is some text 1.
\setupinitial[color=darkred]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[voffset=0mm]}
\setupinitial[voffset=0mm]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[voffset=5mm]}
\setupinitial[voffset=5mm]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[voffset=-5mm]}
\setupinitial[voffset=-5mm]
\placeinitial
\input knuth
\stoptext
</context></cd:example><cd:example title="font"><context mode="mkiv" source="yes">
\definepapersize[sheet][width=120mm,height=150mm]
\setuppapersize[sheet]
\setuppagenumbering[location=]
\setuplayout[width=100mm,backspace=15mm,topspace=0mm,header=0mm,headerdistance=0mm,footer=0mm,footerdistance=0mm]
\starttext
Here is some text 1.
\setupinitial[color=darkred]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[font=Bold at 45pt]}
\setupinitial[font=Bold at 45pt]
\placeinitial
\input knuth
\blank[big]
\type[option=context]{\setupinitial[font=SansBold at 45pt]}
\setupinitial[font=SansBold at 45pt]
\placeinitial
\input knuth
\stoptext
</context></cd:example><cd:example title="text"><context mode="mkiv" source="yes">
\definepapersize[sheet][width=120mm,height=80mm]
\setuppapersize[sheet]
\setuppagenumbering[location=]
\setuplayout[width=100mm,backspace=15mm,topspace=0mm,header=0mm,headerdistance=0mm,footer=0mm,footerdistance=0mm]
\starttext
\type[option=context]{\setupinitial[text=Here]}
\setupinitial[color=darkred,text=Here]
\placeinitial
\input knuth
\stoptext
</context></cd:example></cd:examples>
<cd:notes><cd:note author="Garulfo" date="2020-12-12T22:46:03+0100"> Because the space carved out for the initial is rectangular, initials work best with a font with rectangular ornaments around the letter. </cd:note><cd:note author="Rik" date="2021-12-16T02:10:09+0100"> Named initials must be defined using {{cmd|defineinitial}}. </cd:note></cd:notes>
<cd:seealso>
<cd:commandref name="defineinitial" originator="system">placeinitial </cd:commandref>
<cd:source file="typo-drp.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Fonts"></cd:wikipage>
<cd:commandref name="placeinitial">placeinitial</cd:commandref><cd:commandref name="definefirstline">to apply specific style to the whole first line, or first words</cd:commandref></cd:seealso>
</cd:commandgroup>
