<chapter id="sec_install">
<title>Installation</title>
+ <para>
+ &appname; is a quite complex piece of software, we thus recommend
+ you to either install al precompiled version or use the LiveCD.
+ If you are running Debian GNU/Linux (or one of its derivatives
+ like Ubuntu), you can install matita typing
+ <programlisting><![CDATA[ aptitude install matita matita-standard-library ]]></programlisting>
+ If you are running MacOSX or Windows, give the LiveCD a try before
+ trying to compile &appname; from its sources.
+ </para>
+
+ <sect1 id="inst_livecd">
+ <title>Using the LiveCD</title>
+
+ <para>
+ In the following, we will assume you have installed
+ <ulink type="http" url="http://www.virtualbox.org">virtualbox</ulink>
+ for your platform and downloaded the .iso image of the LiveCD
+ </para>
+
+ <sect2 id="make_vmachine">
+ <title>Creating the virtual machine</title>
+ <para>
+ Click on the New button, a wizard will popup, you should ask to
+ its questions as follows
+ <orderedlist>
+ <listitem><para>
+ The name should be something like &appname;, but can
+ be any meaningful string.
+ </para></listitem>
+ <listitem><para>
+ The OS type should be Debian
+ </para></listitem>
+ <listitem><para>
+ The base memory size can be 256 mega bytes, but you may
+ want to increase it if you are going to work with huge
+ formalizations.
+ </para></listitem>
+ <listitem><para>
+ The boot hard disk should be no hard disk. It may complain
+ that this choice is not common, but it is right, since you
+ will run a LiveCD you do not need to emulate an hard drive.
+ </para></listitem>
+ </orderedlist>
+ Now that you are done with the creation of the virtual machine,
+ you need to insert the LiveCD in the virtual cd reader unit.
+ </para>
+ <figure><title>The brand new virtual machine</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox1.png" format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>The breand new virtual machine</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Click on CD/DVD-ROM (that should display something like: Not mouted).
+ Then click on mount CD/DVD drive and select the ISO image
+ option. The combo-box should display no available image, you need to
+ add the ISO image you downloaded from the &appname; website clicking on
+ the button near the combo-box.
+ to start the virtual machine.
+ </para>
+ <figure><title>Mounting an ISO image</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox2.png" format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>Mounting an ISO image</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ In the newely opened window click
+ the Add button
+ </para>
+ <figure><title>Choosing the ISO image</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox3.png" format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>Choosing the ISO image</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ A new windows will pop-up: choose the file you downloaded
+ (usually matita-version.iso) and click open.
+ </para>
+ <figure><title>Choosing the ISO image</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox35.png" format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>Choosing the ISO image</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Now select the new entry you just added as the CD image
+ you want to insert in the virtual CD drive.
+ You are now ready to start the virtual machine.
+ </para>
+ </sect2>
+ <sect2>
+ <title>Sharing files with the real PC</title>
+ <para>
+ The virtual machine &appname; will run on, has its own file
+ system, that is completely separated from the one of your
+ real PC (thus your files are not available in the
+ emulated environment) and moreover it is a non-presistem
+ file system (thus you data is lost every time yuo
+ turn off the virtual machine).
+ </para>
+ <para>
+ Virtualbox allows you to share a real folder (beloging
+ to your real PC) with the emulated computer. Since this
+ folder is persistent, you are encouraged to put
+ your work there, so that it is not lost when the virtual
+ machine is powered off.
+ </para>
+ <para>
+ The first step to set up a shared folder is to click
+ on the shared folder configuration entry
+ of the virtual machine.
+ </para>
+ <figure><title>Set up a shared folder</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox4.png"
+ format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>Shared folder</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ The you shuld add a shared folder clicking on the
+ plus icon on the right
+ </para>
+ <figure><title>Choosing the folder to share</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox5.png"
+ format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>Shared folder</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ The you have to specify the real PC folder you want to share
+ and name it. A reasonable folder to share is /home on
+ a standard Unix system, while /Users on MaxOSX.
+ The name you give to the share is important, you should
+ remember it.
+ </para>
+ <figure><title>Naming the shared folder</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox6.png"
+ format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>Shared folder</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Once your virtual machine is up and running, you can
+ mount (that meand have access to) the shared folder
+ by clicking on the Mount VirtualBox share icon, and typing
+ the name of the share.
+ </para>
+ <figure><title>Using it from the virtual machine</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/vbox7.png"
+ format="PNG" srccredit="Enrico Tassi"/>
+ </imageobject>
+ <textobject><phrase>Shared folder at work</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ A window will then pop-up, and its content will be the
+ the content of the real PC folder.
+ </para>
+ </sect2>
+
+ </sect1>
+
<sect1 id="inst_from_src">
<title>Installing from sources</title>
- <para>Currently, the only intended way to install &appname; is starting
- from its source code. </para>
+ <para>Install &appname; from the sources is hard, you have been warned!
+ </para>
<sect2 id="get_source_code">
<title>Getting the source code</title>