source: xsoft/office/libreoffice.xml@ 64135787

kde5-14269
Last change on this file since 64135787 was 64135787, checked in by Xi Ruoyao <xry111@…>, 18 months ago

Begin manually (while modifying stuff) merging trunk and systemd branches since revision 14087.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/kde5@14270 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 22.4 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 libreoffice-dl "http://download.documentfoundation.org/libreoffice/src/&libreoffice-version;">
8
9 <!ENTITY libreoffice-core-download-http "&libreoffice-dl;/libreoffice-&libreoffice-dlversion;.tar.xz">
10 <!ENTITY libreoffice-core-md5sum "cf750c01b6cd0b5c6fdd1760672e67d4">
11 <!ENTITY libreoffice-core-size "146 MB">
12
13 <!ENTITY libreoffice-dict-download-http "&libreoffice-dl;/libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz">
14 <!ENTITY libreoffice-dict-md5sum "aae27f6c9db741c42acae48a1dfb0f5e">
15 <!ENTITY libreoffice-dict-size "36 MB">
16
17 <!ENTITY libreoffice-help-download-http "&libreoffice-dl;/libreoffice-help-&libreoffice-dlversion;.tar.xz">
18 <!ENTITY libreoffice-help-md5sum "24692bf69bbe877ad2524653c991705a">
19 <!ENTITY libreoffice-help-size "1.8 MB">
20
21 <!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
22 <!ENTITY libreoffice-translations-md5sum "b8d3445100c10bb4f21f6c8f25c5c600">
23 <!ENTITY libreoffice-translations-size "121 MB">
24
25 <!ENTITY libreoffice-buildsize "8.1 GB (497 MB installed)">
26 <!ENTITY libreoffice-time "200 SBU">
27]>
28
29<sect1 id="libreoffice" xreflabel="LibreOffice-&libreoffice-version;">
30 <?dbhtml filename="libreoffice.html"?>
31
32 <sect1info>
33 <othername>$LastChangedBy$</othername>
34 <date>$Date$</date>
35 </sect1info>
36
37 <title>LibreOffice-&libreoffice-version;</title>
38
39 <indexterm zone="libreoffice">
40 <primary sortas="a-LibreOffice">LibreOffice</primary>
41 </indexterm>
42
43 <sect2 role="package">
44 <title>Introduction to LibreOffice</title>
45
46 <para>
47 <application>LibreOffice</application> is a full-featured office suite.
48 It is largely compatible with <application>Microsoft Office</application>
49 and is descended from <application>OpenOffice.org</application>.
50 </para>
51
52 &lfs76_checked;
53
54 <bridgehead renderas="sect3">Package Information</bridgehead>
55 <itemizedlist spacing="compact">
56 <listitem>
57 <para>
58 Core Download: <ulink url="&libreoffice-core-download-http;"/>
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Core Download MD5 sum: &libreoffice-core-md5sum;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Core Download size: &libreoffice-core-size;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated disk space required: &libreoffice-buildsize;
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Estimated build time: &libreoffice-time;
79 </para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
84 <itemizedlist spacing="compact">
85 <listitem>
86 <para>
87 Dictionaries: <ulink url="&libreoffice-dict-download-http;"/>
88 </para>
89 </listitem>
90 <listitem>
91 <para>
92 Dictionaries MD5 sum: &libreoffice-dict-md5sum;
93 </para>
94 </listitem>
95 <listitem>
96 <para>
97 Dictionaries size: &libreoffice-dict-size;
98 </para>
99 </listitem>
100 <listitem>
101 <para>
102 Help Files: <ulink url="&libreoffice-help-download-http;"/>
103 </para>
104 </listitem>
105 <listitem>
106 <para>
107 Help Files MD5 sum: &libreoffice-help-md5sum;
108 </para>
109 </listitem>
110 <listitem>
111 <para>
112 Help Files size: &libreoffice-help-size;
113 </para>
114 </listitem>
115 <listitem>
116 <para>
117 Translations: <ulink url="&libreoffice-translations-download-http;"/>
118 </para>
119 </listitem>
120 <listitem>
121 <para>
122 Translations MD5 sum: &libreoffice-translations-md5sum;
123 </para>
124 </listitem>
125 <listitem>
126 <para>
127 Translations size: &libreoffice-translations-size;
128 </para>
129 </listitem>
130 <listitem>
131 <para>
132 Required patch to fix building with system Boost:
133 <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-boost_1_56_0-1.patch"/>
134 </para>
135 </listitem>
136 <listitem>
137 <para>
138 Required patch to fix building on i686 systems:
139 <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-gcc_4_9_0-1.patch"/>
140 </para>
141 </listitem>
142 </itemizedlist>
143
144 <bridgehead renderas="sect3">LibreOffice Dependencies</bridgehead>
145
146 <bridgehead renderas="sect4">Required</bridgehead>
147 <para role="required">
148 <xref linkend="perl-archive-zip"/>,
149 <xref linkend="unzip"/>,
150 <xref linkend="wget"/>,
151 <xref linkend="which"/>, and
152 <xref linkend="zip"/>
153 </para>
154
155 <bridgehead renderas="sect4">Recommended</bridgehead>
156 <note>
157 <para>
158 Most of these packages are recommended because if they're not installed,
159 the build process will compile and install its own (often older)
160 version. If you have not installed some of the dependencies listed below,
161 make sure you examine the <command>./configure --help</command> output
162 for information on switches needed to prevent
163 <command>./configure</command> to look for them.
164 </para>
165 </note>
166
167 <para role="recommended">
168 <xref linkend="boost"/>,
169 <xref linkend="clucene"/>,
170 <xref linkend="cups"/>,
171 <xref linkend="curl"/>,
172 <xref linkend="dbus-glib"/>,
173 <xref linkend="glu"/>,
174 <xref linkend="graphite2"/>,
175 <xref linkend="gst-plugins-base"/> or
176 <xref linkend="gst10-plugins-base"/>,
177 <xref linkend="gtk2"/>,
178 <xref linkend="harfbuzz"/>,
179 <xref linkend="icu"/>,
180 <xref linkend="lcms2"/>,
181 <xref linkend="libatomic_ops"/>,
182 <xref linkend="libjpeg"/>,
183 <xref linkend="librsvg"/>,
184 <xref linkend="libxml2"/> and
185 <xref linkend="libxslt"/>,
186 <xref linkend="mesalib"/>,
187 <xref linkend="neon"/>,
188 <xref linkend="npapi-sdk"/>,
189 <xref linkend="nss"/>,
190 <xref linkend="openldap"/> (client only),
191 <xref linkend="openssl"/>,
192 <xref linkend="poppler"/>,
193 <xref linkend="python3"/> (used to build the translations),
194 <xref linkend="redland"/>, and
195 <xref linkend="unixodbc"/>
196 </para>
197
198 <bridgehead renderas="sect4">Optional</bridgehead>
199 <para role="optional">
200 <xref linkend="avahi"/>,
201 <xref linkend="bluez"/>,
202 <xref linkend="doxygen"/> (not relevant if using --disable-odk),
203 <xref linkend="gdb"/>,
204 <xref linkend="gtk3"/>,
205 <xref linkend="kdelibs"/>,
206 <xref linkend="mariadb"/>,
207 <xref linkend="mitkrb"/>,
208 <xref linkend="openjdk"/>,
209 <xref linkend="postgresql"/>,
210 <xref linkend="sane"/>,
211 <xref linkend="vlc"/>,
212 <xref linkend="zenity"/>,
213 <ulink url="http://sourceforge.net/projects/cppunit/">Cppunit</ulink>,
214 <ulink url="http://www.firebirdsql.org/">Firebird</ulink>,
215 <ulink url="http://sourceforge.net/projects/glew/">GLEW</ulink>,
216 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
217 <ulink url="http://sourceforge.net/projects/hunspell/files/Hyphen/">Hyphen</ulink>,
218 <ulink url="http://www.freedesktop.org/wiki/Software/libabw/">libabw</ulink>,
219 <ulink url="http://www.freedesktop.org/wiki/Software/libcdr/">libcdr</ulink>,
220 <ulink url="http://sourceforge.net/projects/libcmis/">libcmis</ulink>,
221 <ulink url="http://www.sourceforge.net/projects/libebook/">libebook</ulink>,
222 <ulink url="http://www.freedesktop.org/wiki/Software/libexttextcat/">libexttextcat</ulink>,
223 <ulink url="http://www.freedesktop.org/wiki/Software/libfreehand/">libfreehand</ulink>,
224 <ulink url="http://tagoh.bitbucket.org/liblangtag/">liblangtag</ulink>,
225 <ulink url="http://www.freedesktop.org/wiki/Software/libmspub/">libmspub</ulink>,
226 <ulink url="http://sourceforge.net/projects/libmwaw/">libmwaw</ulink>,
227 <ulink url="http://sourceforge.net/projects/libwpd/files/libodfgen/">libodfgen</ulink>,
228 <ulink url="http://sourceforge.net/projects/libwpd/files/librevenge/">librevenge</ulink>,
229 <ulink url="http://www.freedesktop.org/wiki/Software/libvisio/">libvisio</ulink>,
230 <ulink url="http://libwpd.sourceforge.net/">libwpd</ulink>,
231 <ulink url="http://libwpg.sourceforge.net/">libwpg</ulink>,
232 <ulink url="http://libwps.sourceforge.net/">libwps</ulink>,
233 <ulink url="http://lpsolve.sourceforge.net/">lp_solve</ulink>,
234 <ulink url="http://code.google.com/p/multidimalgorithm/">mdds</ulink>,
235 <ulink url="http://sourceforge.net/projects/hunspell/files/MyThes/">MyThes</ulink>,
236 <ulink url="http://sourceforge.net/projects/ogl-math/">OGL-Math</ulink>,
237 <ulink url="https://gitorious.org/orcus/">Orcus</ulink>, and
238 <ulink url="http://hci.iwr.uni-heidelberg.de/vigra/">VIGRA</ulink>
239 </para>
240
241 <para>There are many optional dependencies not listed here. They can be
242 found in <quote>download.lst</quote> (source directory).
243 </para>
244
245 <para condition="html" role="usernotes">
246 User Notes: <ulink url="&blfs-wiki;/libreoffice"/>
247 </para>
248 </sect2>
249
250 <sect2 role="installation">
251 <title>Installation of LibreOffice</title>
252
253 <para>
254 Unpack the dictionaries file and create symlinks to tarballs from the
255 source directory so they won't get downloaded again:
256 </para>
257
258<screen><userinput>install -dm755 external/tarballs &amp;&amp;
259
260tar -xf ../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz --no-overwrite-dir --strip-components=1 &amp;&amp;
261ln -sfv ../../../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz external/tarballs/ &amp;&amp;
262ln -sfv ../../../libreoffice-help-&libreoffice-dlversion;.tar.xz external/tarballs/</userinput></screen>
263
264 <para>
265 If you have downloaded the translations tarball, create a symlink:
266 </para>
267
268<screen><userinput>
269ln -sfv ../../../libreoffice-translations-&libreoffice-dlversion;.tar.xz external/tarballs/</userinput></screen>
270
271 <note>
272 <para>
273 During the build process, some packages will be downloaded (including
274 the ones listed as recommended and optional dependencies) if they are
275 not present on the system. Doing so, build time may be different
276 for everyone.
277 </para>
278 </note>
279
280 <para>
281 In the rest of the page, locales "en-US" and "pt-BR" are examples. Change
282 them to suit your needs. You might want to read the "Command Explanations"
283 further below before proceeding.
284 </para>
285
286 <para>
287 If building on an i686 system, fix a problem introduced by
288 <application>GCC-4.9.0</application>:
289 </para>
290
291<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-gcc_4_9_0-1.patch &amp;&amp;</userinput></screen>
292
293 <para>
294 Prepare <application>LibreOffice</application> for compilation by running
295 the following commands:
296 </para>
297
298<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-boost_1_56_0-1.patch &amp;&amp;
299
300sed -e "/gzip -f/d" \
301 -e "s|.1.gz|.1|g" \
302 -i bin/distro-install-desktop-integration &amp;&amp;
303sed -e "/distro-install-file-lists/d" -i Makefile.in &amp;&amp;
304
305sed -e "/distro-install-file-lists/d" -i Makefile.in &amp;&amp;
306
307chmod -v +x bin/unpack-sources &amp;&amp;
308sed -e "s/target\.mk/langlist\.mk/" \
309 -e "s/tar -xf/tar -x --strip-components=1 -f/" \
310 -e "/tar -x/s/lo_src_dir/start_dir/" \
311 -i bin/unpack-sources &amp;&amp;
312
313./autogen.sh --prefix=/usr \
314 --sysconfdir=/etc \
315 --with-vendor="BLFS" \
316 --with-lang="en-US pt-BR" \
317 --with-help \
318 --with-alloc=system \
319 --without-java \
320 --disable-gconf \
321 --disable-odk \
322 --disable-postgresql-sdbc \
323 --enable-release-build \
324 --enable-python=system \
325 --with-system-boost \
326 --with-system-clucene \
327 --with-system-cairo \
328 --with-system-curl \
329 --with-system-expat \
330 --with-system-graphite \
331 --with-system-harfbuzz \
332 --with-system-icu \
333 --with-system-jpeg \
334 --with-system-lcms2 \
335 --with-system-libatomic_ops \
336 --with-system-libpng \
337 --with-system-libxml \
338 --with-system-mesa-headers \
339 --with-system-neon \
340 --with-system-npapi-headers \
341 --with-system-nss \
342 --with-system-odbc \
343 --with-system-openldap \
344 --with-system-openssl \
345 --with-system-poppler \
346 --with-system-redland \
347 --with-system-zlib \
348 --with-parallelism=$(getconf _NPROCESSORS_ONLN)</userinput></screen>
349
350 <para>
351 The instructions below will only build the package without running
352 any unit tests. If you prefer to run the unit tests, replace
353 <command>make build</command> with <command>make</command>.
354 </para>
355
356 <note>
357 <para>
358 The package needs to be built from an X terminal emulator.
359 </para>
360 </note>
361
362 <para>
363 Build the package:
364 </para>
365
366<screen><userinput>make build</userinput></screen>
367
368 <para>
369 Now, as the <systemitem class="username">root</systemitem> user:
370 </para>
371
372<screen role="root"><userinput>make distro-pack-install &amp;&amp;
373install -v -dm755 /usr/share/appdata &amp;&amp;
374install -v -m644 sysui/desktop/appstream-appdata/*.xml \
375 /usr/share/appdata</userinput></screen>
376
377 <para>
378 If the dictionaries have been built, again as
379 <systemitem class="username">root</systemitem> user:
380 </para>
381
382<screen role="root"><userinput>chown -cR 0:0 dictionaries/ &amp;&amp;
383mkdir -pv /usr/lib/libreoffice/share/extensions/dict-en &amp;&amp;
384cp -rv dictionaries/en/* /usr/lib/libreoffice/share/extensions/dict-en &amp;&amp;
385mkdir -pv /usr/lib/libreoffice/share/extensions/dict-pt-BR &amp;&amp;
386cp -rv dictionaries/pt_BR/* /usr/lib/libreoffice/share/extensions/dict-pt-BR</userinput></screen>
387
388 </sect2>
389
390 <sect2 role="commands">
391 <title>Command Explanations</title>
392
393 <para>
394 <command>sed -e ...</command>: First sed prevents compression of the
395 manual pages, the second one prevents a script that causes install to
396 fail from running and the third one fixes the unpack script.
397 </para>
398
399 <para>
400 <command>chmod -v +x ...</command>: Fix the unpack script's permissions.
401 </para>
402
403 <para>
404 <parameter>--with-vendor=BLFS</parameter>: This switch sets BLFS as
405 the vendor which is mentioned when you click "About" on the toolbar.
406 </para>
407
408 <para>
409 <parameter>--with-lang="en-US pt-BR"</parameter>: This switch sets
410 what languages to support. To list several languages, separate them
411 with a space. For all languages, use
412 <parameter>--with-lang=ALL</parameter>.
413 </para>
414
415 <note>
416 <para>
417 For a list of the available languages, you can uncompress the
418 translations tarball by running the following command:
419 <command>tar -xf
420 ../libreoffice-translations-&libreoffice-dlversion;.tar.xz
421 --no-overwrite-dir -C /tmp</command> and proceed to examine
422 the contents of <filename
423 class="directory">/tmp/libreoffice-&libreoffice-dlversion;/translations/source</filename>.
424 </para>
425 </note>
426
427 <para>
428 <parameter>--with-help</parameter>: This switch is used to build
429 the help files.
430 </para>
431
432 <para>
433 <parameter>--with-alloc=system</parameter>: This switch tells
434 <application>LibreOffice</application> to use system allocator
435 instead of the internal one.
436 </para>
437
438 <para>
439 <parameter>--without-java</parameter>: This switch disables
440 <application>Java</application> support in
441 <application>LibreOffice</application>.
442 </para>
443
444 <para>
445 <parameter>--disable-gconf</parameter>: This switch disables compiling
446 <application>LibreOffice</application> with the deprecated
447 <application>GNOME</application> configuration system support.
448 </para>
449
450 <para>
451 <parameter>--disable-odk</parameter>: This switch disables installing the
452 office development kit. Remove if you want to develop a
453 <application>LibreOffice</application> based application.
454 </para>
455
456 <para>
457 <parameter>--disable-postgresql-sdbc</parameter>: This switch disables compiling
458 <application>LibreOffice</application> with the ability to connect to a
459 <application>PostgreSQL</application> database. Remove it if you would
460 like <application>LibreOffice</application> to be able to connect to a
461 <application>PostgreSQL</application> database. If you have installed
462 <application>PostgreSQL</application> on your system and would like
463 <application>LibreOffice</application> to use that rather than compile its
464 own copy, use the <option>--with-system-postgresql</option> switch.
465 </para>
466
467 <para>
468 <parameter>--enable-release-build</parameter>: This switch is used to
469 remove "Beta" or "Dev" from <application>LibreOffice</application>
470 splash screen and "About" menu.
471 </para>
472
473 <para>
474 <parameter>--enable-python=system</parameter>: This switch tells
475 <application>LibreOffice</application> to use installed
476 <application>Python 3</application> to build the translations
477 instead of the bundled one. If you don't need to build any
478 translations, you can use <option>--disable-python</option>
479 instead.
480 </para>
481
482 <para>
483 <parameter>--with-system-*</parameter>: These switches prevent
484 <application>LibreOffice</application> from trying to compile its own
485 versions of these dependencies. If you've not installed some of the
486 dependencies, remove the corresponding switches.
487 </para>
488
489 <para>
490 <parameter>--with-parallelism=$(getconf _NPROCESSORS_ONLN)</parameter>: This
491 switch tells <application>LibreOffice</application> to use all your
492 CPUs to compile in parallel and speed up the build.
493 </para>
494
495 <para>
496 <option>--disable-gstreamer-0-10</option>: Use this switch if you
497 haven't installed <xref linkend="gst-plugins-base"/>.
498 </para>
499
500 <para>
501 <option>--enable-gstreamer</option>: Use this switch if you want to
502 use <xref linkend="gst10-plugins-base"/> instead of
503 <xref linkend="gst-plugins-base"/> for the avmedia module.
504 </para>
505
506 <para>
507 <option>--enable-gtk3</option>: Use this switch if you want to
508 build the <application>GTK+ 3</application> integration module.
509 </para>
510
511 <para>
512 <option>--enable-kde4</option>: Use this switch if you want to
513 build the <application>KDE</application> integration module.
514 </para>
515
516 </sect2>
517
518 <sect2 role="content">
519 <title>Contents</title>
520
521 <segmentedlist>
522 <segtitle>Installed Programs</segtitle>
523 <segtitle>Installed Libraries</segtitle>
524 <segtitle>Installed Directories</segtitle>
525
526 <seglistitem>
527 <seg>
528 libreoffice, lobase, localc, lodraw, loffice, lofromtemplate,
529 loimpress, lomath, loweb, lowriter, soffice and unopkg
530 </seg>
531 <seg>
532 None
533 </seg>
534 <seg>
535 /usr/lib/libreoffice
536 </seg>
537 </seglistitem>
538 </segmentedlist>
539
540 <variablelist>
541 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
542 <?dbfo list-presentation="list"?>
543 <?dbhtml list-presentation="table"?>
544
545 <varlistentry id="lobase">
546 <term><command>lobase</command></term>
547 <listitem>
548 <para>
549 is a database manager.
550 </para>
551 <indexterm zone="libreoffice lobase">
552 <primary sortas="b-lobase">lobase</primary>
553 </indexterm>
554 </listitem>
555 </varlistentry>
556
557 <varlistentry id="localc">
558 <term><command>localc</command></term>
559 <listitem>
560 <para>
561 is a spreadsheet program.
562 </para>
563 <indexterm zone="libreoffice localc">
564 <primary sortas="b-localc">localc</primary>
565 </indexterm>
566 </listitem>
567 </varlistentry>
568
569 <varlistentry id="lodraw">
570 <term><command>lodraw</command></term>
571 <listitem>
572 <para>
573 is a vector graphics editor and diagramming tool.
574 </para>
575 <indexterm zone="libreoffice lodraw">
576 <primary sortas="b-lodraw">lodraw</primary>
577 </indexterm>
578 </listitem>
579 </varlistentry>
580
581 <varlistentry id="loimpress">
582 <term><command>loimpress</command></term>
583 <listitem>
584 <para>
585 can edit and display PowerPoint presentations.
586 </para>
587 <indexterm zone="libreoffice loimpress">
588 <primary sortas="b-loimpress">loimpress</primary>
589 </indexterm>
590 </listitem>
591 </varlistentry>
592
593 <varlistentry id="lomath">
594 <term><command>lomath</command></term>
595 <listitem>
596 <para>
597 is a mathematical formula editor.
598 </para>
599 <indexterm zone="libreoffice lomath">
600 <primary sortas="b-lomath">lomath</primary>
601 </indexterm>
602 </listitem>
603 </varlistentry>
604
605 <varlistentry id="lowriter">
606 <term><command>lowriter</command></term>
607 <listitem>
608 <para>
609 is a word processor.
610 </para>
611 <indexterm zone="libreoffice lowriter">
612 <primary sortas="b-lowriter">lowriter</primary>
613 </indexterm>
614 </listitem>
615 </varlistentry>
616
617 <varlistentry id="unopkg">
618 <term><command>unopkg</command></term>
619 <listitem>
620 <para>
621 is a tool to manage <application>LibreOffice</application>
622 extensions from the command line.
623 </para>
624 <indexterm zone="libreoffice unopkg">
625 <primary sortas="b-unopkg">unopkg</primary>
626 </indexterm>
627 </listitem>
628 </varlistentry>
629
630 </variablelist>
631
632 </sect2>
633
634</sect1>
Note: See TracBrowser for help on using the repository browser.