source: general/graphlib/graphite2.xml@ f012b72

10.0 10.1 11.0 8.4 9.0 9.1 bdubbs/svn ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f012b72 was f012b72, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to LMDB_0.9.23.
Update to harfbuzz-2.3.0.
Update to graphite2-1.3.13.
Update to cups-filters-1.21.6.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@20916 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY graphite2-download-http
8 "https://github.com/silnrsi/graphite/releases/download/&graphite2-version;/graphite2-&graphite2-version;.tgz">
9 <!ENTITY graphite2-download-ftp " ">
10 <!ENTITY graphite2-md5sum "29616d4f9651706036ca25c111508272">
11 <!ENTITY graphite2-size "6.4 MB">
12 <!ENTITY graphite2-buildsize "27 MB (with tests add docs)">
13 <!ENTITY graphite2-time "0.2 SBU (with tests and docs)">
14]>
15
16<sect1 id="graphite2" xreflabel="Graphite2-&graphite2-version;">
17 <?dbhtml filename="graphite2.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Graphite2-&graphite2-version;</title>
25
26 <indexterm zone="graphite2">
27 <primary sortas="a-Graphite2">Graphite2</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Graphite2</title>
32
33 <para>
34 <application>Graphite2</application> is a rendering engine for graphite
35 fonts. These are TrueType fonts with additional tables containing smart
36 rendering information and were originally developed to support complex
37 non-Roman writing systems. They may contain rules for e.g. ligatures,
38 glyph substitution, kerning, justification - this can make them useful
39 even on text written in Roman writing systems such as English. Note that
40 <application>firefox</application> by default provides an internal copy of
41 the graphite engine and cannot use a system version (although it can now
42 be patched to use it), but it too should benefit from the availability of
43 graphite fonts.
44 </para>
45
46 &lfs83_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&graphite2-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&graphite2-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &graphite2-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &graphite2-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &graphite2-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &graphite2-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Graphite2 Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="cmake"/>
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="freetype2"/>,
92 <xref linkend="python2"/>, and
93 <ulink url="http://sourceforge.net/projects/silgraphite/files/silgraphite/2.3.1/">silgraphite</ulink>
94 to build the <command>comparerender</command> test and benchmarking tool,
95 and if that is present,
96 <xref linkend="harfbuzz"/> to add more functionality to it (this is a
97 circular dependency, you would need to first build
98 <application>graphite2</application> without
99 <application>harfbuzz</application>).
100 </para>
101
102 <para>To build the documentation:
103 <xref linkend="asciidoc"/>,
104 <xref linkend="doxygen"/>,
105 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>), and
106 <ulink url="http://dblatex.sourceforge.net/">
107 dblatex</ulink> (for PDF docs)
108 </para>
109
110 <para>To execute the test suite you will need
111 <ulink url="https://pypi.python.org/pypi/FontTools">FontTools</ulink>
112 (Python 2 module), otherwise, the "cmp" tests fail.
113 </para>
114
115 <bridgehead renderas="sect4">Optional (at runtime)</bridgehead>
116 <para role="optional">
117 You will need at least one suitable <ulink role="runtime"
118 url="http://scripts.sil.org/cms/scripts/page.php?site_id=projects&amp;item_id=graphite_fonts">graphite font</ulink>
119 for the package to be useful.
120 </para>
121
122 <para condition="html" role="usernotes">
123 User Notes: <ulink url="&blfs-wiki;/graphite2"/>
124 </para>
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of Graphite2</title>
129
130 <para>
131 Some tests fail if
132 <ulink url="https://pypi.python.org/pypi/FontTools">FontTools</ulink>
133 (Python 2 module) is not installed. These tests can be removed with:
134 </para>
135
136<screen><userinput>sed -i '/cmptest/d' tests/CMakeLists.txt</userinput></screen>
137
138 <para>
139 Install <application>Graphite2</application> by running the following
140 commands:
141 </para>
142
143<screen><userinput>mkdir build &amp;&amp;
144cd build &amp;&amp;
145
146cmake -DCMAKE_INSTALL_PREFIX=/usr .. &amp;&amp;
147make</userinput></screen>
148
149 <para>
150 If you wish to build the documentation, issue:
151 </para>
152
153<screen><userinput>make docs</userinput></screen>
154
155 <para>
156 To test the results, issue: <command>make test</command>.
157 </para>
158
159 <para>
160 Now, as the <systemitem class="username">root</systemitem> user:
161 </para>
162
163<screen role="root"><userinput>make install</userinput></screen>
164
165 <para>
166 If you built the documentation, install, as the
167 <systemitem class="username">root</systemitem> user:
168 </para>
169
170<screen role="root"><userinput>install -v -d -m755 /usr/share/doc/graphite2-&graphite2-version; &amp;&amp;
171<!-- doc/doxygen seems to have gone, so I removed the api dir, but now both html
172and pdf for the GTF and the manual
173cp -v -r -f doc/doxygen/{html,latex/refman.pdf} \
174 /usr/share/doc/graphite2-&graphite2-version;/api &amp;&amp;-->
175cp -v -f doc/{GTF,manual}.html \
176 /usr/share/doc/graphite2-&graphite2-version; &amp;&amp;
177cp -v -f doc/{GTF,manual}.pdf \
178 /usr/share/doc/graphite2-&graphite2-version;</userinput></screen>
179
180 </sect2>
181
182 <sect2 role="commands">
183 <title>Command Explanations</title>
184
185 <para><option>-DCMAKE_VERBOSE_MAKEFILE=ON</option>: This switch turns on
186 build verbose mode.</para>
187
188 </sect2>
189
190 <sect2 role="content">
191 <title>Contents</title>
192
193 <segmentedlist>
194 <segtitle>Installed Programs</segtitle>
195 <segtitle>Installed Libraries</segtitle>
196 <segtitle>Installed Directories</segtitle>
197
198 <seglistitem>
199 <seg>
200 gr2fonttest, and optionally comparerender
201 </seg>
202 <seg>
203 libgraphite2.so
204 </seg>
205 <seg>
206 /usr/{include,share}/graphite2 and optionally
207 /usr/share/doc/graphite2-&graphite2-version;
208 </seg>
209 </seglistitem>
210 </segmentedlist>
211
212 <variablelist>
213 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
214 <?dbfo list-presentation="list"?>
215 <?dbhtml list-presentation="table"?>
216
217 <varlistentry id="comparerender">
218 <term><command>comparerender</command></term>
219 <listitem>
220 <para>
221 is a test and benchmarking tool.
222 </para>
223 <indexterm zone="graphite2 comparerender">
224 <primary sortas="b-comparerender">comparerender</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="gr2fonttest">
230 <term><command>gr2fonttest</command></term>
231 <listitem>
232 <para>
233 is a diagnostic console tool for graphite fonts.
234 </para>
235 <indexterm zone="graphite2 gr2fonttest">
236 <primary sortas="b-gr2fonttest">gr2fonttest</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="libgraphite2">
242 <term><filename class="libraryfile">libgraphite2.so</filename></term>
243 <listitem>
244 <para>
245 is a rendering engine for graphite fonts.
246 </para>
247 <indexterm zone="graphite2 libgraphite2">
248 <primary sortas="c-libgraphite2">libgraphite2.so</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 </variablelist>
254
255 </sect2>
256
257</sect1>
Note: See TracBrowser for help on using the repository browser.