Re: security/faq.wml: LoQ
On Wed, Jan 16, 2002 at 12:46:12PM +0100, Josip Rodin wrote:
[...]
> Cool. I wonder if something like this could be done for CD/faq/index.wml?
I've put tag definitions in toc.inc, but it should be placed in a template
file.
Denis
Index: index.wml
===================================================================
RCS file: /cvs/webwml/webwml/english/CD/faq/index.wml,v
retrieving revision 1.7
diff -u -r1.7 index.wml
--- index.wml 2002/01/14 20:05:59 1.7
+++ index.wml 2002/01/16 21:19:47
@@ -1,4 +1,5 @@
#use wml::debian::cdimage title="Frequently Asked Questions about Debian CDs" NOHEADER=true BARETITLE=true
+#include 'toc.inc'
<h1><a name="top">Frequently Asked Questions</a></h1>
@@ -6,37 +7,11 @@
<p align="right"><a href="#top"><img src="top.png" alt="Top of page" width="11" height="11" border="0"></a></p>
</define-tag>
-<ul>
-# <!-- Create the TOC with the faqtoc.awk script -->
-
- <li><a href="#what-is">What is a "CD image" anyway?</a></li>
- <li><a href="#mailing-list">My question is not answered by this FAQ - how can I send mail to the mailing lists related to Debian CDs?</a></li>
- <li><a href="#why-jigdo">Why do you encourage people not to download CD images via HTTP/FTP, but instead with this "jigdo" program or the "pseudo image kit"?</a></li>
- <li><a href="#which-cd">Which of the numerous CD images should I download? Do I need all of them?</a></li>
- <li><a href="#source-cd">What are the "source" CDs? Do I need them?</a></li>
- <li><a href="#nonus">What is the difference between the normal binary-1 and the binary-1-nonus CDs?</a></li>
- <li><a href="#nonfree">Where is the CD image with non-free?</a></li>
- <li><a href="#dvd">Are any DVD images of the Debian distribution available for download?</a></li>
- <li><a href="#live-cd">Is a Debian "live CD" available?</a></li>
- <li><a href="#bootable">I notice all the CDs are bootable. Is there any difference between the bootable parts of the individual CDs?</a></li>
- <li><a href="#arch">Where are the CDs for architecture X?</a></li>
- <li><a href="#outdated">The software on the official CDs is outdated - why don't you release a new version?</a></li>
- <li><a href="#newest">How do I know if I am downloading the newest CD images?</a></li>
- <li><a href="#verify">How can I verify that the downloaded CD images are correct?</a></li>
- <li><a href="#record-unix">How do I record a CD-R under Linux/UNIX?</a></li>
- <li><a href="#record-windows">How do I record a CD-R under Windows?</a></li>
- <li><a href="#record-mac">How do I record a CD-R under MacOS?</a></li>
- <li><a href="#whatlabel">How should I label the CDs?</a></li>
- <li><a href="#artwork">Is there any artwork for CDs and covers?</a></li>
- <li><a href="#lan-install">I want to install Debian on many interconnected computers - how do I set up a local .deb cache?</a></li>
- <li><a href="#diy">I have a local Debian mirror and want to create my own CDs. How do I do this?</a></li>
- <li><a href="#become-cd-mirror">How do I become a mirror for Debian CD images?</a></li>
-
-</ul>
+<toc-display/>
<hr>
-<p><strong><a name="what-is">What is a "CD image" anyway?</a></strong></p>
+<toc-add-entry name="what-is">What is a "CD image" anyway?</toc-add-entry>
<p>A CD image is the exact representation of the data on a CD in a
normal computer file, that can e.g. be transmitted over the
@@ -46,9 +21,9 @@
<gototop>
# ============================================================
-<p><strong><a name="mailing-list">My question is not answered by
+<toc-add-entry name="mailing-list">My question is not answered by
this FAQ - how can I send mail to the mailing lists related to
-Debian CDs?</a></strong></p>
+Debian CDs?</toc-add-entry>
<p>There are several mailing lists that could be relevant to you.
In all cases, you should <a href="http://lists.debian.org/">search
@@ -90,9 +65,9 @@
# ============================================================
-<p><strong><a name="why-jigdo">Why do you encourage people not to
+<toc-add-entry name="why-jigdo">Why do you encourage people not to
download CD images via HTTP/FTP, but instead with this "jigdo"
-program or the "pseudo image kit"?</a></strong></p>
+program or the "pseudo image kit"?</toc-add-entry>
<p>Today, there are over <a href="$(HOME)/misc/README.mirrors">200 Debian
mirrors</a> (which contain the complete Debian distribution as .deb files),
@@ -123,8 +98,8 @@
<gototop>
# ============================================================
-<p><strong><a name="which-cd">Which of the numerous CD images
-should I download? Do I need all of them?</a></strong></p>
+<toc-add-entry name="which-cd">Which of the numerous CD images
+should I download? Do I need all of them?</toc-add-entry>
<p>No, you only need the CD images for your computer's
architecture. The architecture is the type of hardware your
@@ -149,8 +124,8 @@
<gototop>
# ============================================================
-<p><strong><a name="source-cd">What are the "source" CDs? Do I
-need them?</a></strong></p>
+<toc-add-entry name="source-cd">What are the "source" CDs? Do I
+need them?</toc-add-entry>
<p>There are two types of images, the "binary" CDs that contain
precompiled, ready-to-run programs, and the "source" CDs that
@@ -161,8 +136,8 @@
<gototop>
# ============================================================
-<p><strong><a name="nonus">What is the difference between the
-normal binary-1 and the binary-1-nonus CDs?</a></strong></p>
+<toc-add-entry name="nonus">What is the difference between the
+normal binary-1 and the binary-1-nonus CDs?</toc-add-entry>
<p>There are two variants of the binary-1 CD, one with and one
without software of the "non-US" category. Non-US software may be
@@ -187,8 +162,8 @@
<gototop>
# ============================================================
-<p><strong><a name="nonfree">Where is the CD image with
-non-free?</a></strong></p>
+<toc-add-entry name="nonfree">Where is the CD image with
+non-free?</toc-add-entry>
<p>Debian has a quite strict view with regard to the licenses of
software: Only software that is Free in the sense of the
@@ -210,8 +185,8 @@
<gototop>
# ============================================================
-<p><strong><a name="dvd">Are any DVD images of the Debian
-distribution available for download?</a></strong></p>
+<toc-add-entry name="dvd">Are any DVD images of the Debian
+distribution available for download?</toc-add-entry>
<p>No, not at the moment, sorry! However, there are plans to offer
DVD images via jigdo at some point.</p>
@@ -219,8 +194,8 @@
<gototop>
# ============================================================
-<p><strong><a name="live-cd">Is a Debian "live CD"
-available?</a></strong></p>
+<toc-add-entry name="live-cd">Is a Debian "live CD"
+available?</toc-add-entry>
<p>A so-called "live CD" is a CD which contains a complete system
pre-installed on the CD. You do not need to install anything on the
@@ -235,9 +210,9 @@
<gototop>
# ============================================================
-<p><strong><a name="bootable">I notice all the CDs are bootable.
+<toc-add-entry name="bootable">I notice all the CDs are bootable.
Is there any difference between the bootable parts of the
-individual CDs?</a></strong></p>
+individual CDs?</toc-add-entry>
<p>Yes, although this is only the case for the i386 architecture.
For other architectures, only the first CD is bootable (except for
@@ -284,8 +259,8 @@
<gototop>
# ============================================================
-<p><strong><a name="arch">Where are the CDs for architecture
-X?</a></strong></p>
+<toc-add-entry name="arch">Where are the CDs for architecture
+X?</toc-add-entry>
<p>Depending on the state of support for a certain architecture,
CD images are available from different places:</p>
@@ -313,8 +288,8 @@
<gototop>
# ============================================================
-<p><strong><a name="outdated">The software on the official CDs is
-outdated - why don't you release a new version?</a></strong></p>
+<toc-add-entry name="outdated">The software on the official CDs is
+outdated - why don't you release a new version?</toc-add-entry>
<p>We only make official releases of the "stable" distribution
when we think they truly deserve that name. Unfortunately, this
@@ -335,8 +310,8 @@
<gototop>
# ============================================================
-<p><strong><a name="newest">How do I know if I am downloading the
-newest CD images?</a></strong></p>
+<toc-add-entry name="newest">How do I know if I am downloading the
+newest CD images?</toc-add-entry>
<p>The note at the bottom of the <a href="../#latest">cdimage
homepage</a> always shows the version number of the latest
@@ -355,8 +330,8 @@
<gototop>
# ============================================================
-<p><strong><a name="verify">How can I verify that the downloaded
-CD images are correct?</a></strong></p>
+<toc-add-entry name="verify">How can I verify that the downloaded
+CD images are correct?</toc-add-entry>
<p>If you use <a href="../jigdo-cd/">jigdo</a>, the checksum of
the image is automatically verified after the image has been
@@ -379,8 +354,8 @@
<gototop>
# ============================================================
-<p><strong><a name="record-unix">How do I record a CD-R under
-Linux/UNIX?</a></strong></p>
+<toc-add-entry name="record-unix">How do I record a CD-R under
+Linux/UNIX?</toc-add-entry>
<p>Use the
<a href="http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html">cdrecord</a>
@@ -393,8 +368,8 @@
<gototop>
# ============================================================
-<p><strong><a name="record-windows">How do I record a CD-R under
-Windows?</a></strong></p>
+<toc-add-entry name="record-windows">How do I record a CD-R under
+Windows?</toc-add-entry>
<p>This might be a little problem, as many Windows programs use
their own formats for CD images. To burn the <tt>.iso</tt> images
@@ -481,8 +456,8 @@
<gototop>
# ============================================================
-<p><strong><a name="record-mac">How do I record a CD-R under
-MacOS?</a></strong></p>
+<toc-add-entry name="record-mac">How do I record a CD-R under
+MacOS?</toc-add-entry>
<p>The "Toast" program for MacOS is reported to work fine with
<tt>.iso</tt> files. You can be extra-safe by giving it the
@@ -500,8 +475,8 @@
<gototop>
# ============================================================
-<p><strong><a name="whatlabel">How should I label the
-CDs?</a></strong></p>
+<toc-add-entry name="whatlabel">How should I label the
+CDs?</toc-add-entry>
<p>There is no obligatory way of labeling. However, we suggest you
use the following scheme to ensure interchangeability:</p>
@@ -552,8 +527,8 @@
<gototop>
# ============================================================
-<p><strong><a name="artwork">Is there any artwork for CDs and
-covers?</a></strong></p>
+<toc-add-entry name="artwork">Is there any artwork for CDs and
+covers?</toc-add-entry>
<p>There is no official layout for the cover, back and label of a
Debian CD, but a number of people have produced nice-looking
@@ -563,9 +538,9 @@
<gototop>
# ============================================================
-<p><strong><a name="lan-install">I want to install Debian on many
+<toc-add-entry name="lan-install">I want to install Debian on many
interconnected computers - how do I set up a local .deb
-cache?</a></strong></p>
+cache?</toc-add-entry>
<p>If you want to install Debian on a large number of machines and
then keep all these installations up-to-date (e.g. security
@@ -608,8 +583,8 @@
<gototop>
# ============================================================
-<p><strong><a name="diy">I have a local Debian mirror and want to
-create my own CDs. How do I do this?</a></strong></p>
+<toc-add-entry name="diy">I have a local Debian mirror and want to
+create my own CDs. How do I do this?</toc-add-entry>
<p>Apart from a <a href="$(HOME)/mirror/">local Debian mirror</a>,
you also need plenty of disc space. The CD creation scripts are packaged in
@@ -639,8 +614,8 @@
<gototop>
# ============================================================
-<p><strong><a name="become-cd-mirror">How do I become a mirror for
-Debian CD images?</a></strong></p>
+<toc-add-entry name="become-cd-mirror">How do I become a mirror for
+Debian CD images?</toc-add-entry>
<p>The necessary steps to set up your CD image mirror and keep it
up to date are <a href="../mirroring/">described on a separate
<set-var toc:_cnt=0 />
<define-tag toc-add-entry endtag="required">
<preserve name />
<set-var %attributes />
<ifeq <get-var name /> "" "<increment toc:_cnt />
<set-var name="l<get-var toc:_cnt />" />" />
<p><strong><a name="<get-var name/>">\
<toc-title-question>%body</toc-title-question></a></strong></p>
{#ToC_questions#: <li><a href="#<get-var name/>">%body</a></li>
:##}
<restore name />
</define-tag>
# May be locally redefined
<define-tag toc-title-question endtag="required" whitespace="delete">
%body
</define-tag>
<define-tag toc-display endtag="required">
<ul>
{#ToC_questions#}
</ul>
</define-tag>
Reply to: