[install-guide] Adding unique Quick Start Guide files

Jack Reed jjr at fedoraproject.org
Wed Jan 23 05:05:45 UTC 2013 

commit 23b0bee4a04ba392afe2ef50207cd1276e667f3d
Author: Jack Reed <jreed at redhat.com>
Date:   Wed Jan 23 15:05:21 2013 +1000

    Adding unique Quick Start Guide files

 en-US/Article_Info.xml                   |   28 ++++++++++
 en-US/Boot_your_computer_from_the_CD.xml |   41 ++++++++++++++
 en-US/Burn_the_image_file_to_CD.xml      |   56 ++++++++++++++++++++
 en-US/Download_Fedora.xml                |   12 ++++
 en-US/Installation_Quick_Start_Guide.ent |    6 ++
 en-US/Installation_Quick_Start_Guide.xml |   58 ++++++++++++++++++++
 en-US/Introduction.xml                   |   11 ++++
 en-US/Requirements.xml                   |   84 ++++++++++++++++++++++++++++++
 en-US/Your_installation_is_complete.xml  |   13 +++++
 9 files changed, 309 insertions(+), 0 deletions(-)
---
diff --git a/en-US/Article_Info.xml b/en-US/Article_Info.xml
new file mode 100644
index 0000000..c1b7118
--- /dev/null
+++ b/en-US/Article_Info.xml
@@ -0,0 +1,28 @@
+<?xml version='1.0'?>
+<!DOCTYPE articleinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<articleinfo id="Installation_Quick_Start_Guide">
+	<title>Installation Quick Start Guide</title>
+	<subtitle>Downloading and installing Fedora &PRODVER; on most desktop and laptop computers</subtitle>
+	<productname>Fedora Draft Documentation</productname>
+	<productnumber></productnumber>
+	<edition>17.0.1</edition>
+	<pubsnumber>1</pubsnumber>
+	<abstract>
+		<para>This document shows you how to download and install Fedora. It does not cover every possible scenario, but describes steps that will work in most situations on most common hardware.</para>
+	</abstract>
+	<corpauthor>
+		<inlinemediaobject>
+			<imageobject>
+				<imagedata format='SVG' fileref="Common_Content/images/title_logo.svg" />
+			</imageobject>
+			<textobject><phrase>Fedora Documentation Project</phrase></textobject>
+		</inlinemediaobject>
+	</corpauthor>
+	<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</articleinfo>
+
+
+
diff --git a/en-US/Boot_your_computer_from_the_CD.xml b/en-US/Boot_your_computer_from_the_CD.xml
new file mode 100644
index 0000000..012ee9d
--- /dev/null
+++ b/en-US/Boot_your_computer_from_the_CD.xml
@@ -0,0 +1,41 @@
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
+]>
+
+<section id="Boot_your_computer_from_the_CD">
+	<title>Boot your computer from the CD</title>
+	<para>
+		Switch on your computer, load the Fedora &PRODVER; live CD into the CD or DVD drive, and restart the computer with the disc still in the drive. Ideally, you should soon see the Fedora boot screen and a ten-second countdown:
+	</para>
+	<figure float="0" id="fig-bootscreen"><title>The Fedora live CD boot screen</title>
+		<mediaobject>
+			<imageobject><imagedata fileref="images/bootscreen/bootscreen-livecd.png" format="PNG"/></imageobject>
+			<textobject><para>
+					The boot screen displays a countdown timer.
+				</para>
+			</textobject>
+		</mediaobject>
+	</figure>
+	<para>
+		Either press <keycap>Enter</keycap> to select the <guilabel>Start Fedora &PRODVER;</guilabel> option, or wait for the countdown to expire.
+	</para>	
+	<para>
+		If you do not see this screen, you might need to select an option manually to make your computer boot from the CD. Power your computer on, and watch the initial BIOS screen for a prompt that indicates which key to use for either:
+	</para>
+	<itemizedlist>
+		<listitem>
+			<para>
+				a boot menu, or
+			</para>
+		</listitem>
+		<listitem>
+			<para>
+				the BIOS setup utility
+			</para>
+		</listitem>
+	</itemizedlist>
+	<para>
+		The boot menu option is preferable. If you cannot see such a prompt, consult your manufacturer's documentation for your computer system, motherboard, or mainboard for the correct keystroke. On many systems, the required key will be <keycap>F12</keycap>, <keycap>F2</keycap>, <keycap>F1</keycap>, <keycap>Esc</keycap>, or <keycap>Delete</keycap>.
+	</para>
+</section>
+
diff --git a/en-US/Burn_the_image_file_to_CD.xml b/en-US/Burn_the_image_file_to_CD.xml
new file mode 100644
index 0000000..f71dd10
--- /dev/null
+++ b/en-US/Burn_the_image_file_to_CD.xml
@@ -0,0 +1,56 @@
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
+]>
+
+<section id="Burn_the_image_file_to_CD">
+	<title>Burn the image file to CD</title>
+		<para>
+		The exact series of steps that produces a CD from an image file varies greatly from computer to computer, depending on the operating system and disc burning software installed. Use this procedure as a general guide. You might be able to omit certain steps on your computer, or might have to perform some of the steps in a different order from the order described here.
+	</para>
+	<para>
+		Make sure that your disc burning software is capable of burning discs from image files. Although this is true of most disc burning software, exceptions exist.
+	</para>
+	<para>
+		In particular, note that the CD burning feature built into Windows XP and Windows Vista cannot burn CDs from images and that earlier Windows operating systems did not have any CD burning capability installed by default. Therefore, if your computer has a Windows operating system prior to Windows&nbsp;7 installed on it, you need a separate piece of software for this task. Examples of popular CD burning software for Windows that you might already have on your computer include <application>Nero Burning ROM</application> and <application>Roxio Creator</application>. If you use a Windows operating system on your computer and do not have disc burning software installed (or you are not sure that the software can burn discs from image files) <application>InfraRecorder</application> is a suitable alternative available from <ulink url="http://www.infrarecorder.org/"></ulink>, and is free and open-source. 
+	</para>
+	<para>
+		The <application>Disk Utility</application> software installed by default with Mac OS&nbsp;X on Apple computers has the capability to burn CDs from images built into it already. Most widely-used CD burning software for Linux, such as <application>Brasero</application> and <application>K3b</application>, also includes this capability.
+	</para>
+	<procedure>
+		<step>
+			<para>
+				Insert a blank, writeable CD into your computer's CD or DVD burner. On some computers, a window opens and displays various options when you insert the disc. If you see a window like this, look for an option to launch your chosen disc burning program. If you do not see an option like this, close the window and launch the program manually.
+			</para>
+		</step>
+		<step>
+			<para>
+				Launch your disc burning program. On some computers, you can do this by right-clicking (or control-clicking) on the image file and selecting a menu option with a label like <guilabel>Copy image to CD</guilabel>, or <guilabel>Copy CD or DVD image</guilabel>. Other computers might provide you with a menu option to launch your chosen disc burning program, either directly or with an option like <guimenuitem>Open With</guimenuitem>. If none of these options are available on your computer, launch the program from an icon on your desktop, in a menu of applications such as the <guimenu>Start</guimenu> menu on Windows operating systems, or in the Mac <filename>Applications</filename> folder.
+			</para>
+		</step>
+		<step>
+			<para>
+				In your disc burning program, select the option to burn a CD from an image file. For example, in <application>Nero Burning ROM</application>, this option is called <guimenuitem>Burn Image</guimenuitem> and is located on the <guimenu>File</guimenu> menu.
+			</para>
+			<para>
+				Note that you can skip this step when using certain CD burning software; for example, <application>Disk Utility</application> on Mac OS&nbsp;X does not require it.
+			</para>
+		</step>
+		<step>
+			<para>
+				Browse to the ISO CD image file that you downloaded previously and select it for burning.
+			</para>
+		</step>
+		<step>
+			<para>
+				Click the button that starts the burning process.
+			</para>
+		</step>
+	</procedure>
+	<note>
+		<title>Check the CD</title>
+		<para>
+			After the burning process completes, browse to the CD and check its contents. If you have burned the disc correctly, it should contain a number of files and folders, including <filename>GPL</filename>, <filename>README</filename>, <filename>LiveOS</filename>, <filename>EFI</filename>, and 
+			<filename>isolinux</filename>. If you see only a single file named <filename>Fedora-&PRODVER;-i686-Live.iso</filename>, you have burned the image file itself to the CD, rather than burning a CD from the image file. In this case, you cannot use the CD and must try again.
+		</para>
+	</note>
+</section>
diff --git a/en-US/Download_Fedora.xml b/en-US/Download_Fedora.xml
new file mode 100644
index 0000000..16090ce
--- /dev/null
+++ b/en-US/Download_Fedora.xml
@@ -0,0 +1,12 @@
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
+]>
+
+<section id="Download_Fedora">
+	<title>Download the Fedora live CD image file</title>
+	<para>
+		The image file for the Fedora &PRODVER; live CD is available from
+		<ulink url="http://download.fedoraproject.org/pub/fedora/linux/releases/&amp;PRODVER;/Live/i686/Fedora-&amp;PRODVER;-i686-Live-Desktop.iso"></ulink>.
+		Download and save this file to your computer. 
+	</para>
+</section>
diff --git a/en-US/Installation_Quick_Start_Guide.ent b/en-US/Installation_Quick_Start_Guide.ent
new file mode 100644
index 0000000..f7738aa
--- /dev/null
+++ b/en-US/Installation_Quick_Start_Guide.ent
@@ -0,0 +1,6 @@
+<!ENTITY PRODUCT "Fedora Documentation">
+<!ENTITY BOOKID "installation-quick-start-guide">
+<!ENTITY YEAR "2011">
+<!ENTITY HOLDER "Red Hat, Inc. and others">
+<!ENTITY PRODVER "17">
+
diff --git a/en-US/Installation_Quick_Start_Guide.xml b/en-US/Installation_Quick_Start_Guide.xml
new file mode 100644
index 0000000..7effcf9
--- /dev/null
+++ b/en-US/Installation_Quick_Start_Guide.xml
@@ -0,0 +1,58 @@
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
+]>
+
+<article>
+	<xi:include href="Article_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Download_Fedora.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Burn_the_image_file_to_CD.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Boot_your_computer_from_the_CD.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<!-- <xi:include href="Fedora_Live_Desktop.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
+	
+	<xi:include href="Language_Configuration-x86.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Graphical_Installation_install-hub.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Key_Board_Configuration-x86.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Storage_Devices-x86.xml"/>  
+	
+	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Assign_Storage_Devices-x86.xml"/>  -->
+	
+	<!-- <xi:include href="Time_Zone-x86.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Account_Configuration-x86.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Disk_Partitioning_Setup-x86.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Package_Selection-Live.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
+	
+	<xi:include href="Write_changes_to_disk_x86.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="firstboot-welcome.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="firstboot-license.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="firstboot-systemuser.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="firstboot-datetime.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="firstboot-smolt.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Your_installation_is_complete.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	
+	<!-- <xi:include href="Package_Selection-dvd.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
+	
+	<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</article>
+
diff --git a/en-US/Introduction.xml b/en-US/Introduction.xml
new file mode 100644
index 0000000..1921579
--- /dev/null
+++ b/en-US/Introduction.xml
@@ -0,0 +1,11 @@
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
+]>
+
+<section id="Introduction">
+	<title>Introduction</title>
+	<para>
+		This guide shows you how to download a Fedora &PRODVER; live CD image, burn this image to a disc, and use this disc to install Fedora &PRODVER; on a typical desktop or notebook computer. This guide is not a complete description of the installation process and all its options &mdash; for greater detail, refer to the <citetitle>Fedora &PRODVER; Installation Guide</citetitle>, available from <ulink url="http://docs.fedoraproject.org/"></ulink>.
+	</para>
+</section>
+
diff --git a/en-US/Requirements.xml b/en-US/Requirements.xml
new file mode 100644
index 0000000..1a92276
--- /dev/null
+++ b/en-US/Requirements.xml
@@ -0,0 +1,84 @@
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
+]>
+
+<section id="Requirements">
+	<title>Requirements</title>
+	<para>
+		To create a Fedora live CD, you need:
+		<itemizedlist>
+			<listitem>
+				<para>
+					a broadband connection to the Internet.
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					a computer with a CD or DVD burner.
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					software that allows you to create a CD from an image file.
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					a blank, writeable CD.
+				</para>
+			</listitem>
+		</itemizedlist>
+	</para>
+	<!-- the following para is from new-users.xml -->
+	<para>
+		If you do not have a fast Internet connection, or if you have a problem creating boot media, downloading may not be an option. Fedora DVD and CD distribution media is available from a number of online sources around the world at a minimal cost. Use your favorite Web search engine to locate a vendor, or refer to <ulink url="http://fedoraproject.org/wiki/Distribution"/>.
+	</para>
+	<para>
+		The computer on which you intend to install Fedora &PRODVER; from the live CD should have:
+		<itemizedlist>
+			<listitem>
+				<para>
+					a CD or DVD drive, and the capability to boot from this drive.
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					a 400 MHz processor or faster
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					at least 1&nbsp;GB of memory (RAM) <!-- this line different from Installation Guide; more RAM required to install from live image -->
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					at least 10 GB of permanent storage (hard drive) space.
+				</para>
+			</listitem>
+		</itemizedlist>
+		These specifications represent a bare minumum to use Fedora in graphical mode. Almost any laptop or desktop computer manufactured in recent years will meet these requirements. For more details of the hardware requirements for Fedora &PRODVER;, refer to the <citetitle>Fedora &PRODVER; Release Notes</citetitle>, available from <ulink url="http://docs.fedoraproject.org/"></ulink>.
+	</para>
+	<para>
+		If your computer does not have a CD or DVD drive, or is not capable of booting from this drive, then you might be able to install Fedora from a USB storage device such as a USB flash drive. Refer to the <citetitle>liveusb-creator</citetitle> page at <ulink url="https://fedorahosted.org/liveusb-creator/"></ulink> for instructions. 
+	</para>
+	<note>
+		<title>Do you already have Fedora &PRODVER; on CD, DVD, or live USB media?</title>
+		<para>
+			If you already have Fedora &PRODVER; on CD, DVD, or live USB media, you can still use this guide, because many steps will be similar. Skip ahead to <xref linkend="Boot_your_computer_from_the_CD"/>, then 
+		</para>
+		<itemizedlist>
+			<listitem>
+				<para>
+					continue through the instructions in order if you have a Fedora &PRODVER; live CD or live USB device.
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					skip ahead to <xref linkend="sn-keyboard-x86"/> if you have a Fedora &PRODVER; DVD.
+				</para>
+			</listitem>
+		</itemizedlist>
+	</note>
+</section>
+
diff --git a/en-US/Your_installation_is_complete.xml b/en-US/Your_installation_is_complete.xml
new file mode 100644
index 0000000..0aba7ca
--- /dev/null
+++ b/en-US/Your_installation_is_complete.xml
@@ -0,0 +1,13 @@
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
+]>
+
+<section id="Your_installation_is_complete">
+	<title>Your installation is complete</title>
+	<para>
+		Fedora is now installed on your computer. Log in with the username and password that you created during the installation process.
+	</para>
+	<para>
+		To learn more about Fedora, visit the Fedora Project website at <ulink url="http://fedoraproject.org/"></ulink>. If you need help installing or using Fedora, visit  <ulink url="http://fedoraproject.org/en/get-help"></ulink>.
+	</para>
+</section>

More information about the docs-commits mailing list