Larch 7

author: Cecil Hugh Watson <knoppmyth@gmail.com> 2010-08-28 21:23:23 (GMT)
committer: Cecil Hugh Watson <knoppmyth@gmail.com> 2010-08-28 21:23:23 (GMT)
commit: f83117d46d8fc1f6192783371a68607a192c3276 (patch)
tree: 21bf30aeb943fe6cb23eb9c62a0ba899de2af0d7 /build_tools/l7/larch0/docs/html/larch_quick.html
parent: 69a0137390be9816d5ec5dc9e81d48817a817758 (diff)
download: linhes_dev-f83117d46d8fc1f6192783371a68607a192c3276.zip
1 files changed, 148 insertions, 0 deletions
diff --git a/build_tools/l7/larch0/docs/html/larch_quick.html b/build_tools/l7/larch0/docs/html/larch_quick.html
new file mode 100644
index 0000000..eeb035b
--- /dev/null
+++ b/build_tools/l7/larch0/docs/html/larch_quick.html
@@ -0,0 +1,148 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<html>
+<head>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
+<title>Quick Start</title>
+<!-- (en) Add your meta data here -->
+
+<link href="css/larchdocs.css" rel="stylesheet" type="text/css"/>
+<!--[if lte IE 7]>
+<link href="css/yaml/core/iehacks.css" rel="stylesheet" type="text/css" />
+<![endif]-->
+</head>
+
+<body>
+<!-- skip link navigation -->
+<ul id="skiplinks">
+    <li><a class="skip" href="#col1">Skip to main content (Press Enter).</a></li>
+</ul>
+
+<div class="page_margins">
+  <div class="page">
+    <div id="top"><div id="tm"></div></div>
+     <!-- begin: #col1 -->
+      <div id="col1" role="main">
+        <div id="col1_content">
+          <div id="header" role="banner">
+            <h1><span><em>live Arch Linux</em> builder</span></h1>
+          </div>
+
+      <!-- begin: #col3 navigation column -->
+      <div id="col3" role="complementary">
+        <div id="col3_content">
+          <img class="indent2" alt="larch logo" src="css/screen/larch150x.png" width="150" height="150" />
+              <div class="vlist">
+                <ul>
+                  <li><a href="index.html"><h6>Table Of Contents</h6></a></li>
+                  <li><a href="archin.html"><h6>Next:</h6>
+                    <div class="indent1">Installation of the base Arch system</div></a></li>
+                  <li><a href="larch_quick-console.html"><h6>Previous:</h6>
+                    <div class="indent1">Quick Start - Console</div></a></li>
+                </ul>
+              </div>
+        </div>
+      </div>
+      <!-- end: #col3 -->
+
+<div class="larchdocs">
+<h2 id="pagetitle" level="1">Quick Start</h2>
+
+<p>The gui should make exploration of the possibilities offered by <em>larch</em>
+quite straightforward. The documentation should provide enough information to
+understand how a <em>larch live</em> system works, so that further customizations
+can be performed beyond those directly supported.
+</p>
+<p>The general sequence of events starts with creating a 'project', which will
+determine certain aspects of the build environment (such as where to place the
+installation files), and select a profile. The profile describes the system to be
+installed (primarily which packages, but also various other aspects). All this
+configuration information is stored in the user's home directory (~/.config/larch),
+so that it is retained from one <em>larch</em> run to the next.
+</p>
+
+<ul>
+   <li>At present I only maintain a repository for 'i686', as I don't run a 64-bit
+   <em>Arch</em> machine, but as all the current <em>larch</em> packages
+   have architecture 'any', both architectures should be supported.
+   </li>
+   <li>Make sure you have 'pyqt' and 'python-pexpect' packages installed.
+   </li>
+   <li>Download the latest
+   <a href="ftp://ftp.berlios.de/pub/larch/larch7.2/i686/larch-setup">
+   <strong>larch-setup</strong></a> script
+   to an empty working directory. Then run it (it is a shell script).
+   It will download and prepare the 'larch' and 'larch-profiles' packages so that
+   <em>larch</em> can be run from this directory.
+   </li>
+   <li>Run './larch' in the working directory.
+   As it is a gui program, you must of course be running xorg (see
+   <a href="larch_quick-console.html">Command-Line Interface</a>
+   for use from the command line). In general you should start <em>larch</em>
+   as a normal, unprivileged user, so that the access to the configuration
+   files is as the correct user. It will ask for the <em>sudo</em>
+   password when it needs it.
+   </li>
+   <li>To build a <em>larch live</em> system you basically just have to go through
+   the tabs one after the other.
+   </li>
+   <li>The first tab allows you to create a project and select a profile. The 'mini'
+   (no <em>xorg</em>) and 'xmini' (a fairly minimal <em>xfce</em> desktop) examples
+   (from the supplied 'profiles' folder) might be good places to start.
+   The default installation path should be alright for most purposes,
+   but you might need to move it if you don't have enough space on that partition.
+   Be careful! If you put a silly path in here you might overwrite your system.
+   </li>
+   <li>The 'Installation' tab performs the installation of the system to be squashed,
+   by downloading and installing all the requested packages to the installation path
+   set for the project. You can adjust a few aspects of this process, for example
+   to use a local package mirror, or to add repositories to pacman.conf. The default
+   is to use the mirror set on the host system and also to use the host's package
+   cache, so that repeated builds don't need to download the packages all over
+   again.
+   </li>
+   <li>The 'Larchify' tab compresses the installation using squashfs, also building
+   a squashed overlay containing all the customizations necessary for the
+   <em>live</em> system and those specified in the profile.
+   </li>
+   <li>A few customizations of the medium are accessible on the 'Medium Profile' tab,
+   for example the bootloader configurations.
+   </li>
+   <li>Finally the 'Medium' tab writes the prepared <em>larch</em> files to an
+   <em>iso</em> file (for CD or DVD), or to the partition of your choice (be careful!),
+   so that you end up with a bootable <em>larch</em> system.
+   </li>
+   <li>Particular things that you might want to customize even in a first test run might
+   be the supported <strong>locales</strong> and <strong>rc.conf</strong> (both on the
+   'Larchify' tab).
+   </li>
+   <li>Further details of the customization process are in the section
+   <a href="profiles.html">Profiles</a> and in the documentation to the individual
+   gui tabs.
+   </li>
+   <li>  Share and Enjoy!</li>
+</ul>
+
+</div>
+
+
+          <div class="topref"><a href="#top">Top</a></div>
+        </div>
+    <!-- begin: #footer -->
+    <div id="footer">
+      <div id="footer-content" role="contentinfo">© 2010 Michael Towers<br />
+        Page layout assisted by <a href="http://www.yaml.de/">YAML</a> and
+        <a href="http://www.kuwata-lab.com/tenjin/">pyTenjin</a>
+      </div>
+    </div>
+    <!-- end: #footer -->
+      </div>
+      <!-- end: #col1 -->
+    <div id="bottom"><div id="bl"><div id="bm"></div></div></div>
+  </div>
+</div>
+<!-- full skiplink functionality in webkit browsers -->
+<script src="css/yaml/core/js/webkit-focusfix.js" type="text/javascript"></script>
+</body>
+</html>
author	Cecil Hugh Watson <knoppmyth@gmail.com>	2010-08-28 21:23:23 (GMT)
committer	Cecil Hugh Watson <knoppmyth@gmail.com>	2010-08-28 21:23:23 (GMT)
commit	f83117d46d8fc1f6192783371a68607a192c3276 (patch)
tree	21bf30aeb943fe6cb23eb9c62a0ba899de2af0d7 /build_tools/l7/larch0/docs/html/larch_quick.html
parent	69a0137390be9816d5ec5dc9e81d48817a817758 (diff)
download	linhes_dev-f83117d46d8fc1f6192783371a68607a192c3276.zip