From f8800abb927ebe6fdba2ac011724f5e60f704990 Mon Sep 17 00:00:00 2001 From: Tammy Fox Date: Fri, 13 Aug 2004 16:08:48 +0000 Subject: use common entities file --- docs-intro-en.xml | 4 ++-- docs-tutorial-en.xml | 18 +++++++++--------- docs-xml-tags-en.xml | 10 +++++----- documentation-guide-en.xml | 12 ++++-------- 4 files changed, 20 insertions(+), 24 deletions(-) diff --git a/docs-intro-en.xml b/docs-intro-en.xml index 19e586f..90adb3c 100644 --- a/docs-intro-en.xml +++ b/docs-intro-en.xml @@ -1,11 +1,11 @@ - + Introduction The goal of the Docs Project is to create easy-to-follow, task-based - documentation for &DISTRO; users and developers. Other than the + documentation for &FC; users and developers. Other than the &IG;, each tutorial should be in DocBook XML article format, with one article per topic. This way, writers can contribute documentation about a specific topic without having to worry diff --git a/docs-tutorial-en.xml b/docs-tutorial-en.xml index 3a0aca0..3d68f89 100644 --- a/docs-tutorial-en.xml +++ b/docs-tutorial-en.xml @@ -1,5 +1,4 @@ - - + The Layout of a Tutorial @@ -7,7 +6,8 @@ In this chapter, you will find an example of a &PROJECT; documentation parent file. This example is specific to the way the Docs Project uses DocBook XML. The parent file contains the main structural format of the - book, entities that should be used for this book specifically and more. + book, a link to the entities file that contain common entities that should + be used, and an entity to change the version and date of the tutorial. @@ -22,12 +22,12 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ -<!ENTITY RH "Red Hat"> <!--The generic term "Red Hat" --> -<!ENTITY FORMAL-RHI "&RH;, Inc."> <!--The generic term "Red Hat, Inc. --> -<!ENTITY PROJECT "Fedora project"> <!-- Set the project name --> -<!ENTITY NAME-TITLE "Fedora Project"> <!-- Set the project name, use for titles --> -<!ENTITY DISTRO "Fedora Core"> <!-- Set the distro name --> -<!ENTITY BOOKID "example-tutorial-0.1 (2003-07-07)"> <!-- change version of manual and date here --> +<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../common/fedora-entities-en.xml"> +%FEDORA-ENTITIES-EN; + +<!ENTITY VERSION "0.1"> <!-- change version of tutorial here --> + +<!ENTITY BOOKID "example-tutorial-&VERSION; (2003-07-07)"> <!-- change last modified date here --> <!ENTITY LEGALNOTICE SYSTEM "../common/legalnotice-en.xml"> diff --git a/docs-xml-tags-en.xml b/docs-xml-tags-en.xml index af27ea7..0fc2ab0 100644 --- a/docs-xml-tags-en.xml +++ b/docs-xml-tags-en.xml @@ -1,4 +1,4 @@ - + DocBook XML Tags @@ -191,7 +191,7 @@ browser. -<!--$Id: docs-xml-tags-en.xml,v 1.8 2004/08/12 21:33:45 tfox Exp $ --> +<!--$Id: docs-xml-tags-en.xml,v 1.9 2004/08/13 16:08:48 tfox Exp $ --> <chapter id="ch-sample"> <title>Sample Chapter</title> @@ -511,7 +511,7 @@ To use the <application>Keyboard Configuration Tool</application>, t Nearly every modern-day operating system uses <firstterm>disk -partitions</firstterm>, and &DISTRO; is no exception. +partitions</firstterm>, and &FC; is no exception. @@ -521,7 +521,7 @@ partitions</firstterm>, and &DISTRO; is no exception. Nearly every modern-day operating system uses disk - partitions, and &DISTRO; is no exception. + partitions, and &FC; is no exception. @@ -1690,7 +1690,7 @@ own entry to refer to. <partintro> <para>This section contains information you will need when you first join the Docs group. You might need to refer to this part again for - information such as installing &DISTRO;.</para> + information such as installing &FC;.</para> </partintro> diff --git a/documentation-guide-en.xml b/documentation-guide-en.xml index f77d1a6..4ffd001 100644 --- a/documentation-guide-en.xml +++ b/documentation-guide-en.xml @@ -1,14 +1,10 @@ - + - - - - - + +%FEDORA-ENTITIES-EN; @@ -34,7 +30,7 @@ - &NAME-TITLE; Documentation Guide + &FP; Documentation Guide Version &VERSION; 2003,2004 -- cgit