source: xsoft/office/abiword.xml@ d60cd837

elogind
Last change on this file since d60cd837 was d60cd837, checked in by DJ Lucas <dj@…>, 5 years ago

Merge to HEAD 21080.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/BOOK-elogind@21081 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 12.9 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 AbiWord-minor-version "3.0">
8
9 <!ENTITY AbiWord-download-http
10 "http://www.abisource.com/downloads/abiword/&AbiWord-version;/source/abiword-&AbiWord-version;.tar.gz">
11 <!ENTITY AbiWord-download-ftp " ">
12 <!ENTITY AbiWord-md5sum "cda6dd58c747c133b421cc7eb18f5796">
13 <!ENTITY AbiWord-size "11 MB">
14
15 <!ENTITY AbiWordDocs-download-http
16 "http://www.abisource.com/downloads/abiword/&AbiWord-version;/source/abiword-docs-&AbiWord-version;.tar.gz">
17 <!ENTITY AbiWordDocs-md5sum "c92c0e1e2081db20757231a53d80c338">
18 <!ENTITY AbiWordDocs-size "1.5 MB">
19
20 <!ENTITY AbiWord-buildsize "626 MB, additional 12 MB for docs (73 MB installed - additional 3.1 MB for docs)">
21 <!ENTITY AbiWord-time "6.5 SBU - additional 0.5 SBU for docs">
22]>
23
24<sect1 id="abiword" xreflabel="AbiWord-&AbiWord-version;">
25 <?dbhtml filename="AbiWord.html" ?>
26
27 <sect1info>
28 <othername>$LastChangedBy$</othername>
29 <date>$Date$</date>
30 </sect1info>
31
32 <title>AbiWord-&AbiWord-version;</title>
33
34 <indexterm zone="abiword">
35 <primary sortas="a-AbiWord">AbiWord</primary>
36 </indexterm>
37
38 <sect2 role="package">
39 <title>Introduction to AbiWord</title>
40
41 <para>
42 <application>AbiWord</application> is a word processor which is useful for
43 writing reports, letters and other formatted documents.
44 </para>
45
46 <!-- https://bugzilla.abisource.com/show_bug.cgi?id=13791. Fixed upstream
47 <note>
48 <para>
49 It has been reported that, depending on the desktop enviroment and on
50 the theme settings, the window where <application>Abiword</application>
51 is running may flicker. This is known uptream, but no fix seems to be
52 available yet.
53 </para>
54 </note>
55-->
56 &lfs83_checked;
57
58 <bridgehead renderas="sect3">Package Information</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>
62 Download (HTTP): <ulink url="&AbiWord-download-http;"/>
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download (FTP): <ulink url="&AbiWord-download-ftp;"/>
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Download MD5 sum: &AbiWord-md5sum;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Download size: &AbiWord-size;
78 </para>
79 </listitem>
80 <listitem>
81 <para>
82 Estimated disk space required: &AbiWord-buildsize;
83 </para>
84 </listitem>
85 <listitem>
86 <para>
87 Estimated build time: &AbiWord-time;
88 </para>
89 </listitem>
90 </itemizedlist>
91
92 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
93 <itemizedlist spacing="compact">
94 <listitem>
95 <para>
96 AbiWord Docs: <ulink url="&AbiWordDocs-download-http;"/>
97 </para>
98 </listitem>
99 <listitem>
100 <para>
101 AbiWord Docs MD5 sum: &AbiWordDocs-md5sum;
102 </para>
103 </listitem>
104 <listitem>
105 <para>
106 AbiWord Docs size: &AbiWordDocs-size;
107 </para>
108 </listitem>
109 <listitem>
110 <para>
111 Required patch (fixes GTK+-3.22.x rendering):
112 <ulink url="&patch-root;/abiword-&AbiWord-version;-gtk3_22_render_fix-1.patch"/>
113 </para>
114 </listitem>
115 <listitem>
116 <para>
117 Recommended patch (fixes flickering and caret problems):
118 <ulink url="&patch-root;/abiword-&AbiWord-version;-fix_flicker-1.patch"/>
119 </para>
120 </listitem>
121 </itemizedlist>
122
123 <bridgehead renderas="sect3">AbiWord Dependencies</bridgehead>
124
125 <bridgehead renderas="sect4">Required</bridgehead>
126 <para role="required">
127 <xref linkend="boost"/>,
128 <xref linkend="fribidi"/>,
129 <xref linkend="goffice010"/>, and
130 <xref linkend="wv"/>
131 </para>
132
133 <bridgehead renderas="sect4">Recommended</bridgehead>
134 <para role="recommended">
135 <xref linkend="enchant"/>
136 </para>
137
138 <bridgehead renderas="sect4">Optional</bridgehead>
139 <para role="optional">
140 <xref linkend="dbus-glib"/>,
141 <xref linkend="gobject-introspection"/>,
142 <xref linkend="libgcrypt"/>,
143 <xref linkend="libical"/>,
144 <xref linkend="libsoup"/>,
145 <xref linkend="redland"/>,
146 <xref linkend="valgrind"/>.
147 <ulink url="http://aiksaurus.sourceforge.net/">Aiksaurus</ulink>,
148 <phrase revision="sysv"><ulink url="&gnome-download-http;/evolution-data-server/">
149 Evolution Data Server</ulink></phrase>
150 <phrase revision="systemd"><xref linkend="evolution-data-server"/></phrase>,
151 <ulink url="http://helm.cs.unibo.it/mml-widget/">GtkMathView</ulink>,
152 <phrase revision="sysv"><ulink url="&gnome-download-http;/libchamplain">libchamplain</ulink></phrase>
153 <phrase revision="systemd"><xref linkend="libchamplain"/></phrase>,
154 <ulink url="http://sourceforge.net/projects/wvware">libwmf</ulink>,
155 <ulink url="http://sourceforge.net/projects/libwpd/">libwpd</ulink>,
156 <ulink url="http://sourceforge.net/projects/libwpg/">libwpg</ulink>,
157 <ulink url="http://sourceforge.net/projects/libwps/">libwps</ulink>,
158 <ulink url="http://www.abisource.com/projects/link-grammar/">
159 Link Grammar Parser</ulink>,
160 <ulink url="&gnome-download-http;/loudmouth">Loudmouth</ulink>,
161 <phrase revision="sysv"><ulink url="http://telepathy.freedesktop.org/releases/telepathy-glib/">
162 Telepathy GLib</ulink></phrase>
163 <phrase revision="systemd"><xref linkend="telepathy-glib"/></phrase>,
164 <ulink url="https://sourceforge.net/projects/otslibrary/">OTS</ulink>, and
165 <ulink url="http://software.frodo.looijaard.name/psiconv/">Psiconv</ulink>
166 </para>
167
168 <note>
169 <para>
170 To enable many of the optional dependencies, review the information
171 from <command>./configure --help</command> for the necessary switches
172 you must pass to the <command>configure</command> script.
173 </para>
174 </note>
175
176
177 <para condition="html" role="usernotes">
178 User Notes: <ulink url="&blfs-wiki;/abiword"/>
179 </para>
180 </sect2>
181
182 <sect2 role="installation">
183 <title>Installation of AbiWord</title>
184
185 <para>
186 Install <application>AbiWord</application> by running the following
187 commands:
188 </para>
189
190<screen><userinput>patch -Np1 -i ../abiword-&AbiWord-version;-gtk3_22_render_fix-1.patch &amp;&amp;
191
192patch -Np1 -i ../abiword-&AbiWord-version;-fix_flicker-1.patch &amp;&amp;
193
194sed -e "s/free_suggestions/free_string_list/" \
195 -e "s/_to_personal//" \
196 -e "s/in_session/added/" \
197 -i src/af/xap/xp/enchant_checker.cpp &amp;&amp;
198
199sed -e "/icaltime_from_timet/{s/timet/&amp;_with_zone/;s/0/0, 0/}" \
200 -i src/text/ptbl/xp/pd_DocumentRDF.cpp &amp;&amp;
201
202./configure --prefix=/usr --without-evolution-data-server &amp;&amp;
203make</userinput></screen>
204
205 <para>
206 This program does not come with a functional test suite.
207 </para>
208
209 <para>
210 Now, as the <systemitem class="username">root</systemitem> user:
211 </para>
212
213<screen role="root"><userinput>make install</userinput></screen>
214
215 <note>
216 <para>
217 In order to install the local help files,
218 a graphics session is recommended.
219 </para>
220 </note>
221
222 <para>
223 If you wish to install the local help files, untar and build them first:
224 </para>
225
226<!-- I had to hardcode the docs version here, as it doesn't decompress to
227 abiword-docs-3.0.2. -->
228<screen><userinput>tar -xf ../abiword-docs-&AbiWord-version;.tar.gz &amp;&amp;
229cd abiword-docs-3.0.1 &amp;&amp;
230./configure --prefix=/usr &amp;&amp;
231make</userinput></screen>
232
233 <para>
234 and then, as the <systemitem class="username">root</systemitem> user:
235 </para>
236
237<screen role="root"><userinput>make install</userinput></screen>
238
239 </sect2>
240
241 <sect2 role="commands">
242 <title>Command Explanations</title>
243
244 <para>
245 <command>sed ...</command>: These commands correct the source for
246 changes in dependencies <xref linkend="enchant"/> and
247 <xref linkend="libical"/>.
248 </para>
249
250 <para>
251 <option>--without-evolution-data-server</option>: This switch disables
252 <application>AbiWord</application>
253 <application>Evolution Data Server</application> support which is known
254 to fail when using recent versions of
255 <application>Evolution Data Server</application>.
256 </para>
257
258 <para>
259 <option>--enable-plugins="collab openxml goffice grammar"</option>: Build
260 some or all plugins. The openxml plugin enables
261 <application>Abiword</application> to open some .docx files.
262 The grammar plugin requires
263 <ulink url="http://www.abisource.com/projects/link-grammar/">Link Grammar
264 Parser</ulink>
265 </para>
266
267 </sect2>
268
269 <sect2 role="configuration">
270 <title>Configuring AbiWord</title>
271
272 <sect3 id="abiword-config">
273 <title>Config File</title>
274
275 <para>
276 <filename>~/.AbiSuite/templates/normal.awt</filename>
277 </para>
278
279 <indexterm zone="abiword abiword-config">
280 <primary sortas="e-AA.AbiSuite-templates-normal">~/.AbiSuite/templates/normal.awt</primary>
281 </indexterm>
282 </sect3>
283
284 <sect3>
285 <title>Configuration Information</title>
286
287 <para>
288 Choose the right template for your language and locale from the list
289 produced by the following command:
290 </para>
291
292<screen><userinput>ls /usr/share/abiword-&AbiWord-minor-version;/templates</userinput></screen>
293
294 <para>
295 Create the folder
296 <filename class='directory'>~/.AbiSuite/templates</filename> then copy
297 the <filename>normal.awt</filename> you want into it:
298 </para>
299
300<screen><userinput>install -v -m750 -d ~/.AbiSuite/templates &amp;&amp;
301install -v -m640 /usr/share/abiword-&AbiWord-minor-version;/templates/normal.awt-<replaceable>&lt;lang&gt;</replaceable> \
302 ~/.AbiSuite/templates/normal.awt</userinput></screen>
303
304 <para>
305 Change <replaceable>&lt;lang&gt;</replaceable> by the above command to
306 fit the name of the file you want.
307 </para>
308
309 <para>
310 If you are using multiple languages, you may need to edit the template
311 to use a font with greater coverage (e.g. one of the
312 <xref linkend="dejavu-fonts"/>,
313 <!--
314 <ulink url="http://dejavu.sourceforge.net/">DejaVu fonts</ulink>), -->
315 because <application>Abiword</application> does not use
316 <application>fontconfig</application> and can only display glyphs that
317 are provided in the chosen font.
318 </para>
319
320 <para>
321 If you have <xref linkend="desktop-file-utils"/> installed, you should
322 run the <command>update-desktop-database</command> command to update the
323 mimeinfo cache and allow the Help system to work.
324 </para>
325
326 <para>
327 If you have <xref linkend="xdg-utils"/> installed, you should
328 run the <command>xdg-icon-resource forceupdate --theme hicolor</command>
329 command, for the installed icon to be displayed in the menu item.
330 </para>
331
332 </sect3>
333
334 </sect2>
335
336 <sect2 role="content">
337 <title>Contents</title>
338
339 <segmentedlist>
340 <segtitle>Installed Program</segtitle>
341 <segtitle>Installed Library</segtitle>
342 <segtitle>Installed Directories</segtitle>
343
344 <seglistitem>
345 <seg>
346 abiword
347 </seg>
348 <seg>
349 libabiword-&AbiWord-minor-version;.so
350 </seg>
351 <seg>
352 /usr/include/abiword-&AbiWord-minor-version;,
353 /usr/lib/abiword-&AbiWord-minor-version;, and
354 /usr/share/abiword-&AbiWord-minor-version;
355 </seg>
356 </seglistitem>
357 </segmentedlist>
358
359 <variablelist>
360 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
361 <?dbfo list-presentation="list"?>
362 <?dbhtml list-presentation="table"?>
363
364 <varlistentry id="abiword-prog">
365 <term><command>abiword</command></term>
366 <listitem>
367 <para>
368 is the word processor, a wrapper for the functions in
369 libabiword-&AbiWord-minor-version; - it can also be used on the
370 command line, see <command>man 1 abiword</command>.
371 </para>
372 <indexterm zone="abiword abiword-prog">
373 <primary sortas="b-abiword">abiword</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="libabiword">
379 <term><filename class="libraryfile">libabiword-&AbiWord-minor-version;.so</filename></term>
380 <listitem>
381 <para>
382 provides functions to access MS Word documents.
383 </para>
384 <indexterm zone="abiword libabiword">
385 <primary sortas="c-libabiword">libabiword-&AbiWord-minor-version;.so</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389
390 </variablelist>
391
392 </sect2>
393
394</sect1>
Note: See TracBrowser for help on using the repository browser.