debian-cd-clone/contrib/HEADER.html.in

308 lines
10 KiB
HTML
Raw Normal View History

#if 0
Input file for docs in multiple different directories. Process with
cpp.
#endif
<h1>What's in this directory?</h1>
#ifdef STYLElist
<p>These are list files.</p>
<h2>How do I use these files?</h2>
<p>
The list files here simply describe what files are contained in
each Debian ISO image, in order to help users find which images
they might want to download. They are simply text files, compressed
to save space and download time.</p>
#else
# ifdef ARCHsource
<p>These are files containing source code for the Debian
operating system.</p>
# else
<p>These are files containing the installer and other software
for the Debian GNU/KERNEL operating system.
# ifdef ARCHmulti
The files in this directory are designed to work on both 32-bit
and 64-bit PCs (<code>i386</code> and <code>amd64</code>).
# else
The files in this directory are specifically for
the <code>ARCH</code> architecture.
# endif
</p>
# endif
<h2>How do I use these files?</h2>
# ifdef STYLEjigdo
<p>The files here are in "jigdo"
format. Use <a href="https://www.debian.org/CD/jigdo-cd/">jigdo</a>
tools to download the contents of the complete ISO image files
from what's here and a normal Debian mirror. You should end up
with an exact copy of each ISO image as though you'd downloaded
it directly via HTTP or FTP.</p>
# elif defined(STYLEbt)
<p>The files here are bittorrent files. Use
a <a href="https://www.debian.org/CD/torrent-cd/">bittorrent</a>
client program to download the contents of the complete ISO image
files in a peer-to-peer manner. You should end up with an exact
copy of each ISO image as though you'd downloaded it directly via
HTTP or FTP.</p>
# elif defined(STYLEiso)
<p>The files here are complete ISO images, ready to use.</p>
# endif
<p> Once you have downloaded all the ISO images you want, you will
typically need to write them to installation media.</p>
<h2>What size and type of media will I need?</h2>
<p>The images described here are sized to be written to
# ifdef TYPEcd
writeable CD media
# elif TYPEdvd
writeable DVD media
# elif TYPEbd
writeable Blu-Ray media
# elif TYPEdlbd
writeable dual-layer Blu-Ray media
# endif
at a minimum, but may be written to larger media if needed.</p>
# ifdef ISOHYBRID
<p>For extra convenience, <strong>these images may also be written
directly to a USB stick</strong>. So long as your computer will
boot directly from that USB stick, it should start the Debian
installer that way.
# if defined(TYPEdvd)
The first DVD in this set is also deliberately limited in size
so it should fit on a standard-sized 4GB USB stick.
# endif
# endif
</p>
# if !defined(ONEonly) && !defined(ARCHsource)
<h2>There are lots of files here! Do I need all of them?</h2>
<p>In most cases it is not necessary to download and
use <strong>all</strong> of these images to be able to install
Debian on your computer. Debian comes with a massive set of
software packages, hence why it takes so many disks for a
complete set. Most typical users only need a small subset of
those software packages.</p>
# if !defined(TYPEcd)
<p>Initially, you will only need to download and use
the <strong>first</strong> image of a set (labelled as
<code>debian-<i>something</i>-1</code> to be able to start the
Debian installer and set up Debian on your computer. If there are
more images available here
(labelled <code>debian-<i>something</i>-2</code>,
<code>debian-<i>something</i>-3</code>, etc.), they contain the
extra packages that can be installed on a Debian system (as
mentioned previously). They will <strong>not</strong> be
bootable and are entirely optional. If you have a fast Internet
connection, you're most likely better off installing any
desired extra packages directly from the Debian mirrors on the
Internet instead of by using these extra images.</p>
# endif
# endif
# if defined(TYPEcd) && !defined(ARCHsource) && !defined(STYLElist)
<h2>What is a netinst image?</h2>
<p>The <code>netinst</code> CD here is a small CD image that
contains just the core Debian installer code and a small core set
of text-mode programs (known as "standard" in Debian). To install
a desktop or other common software, you'll also need either an
Internet connection or some other Debian CD/DVD images.</p>
# if defined(ARCHi386)
<h2>What is an edu netinst image?</h2>
<p>The <code>edu netinst</code> CD here is a special version of
the netinst CD image that is targeted specifically at 32-bit
Intel machines. It provides a menu to install the Debian Edu Pure
Blend. See the <a href="https://wiki.debian.org/DebianEdu/">
Debian Wiki</a> for more information.</p>
# endif
# if defined(ARCHamd64)
<h2>What is an edu netinst image?</h2>
<p>The <code>edu netinst</code> CD here is a special version of
the netinst CD image that is targeted specifically at 64-bit
Intel machines. It provides a menu to install the Debian Edu Pure
Blend. See the <a href="https://wiki.debian.org/DebianEdu/">
Debian Wiki</a> for more information.</p>
# endif
# if defined(ARCHi386)
<h2>What is a mac netinst image?</h2>
<p>The <code>mac netinst</code> CD here is a special version of
the netinst CD image that is targeted specifically at older
32-bit Intel Macintosh machines. It will likely work on most
other i386 machines too, but it does not contain UEFI boot
files that some people
need. See <a href="https://wiki.debian.org/MacMiniIntel#Macmini_1.2C1">
the Debian Wiki</a> for more information.</p>
# endif
# if defined(ARCHamd64)
<h2>What is a mac netinst image?</h2>
<p>The <code>mac netinst</code> CD here is a special version of
the netinst CD image that is targeted specifically at older
64-bit Intel Macintosh machines. It will likely work on most
other amd64 machines too, but it does not contain UEFI boot
files that some people
need. See <a href="https://wiki.debian.org/MacMiniIntel#Macmini_2.2C1">
the Debian Wiki</a> for more information.</p>
# endif
# endif
# if defined(TYPEbd) && !defined(ARCHsource) && !defined(STYLElist)
<p>The <code>BD</code> image here is a special large image that
contains the core Debian installer code and a specific set of
programs. Depending on the purpose you'll also need an Internet
connection.</p>
# if defined(ARCHi386)
<p>The <code>edu-usb</code> BD here is a special version of
the BD image that is targeted specifically at 32-bit Intel machines.
It provides a menu to install the Debian Edu Pure Blend without the
need of an Internet connection. See the
<a href="https://wiki.debian.org/DebianEdu/">Debian Wiki</a> for
more information.</p>
# endif
# if defined(ARCHamd64)
<p>The <code>edu-usb</code> BD here is a special version of
the BD image that is targeted specifically at 64-bit Intel machines.
It provides a menu to install the Debian Edu Pure Blend without the
need of an Internet connection. See the
<a href="https://wiki.debian.org/DebianEdu/">Debian Wiki</a> for
more information.</p>
# endif
# endif
# ifdef UPDATES
<p>The <code>update</code> files here are extra convenience files
for people updating from previous versions of Debian. If you are
installing fresh, you may safely ignore
them. <a href="https://www.debian.org/CD/faq/#update-cd">More
details...</a></p>
# endif
<h2>How can I verify my download is correct and exactly what has
been created by Debian?</h2>
<p>There are files here (SHA1SUMS, SHA256SUMS, etc.) which contain
checksums of the images. These checksum files are also signed - see
SHA1SUMS.sign, SHA256SUMS.sign, etc. Once you've downloaded an image,
you can check:</p>
<ul>
<li>that its checksum matches that expected from the checksum file; and
<li>that the checksum file has not been tampered with.
</ul>
<p>For more information about how to do these steps, read
the <a href="https://www.debian.org/CD/verify">verification guide</a>.
#endif
#if !defined(ONEonly) && !defined(FIRMWARE) && (defined(STYLEbt) || defined(STYLEiso))
<h2>Only the first few images are available! Where are the rest?</h2>
<p>We don't store/serve the full set of ISO images for all
architectures, to reduce the amount of space taken up on the
mirrors. You can
<a href="https://www.debian.org/CD/faq/#why-jigdo">use the jigdo
tool</a> to recreate the missing ISO images instead.</p>
#endif
#ifdef FIRMWARE
<h2>Non-free Firmware</h2>
<p>For convenience for some users, this <strong>unofficial</strong>
alternative build
includes <a href="https://wiki.debian.org/Firmware">non-free
firmware</a> for extra support for some awkward hardware.</p>
#endif
#ifdef ARCH_HAS_FIRMWARE
<h2>Non-free Firmware</h2>
<p>This is an <strong>official</strong> Debian image build and so
only includes Free Software.</p>
<p>For convenience for some users, there is an
alternative <strong>unofficial</strong> netinst CD build which
includes <a href="https://wiki.debian.org/Firmware">non-free
firmware</a> for extra support for some awkward hardware. Look under
<a href="/cdimage/unofficial/non-free/cd-including-firmware/">/cdimage/unofficial/non-free/cd-including-firmware/</a>
if you need that CD image instead.</p>
#endif
<h2>Other questions?</h2>
<p>See the Debian CD <a href="https://www.debian.org/CD/faq/">FAQ</a>
for lots more information about Debian CDs and installation.</p>
<p>The images here were put together by
the <a href="https://wiki.debian.org/Teams/DebianCd">Debian CD team</a>
, using debian-cd and other software.</p>