source: xsoft/office/abiword.xml@ 8b0496b

10.0 10.1 11.0 8.4 9.0 9.1 bdubbs/svn elogind ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 8b0496b was 8b0496b, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Various fixes and comments from my last build

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

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