[JM:01106] Re: fonts-conf(5)のインデックスへの追加依頼

Back to archive index

Kikutake Ko kikut****@appi*****
2015年 4月 21日 (火) 20:26:01 JST


菊竹です。

長南さん、ありがとうございます。
翻訳したroff形式ファイルを添付します。
utf-8の、LF改行です。

何か問題がありましたら、仰ってください。
どうぞ、よろしくお願いします。

--
菊竹
-------------- next part --------------
.\" auto-generated by docbook2man-spec from docbook-utils package
.TH "FONTS-CONF" "5" "09 March 2015" "" ""
.\"O.SH NAME
.SH 名前 
fonts.conf \- Font configuration files
.\"O.SH SYNOPSIS
.SH 書式 
.sp
.nf
   /etc/fonts/fonts.conf
   /etc/fonts/fonts.dtd
   /etc/fonts/conf.d
   $XDG_CONFIG_HOME/fontconfig/conf.d
   $XDG_CONFIG_HOME/fontconfig/fonts.conf
   ~/.fonts.conf.d
   ~/.fonts.conf
.sp
.fi
.\"O.SH "DESCRIPTION"
.SH 書式 
.\"O.PP
.\"OFontconfig is a library designed to provide system-wide font configuration,
.\"Ocustomization and application access.
.PP
fontconfigはシステム共通のフォント構成、カスタム、アプリケーションアクセスを提供するライブラリである。
.\"O.SH "FUNCTIONAL OVERVIEW"
.SH 機能 
.\"O.PP
.\"OFontconfig contains two essential modules, the configuration module which
.\"Obuilds an internal configuration from XML files and the matching module
.\"Owhich accepts font patterns and returns the nearest matching font.
.PP
fontconfigは2つの基本的なモジュールからなっている。
設定モジュールはXMLファイルから内部的な設定を行い、マッチングモジュールはフォントパターンを元に、最も近いパターンのフォントを返す。
.\"O.SS "FONT CONFIGURATION"
.SS フォント設定 
.\"O.PP
.\"OThe configuration module consists of the FcConfig datatype, libexpat and
.\"OFcConfigParse which walks over an XML tree and amends a configuration with
.\"Odata found within. From an external perspective, configuration of the
.\"Olibrary consists of generating a valid XML tree and feeding that to
.\"OFcConfigParse. The only other mechanism provided to applications for
.\"Ochanging the running configuration is to add fonts and directories to the
.\"Olist of application-provided font files. 
.PP
設定モジュールは、FcConfigデータ型、libexpat、FcConfigParseからなる。
FcConfigParseはXML木構造をパースし、含まれるデータに基づいて内部設定を変更する。
利用するユーザーは、妥当なXML木を生成し、FcConfigParseに読み込ませる必要がある。
上記の方法以外に、実行中の設定を変更する方法は、フォントやディレクトリを、アプリケーションが提供するフォントファイルのリストに追加する事である。
.\"O.PP
.\"OThe intent is to make font configurations relatively static, and shared by
.\"Oas many applications as possible. It is hoped that this will lead to more
.\"Ostable font selection when passing names from one application to another.
.\"OXML was chosen as a configuration file format because it provides a format
.\"Owhich is easy for external agents to edit while retaining the correct
.\"Ostructure and syntax.
.PP
フォント設定は、静的に作られ、できるだけ多くのアプリケーションに共有される様に意図されている。
これによって、アプリケーション毎にフォント名をやり取りした時に、安定してフォントが選択されると思われる。
XMLを設定ファイルとして選んだのは、外部エージェントによって、容易に編集できるためである。
.\"O.PP
.\"OFont configuration is separate from font matching; applications needing to
.\"Odo their own matching can access the available fonts from the library and
.\"Operform private matching. The intent is to permit applications to pick and
.\"Ochoose appropriate functionality from the library instead of forcing them to
.\"Ochoose between this library and a private configuration mechanism. The hope
.\"Ois that this will ensure that configuration of fonts for all applications
.\"Ocan be centralized in one place. Centralizing font configuration will
.\"Osimplify and regularize font installation and customization.
.PP
フォント設定は、フォントマッチングとは分離されている。
アプリケーションは、このライブラリから有効なフォントリストを取得し、自分で用意したマッチングを行う事ができる。
アプリケーションは、ライブラリに100%依存するか全く利用しないか、ではなく、ライブラリの適切な機能のみを利用する事ができる。
また、全てのアプリケーションに対する設定を一所に集める事ができる。
一か所に集められたフォント設定はフォントのインストールとカスタマイズを容易にする。
.\"O.SS "FONT PROPERTIES"
.SS フォントプロパティ 
.\"O.PP
.\"OWhile font patterns may contain essentially any properties, there are some
.\"Owell known properties with associated types. Fontconfig uses some of these
.\"Oproperties for font matching and font completion. Others are provided as a
.\"Oconvenience for the applications' rendering mechanism.
.PP
フォントパターンは、本質的に如何なるプロパティをも持てるが、いくつかのプロパティは、それぞれの型と共に良く使われる。
fontconfigはこれらのプロパティのいくつかをフォントマッチングとフォント補完のために使う。
それ以外には、アプリケーションのレンダリング機構のためのヒントとして使われる物もある。
.sp
.nf
  Property        Type    Description
  --------------------------------------------------------------
  family          String  Font family names
  familylang      String  Languages corresponding to each family
  style           String  Font style. Overrides weight and slant
  stylelang       String  Languages corresponding to each style
  fullname        String  Font full names (often includes style)
  fullnamelang    String  Languages corresponding to each fullname
  slant           Int     Italic, oblique or roman
  weight          Int     Light, medium, demibold, bold or black
  size            Double  Point size
  width           Int     Condensed, normal or expanded
  aspect          Double  Stretches glyphs horizontally before hinting
  pixelsize       Double  Pixel size
  spacing         Int     Proportional, dual-width, monospace or charcell
  foundry         String  Font foundry name
  antialias       Bool    Whether glyphs can be antialiased
  hinting         Bool    Whether the rasterizer should use hinting
  hintstyle       Int     Automatic hinting style
  verticallayout  Bool    Use vertical layout
  autohint        Bool    Use autohinter instead of normal hinter
  globaladvance   Bool    Use font global advance data (deprecated)
  file            String  The filename holding the font
  index           Int     The index of the font within the file
  ftface          FT_Face Use the specified FreeType face object
  rasterizer      String  Which rasterizer is in use (deprecated)
  outline         Bool    Whether the glyphs are outlines
  scalable        Bool    Whether glyphs can be scaled
  color           Bool    Whether any glyphs have color
  scale           Double  Scale factor for point->pixel conversions
  dpi             Double  Target dots per inch
  rgba            Int     unknown, rgb, bgr, vrgb, vbgr,
                          none - subpixel geometry
  lcdfilter       Int     Type of LCD filter
  minspace        Bool    Eliminate leading from line spacing
  charset         CharSet Unicode chars encoded by the font
  lang            String  List of RFC-3066-style languages this
                          font supports
  fontversion     Int     Version number of the font
  capability      String  List of layout capabilities in the font
  fontformat      String  String name of the font format
  embolden        Bool    Rasterizer should synthetically embolden the font
  embeddedbitmap  Bool    Use the embedded bitmap instead of the outline
  decorative      Bool    Whether the style is a decorative variant
  fontfeatures    String  List of the feature tags in OpenType to be enabled
  namelang        String  Language name to be used for the default value of
                          familylang, stylelang, and fullnamelang
  prgname         String  String  Name of the running program
  postscriptname  String  Font family name in PostScript
   
.sp
.fi
.\"O.SS "FONT MATCHING"
.SS フォントマッチング 
.\"O.PP
.\"OFontconfig performs matching by measuring the distance from a provided
.\"Opattern to all of the available fonts in the system. The closest matching
.\"Ofont is selected. This ensures that a font will always be returned, but
.\"Odoesn't ensure that it is anything like the requested pattern.
.PP
fontconfigは、与えられたパターンとシステム中のフォントとの"距離"を計算する事で、マッチングを行う。
最も近いフォントが選ばれる。
これによって、フォントが必ず返されるが、返されたフォントが要求されたパターンに近いとは限らない。
.\"O.PP
.\"OFont matching starts with an application constructed pattern. The desired
.\"Oattributes of the resulting font are collected together in a pattern. Each
.\"Oproperty of the pattern can contain one or more values; these are listed in
.\"Opriority order; matches earlier in the list are considered "closer" than
.\"Omatches later in the list.
.PP
フォントマッチングは、アプリケーションがパターンを生成する所から始まる。
返されるフォントに求める属性は、パターンに記述される。
パターンのそれぞれのプロパティは一つ以上の値を含む。
これらは優先度順に並べられる。
より最初の方のプロパティの値にマッチしたフォントが、後ろの方の値にマッチした物よりも、パターンに"近い"と見なされる。
.\"O.PP
.\"OThe initial pattern is modified by applying the list of editing instructions
.\"Ospecific to patterns found in the configuration; each consists of a match
.\"Opredicate and a set of editing operations. They are executed in the order
.\"Othey appeared in the configuration. Each match causes the associated
.\"Osequence of editing operations to be applied.
.PP
editing instructionによって、元々のパターンは変更される事がある。
それぞれのinstructionはmatch predicateとediting operationから成る。
これらは設定中で見つかった順番に実行される。
それぞれのマッチは、それに伴うediting operatorの列を生成し、適応する。
.\"O.PP
.\"OAfter the pattern has been edited, a sequence of default substitutions are
.\"Operformed to canonicalize the set of available properties; this avoids the
.\"Oneed for the lower layers to constantly provide default values for various
.\"Ofont properties during rendering.
.PP
パターンが編集された後、デフォルト設定の代入が行われ、プロパティは正規化される。
これによって、低いレイヤーでのレンダリング中に、様々なプロパティに対してデフォルト値を与える必要が無くなる。
.\"O.PP
.\"OThe canonical font pattern is finally matched against all available fonts.
.\"OThe distance from the pattern to the font is measured for each of several
.\"Oproperties: foundry, charset, family, lang, spacing, pixelsize, style,
.\"Oslant, weight, antialias, rasterizer and outline. This list is in priority
.\"Oorder -- results of comparing earlier elements of this list weigh more
.\"Oheavily than later elements.
.PP
正規化フォントパターンは、最終的に全てのフォントに対してマッチを試す。
フォントとパターンの距離は、foundry、charset、family、lang、spacing、pixelsize、style、slant、weight、antialias、rastersizer、outlineのそれぞれに対して計算される。
このリストは優先度順に並んでいる。
すなわち、リストの最初の方のプロパティがより高い重みを持っている。
.\"O.PP
.\"OThere is one special case to this rule; family names are split into two
.\"Obindings; strong and weak. Strong family names are given greater precedence
.\"Oin the match than lang elements while weak family names are given lower
.\"Oprecedence than lang elements. This permits the document language to drive
.\"Ofont selection when any document specified font is unavailable.
.PP
上記には、例外的なルールがある。family namesはstrongとweakに分けられる。
strongは、langよりも高い優先度を持つが、weakはlangよりも低い優先度を持つ。
これによって、指定されたfont familyが有効で無い場合でも、langに基づいてフォントが選択出来る。
.\"O.PP
.\"OThe pattern representing that font is augmented to include any properties
.\"Ofound in the pattern but not found in the font itself; this permits the
.\"Oapplication to pass rendering instructions or any other data through the
.\"Omatching system. Finally, the list of editing instructions specific to
.\"Ofonts found in the configuration are applied to the pattern. This modified
.\"Opattern is returned to the application.
.PP
あるフォントを表すパターンは、フォント中では無く、パターン中で見つかったパターンをインクルードする。
これによって、アプリケーションは、レンダリング用のインストラクションや、あらゆるデータを、マッチングシステムを通して渡す事が出来る。
この編集されたパターンは、アプリケーションに返される。
.\"O.PP
.\"OThe return value contains sufficient information to locate and rasterize the
.\"Ofont, including the file name, pixel size and other rendering data. As
.\"Onone of the information involved pertains to the FreeType library,
.\"Oapplications are free to use any rasterization engine or even to take
.\"Othe identified font file and access it directly.
.PP
返された値は、フォント名、ピクセルサイズやその他のレンダリングデータを含み、ファイルの位置を特定し、ラスター化するための十分な値を持つ。
FreeTypeライブラリに属する情報は含まれないので、アプリケーションは自由に、独自のラスタライズエンジンを用いたり、フォントファイルに直接アクセスできる。
.\"O.PP
.\"OThe match/edit sequences in the configuration are performed in two passes
.\"Obecause there are essentially two different operations necessary -- the
.\"Ofirst is to modify how fonts are selected; aliasing families and adding
.\"Osuitable defaults. The second is to modify how the selected fonts are
.\"Orasterized. Those must apply to the selected font, not the original pattern
.\"Oas false matches will often occur.
.PP
設定ファイル中のmatch/edit列は2つのやり方で処理される。
一つは、フォントがどの様に選ばれるかを変更する。
もう一つは、選ばれたフォントがどの様にラスタライズされるかを変更する。
間違ったマッチを防ぐために、これらは元のパターンを変更する事無く、選ばれたフォントに適応される。
.\"O.SS "FONT NAMES"
.SS フォント名 
.\"O.PP
.\"OFontconfig provides a textual representation for patterns that the library
.\"Ocan both accept and generate. The representation is in three parts, first a
.\"Olist of family names, second a list of point sizes and finally a list of
.\"Oadditional properties:
.PP
Fontconfigは、ライブラリが読み書きできる、パターンの文字列表現を提供する。
この表現は3つの部分からなる。famili nameのリスト、point sizeのリスト、その他のプロパティのリストである。

.sp
.nf
	<families>-<point sizes>:<name1>=<values1>:<name2>=<values2>\&...
    
.sp
.fi
.\"O.PP
.\"OValues in a list are separated with commas. The name needn't include either
.\"Ofamilies or point sizes; they can be elided. In addition, there are
.\"Osymbolic constants that simultaneously indicate both a name and a value.
.\"OHere are some examples:
.PP
リスト中の値はコンマで区切られる。nameはfamilyもpoint sizeも含む必要は無い。
また、名前と値を同時に指定する特別な記号が容易されている。以下が例である。
.sp
.nf
  Name                            Meaning
  ----------------------------------------------------------
  Times-12                        12 point Times Roman
  Times-12:bold                   12 point Times Bold
  Courier:italic                  Courier Italic in the default size
  Monospace:matrix=1 .1 0 1       The users preferred monospace font
                                  with artificial obliquing
    
.sp
.fi
.\"O.PP
.\"OThe '\\', '-', ':' and ',' characters in family names must be preceeded by a
.\"O\&'\\' character to avoid having them misinterpreted. Similarly, values
.\"Ocontaining '\\', '=', '_', ':' and ',' must also have them preceeded by a
.\"O\&'\\' character. The '\\' characters are stripped out of the family name and
.\"Ovalues as the font name is read.
.PP
family name中の'\\'、'-'、':'、','の文字は、誤った解釈を防ぐため、'\\'に続く。
同様に、値の中で、'\\'、'='、'_'、':'、','を含む文字も'\\'に続く。
'\\'に続く文字は、family name中とvalueの中でストリップされる。
.\"O.SH "DEBUGGING APPLICATIONS"
.SH アプリケーションデバッグ 
.\"O.PP
.\"OTo help diagnose font and applications problems, fontconfig is built with a
.\"Olarge amount of internal debugging left enabled. It is controlled by means
.\"Oof the FC_DEBUG environment variable. The value of this variable is
.\"Ointerpreted as a number, and each bit within that value controls different
.\"Odebugging messages.
.PP
フォントとアプリケーションの問題の診断を助けるために、fontconfigは多くの内部的なデバッグ機構とともにビルドされる。こ
れはFC_DEBUG環境変数によってコントロールされる。
この変数の値は、数値と認識され、それぞれのビットが、異なるデバッグメッセージをコントロールする。
.sp
.nf
  Name         Value    Meaning
  ---------------------------------------------------------
  MATCH            1    Brief information about font matching
  MATCHV           2    Extensive font matching information
  EDIT             4    Monitor match/test/edit execution
  FONTSET          8    Track loading of font information at startup
  CACHE           16    Watch cache files being written
  CACHEV          32    Extensive cache file writing information
  PARSE           64    (no longer in use)
  SCAN           128    Watch font files being scanned to build caches
  SCANV          256    Verbose font file scanning information
  MEMORY         512    Monitor fontconfig memory usage
  CONFIG        1024    Monitor which config files are loaded
  LANGSET       2048    Dump char sets used to construct lang values
  OBJTYPES      4096    Display message when value typechecks fail
  
.sp
.fi
.\"O.PP
.\"OAdd the value of the desired debug levels together and assign that (in
.\"Obase 10) to the FC_DEBUG environment variable before running the
.\"Oapplication. Output from these statements is sent to stdout.
.PP
望むデバッグレベルの値を足して、アプリケーションを実行する前に、10進数としてFC_DEBUG環境変数に代入しなさい。
デバッグメッセージはstdoutに送られる。
.\"O.SH "LANG TAGS"
.SH 言語タグ
.\"O.PP
.\"OEach font in the database contains a list of languages it supports. This is
.\"Ocomputed by comparing the Unicode coverage of the font with the orthography
.\"Oof each language. Languages are tagged using an RFC-3066 compatible naming
.\"Oand occur in two parts -- the ISO 639 language tag followed a hyphen and then
.\"Oby the ISO 3166 country code. The hyphen and country code may be elided.
.PP
データベース中のそれぞれのフォントは、そのフォントがサポートしている言語のリストを含んでいる。
これは、フォント中のUnicode範囲と、それぞれの言語のorthographyを比較する事で計算される。
言語はRFC-3066互換名によってタグ付けされる。
RFC-3066互換名は、ISO639言語タグとISO3166カントリーコードをハイフンで繋いだ物である。
ハイフンとカントリーコードは省略され得る。
.\"O.PP
.\"OFontconfig has orthographies for several languages built into the library.
.\"ONo provision has been made for adding new ones aside from rebuilding the
.\"Olibrary. It currently supports 122 of the 139 languages named in ISO 639-1,
.\"O141 of the languages with two-letter codes from ISO 639-2 and another 30
.\"Olanguages with only three-letter codes. Languages with both two and three
.\"Oletter codes are provided with only the two letter code.
.\"O TODO:[jp-trans] この辺りの説明はバグってる 
.PP
Fontconfigはいくつかの言語のorthographyをライブラリとして持っている。
再ビルドせずに、新しいorthographyを追加する予定は無い。
現在の所、139のISO 639-1言語名のうち122、ISO 639-2の2文字コード言語のうち141、ISO 639-2の3文字コード言語のうち30がサポートされている。
2文字コードと3文字コードの両方を持つ言語は、2文字コードの方だけがサポートされる。
.\"O.PP
.\"OFor languages used in multiple territories with radically different
.\"Ocharacter sets, fontconfig includes per-territory orthographies. This
.\"Oincludes Azerbaijani, Kurdish, Pashto, Tigrinya and Chinese.
.PP
著しく異なる文字集合を持つ、複数のテリトリーで使われる言語に対して、fontconfigはテリトリー毎のorthographyを持っている。
これには、Azerbaijani、Kurdish、Pashto、Tigrinya、Chineseが含まれる。
.\"O.SH "CONFIGURATION FILE FORMAT"
.SH 設定ファイルフォーマット 
.\"O.PP
.\"OConfiguration files for fontconfig are stored in XML format; this
.\"Oformat makes external configuration tools easier to write and ensures that
.\"Othey will generate syntactically correct configuration files. As XML
.\"Ofiles are plain text, they can also be manipulated by the expert user using
.\"Oa text editor.
.PP
fontconfigのための設定ファイルはXML形式で保存される。
このフォーマットは外部の設定ツールが、文法的に正しい設定ファイルを作る事を簡単にする。
XMLファイルはプレーンテキストで、専門家によってテキストエディターで操作できる。
.\"O.PP
.\"OThe fontconfig document type definition resides in the external entity
.\"O"fonts.dtd"; this is normally stored in the default font configuration
.\"Odirectory (/etc/fonts). Each configuration file should contain the
.\"Ofollowing structure:
.PP
fontconfigのDocument Type Definitionは"fonts.dtd"の外部ファイルに記述してある。
このファイルは通常、デフォルトのフォント設定ディレクトリ(/etc/fonts)にある。
それぞれの設定ファイルは次の様な構造を含んでいなければならない。
.sp
.nf
	<?xml version="1.0"?>
	<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
	<fontconfig>
\&...
	</fontconfig>
    
.sp
.fi
.SS "<FONTCONFIG>"
.\"O.PP
.\"OThis is the top level element for a font configuration and can contain
.\"O<dir>, <cache>, <include>, <match> and <alias> elements in any order.
.PP
これはフォント設定のトップレベル要素で、<dir>、<cache>、<include>、<match>、<alias>要素をどの様な順序でも含んでいても良い。
.SS "<DIR PREFIX=""DEFAULT"">"
.\"O.PP
.\"OThis element contains a directory name which will be scanned for font files
.\"Oto include in the set of available fonts. If 'prefix' is set to "xdg", the value in the XDG_DATA_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details.
.PP
この要素はフォントファイルが検索されるディレクトリ名を含む。
もし、'prefix'が"xdg"にセットされたならば、XDG_DATA_HOME環境変数の値が、パスの先頭に追加される。
XDG Base Directory Specificationを参照せよ。
.SS "<CACHEDIR PREFIX=""DEFAULT"">"
.PP
.\"Ofile version number (currently 2).
.\"OThis element contains a directory name that is supposed to be stored or read
.\"Othe cache of font information. If multiple elements are specified in
.\"Othe configuration file, the directory that can be accessed first in the list
.\"Owill be used to store the cache files. If it starts with '~', it refers to
.\"Oa directory in the users home directory. If 'prefix' is set to "xdg", the value in the XDG_CACHE_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details.
.\"OThe default directory is ``$XDG_CACHE_HOME/fontconfig'' and it contains the cache files
.\"Onamed ``<hash value>-<architecture>\&.cache-<version>\&'',
.\"Owhere <version> is the font configureation file
.\"Oversion number (currently 3).
.PP
この要素は、ユーザー毎の、フォント情報のキャッシュのためのファイル名を含む。
もし、複数の要素が指定された場合、リストの一番最初のアクセスできるディレクトリが、キャッシュファイルの格納に用いられる。
もし、この要素が'~'で始まる場合、ユーザーのhomeディレクトリを指す。
もし、'prefix'が"xdg"にセットされたならば、XDG_DATA_HOME環境変数の値が、パスの先頭に追加される。
XDG Base Directory Specificationを参照せよ。
デフォルトディレクトリは、``$XDG_CACHE_HOME/fontconfig''であり、``<hash value>-<architecture>\&.cache-<version>\&''にキャッシュファイルが置かれる。
<version>はフォント設定ファイルのバージョンで、現在の所、3である。

.SS "<INCLUDE IGNORE_MISSING=""NO"" PREFIX=""DEFAULT"">"
.\"O.PP
.\"OThis element contains the name of an additional configuration file or
.\"Odirectory. If a directory, every file within that directory starting with an
.\"OASCII digit (U+0030 - U+0039) and ending with the string ``.conf'' will be processed in sorted order. When
.\"Othe XML datatype is traversed by FcConfigParse, the contents of the file(s)
.\"Owill also be incorporated into the configuration by passing the filename(s) to
.\"OFcConfigLoadAndParse. If 'ignore_missing' is set to "yes" instead of the
.\"Odefault "no", a missing file or directory will elicit no warning message from
.\"Othe library. If 'prefix' is set to "xdg", the value in the XDG_CONFIG_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details.
.PP
この要素は、追加の設定ファイルやディレクトリの名前を含んでいる。
もし、ディレクトリ名ならば、ディレクトリ中のASCII digit(U+0030 - U+0039)で始まり、``.conf''で終わる全てのファイルがソート順で処理される。
XMLデータ型がFcConfigParseによってトラバースされる時、この要素で指定されるファイルの内容が、ファイル名をFcConfigLoadAndParseに渡される事で取り込まれる。
もし、'ignore_missing'がデフォルトの"no"の代わりに、"yes"に設定されると、存在しないファイルやディレクトリに対する、ライブラリからの警告メッセージは省略される。
もし、'prefix'が"xdg"にセットされたならば、XDG_DATA_HOME環境変数の値が、パスの先頭に追加される。
XDG Base Directory Specificationを参照せよ。
.SS "<CONFIG>"
.\"O.PP
.\"OThis element provides a place to consolidate additional configuration
.\"Oinformation. <config> can contain <blank> and <rescan> elements in any
.\"Oorder.
.PP
この要素は、追加の設定情報のための場所を提供する。
<config>は<blank>と<rescan>要素をいかなる順序でも含める。
.SS "<BLANK>"
.\"O.PP
.\"OFonts often include "broken" glyphs which appear in the encoding but are
.\"Odrawn as blanks on the screen. Within the <blank> element, place each
.\"OUnicode characters which is supposed to be blank in an <int> element.
.\"OCharacters outside of this set which are drawn as blank will be elided from
.\"Othe set of characters supported by the font.
.PP
フォントはしばしば"壊れた"グリフを含み、それらはエンコード情報は持つが、空白として描画される。
<blank>要素中では、<int>要素の中で、空白となるUnicode文字を指定できる。
この中で指定されなかった文字で、空白として描画される文字は、フォントがサポートする文字として見なされない。
.SS "<RESCAN>"
.\"O.PP
.\"OThe <rescan> element holds an <int> element which indicates the default
.\"Ointerval between automatic checks for font configuration changes.
.\"OFontconfig will validate all of the configuration files and directories and
.\"Oautomatically rebuild the internal datastructures when this interval passes.
.PP
<rescan>要素は<int>要素を持ち、フォント設定が変わったかどうかの自動チェックの、デフォルトの間隔を指定できる。
Fontconfigは全ての設定ファイルとディレクトリを自動的に確認し、内部的なデータ構造を、設定された間隔毎に、自動的に再構成する。
.SS "<SELECTFONT>"
.\"O.PP
.\"OThis element is used to black/white list fonts from being listed or matched
.\"Oagainst. It holds acceptfont and rejectfont elements.
.PP
この要素は、フォントの列挙やマッチのブラック/ホワイトリストを指定する。
これは、acceptfont要素とrejectfont要素を持つ。
.SS "<ACCEPTFONT>"
.\"O.PP
.\"OFonts matched by an acceptfont element are "whitelisted"; such fonts are
.\"Oexplicitly included in the set of fonts used to resolve list and match
.\"Orequests; including them in this list protects them from being "blacklisted"
.\"Oby a rejectfont element. Acceptfont elements include glob and pattern
.\"Oelements which are used to match fonts.
.PP
acceptfont要素によってマッチしたフォントに"ホワイトリスト"に登録される。
これらのフォントは、明示的に、フォントの列挙や、マッチの候補に登録される。
フォントをホワイトリストに登録する事で、rejectfont要素によって、"ブラックリスト"に登録される事を防げる。
acceptfontはglopとpattern要素を含み、これらはフォントマッチのために使われる。
.SS "<REJECTFONT>"
.\"O.PP
.\"OFonts matched by an rejectfont element are "blacklisted"; such fonts are
.\"Oexcluded from the set of fonts used to resolve list and match requests as if
.\"Othey didn't exist in the system. Rejectfont elements include glob and
.\"Opattern elements which are used to match fonts.
.PP
rejectfontにマッチしたフォントは"ブラックリスト"に登録される。
これらのフォントは、明示的に、フォントの列挙や、マッチの候補から外され、あたかも存在しないかの様に振舞う。
rejectfont要素はglobやpattern要素を含み、これらはフォントマッチのために使われる。
.SS "<GLOB>"
.\"O.PP
.\"OGlob elements hold shell-style filename matching patterns (including ? and
.\"O*) which match fonts based on their complete pathnames. This can be used to
.\"Oexclude a set of directories (/usr/share/fonts/uglyfont*), or particular
.\"Ofont file types (*.pcf.gz), but the latter mechanism relies rather heavily
.\"Oon filenaming conventions which can't be relied upon. Note that globs
.\"Oonly apply to directories, not to individual fonts.
.PP
glob要素は、shell形式のファイル名マッチングパターン(?と*を含む)を持ち、絶対パスに基づいてフォントをマッチする。
これは、特定のディレクトリの集合(/usr/share/fonts/uglyfont*)やフォントファイルの集合(*.pcf.gz)を除外するのに用いられる。
しかし、後者の使用法は、ファイル名の慣習に強く依存し、信頼して使う事は出来ない。
したがって、globはディレクトリにたいして 使うべきで、それぞれのフォントに対しては使うべきではない。
.SS "<PATTERN>"
.\"O.PP
.\"OPattern elements perform list-style matching on incoming fonts; that is,
.\"Othey hold a list of elements and associated values. If all of those
.\"Oelements have a matching value, then the pattern matches the font. This can
.\"Obe used to select fonts based on attributes of the font (scalable, bold,
.\"Oetc), which is a more reliable mechanism than using file extensions.
.\"OPattern elements include patelt elements.
.PP
pattern要素は、入って来るフォントに対して、リスト形式のマッチングを行う。
つまり、pattern要素は要素と値のリストを持つ。
もし、これらの全ての要素がマッチング値を持つ場合、パターンはフォントにマッチする。
pattern要素は、フォントの属性(scalable、bold、etc)に基づいて、フォントを選ぶために使われる。
この方法は、ファイル拡張を用いる方法よりも信頼できる。
.SS "<PATELT NAME=""PROPERTY"">"
.\"O.PP
.\"OPatelt elements hold a single pattern element and list of values. They must
.\"Ohave a 'name' attribute which indicates the pattern element name. Patelt
.\"Oelements include int, double, string, matrix, bool, charset and const
.\"Oelements.
.PP
patelt要素は単一のpattern要素と値のリストを持つ。
patelt要素は'name'属性を持ち、pattern要素の名前を指定する。
patelt要素はint、double、string、matrix、bool、charset、const要素を持てる。
.SS "<MATCH TARGET=""PATTERN"">"
.\"O.PP
.\"OThis element holds first a (possibly empty) list of <test> elements and then
.\"Oa (possibly empty) list of <edit> elements. Patterns which match all of the
.\"Otests are subjected to all the edits. If 'target' is set to "font" instead
.\"Oof the default "pattern", then this element applies to the font name
.\"Oresulting from a match rather than a font pattern to be matched. If 'target'
.\"Ois set to "scan", then this element applies when the font is scanned to
.\"Obuild the fontconfig database.
.PP
match要素は、まず、<test>要素のリスト(空も有り得る)を持ち、次に、<edit>要素のリスト(空も有り得る)を持つ。
全てのtestにマッチするpatternは全てのeditに作用される。
もし、'target'が、デフォルトの"pattern"ではなく、"font"にセットされた場合、この要素は、マッチするフォントパターンではなく、マッチの結果のフォント名に適応される。
もし、'target'が、"scan"にセットされた場合、fontconfigデータベースを構築するために、フォントが検索された時に、この要素が適応される。
.SS "<TEST QUAL=""ANY"" NAME=""PROPERTY"" TARGET=""DEFAULT"" COMPARE=""EQ"">"
.\"O.PP
.\"OThis element contains a single value which is compared with the target
.\"O('pattern', 'font', 'scan' or 'default') property "property" (substitute any of the property names seen 
.\"Oabove). 'compare' can be one of "eq", "not_eq", "less", "less_eq", "more", "more_eq", "contains" or
.\"O"not_contains". 'qual' may either be the default, "any", in which case the match
.\"Osucceeds if any value associated with the property matches the test value, or
.\"O"all", in which case all of the values associated with the property must
.\"Omatch the test value. 'ignore-blanks' takes a boolean value. if 'ignore-blanks' is set "true", any blanks in the string will be ignored on its comparison. this takes effects only when compare="eq" or compare="not_eq".
.\"OWhen used in a <match target="font"> element,
.\"Othe target= attribute in the <test> element selects between matching
.\"Othe original pattern or the font. "default" selects whichever target the
.\"Oouter <match> element has selected.
.PP
この要素は、target('pattern'、'font'、'scan'、'default')のプロパティ"property"と比較される単一の値を持つ。
\&'compare'は、"eq"、"not_eq"、"less"、"less_eq"、"more"、"more_eq"、"contains"、"not_contains"のいずれかである。
"qual"はデフォルトで、"any"である。
"any"は、いずれかのプロパティの値がtestの値と等しい時、マッチする。
"all"は、全てのプロパティの値がtestの値と等しい時、マッチする。
\&'ignore-blanks'はbool値を取る。
もし、'ignore-blanks'が"true"にセットされた時、比較の際に、文字列中の空白は無視される。
\&'ignore-blansk'は、compare="eq"、または、compare="not_eq"の時、影響する。
<match target="font">要素の中でtest要素が使われた時、test要素のtarget属性は、マッチがパターンに対して行われるか、フォントに対して行われるか選択する。
"default"の時、外側の<match>要素のtargetが選ばれる。

.SS "<EDIT NAME=""PROPERTY"" MODE=""ASSIGN"" BINDING=""WEAK"">"
.\"O.PP
.\"OThis element contains a list of expression elements (any of the value or
.\"Ooperator elements). The expression elements are evaluated at run-time and
.\"Omodify the property "property". The modification depends on whether
.\"O"property" was matched by one of the associated <test> elements, if so, the
.\"Omodification may affect the first matched value. Any values inserted into
.\"Othe property are given the indicated binding ("strong", "weak" or "same")
.\"Owith "same" binding using the value from the matched pattern element.
.\"O\&'mode' is one of:
.PP
この要素は、expression要素(値またはoperator要素)のリストを含む。
expression要素は、実行時に評価され、プロパティ"property"を変更する。
変更は、"property"が<test>要素のうちの一つにマッチするかどうかに依存し、もしマッチするなら、変更は最初のマッチした値に影響する。
プロパティに与えられた値は、binding("strong、"weak"、"same")を持ち、"same"は、パターン要素でマッチした値を用いる。
.sp
.nf
  Mode                    With Match              Without Match
  ---------------------------------------------------------------------
  "assign"                Replace matching value  Replace all values
  "assign_replace"        Replace all values      Replace all values
  "prepend"               Insert before matching  Insert at head of list
  "prepend_first"         Insert at head of list  Insert at head of list
  "append"                Append after matching   Append at end of list
  "append_last"           Append at end of list   Append at end of list
  "delete"                Delete matching value   Delete all values
  "delete_all"            Delete all values       Delete all values
    
.sp
.fi
.SS "<INT>, <DOUBLE>, <STRING>, <BOOL>"
.\"O.PP
.\"OThese elements hold a single value of the indicated type. <bool>
.\"Oelements hold either true or false. An important limitation exists in
.\"Othe parsing of floating point numbers -- fontconfig requires that
.\"Othe mantissa start with a digit, not a decimal point, so insert a leading
.\"Ozero for purely fractional values (e.g. use 0.5 instead of .5 and -0.5
.\"Oinstead of -.5).
.PP
この要素は、指定された型の単一の値を持つ。
<bool>はtrueかfalseを持つ。
重要な宣言として、浮動小数点実数のパースである。
fontconfigは仮数部が数字で始まり、浮動小数点で始まらない事を要求する。
すなわち、浮動小数点は0で始まる必要がある。
例えば、0.5や-0.5は良いが、.5や-.5は不正である。
.SS "<MATRIX>"
.\"O.PP
.\"OThis element holds the four <double> elements of an affine
.\"Otransformation.
.PP
この要素は、アフィン変換のための4つの<double>要素を持つ。
This element holds the four <double> elements of an affine
transformation.
.SS "<RANGE>"
.\"O.PP
.\"OThis element holds the two <int> elements of a range
.\"Orepresentation.
.PP
この要素は、範囲を表す二つの<int>要素を持つ。
.SS "<CHARSET>"
.\"O.PP
.\"OThis element holds at least one <int> element of
.\"Oan Unicode code point or more.
.PP
この要素は、一つ以上の、Unicodeコードポイントを表す<int>要素を持つ。
.SS "<LANGSET>"
.\"O.PP
.\"OThis element holds at least one <string> element of
.\"Oa RFC-3066-style languages or more.
.PP
この要素は、一つ以上の、RFC-3066形式の言語名を表す<string>要素を持つ。
.SS "<NAME>"
.PP
Holds a property name. Evaluates to the first value from the property of
the pattern. If the 'target' attribute is not present, it will default to
\&'default', in which case the property is returned from the font pattern
during a target="font" match, and to the pattern during a target="pattern"
match. The attribute can also take the values 'font' or 'pattern' to
explicitly choose which pattern to use. It is an error to use a target
of 'font' in a match that has target="pattern".
.PP
この要素は、プロパティ名を持つ。
パターンではなく、フォントのプロパティの最初の要素と評価される。
もし、'target'属性が存在しないならば、デフォルトで'default'と見なされ、target="font"を持つマッチからはフォントパターンが返され、target="pattern"を持つマッチからは、パターンが返される。
\&'target'属性は、明示的に'font'や'pattern'を指定する事もできる。
target="pattern"を持つマッチ中でtarget='font'を用いるのは、不正である。

.SS "<CONST>"
.\"O.PP
.\"OHolds the name of a constant; these are always integers and serve as
.\"Osymbolic names for common font values:
.PP
定数の名前を持つ。
これらは、いつも整数で、共通フォント値のシンボリック名として扱われる。
.sp
.nf
  Constant        Property        Value
  -------------------------------------
  thin            weight          0
  extralight      weight          40
  ultralight      weight          40
  light           weight          50
  demilight       weight          55
  semilight       weight          55
  book            weight          75
  regular         weight          80
  normal          weight          80
  medium          weight          100
  demibold        weight          180
  semibold        weight          180
  bold            weight          200
  extrabold       weight          205
  black           weight          210
  heavy           weight          210
  roman           slant           0
  italic          slant           100
  oblique         slant           110
  ultracondensed  width           50
  extracondensed  width           63
  condensed       width           75
  semicondensed   width           87
  normal          width           100
  semiexpanded    width           113
  expanded        width           125
  extraexpanded   width           150
  ultraexpanded   width           200
  proportional    spacing         0
  dual            spacing         90
  mono            spacing         100
  charcell        spacing         110
  unknown         rgba            0
  rgb             rgba            1
  bgr             rgba            2
  vrgb            rgba            3
  vbgr            rgba            4
  none            rgba            5
  lcdnone         lcdfilter       0
  lcddefault      lcdfilter       1
  lcdlight        lcdfilter       2
  lcdlegacy       lcdfilter       3
  hintnone        hintstyle       0
  hintslight      hintstyle       1
  hintmedium      hintstyle       2
  hintfull        hintstyle       3
    
.sp
.fi
.SS "<OR>, <AND>, <PLUS>, <MINUS>, <TIMES>, <DIVIDE>"
.\"O.PP
.\"OThese elements perform the specified operation on a list of expression
.\"Oelements. <or> and <and> are boolean, not bitwise.
.PP
これらの要素は、expression要素のリストに対して、指定された演算を施す。
<or>と<and>はブール値であって、ビット値としては行われない。
.SS "<EQ>, <NOT_EQ>, <LESS>, <LESS_EQ>, <MORE>, <MORE_EQ>, <CONTAINS>, <NOT_CONTAINS>"
.PP
.\"OThese elements compare two values, producing a boolean result.
.PP
これらの要素は二つの値を比較し、bool値を返す。
.SS "<NOT>"
.\"O.PP
.\"OInverts the boolean sense of its one expression element
.PP
この要素は、expression要素の否定を返す。
.SS "<IF>"
.\"O.PP
.\"OThis element takes three expression elements; if the value of the first is
.\"Otrue, it produces the value of the second, otherwise it produces the value
.\"Oof the third.
.PP
この要素は3つのexpression要素を取る。
もし、最初の要素の値がtrueなら、二つ目の要素の値が返され、そうでなければ、3つめの要素の値が返される。
.SS "<ALIAS>"
.\"O.PP
.\"OAlias elements provide a shorthand notation for the set of common match
.\"Ooperations needed to substitute one font family for another. They contain a
.\"O<family> element followed by optional <prefer>, <accept> and <default>
.\"Oelements. Fonts matching the <family> element are edited to prepend the
.\"Olist of <prefer>ed families before the matching <family>, append the
.\"O<accept>able families after the matching <family> and append the <default>
.\"Ofamilies to the end of the family list.
.PP
alias要素は、font familyの代入のために必要な、共通のマッチ演算のための短縮名を提供する。
これらは、<family>、<prefer>、<accept>、<default>要素をこの順番で持つ。
<family>要素にマッチを試すフォントは、<family>のマッチングが行われる前に、<prefer>の先頭に追加される。
さらに、<family>のマッチングが行われた後に、<accept>の後に追加される。
また、<default>は、familyの最後に追加される。
.SS "<FAMILY>"
.\"O.PP
.\"OHolds a single font family name
.PP
この要素は、単一のフォントファミリー名を持つ。
.SS "<PREFER>, <ACCEPT>, <DEFAULT>"
.\"O.PP
.\"OThese hold a list of <family> elements to be used by the <alias> element.
.PP
この要素は、alias要素で使われ、<family>要素のリストを持つ。
.\"O.SH "EXAMPLE CONFIGURATION FILE"
.SH 設定ファイル例 
.\"O.SS "SYSTEM CONFIGURATION FILE"
.SS システム設定ファイル 
.\"O.PP
.\"OThis is an example of a system-wide configuration file
.PP
これは、system-wideな設定ファイルの例である。
.sp
.nf
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<!-- /etc/fonts/fonts.conf file to configure system font access -->
<fontconfig>
<!-- 
	Find fonts in these directories
-->
<dir>/usr/share/fonts</dir>
<dir>/usr/X11R6/lib/X11/fonts</dir>

<!--
	Accept deprecated 'mono' alias, replacing it with 'monospace'
-->
<match target="pattern">
	<test qual="any" name="family"><string>mono</string></test>
	<edit name="family" mode="assign"><string>monospace</string></edit>
</match>

<!--
	Names not including any well known alias are given 'sans-serif'
-->
<match target="pattern">
	<test qual="all" name="family" mode="not_eq"><string>sans-serif</string></test>
	<test qual="all" name="family" mode="not_eq"><string>serif</string></test>
	<test qual="all" name="family" mode="not_eq"><string>monospace</string></test>
	<edit name="family" mode="append_last"><string>sans-serif</string></edit>
</match>

<!--
	Load per-user customization file, but don't complain
	if it doesn't exist
-->
<include ignore_missing="yes" prefix="xdg">fontconfig/fonts.conf</include>

<!--
	Load local customization files, but don't complain
	if there aren't any
-->
<include ignore_missing="yes">conf.d</include>
<include ignore_missing="yes">local.conf</include>

<!--
	Alias well known font names to available TrueType fonts.
	These substitute TrueType faces for similar Type1
	faces to improve screen appearance.
-->
<alias>
	<family>Times</family>
	<prefer><family>Times New Roman</family></prefer>
	<default><family>serif</family></default>
</alias>
<alias>
	<family>Helvetica</family>
	<prefer><family>Arial</family></prefer>
	<default><family>sans</family></default>
</alias>
<alias>
	<family>Courier</family>
	<prefer><family>Courier New</family></prefer>
	<default><family>monospace</family></default>
</alias>

<!--
	Provide required aliases for standard names
	Do these after the users configuration file so that
	any aliases there are used preferentially
-->
<alias>
	<family>serif</family>
	<prefer><family>Times New Roman</family></prefer>
</alias>
<alias>
	<family>sans</family>
	<prefer><family>Arial</family></prefer>
</alias>
<alias>
	<family>monospace</family>
	<prefer><family>Andale Mono</family></prefer>
</alias>

<--
	The example of the requirements of OR operator;
	If the 'family' contains 'Courier New' OR 'Courier'
	add 'monospace' as the alternative
-->
<match target="pattern">
	<test name="family" mode="eq">
		<string>Courier New</string>
	</test>
	<edit name="family" mode="prepend">
		<string>monospace</string>
	</edit>
</match>
<match target="pattern">
	<test name="family" mode="eq">
		<string>Courier</string>
	</test>
	<edit name="family" mode="prepend">
		<string>monospace</string>
	</edit>
</match>

</fontconfig>
    
.sp
.fi
.\"O.SS "USER CONFIGURATION FILE"
.SS ユーザー設定ファイル
.\"O.PP
.\"OThis is an example of a per-user configuration file that lives in
.\"O$XDG_CONFIG_HOME/fontconfig/fonts.conf
.PP
これは、$XDG_CONFIG_HOME/fontconfig/fonts.confにある、ユーザー毎の設定ファイルの例である。
.sp
.nf
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<!-- $XDG_CONFIG_HOME/fontconfig/fonts.conf for per-user font configuration -->
<fontconfig>

<!--
	Private font directory
-->
<dir prefix="xdg">fonts</dir>

<!--
	use rgb sub-pixel ordering to improve glyph appearance on
	LCD screens.  Changes affecting rendering, but not matching
	should always use target="font".
-->
<match target="font">
	<edit name="rgba" mode="assign"><const>rgb</const></edit>
</match>
<!--
	use WenQuanYi Zen Hei font when serif is requested for Chinese
-->
<match>
	<!--
		If you don't want to use WenQuanYi Zen Hei font for zh-tw etc,
		you can use zh-cn instead of zh.
		Please note, even if you set zh-cn, it still matches zh.
		if you don't like it, you can use compare="eq"
		instead of compare="contains".
	-->
	<test name="lang" compare="contains">
		<string>zh</string>
	</test>
	<test name="family">
		<string>serif</string>
	</test>
	<edit name="family" mode="prepend">
		<string>WenQuanYi Zen Hei</string>
	</edit>
</match>
<!--
	use VL Gothic font when sans-serif is requested for Japanese
-->
<match>
	<test name="lang" compare="contains">
		<string>ja</string>
	</test>
	<test name="family">
		<string>sans-serif</string>
	</test>
	<edit name="family" mode="prepend">
		<string>VL Gothic</string>
	</edit>
</match>
</fontconfig>
    
.sp
.fi
.SH ファイル
.\"O.PP
.\"O\fBfonts.conf\fR
.\"Ocontains configuration information for the fontconfig library
.\"Oconsisting of directories to look at for font information as well as
.\"Oinstructions on editing program specified font patterns before attempting to
.\"Omatch the available fonts. It is in xml format.
.PP
\fBfonts.conf\fR
このファイルは、fontconfigライブラリのための設定を含み、フォント情報を探すためのディレクトリを含む。
また、フォントに対してマッチを行う前に、指定されたフォントパターンに対して、プログラムを編集するためのインストラクションも含まれる。
これは、XML形式である。
.\"O.PP
.\"O\fBconf.d\fR
.\"Ois the conventional name for a directory of additional configuration files
.\"Omanaged by external applications or the local administrator. The
.\"Ofilenames starting with decimal digits are sorted in lexicographic order
.\"Oand used as additional configuration files. All of these files are in xml
.\"Oformat. The master fonts.conf file references this directory in an 
.\"O<include> directive.
.PP
\fBconf.d\fRは、外部アプリケーションや、ローカル管理者に管理される、追加の設定ファイルのディレクトリの慣習名。
10進数文字列で始まるファイル名は、辞書式順序でソートされ、追加の設定ファイルとして使用される。
これらのファイルは、全てXML形式である。
fonts.confファイルは、<include>ディレクティブによって、このディレクトリを指定する。
.\"O.PP
.\"O\fBfonts.dtd\fR
.\"Ois a DTD that describes the format of the configuration files.
.PP
\fBfonts.dtd\fRは、設定ファイルのフォーマットを記述するDocument Type Definition文書。
.\"O.PP
.\"O\fB$XDG_CONFIG_HOME/fontconfig/conf.d\fR and \fB~/.fonts.conf.d\fR
.\"Ois the conventional name for a per-user directory of (typically
.\"Oauto-generated) configuration files, although the
.\"Oactual location is specified in the global fonts.conf file. please note that ~/.fonts.conf.d is deprecated now. it will not be read by default in the future version.
.PP
\fB$XDG_CONFIG_HOME/fontconfig/conf.d\fR と \fB~/.fonts.conf.d\fRは、ユーザー毎の設定ファイルのディレクトリの慣習名であり、普通は自動生成される。
実際の位置は、fonts.confファイルで指定される。
~/.fonts.conf.dは現在、非推奨である。
将来的には、~/.fonts.conf.dはデフォルトでは読み込まれなくなる。
.\"O.PP
.\"O\fB$XDG_CONFIG_HOME/fontconfig/fonts.conf\fR and \fB~/.fonts.conf\fR
.\"Ois the conventional location for per-user font configuration, although the
.\"Oactual location is specified in the global fonts.conf file. please note that ~/.fonts.conf is deprecated now. it will not be read by default in the future version.
.PP
\fB$XDG_CONFIG_HOME/fontconfig/fonts.conf\fR と \fB~/.fonts.conf\fRは、ユーザー毎の設定ファイルの慣習的な位置。
実際の位置は、fonts.confで指定される。
~/.fonts.confは現在、非推奨である。
将来的には、~/.fonts.confはデフォルトで読み込まれなくなる。
.\"O.PP
.\"O\fB$XDG_CACHE_HOME/fontconfig/*.cache-*\fR and \fB ~/.fontconfig/*.cache-*\fR
.\"Ois the conventional repository of font information that isn't found in the
.\"Oper-directory caches. This file is automatically maintained by fontconfig. please note that ~/.fontconfig/*.cache-* is deprecated now. it will not be read by default in the future version.
.PP
\fB$XDG_CACHE_HOME/fontconfig/*.cache-*\fR と \fB ~/.fontconfig/*.cache-*\fRは、ディレクトリ毎のキャッシュ中に見つからないフォント情報の慣習的なレポジトリ。
このファイルはfontconfigに、自動的に管理される。
~/.fontconfig/*.cache-*は現在、非推奨である。
将来的に、~/.fontconfig/*.cache-*はデフォルトで読み込まれなくなる。
.\"O.SH "ENVIRONMENT VARIABLES"
.SH 環境変数 
.\"O.PP
.\"O\fBFONTCONFIG_FILE\fR
.\"Ois used to override the default configuration file.
.PP
\fBFONTCONFIG_FILE\fRは、デフォルトの設定ファイルをオーバーライドするのに使われる。
.\"O.PP
.\"O\fBFONTCONFIG_PATH\fR
.\"Ois used to override the default configuration directory.
.PP
\fBFONTCONFIG_PATH\fRは、デフォルトの設定ディレクトリをオーバーライドするのに使われる。
.\"O.PP
.\"O\fBFC_DEBUG\fR
.\"Ois used to output the detailed debugging messages. see Debugging Applications section for more details.
.PP
\fBFC_DEBUG\fRは、デバッグメッセージの出力を制御するのに使われる。
アプリケーションデバッグを参照せよ。
.\"O.PP
.\"O\fBFONTCONFIG_USE_MMAP\fR
.\"Ois used to control the use of mmap(2) for the cache files if available. this take a boolean value. fontconfig will checks if the cache files are stored on the filesystem that is safe to use mmap(2). explicitly setting this environment variable will causes skipping this check and enforce to use or not use mmap(2) anyway.
.PP
\fBFONTCONFIG_USE_MMAP\fRは、キャッシュファイルに対するmmap(2)の使い方を制御する。
この環境変数はbool値である。
fontconfigは、ファイルシステムにおけるキャッシュファイルに対して、mmap(2)の使用が安全かどうかをチェックする。
この環境変数をセットする事で、安全性のチェックをスキップし、mmap(2)の使用・不使用を強制できる。
.SH 関連項目
.PP
fc-cat(1), fc-cache(1), fc-list(1), fc-match(1), fc-query(1)
.SH バージョン
.PP
Fontconfig version 2.11.93



linuxjm-discuss メーリングリストの案内
Back to archive index