blob: 68d01ac276ff6ec71a6267f1cd9b3ff6c8fc6beb (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
]>
<chapter id="chap-Customization_Guide-Preparation">
<title>Preparation</title>
<para>
This chapter will demonstrate the stages required to customize Sugar on a Stick in different ways and will guide you through them step by step. Please pay close attention to the instructions to make sure no loss of data occurs.
</para>
<section id="sect-Creation_Kit-Preparation-System_Requirements">
<title>System Requirements</title>
<table id="tabl-Creation_Kit-Preparation-System_Requirements-Platforms">
<title>Platforms</title>
<tgroup cols="3">
<colspec colname="Platform" colnum="1" colwidth="2*"></colspec>
<colspec colname="Requirements" colnum="2" colwidth="4*"></colspec>
<colspec colname="Notes" colnum="3" colwidth="4*"></colspec>
<thead>
<row>
<entry> Platform </entry>
<entry> Requirements </entry>
<entry> Notes </entry>
</row>
</thead>
<tbody>
<row>
<entry> <simplelist> <member> Linux </member> </simplelist> </entry>
<entry>
<simplelist>
<member> Fedora 12 or higher </member>
<member> at least 5 GB of free hard disk space </member>
<member> a decently fast internet connection </member>
</simplelist>
</entry>
<entry> <simplelist>
<member> root access is required </member>
<member> older versions may be unsupported </member>
</simplelist>
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section id="sect-Creation_Kit-Preparation-Getting_Started">
<title>Getting Started</title>
<para>
When remixing Sugar on a Stick, you will note a lot of references to Fedora and related projects. This is mainly, because Sugar on a Stick is a Fedora Spin and thus based on this distribution. Hence, we are also assuming that you are starting with a current Fedora installation, as defined in the system requirements.
</para>
<para>
As a first step, you will need to install a number of packages that allow you to build your own Sugar on a Stick. For the build process, we are relying on Fedora's livecd-tools. <footnote><para>http://fedoraproject.org/wiki/FedoraLiveCD</para></footnote> Therefore, you will need to install these, along with a couple of other packages.
</para>
<itemizedlist>
<listitem>
<para>
Execute as root: <command>yum install <replaceable>git livecd-tools system-config-keyboard system-config-language</replaceable></command>
</para>
</listitem>
</itemizedlist>
<para>
The production of Sugar on a Stick usually takes place by providing the build tool with a kind of configuration file. This file is called <firstterm>kickstart</firstterm> file. We are going to start from the currently existing files, which are available in Fedora's GIT repositories, since Sugar on a Stick v3 "Mirabelle" as a spin is part of Fedora's engineering process.
</para>
<itemizedlist>
<listitem>
<para>
Grab the configuration files by running: <command>git clone <replaceable>git://git.fedorahosted.org/spin-kickstarts.git</replaceable></command>
</para>
</listitem>
</itemizedlist>
<note>
<title>Note</title>
<para>
Make sure to pull the appropriate branch from GIT if you want to build against one of the stable releases. Otherwise, you will checkout the latest moving contents from the repository.
</para>
<para>
To build against the stable version fedora 13 :
<command>git checkout <replaceable>F-13</replaceable></command>
</para>
</note>
<para>
You have taken the first step! You have downloaded all the required components and are now ready to learn how to customize Sugar on a Stick for your own purposes in the next chapter.
</para>
</section>
</chapter>
|
