path: root/en_US.ISO8859-1/books/handbook/desktop/chapter.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!--
     The FreeBSD Documentation Project
     $FreeBSD$
-->
<chapter xmlns="http://docbook.org/ns/docbook"
  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
  xml:id="desktop">
  <!--
  <chapterinfo>
    <authorgroup>
      <author>
	<firstname>Christophe</firstname>
	<surname>Juniet</surname>
	<contrib>Contributed by </contrib>
      </author>
    </authorgroup>
  </chapterinfo>
  -->

  <title>Desktop Applications</title>

  <sect1 xml:id="desktop-synopsis">
    <title>Synopsis</title>

    <para>While &os; is popular as a server for its performance and
      stability, it is also suited for day-to-day use as a desktop.
      With over &os.numports; applications available as &os; packages
      or ports, it is easy to build a customized desktop that runs
      a wide variety of desktop applications.  This chapter
      demonstrates how to install numerous desktop applications,
      including web browsers, productivity software, document viewers,
      and financial software.</para>

    <note>
      <para>Users who prefer to install a pre-built desktop version
	of FreeBSD rather than configuring one from scratch should
	refer to the
	<link xlink:href="http://www.trueos.org/">trueos.org
	  website.</link></para>
    </note>

    <para>Readers of this chapter should know how to:</para>

    <itemizedlist>
      <listitem>
	<para>Install additional software using packages or
	  ports as described in <xref linkend="ports"/>.</para>
      </listitem>

      <listitem>
	<para>Install X and a window manager as described in
	  <xref linkend="x11"/>.</para>
      </listitem>
    </itemizedlist>

    <para>For information on how to configure a multimedia
      environment, refer to <xref linkend="multimedia"/>.</para>
  </sect1>

  <sect1 xml:id="desktop-browsers">
    <title>Browsers</title>

    <indexterm>
      <primary>browsers</primary>
      <secondary>web</secondary>
    </indexterm>

    <para>&os; does not come with a pre-installed web browser.
      Instead, the <link
	xlink:href="http://www.FreeBSD.org/ports/www.html">www</link>
      category of the Ports Collection contains many browsers which
      can be installed as a package or compiled from the Ports
      Collection.</para>

    <para>The <application>KDE</application> and
      <application>GNOME</application> desktop environments include
      their own HTML browser.  Refer to <xref linkend="x11-wm"/>
      for more information on how to set up these complete
      desktops.</para>

    <para>Some lightweight browsers include
      <package>www/dillo2</package>, <package>www/links</package>, and
      <package>www/w3m</package>.</para>

    <para>This section demonstrates how to install the following
      popular web browsers and indicates if the application is
      resource-heavy, takes time to compile from ports, or has any
      major dependencies.</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
	<thead>
	  <row>
	    <entry>Application Name</entry>
	    <entry>Resources Needed</entry>
	    <entry>Installation from Ports</entry>
	    <entry>Notes</entry>
	  </row>
	</thead>

	<tbody>
	  <row>
	    <entry><application>Firefox</application></entry>
	    <entry>medium</entry>
	    <entry>heavy</entry>
	    <entry>&os;, &linux;, and localized versions are
	      available</entry>
	  </row>

	  <row>
	    <entry><application>Opera</application></entry>
	    <entry>light</entry>
	    <entry>light</entry>
	    <entry>&os; and &linux; versions are available</entry>
	  </row>

	  <row>
	    <entry><application>Konqueror</application></entry>
	    <entry>medium</entry>
	    <entry>heavy</entry>
	    <entry>Requires <application>KDE</application>
	      libraries</entry>
	  </row>

	  <row>
	    <entry><application>Chromium</application></entry>
	    <entry>medium</entry>
	    <entry>heavy</entry>
	    <entry>Requires <application>Gtk+</application></entry>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>

    <sect2>
      <title>Firefox</title>

      <indexterm>
	<primary><application>Firefox</application></primary>
      </indexterm>

      <para><application>Firefox</application> is an open source
	browser that is fully ported to &os;.  It features a
	standards-compliant HTML display engine, tabbed browsing,
	popup blocking, extensions, improved security, and more.
	<application>Firefox</application> is based on the
	<application>Mozilla</application> codebase.</para>

      <para>To install the package of the latest release version of
	<application>Firefox</application>, type:</para>

      <screen>&prompt.root; <userinput>pkg install firefox</userinput></screen>

      <para>To instead install <application>Firefox</application>
	Extended Support Release (ESR) version, use:</para>

      <screen>&prompt.root; <userinput>pkg install firefox-esr</userinput></screen>

      <para>Localized versions are available in
	<package>www/firefox-i18n</package> and
	<package>www/firefox-esr-i18n</package>.</para>

      <para>The Ports Collection can instead be used to compile the
	desired version of <application>Firefox</application> from
	source code.  This example builds
	<package>www/firefox</package>, where
	<literal>firefox</literal> can be replaced with the ESR or
	localized version to install.</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/firefox</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

    <sect3 xml:id="moz-java-plugin">
      <title>Firefox and &java; Plugin</title>

      <para>The installation of
	<application>Firefox</application> does not include &java;
	support.  However, <package>java/icedtea-web</package>
	provides a free software web browser plugin for running Java
	applets.  It can be installed as a package by running:</para>

      <screen>&prompt.root; <userinput>pkg install icedtea-web</userinput></screen>

      <para>Alternatively, to compile from the Ports Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/java/icedtea-web</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>Keep the default configuration options when compiling the
	port.</para>

      <para>Once installed, start <application>Firefox</application>,
	enter <literal>about:plugins</literal> in the location bar and
	press <keycap>Enter</keycap>.  A page listing the installed
	plugins will be displayed.  The
	<application>&java;</application> plugin should be
	listed.</para>

      <para>If the browser is unable to find the plugin, each user
	will have to run the following command and relaunch the
	browser:</para>

      <screen>&prompt.user; <userinput>ln -s /usr/local/lib/IcedTeaPlugin.so \
  $HOME/.mozilla/plugins/</userinput></screen>
    </sect3>

    <sect3 xml:id="moz-flash-plugin">

      <title>Firefox and &adobe; &flash; Plugin</title>

      <indexterm>
	<primary>Flash</primary>
      </indexterm>

      <para>A native &adobe; &flash; plugin is not available for &os;.
	However, a software wrapper for running the &linux; version
	of the plugin is available.  This wrapper also provides
	support for other browser plugins such as &realplayer;.</para>

      <para>To install and enable this plugin, perform these
	steps:</para>

      <procedure>
	<step>
	  <para>Install <package
	      role="port">www/nspluginwrapper</package> from the port.
	    Due to licensing restrictions, a package is not available.
	    This port requires
	    <package>emulators/linux_base-c6</package>.</para>
	</step>

	<step>
	  <para>Install <package
	      role="port">www/linux-flashplayer</package> from
	    the port.  Due to licensing restrictions, a package is not
	    available.</para>
	</step>

	<step>
	  <para>Before the plugin is first used, each user must
	    run:</para>

	  <screen>&prompt.user; <userinput>nspluginwrapper -v -a -i</userinput></screen>

	  <para>When the plugin port has been updated and reinstalled,
	    each user must run:</para>

	  <screen>&prompt.user; <userinput>nspluginwrapper -v -a -u</userinput></screen>

	  <para>Start the browser, enter
	    <literal>about:plugins</literal> in the location bar and
	    press <keycap>Enter</keycap>.  A list of all the currently
	    available plugins will be shown.</para>
	</step>

      </procedure>
    </sect3>

    <sect3 xml:id="moz-swfdec-flash-plugin">
      <title>Firefox and Swfdec &flash; Plugin</title>

      <para><application>Swfdec</application> is a decoder and
	renderer for &flash; animations.
	<application>Swfdec-Mozilla</application> is a plugin for
	<application>Firefox</application> browsers that uses the
	Swfdec library for playing SWF files.</para>

      <para>To install the package:</para>

      <screen>&prompt.root; <userinput>pkg install swfdec-plugin</userinput></screen>

      <para>If the package is not available, compile and install it
	from the Ports Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/swfdec-plugin</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

	<para>Restart the browser to activate this plugin.</para>
      </sect3>
    </sect2>

    <sect2>
      <title>Opera</title>

      <indexterm>
	<primary><application>Opera</application></primary>
      </indexterm>

      <para><application>Opera</application> is a full-featured and
	standards-compliant browser which is still lightweight and
	fast.  It comes with a built-in mail and news reader, an IRC
	client, an RSS/Atom feeds reader, and more.  It is available
	as a native &os; version and as a version that runs under
	&linux; emulation.</para>

      <para>This command installs the package of the &os; version of
	<application>Opera</application>.  Replace
	<literal>opera</literal> with <literal>linux-opera</literal>
	to instead install the &linux; version.</para>

      <screen>&prompt.root; <userinput>pkg install opera</userinput></screen>

      <para>Alternately, install either version through the Ports
	Collection.  This example compiles the native version:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/opera</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>To install the &linux; version, substitute
	<literal>linux-opera</literal> in place of
	<literal>opera</literal>.</para>

      <para>To install &adobe; &flash; plugin support, first compile
	the <package role="port">www/linux-c6-flashplugin11</package>
	port.  Licensing restrictions prevent making a package
	available.  Then install <package
	  role="port">www/opera-linuxplugins</package>.  This example
	compiles both applications from ports:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/linux-c6-flashplugin11</userinput>
&prompt.root; <userinput>make install clean</userinput>
&prompt.root; <userinput>cd /usr/ports/www/opera-linuxplugins</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>Once installed, check the presence of the plugin by
	starting the browser, entering
	<literal>opera:plugins</literal> in the location bar and
	pressing <keycap>Enter</keycap>.  A list should appear with
	all the currently available plugins.</para>

      <para>To add the <application>&java;</application> plugin,
	follow the instructions in <xref
	  linkend="moz-java-plugin"/>.</para>
    </sect2>

    <sect2>
      <title>Konqueror</title>

      <indexterm>
	<primary><application>Konqueror</application></primary>
      </indexterm>

      <para><application>Konqueror</application> is more than a web
	browser as it is also a file manager and a multimedia
	viewer.  It is included in the
	<package>x11/kde4-baseapps</package> package or port.</para>

      <para><application>Konqueror</application> supports WebKit as
	well as its own KHTML.  WebKit is a rendering engine used by
	many modern browsers including Chromium.  To use WebKit with
	<application>Konqueror</application> on &os;, install the
	<package>www/kwebkitpart</package> package
	or port.  This example installs the package:</para>

      <screen>&prompt.root; <userinput>pkg install kwebkitpart</userinput></screen>

      <para>To install from the Ports Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/kwebkitpart</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>To enable WebKit within
	<application>Konqueror</application>, click
	<quote>Settings</quote>, <quote>Configure Konqueror</quote>.
	In the <quote>General</quote> settings page, click the
	drop-down menu next to <quote>Default web browser
	engine</quote> and change <quote>KHTML</quote> to
	<quote>WebKit</quote>.</para>

      <para><application>Konqueror</application> also supports
	<application>&flash;</application>.  A <quote>How To</quote>
	guide for getting <application>&flash;</application> support
	on <application>Konqueror</application> is available at <uri
	  xlink:href="http://freebsd.kde.org/howtos/konqueror-flash.php">http://freebsd.kde.org/howtos/konqueror-flash.php</uri>.</para>
    </sect2>

    <sect2>
      <title>Chromium</title>

      <indexterm>
	<primary><application>Chromium</application></primary>
      </indexterm>

      <para><application>Chromium</application> is an open source
	browser project that aims to build a safer, faster, and more
	stable web browsing experience.
	<application>Chromium</application> features tabbed browsing,
	popup blocking, extensions, and much more.
	<application>Chromium</application> is the open source project
	upon which the Google Chrome web browser is based.</para>

      <para><application>Chromium</application> can be installed as a
	package by typing:</para>

      <screen>&prompt.root; <userinput>pkg install chromium</userinput></screen>

      <para>Alternatively, <application>Chromium</application> can be
	compiled from source using the Ports Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/chromium</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <note>
	<para>The executable for <application>Chromium</application>
	  is <filename>/usr/local/bin/chrome</filename>, not
	  <filename>/usr/local/bin/chromium</filename>.</para>
      </note>

      <sect3 xml:id="chromium-java-plugin">
	<title>Chromium and &java; Plugin</title>

	<para>The installation of
	  <application>Chromium</application> does not include &java;
	  support.  To install &java; plugin support, follow the
	  instructions in <xref linkend="moz-java-plugin"/>.</para>

	<para>Once &java; support is installed, start
	  <application>Chromium</application> and enter
	  <literal>about:plugins</literal> in the address bar.
	  IcedTea-Web should be listed as one of the installed
	  plugins.</para>

	<para>If <application>Chromium</application> does not display
	  the IcedTea-Web plugin, run the following commands and
	  restart the web browser:</para>

	<screen>&prompt.root; <userinput>mkdir -p /usr/local/share/chromium/plugins
&prompt.root; ln -s /usr/local/lib/IcedTeaPlugin.so \
  /usr/local/share/chromium/plugins/</userinput></screen>
      </sect3>

      <sect3 xml:id="chromium-flash-plugin">
	<title>Chromium and &adobe;&nbsp;&flash; Plugin</title>

	<para>Configuring <application>Chromium</application> and
	  &adobe;&nbsp;&flash; is similar to the instructions in
	  <xref linkend="moz-flash-plugin"/>.  No additional
	  configuration should be necessary, since
	  <application>Chromium</application> is able to use some
	  plugins from other browsers.</para>
      </sect3>
    </sect2>
  </sect1>

  <sect1 xml:id="desktop-productivity">
    <title>Productivity</title>

    <para>When it comes to productivity, new users often look for an
      office suite or an easy-to-use word processor.  While some
      <link linkend="x11-wm">desktop environments</link> like
      <application>KDE</application> provide an office suite, there
      is no default productivity package.  Several office suites and
      graphical word processors are available for &os;, regardless
      of the installed window manager.</para>

    <para>This section demonstrates how to install the following
      popular productivity software and indicates if the application
      is resource-heavy, takes time to compile from ports, or has any
      major dependencies.</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
	<thead>
	  <row>
	    <entry>Application Name</entry>
	    <entry>Resources Needed</entry>
	    <entry>Installation from Ports</entry>
	    <entry>Major Dependencies</entry>
	  </row>
	</thead>

	<tbody>
	  <row>
	    <entry><application>Calligra</application></entry>
	    <entry>light</entry>
	    <entry>heavy</entry>
	    <entry><application>KDE</application></entry>
	  </row>

	  <row>
	    <entry><application>AbiWord</application></entry>
	    <entry>light</entry>
	    <entry>light</entry>
	    <entry><application>Gtk+</application> or
	      <application>GNOME</application></entry>
	  </row>

	  <row>
	    <entry><application>The Gimp</application></entry>
	    <entry>light</entry>
	    <entry>heavy</entry>
	    <entry><application>Gtk+</application></entry>
	  </row>

	  <row>
	    <entry><application>Apache
		OpenOffice</application></entry>
	    <entry>heavy</entry>
	    <entry>huge</entry>
	    <entry><application>&jdk;</application> and
	      <application>Mozilla</application></entry>
	  </row>

	  <row>
	    <entry><application>LibreOffice</application></entry>
	    <entry>somewhat heavy</entry>
	    <entry>huge</entry>
	    <entry><application>Gtk+</application>, or
	      <application>KDE</application>/
	      <application>GNOME</application>, or
	      <application>&jdk;</application></entry>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>

    <sect2>
      <title>Calligra</title>

      <indexterm>
	<primary><application>Calligra</application></primary>
      </indexterm>
      <indexterm>
	<primary>office suite</primary>
	<secondary><application>Calligra</application></secondary>
      </indexterm>

      <para>The KDE desktop environment includes
	an office suite which can be installed separately from
	<application>KDE</application>.
	<application>Calligra</application> includes standard
	components that can be found in other office suites.
	<application>Words</application> is the word processor,
	<application>Sheets</application> is the spreadsheet program,
	<application>Stage</application> manages slide presentations,
	and <application>Karbon</application> is used to draw
	graphical documents.</para>

      <para>In &os;, <package>editors/calligra</package> can be
	installed as a package or a port.  To install the
	package:</para>

      <screen>&prompt.root; <userinput>pkg install calligra</userinput></screen>

      <para>If the package is not available, use the Ports Collection
	instead:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/editors/calligra</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>AbiWord</title>

      <indexterm>
	<primary><application>AbiWord</application></primary>
      </indexterm>

      <para><application>AbiWord</application> is a free word
	processing program similar in look and feel to
	<application>&microsoft; Word</application>.  It is fast,
	contains many features, and is user-friendly.</para>

      <para><application>AbiWord</application> can import or export
	many file formats, including some proprietary ones like
	&microsoft; <filename>.rtf</filename>.</para>

      <para>To install the <application>AbiWord</application>
	package:</para>

      <screen>&prompt.root; <userinput>pkg install abiword</userinput></screen>

      <para>If the package is not available, it can be compiled from
	the Ports Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/editors/abiword</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>The GIMP</title>

      <indexterm>
	<primary><application>The GIMP</application></primary>
      </indexterm>

      <para>For image authoring or picture retouching,
	<application>The GIMP</application> provides a sophisticated
	image manipulation program.  It can be used as a simple paint
	program or as a quality photo retouching suite.  It supports a
	large number of plugins and features a scripting interface.
	<application>The GIMP</application> can read and write a wide
	range of file formats and supports interfaces with scanners
	and tablets.</para>

      <para>To install the package:</para>

      <screen>&prompt.root; <userinput>pkg install gimp</userinput></screen>

      <para>Alternately, use the Ports Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/gimp</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>The graphics category (<link
	  xlink:href="http://www.FreeBSD.org/ports/graphics.html">freebsd.org/ports/graphics.html</link>)
	of the Ports Collection contains several
	<application>GIMP</application>-related plugins, help files,
	and user manuals.</para>

    </sect2>

    <sect2>
      <title>Apache OpenOffice</title>

      <indexterm>
	<primary>
	  <application>Apache OpenOffice</application>
	</primary>
      </indexterm>
      <indexterm>
	<primary>office suite</primary>
	<secondary>
	  <application>Apache OpenOffice</application>
	</secondary>
      </indexterm>

      <para><application>Apache OpenOffice</application> is an open
	source office suite which is developed under the wing of the
	Apache Software Foundation's Incubator.  It includes all of
	the applications found in a complete office productivity
	suite: a word processor, spreadsheet, presentation manager,
	and drawing program.  Its user interface is similar to other
	office suites, and it can import and export in various popular
	file formats.  It is available in a number of different
	languages and internationalization has been extended to
	interfaces, spell checkers, and dictionaries.</para>

      <para>The word processor of <application>Apache
	  OpenOffice</application> uses a native XML file format for
	increased portability and flexibility.  The spreadsheet
	program features a macro language which can be interfaced
	with external databases.  <application>Apache
	  OpenOffice</application> is stable and runs natively on
	&windows;, &solaris;, &linux;, &os;, and &macos;&nbsp;X.
	More information about <application>Apache
	  OpenOffice</application> can be found at <link
	  xlink:href="http://openoffice.org/">openoffice.org</link>.
	For &os; specific information refer to <link
	  xlink:href="http://porting.openoffice.org/freebsd/">porting.openoffice.org/freebsd/</link>.</para>

      <para>To install the <application>Apache
	  OpenOffice</application> package:</para>

      <screen>&prompt.root; <userinput>pkg install apache-openoffice</userinput></screen>

      <para>Once the package is installed, type the following command
	to launch <application>Apache OpenOffice</application>:</para>

      <screen>&prompt.user; <userinput>openoffice-<replaceable>X.Y.Z</replaceable></userinput></screen>

      <para>where <replaceable>X.Y.Z</replaceable> is the version
	number of the installed version of <application>Apache
	  OpenOffice</application>.  The first time
	<application>Apache OpenOffice</application> launches, some
	questions will be asked and a
	<filename>.openoffice.org</filename> folder will be created in
	the user's home directory.</para>

      <para>If the desired <application>Apache
	  OpenOffice</application> package is not available, compiling
	the port is still an option.  However, this requires a lot of
	disk space and a fairly long time to compile:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/editors/openoffice-4</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <note>
	<para>To build a localized version, replace the previous
	  command with:</para>

	<screen>&prompt.root; <userinput>make LOCALIZED_LANG=<replaceable>your_language</replaceable> install clean</userinput></screen>

	<para>Replace
	  <replaceable>your_language</replaceable> with the correct
	  language ISO-code.  A list of supported language codes is
	  available in
	  <filename>files/Makefile.localized</filename>, located in
	  the port's directory.</para>
      </note>
    </sect2>

    <sect2>
      <title>LibreOffice</title>

      <indexterm>
	<primary><application>LibreOffice</application></primary>
      </indexterm>
      <indexterm>
	<primary>office suite</primary>
	<secondary><application>LibreOffice</application></secondary>
      </indexterm>

      <para><application>LibreOffice</application> is a free software
	office suite developed by <link
	  xlink:href="http://www.documentfoundation.org/">documentfoundation.org</link>.
	It is compatible with other major office suites and available
	on a variety of platforms.  It is a rebranded fork of
	<application>Apache OpenOffice</application> and includes
	applications found in a complete office productivity suite:
	a word processor, spreadsheet, presentation manager, drawing
	program, database management program, and a tool for creating
	and editing mathematical formul&aelig;.  It is available in
	a number of different languages and internationalization has
	been extended to interfaces, spell checkers, and
	dictionaries.</para>

      <para>The word processor of
	<application>LibreOffice</application> uses a native XML file
	format for increased portability and flexibility.  The
	spreadsheet program features a macro language which can be
	interfaced with external databases.
	<application>LibreOffice</application> is stable and runs
	natively on &windows;, &linux;, &os;, and &macos;&nbsp;X.
	More information about <application>LibreOffice</application>
	can be found at <link
	  xlink:href="http://www.libreoffice.org/">libreoffice.org</link>.</para>

      <para>To install the English version of the
	<application>LibreOffice</application> package:</para>

      <screen>&prompt.root; <userinput>pkg install libreoffice</userinput></screen>

      <para>The editors category (<link
	  xlink:href="http://www.FreeBSD.org/ports/editors.html">freebsd.org/ports/editors.html</link>)
	of the Ports Collection contains several localizations for
	<application>LibreOffice</application>.  When installing a
	localized package, replace <literal>libreoffice</literal>
	with the name of the localized package.</para>

      <para>Once the package is installed, type the following command
	to run <application>LibreOffice</application>:</para>

      <screen>&prompt.user; <userinput>libreoffice</userinput></screen>

      <para>During the first launch, some questions will be asked
	and a <filename>.libreoffice</filename> folder will be created
	in the user's home directory.</para>

      <para>If the desired <application>LibreOffice</application>
	package is not available, compiling the port is still an
	option.  However, this requires a lot of disk space and a
	fairly long time to compile.  This example compiles the
	English version:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/editors/libreoffice</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <note>
	<para>To build a localized version,
	  <command>cd</command> into the port directory of
	  the desired language.  Supported languages can be found
	  in the editors category (<link
	    xlink:href="http://www.FreeBSD.org/ports/editors.html">freebsd.org/ports/editors.html</link>)
	  of the Ports Collection.</para>
      </note>
    </sect2>
  </sect1>

  <sect1 xml:id="desktop-viewers">
    <title>Document Viewers</title>

    <para>Some new document formats have gained popularity since
      the advent of &unix; and the viewers they require may not be
      available in the base system.  This section demonstrates how to
      install the following document viewers:</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
	<thead>
	  <row>
	    <entry>Application Name</entry>
	    <entry>Resources Needed</entry>
	    <entry>Installation from Ports</entry>
	    <entry>Major Dependencies</entry>
	  </row>
	</thead>

	<tbody>
	  <row>
	    <entry><application>Xpdf</application></entry>
	    <entry>light</entry>
	    <entry>light</entry>
	    <entry><application>FreeType</application></entry>
	  </row>

	  <row>
	    <entry><application>gv</application></entry>
	    <entry>light</entry>
	    <entry>light</entry>
	    <entry><application>Xaw3d</application></entry>
	  </row>

	  <row>
	    <entry><application>Geeqie</application></entry>
	    <entry>light</entry>
	    <entry>light</entry>
	    <entry><application>Gtk+</application> or
	      <application>GNOME</application></entry>
	  </row>

	  <row>
	    <entry><application>ePDFView</application></entry>
	    <entry>light</entry>
	    <entry>light</entry>
	    <entry><application>Gtk+</application></entry>
	  </row>

	  <row>
	    <entry><application>Okular</application></entry>
	    <entry>light</entry>
	    <entry>heavy</entry>
	    <entry><application>KDE</application></entry>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>

    <sect2>
      <title>Xpdf</title>

      <indexterm>
	<primary><application>Xpdf</application></primary>
      </indexterm>
      <indexterm>
	<primary>PDF</primary>
	<secondary>viewing</secondary>
      </indexterm>

      <para>For users that prefer a small &os; PDF viewer,
	<application>Xpdf</application> provides a light-weight and
	efficient viewer which requires few resources.  It uses the
	standard X fonts and does not require any additional
	toolkits.</para>

      <para>To install the <application>Xpdf</application>
	package:</para>

      <screen>&prompt.root; <userinput>pkg install xpdf</userinput></screen>

      <para>If the package is not available, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/xpdf</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>Once the installation is complete, launch
	<command>xpdf</command> and use the right mouse button to
	activate the menu.</para>
    </sect2>

    <sect2>
      <title><application>gv</application></title>

      <indexterm>
	<primary><application>gv</application></primary>
      </indexterm>
      <indexterm>
	<primary>PDF</primary>
	<secondary>viewing</secondary>
      </indexterm>
      <indexterm>
	<primary>PostScript</primary>
	<secondary>viewing</secondary>
      </indexterm>

      <para><application>gv</application> is a &postscript; and PDF
	viewer.  It is based on <application>ghostview</application>,
	but has a nicer look as it is based on the
	<application>Xaw3d</application> widget toolkit.
	<application>gv</application> has many configurable features,
	such as orientation, paper size, scale, and anti-aliasing.
	Almost any operation can be performed with either the
	keyboard or the mouse.</para>

      <para>To install <application>gv</application> as a
	package:</para>

      <screen>&prompt.root; <userinput>pkg install gv</userinput></screen>

      <para>If a package is unavailable, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/print/gv</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>Geeqie</title>

      <indexterm>
	<primary><application>Geeqie</application></primary>
      </indexterm>

      <para><application>Geeqie</application> is a fork from the
	unmaintained <application>GQView</application> project, in an
	effort to move development forward and integrate the existing
	patches.  <application>Geeqie</application> is an image
	manager which supports viewing a file with a single click,
	launching an external editor, and thumbnail previews.  It also
	features a slideshow mode and some basic file operations,
	making it easy to manage image collections and to find
	duplicate files.  <application>Geeqie</application> supports
	full screen viewing and internationalization.</para>

      <para>To install the <application>Geeqie</application>
	package:</para>

      <screen>&prompt.root; <userinput>pkg install geeqie</userinput></screen>

      <para>If the package is not available, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/geeqie</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>ePDFView</title>

      <indexterm>
	<primary><application>ePDFView</application></primary>
      </indexterm>
      <indexterm>
	<primary>PDF</primary>
	<secondary>viewing</secondary>
      </indexterm>

      <para><application>ePDFView</application> is a lightweight
	<acronym>PDF</acronym> document viewer that only uses the
	<application>Gtk+</application> and
	<application>Poppler</application> libraries.  It is currently
	under development, but already opens most
	<acronym>PDF</acronym> files (even encrypted), save copies of
	documents, and has support for printing using
	<application>CUPS</application>.</para>

      <para>To install <application>ePDFView</application> as a
	package:</para>

      <screen>&prompt.root; <userinput>pkg install epdfview</userinput></screen>

      <para>If a package is unavailable, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/epdfview</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>Okular</title>

      <indexterm>
	<primary><application>Okular</application></primary>
      </indexterm>
      <indexterm>
	<primary><acronym>PDF</acronym></primary>
	<secondary>viewing</secondary>
      </indexterm>

      <para><application>Okular</application> is a universal document
	viewer based on <application>KPDF</application> for
	<application>KDE</application>.  It can open many document
	formats, including <acronym>PDF</acronym>, &postscript;, DjVu,
	<acronym>CHM</acronym>, <acronym>XPS</acronym>, and
	ePub.</para>

      <para>To install <application>Okular</application> as a
	package:</para>

      <screen>&prompt.root; <userinput>pkg install okular</userinput></screen>

      <para>If a package is unavailable, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/okular</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>
  </sect1>

  <sect1 xml:id="desktop-finance">
    <title>Finance</title>

    <para>For managing personal finances on a &os; desktop, some
      powerful and easy-to-use applications can be installed.  Some
      are compatible with widespread file formats, such as the formats
      used by <application>Quicken</application> and
      <application>Excel</application>.</para>

    <para>This section covers these programs:</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
	<thead>
	  <row>
	    <entry>Application Name</entry>
	    <entry>Resources Needed</entry>
	    <entry>Installation from Ports</entry>
	    <entry>Major Dependencies</entry>
	  </row>
	</thead>

	<tbody>
	  <row>
	    <entry><application>GnuCash</application></entry>
	    <entry>light</entry>
	    <entry>heavy</entry>
	    <entry><application>GNOME</application></entry>
	  </row>

	  <row>
	    <entry><application>Gnumeric</application></entry>
	    <entry>light</entry>
	    <entry>heavy</entry>
	    <entry><application>GNOME</application></entry>
	  </row>

	  <row>
	    <entry><application>KMyMoney</application></entry>
	    <entry>light</entry>
	    <entry>heavy</entry>
	    <entry><application>KDE</application></entry>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>

    <sect2>
      <title>GnuCash</title>

      <indexterm>
	<primary><application>GnuCash</application></primary>
      </indexterm>

      <para><application>GnuCash</application> is part of the
	<application>GNOME</application> effort to provide
	user-friendly, yet powerful, applications to end-users.
	<application>GnuCash</application> can be used to keep track
	of income and expenses, bank accounts, and stocks.  It
	features an intuitive interface while remaining
	professional.</para>

      <para><application>GnuCash</application> provides a smart
	register, a hierarchical system of accounts, and many keyboard
	accelerators and auto-completion methods.  It can split a
	single transaction into several more detailed pieces.
	<application>GnuCash</application> can import and merge
	<application>Quicken</application> QIF files.  It also handles
	most international date and currency formats.</para>

      <para>To install the <application>GnuCash</application>
	package:</para>

      <screen>&prompt.root; <userinput>pkg install gnucash</userinput></screen>

      <para>If the package is not available, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/finance/gnucash</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>Gnumeric</title>

      <indexterm>
	<primary><application>Gnumeric</application></primary>
      </indexterm>
      <indexterm>
	<primary>spreadsheet</primary>
	<secondary><application>Gnumeric</application></secondary>
      </indexterm>

      <para><application>Gnumeric</application> is a spreadsheet
	program developed by the <application>GNOME</application>
	community.  It features convenient automatic guessing of user
	input according to the cell format with an autofill system
	for many sequences.  It can import files in a number of
	popular formats, including <application>Excel</application>,
	<application>Lotus 1-2-3</application>, and
	<application>Quattro Pro</application>.  It has a large number
	of built-in functions and allows all of the usual cell formats
	such as number, currency, date, time, and much more.</para>

      <para>To install <application>Gnumeric</application> as a
	package:</para>

      <screen>&prompt.root; <userinput>pkg install gnumeric</userinput></screen>

      <para>If the package is not available, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/math/gnumeric</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>KMyMoney</title>

      <indexterm><primary><application>KMyMoney</application></primary></indexterm>

      <indexterm>
	<primary>spreadsheet</primary>
	<secondary><application>KMyMoney</application></secondary>
      </indexterm>

      <para><application>KMyMoney</application> is a personal finance
	application created by the <application>KDE</application>
	community.  <application>KMyMoney</application> aims to
	provide the important features found in commercial personal
	finance manager applications.  It also highlights ease-of-use
	and proper double-entry accounting among its features.
	<application>KMyMoney</application> imports from standard
	<application>Quicken</application> QIF files, tracks
	investments, handles multiple currencies, and provides a
	wealth of reports.</para>

      <para>To install <application>KMyMoney</application> as a
	package:</para>

      <screen>&prompt.root; <userinput>pkg install kmymoney-kde4</userinput></screen>

      <para>If the package is not available, use the Ports
	Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/finance/kmymoney-kde4</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>
  </sect1>
</chapter>