gardener, Interface administrators, Administrators
1,547
edits
Changes
Command/definefallbackfamily (view source)
Revision as of 11:26, 22 April 2023
, 11:26, 22 April 2023new
<cd:commandgroup name="definefallbackfamily" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc><!-- a short command summary goes here -->
The command <tt>\definefallbackfamily</tt> is used in typescripts to setup a font family for missing characters in the main font family. It’s very similar to {{cmd||definetypeface}}.
</cd:shortdesc>
<cd:variants>
<cd:command category="fonts" file="font-sel.mkvi" interfacedate="2020-06-19T13:41" interfacefile="i-fontfamily.xml" level="style" name="definefallbackfamily" variantnumber="1">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc>Name of the font family that the typescript defines.</cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="2">
<cd:keywordsdoc>Font style</cd:keywordsdoc>
<cd:constant default="yes" type="rm"></cd:constant>
<cd:constant type="ss"></cd:constant>
<cd:constant type="tt"></cd:constant>
<cd:constant type="mm"></cd:constant>
<cd:constant type="hw"></cd:constant>
<cd:constant type="cg"></cd:constant>
<cd:constant type="roman"></cd:constant>
<cd:constant type="serif"></cd:constant>
<cd:constant type="regular"></cd:constant>
<cd:constant type="sansserif"></cd:constant>
<cd:constant type="sans"></cd:constant>
<cd:constant type="support"></cd:constant>
<cd:constant type="teletype"></cd:constant>
<cd:constant type="type"></cd:constant>
<cd:constant type="mono"></cd:constant>
<cd:constant type="handwritten"></cd:constant>
<cd:constant type="calligraphic"></cd:constant>
<cd:constant type="math"></cd:constant>
<cd:constant type="mathematics"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="3">
<cd:keywordsdoc>Name of the replacement font</cd:keywordsdoc>
<cd:constant type="cd:font"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="4">
<cd:assignmentsdoc>Options define when the replacement font should get applied.</cd:assignmentsdoc>
<cd:parameter name="rscale">
<cd:paramdoc>relative scaling</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
<cd:parameter name="designsize">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="default"></cd:constant>
<cd:constant type="auto"></cd:constant>
</cd:parameter>
<cd:parameter name="goodies">
<cd:paramdoc>filename of a font goodies file</cd:paramdoc>
<cd:constant type="cd:file"></cd:constant>
</cd:parameter>
<cd:parameter name="range">
<cd:paramdoc>Unicode range (named or numbers) for which the replacement font should get applied</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
<cd:constant type="cd:name"></cd:constant>
</cd:parameter>
<cd:parameter name="offset">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
<cd:constant type="cd:name"></cd:constant>
</cd:parameter>
<cd:parameter name="check">
<cd:paramdoc>Check if the main fonts contains the characters (adds some lag)</cd:paramdoc>
<cd:constant type="yes"></cd:constant>
<cd:constant default="yes" type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="force">
<cd:paramdoc>Always apply, even if the main font contains the characters.</cd:paramdoc>
<cd:constant type="yes"></cd:constant>
<cd:constant default="yes" type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="features">
<cd:paramdoc>Font features to activate</cd:paramdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:parameter>
<cd:parameter name="tf">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="bf">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="it">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="sl">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="bi">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="bs">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="sc">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
</cd:assignments>
</cd:arguments>
</cd:command>
<cd:command category="fonts" file="font-sel.mkvi" interfacedate="2020-06-19T13:41" interfacefile="i-fontfamily.xml" level="style" name="definefallbackfamily" variant="preset" variantnumber="2">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="2">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant default="yes" type="rm"></cd:constant>
<cd:constant type="ss"></cd:constant>
<cd:constant type="tt"></cd:constant>
<cd:constant type="mm"></cd:constant>
<cd:constant type="hw"></cd:constant>
<cd:constant type="cg"></cd:constant>
<cd:constant type="roman"></cd:constant>
<cd:constant type="serif"></cd:constant>
<cd:constant type="regular"></cd:constant>
<cd:constant type="sansserif"></cd:constant>
<cd:constant type="sans"></cd:constant>
<cd:constant type="support"></cd:constant>
<cd:constant type="teletype"></cd:constant>
<cd:constant type="type"></cd:constant>
<cd:constant type="mono"></cd:constant>
<cd:constant type="handwritten"></cd:constant>
<cd:constant type="calligraphic"></cd:constant>
<cd:constant type="math"></cd:constant>
<cd:constant type="mathematics"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="3">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:font"></cd:constant>
</cd:keywords>
<cd:keywords list="yes" optional="yes" ordinal="4">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description><!-- the long description of the command goes here -->
</cd:description>
<cd:examples><cd:example title="Setup a replacement font for Japanese characters"><texcode>
\usetypescriptfile [type-alegreya]
\usetypescript[sans][alegreya][name]
\definefallbackfamily [alegreya] [rm] [KaiseiOpti] [preset=range:japanese]
\definefontfamily [alegreya] [rm] [Alegreya]
\definefallbackfamily [alegreya] [ss] [HiraginoSans] [preset=range:japanese]
\definefontfamily [alegreya] [ss] [alegreya-light]
\setupbodyfont [alegreya,rm,10pt]
</texcode></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:source file="font-sel.mkvi" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Fonts"></cd:wikipage>
<cd:commandref name="definetypeface"></cd:commandref>
<cd:commandref name="definefontfallback">different approach</cd:commandref></cd:seealso>
</cd:commandgroup>
<cd:shortdesc><!-- a short command summary goes here -->
The command <tt>\definefallbackfamily</tt> is used in typescripts to setup a font family for missing characters in the main font family. It’s very similar to {{cmd||definetypeface}}.
</cd:shortdesc>
<cd:variants>
<cd:command category="fonts" file="font-sel.mkvi" interfacedate="2020-06-19T13:41" interfacefile="i-fontfamily.xml" level="style" name="definefallbackfamily" variantnumber="1">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc>Name of the font family that the typescript defines.</cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="2">
<cd:keywordsdoc>Font style</cd:keywordsdoc>
<cd:constant default="yes" type="rm"></cd:constant>
<cd:constant type="ss"></cd:constant>
<cd:constant type="tt"></cd:constant>
<cd:constant type="mm"></cd:constant>
<cd:constant type="hw"></cd:constant>
<cd:constant type="cg"></cd:constant>
<cd:constant type="roman"></cd:constant>
<cd:constant type="serif"></cd:constant>
<cd:constant type="regular"></cd:constant>
<cd:constant type="sansserif"></cd:constant>
<cd:constant type="sans"></cd:constant>
<cd:constant type="support"></cd:constant>
<cd:constant type="teletype"></cd:constant>
<cd:constant type="type"></cd:constant>
<cd:constant type="mono"></cd:constant>
<cd:constant type="handwritten"></cd:constant>
<cd:constant type="calligraphic"></cd:constant>
<cd:constant type="math"></cd:constant>
<cd:constant type="mathematics"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="3">
<cd:keywordsdoc>Name of the replacement font</cd:keywordsdoc>
<cd:constant type="cd:font"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="4">
<cd:assignmentsdoc>Options define when the replacement font should get applied.</cd:assignmentsdoc>
<cd:parameter name="rscale">
<cd:paramdoc>relative scaling</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
<cd:parameter name="designsize">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="default"></cd:constant>
<cd:constant type="auto"></cd:constant>
</cd:parameter>
<cd:parameter name="goodies">
<cd:paramdoc>filename of a font goodies file</cd:paramdoc>
<cd:constant type="cd:file"></cd:constant>
</cd:parameter>
<cd:parameter name="range">
<cd:paramdoc>Unicode range (named or numbers) for which the replacement font should get applied</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
<cd:constant type="cd:name"></cd:constant>
</cd:parameter>
<cd:parameter name="offset">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
<cd:constant type="cd:name"></cd:constant>
</cd:parameter>
<cd:parameter name="check">
<cd:paramdoc>Check if the main fonts contains the characters (adds some lag)</cd:paramdoc>
<cd:constant type="yes"></cd:constant>
<cd:constant default="yes" type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="force">
<cd:paramdoc>Always apply, even if the main font contains the characters.</cd:paramdoc>
<cd:constant type="yes"></cd:constant>
<cd:constant default="yes" type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="features">
<cd:paramdoc>Font features to activate</cd:paramdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:parameter>
<cd:parameter name="tf">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="bf">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="it">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="sl">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="bi">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="bs">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="sc">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
</cd:assignments>
</cd:arguments>
</cd:command>
<cd:command category="fonts" file="font-sel.mkvi" interfacedate="2020-06-19T13:41" interfacefile="i-fontfamily.xml" level="style" name="definefallbackfamily" variant="preset" variantnumber="2">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="2">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant default="yes" type="rm"></cd:constant>
<cd:constant type="ss"></cd:constant>
<cd:constant type="tt"></cd:constant>
<cd:constant type="mm"></cd:constant>
<cd:constant type="hw"></cd:constant>
<cd:constant type="cg"></cd:constant>
<cd:constant type="roman"></cd:constant>
<cd:constant type="serif"></cd:constant>
<cd:constant type="regular"></cd:constant>
<cd:constant type="sansserif"></cd:constant>
<cd:constant type="sans"></cd:constant>
<cd:constant type="support"></cd:constant>
<cd:constant type="teletype"></cd:constant>
<cd:constant type="type"></cd:constant>
<cd:constant type="mono"></cd:constant>
<cd:constant type="handwritten"></cd:constant>
<cd:constant type="calligraphic"></cd:constant>
<cd:constant type="math"></cd:constant>
<cd:constant type="mathematics"></cd:constant>
</cd:keywords>
<cd:keywords ordinal="3">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:font"></cd:constant>
</cd:keywords>
<cd:keywords list="yes" optional="yes" ordinal="4">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description><!-- the long description of the command goes here -->
</cd:description>
<cd:examples><cd:example title="Setup a replacement font for Japanese characters"><texcode>
\usetypescriptfile [type-alegreya]
\usetypescript[sans][alegreya][name]
\definefallbackfamily [alegreya] [rm] [KaiseiOpti] [preset=range:japanese]
\definefontfamily [alegreya] [rm] [Alegreya]
\definefallbackfamily [alegreya] [ss] [HiraginoSans] [preset=range:japanese]
\definefontfamily [alegreya] [ss] [alegreya-light]
\setupbodyfont [alegreya,rm,10pt]
</texcode></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:source file="font-sel.mkvi" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Fonts"></cd:wikipage>
<cd:commandref name="definetypeface"></cd:commandref>
<cd:commandref name="definefontfallback">different approach</cd:commandref></cd:seealso>
</cd:commandgroup>