from code-server

This commit is contained in:
Andy Bunce 2021-03-23 22:38:58 +00:00
parent eda5c02fe9
commit 5ef8bdba47
2652 changed files with 528235 additions and 0 deletions

View file

@ -0,0 +1,26 @@
<?xml version="1.0" encoding="UTF-8"?>
<project name="build-chm-pdf-hybrid" default="all" basedir=".">
<description>An Ant build that calls the dita command</description>
<include file="dita-cmd.xml"/><!-- defines the <dita-cmd> macro -->
<target name="all" depends="pre,main,post"/>
<target name="pre">
<description>Preprocessing steps</description>
</target>
<target name="main">
<description>Build the CHM and PDF with the dita command</description>
<property name="absolute.path.base" location="../"/>
<dita-cmd
input="${absolute.path.base}/sequence.ditamap"
format="htmlhelp"
propertyfile="${absolute.path.base}/properties/chm.properties"
/>
<dita-cmd
input="${absolute.path.base}/taskbook.ditamap"
format="pdf"
propertyfile="${absolute.path.base}/properties/pdf.properties"
/>
</target>
<target name="post">
<description>Postprocessing steps</description>
</target>
</project>

View file

@ -0,0 +1,22 @@
<?xml version="1.0" encoding="UTF-8"?>
<project name="build-chm-pdf" default="all" basedir=".">
<property name="dita.dir" location="${basedir}/../../.."/>
<target name="all" description="build CHM and PDF" depends="chm,pdf"/>
<target name="chm" description="build CHM">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="../sequence.ditamap"/>
<property name="transtype" value="htmlhelp"/>
<property name="output.dir" location="../out/chm"/>
<property name="args.gen.task.lbl" value="YES"/>
</ant>
</target>
<target name="pdf" description="build PDF">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="../taskbook.ditamap"/>
<property name="transtype" value="pdf"/>
<property name="output.dir" location="../out/pdf"/>
<property name="args.gen.task.lbl" value="YES"/>
<property name="args.rellinks" value="nofamily"/>
</ant>
</target>
</project>

View file

@ -0,0 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<project basedir="." name="dita-cmd">
<description>Defines a dita-cmd macro you can use in your Ant builds. See build-chm-pdf-hybrid.xml for
usage.</description>
<property name="dita.dir" location="${basedir}/../../.."/>
<macrodef name="dita-cmd">
<attribute name="input"/>
<attribute name="format"/>
<attribute name="propertyfile"/>
<sequential>
<!-- For Unix run the DITA executable-->
<exec taskname="dita-cmd" executable="${dita.dir}/bin/dita" osfamily="unix" failonerror="true">
<arg value="--input"/>
<arg value="@{input}"/>
<arg value="--format"/>
<arg value="@{format}"/>
<arg value="--propertyfile"/>
<arg value="@{propertyfile}"/>
</exec>
<!-- For Windows run DITA from a DOS command -->
<exec taskname="dita-cmd" dir="${dita.dir}/bin" executable="cmd" osfamily="windows" failonerror="true">
<arg value="/C"/>
<arg value="dita --input @{input} --format @{format} --propertyfile=@{propertyfile}"/>
</exec>
</sequential>
</macrodef>
</project>

View file

@ -0,0 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<project name="sample_all" default="all" basedir=".">
<import file="sample_html5.xml"/>
<import file="sample_xhtml_plus_css.xml"/>
<import file="sample_eclipsehelp.xml"/>
<import file="sample_htmlhelp.xml"/>
<import file="sample_pdf.xml"/>
<target name="all" depends="samples"/>
<target
name="samples"
description="build the sample output"
depends="samples.html5, samples.xhtml_plus_css, samples.eclipse, samples.htmlhelp, samples.pdf"
/>
<target
name="clean.samples"
description="remove the sample output"
depends="clean.samples.html5, clean.samples.xhtml_plus_css, clean.samples.eclipse, clean.samples.htmlhelp, clean.samples.pdf"
>
<delete dir="${dita.dir}/out/samples"/>
</target>
</project>

View file

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<project name="sample_eclipsehelp" default="samples.eclipse" basedir=".">
<property name="dita.dir" location="${basedir}/../../.."/>
<target name="samples.eclipse" description="build the samples for Eclipse" depends="clean.samples.eclipse">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="${dita.dir}/docsrc/samples/hierarchy.ditamap"/>
<property name="output.dir" location="${dita.dir}/out/samples/org.dita.sample.doc"/>
<property name="transtype" value="eclipsehelp"/>
</ant>
</target>
<target name="clean.samples.eclipse" description="remove the sample Eclipse output">
<delete dir="${dita.dir}/out/samples/org.dita.sample.doc"/>
</target>
</project>

View file

@ -0,0 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<project name="sample_html5" default="samples.html5" basedir=".">
<property name="dita.dir" location="${basedir}/../../.."/>
<target name="samples.html5" description="build the HTML5 samples" depends="clean.samples.html5">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="${dita.dir}/docsrc/samples/hierarchy.ditamap"/>
<property name="output.dir" location="${dita.dir}/out/samples/html5"/>
<property name="args.html5.toc" value="toc"/>
<property name="transtype" value="html5"/>
</ant>
</target>
<target name="clean.samples.html5" description="remove the sample html5 output">
<delete dir="${dita.dir}/out/samples/html5"/>
</target>
</project>

View file

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<project name="sample_htmlhelp" default="samples.htmlhelp" basedir=".">
<property name="dita.dir" location="${basedir}/../../.."/>
<target name="samples.htmlhelp" description="build the samples for HTMLHelp" depends="clean.samples.htmlhelp">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="${dita.dir}/docsrc/samples/hierarchy.ditamap"/>
<property name="output.dir" location="${dita.dir}/out/samples/htmlhelp"/>
<property name="transtype" value="htmlhelp"/>
</ant>
</target>
<target name="clean.samples.htmlhelp" description="remove the sample HTMLHelp output">
<delete dir="${dita.dir}/out/samples/htmlhelp"/>
</target>
</project>

View file

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<project name="sample_pdf" default="samples.pdf" basedir=".">
<property name="dita.dir" location="${basedir}/../../.."/>
<target name="samples.pdf" description="build the samples as PDF" depends="clean.samples.pdf">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="${dita.dir}/docsrc/samples/sequence.ditamap"/>
<property name="output.dir" location="${dita.dir}/out/samples/pdf"/>
<property name="transtype" value="pdf"/>
</ant>
</target>
<target name="clean.samples.pdf" description="remove the sample PDF output">
<delete dir="${dita.dir}/out/samples/pdf"/>
</target>
</project>

View file

@ -0,0 +1,26 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<project name="sample_xhtml_plus_css" default="samples.xhtml_plus_css" basedir=".">
<property name="dita.dir" location="${basedir}/../../.."/>
<property name="sample.output.dir" value="${dita.dir}/out/samples/xhtml_plus_css"/>
<property name="css.source.dir" location="${dita.dir}/docsrc/samples/css"/>
<target name="samples.xhtml_plus_css" depends="clean.samples.xhtml_plus_css">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="${dita.dir}/docsrc/samples/hierarchy.ditamap"/>
<property name="output.dir" location="${sample.output.dir}"/>
<property name="transtype" value="xhtml"/>
<property name="args.css" value="style.css"/>
<property name="args.csspath" value="css"/>
<property name="args.copycss" value="yes"/>
<property name="args.cssroot" location="${css.source.dir}"/>
</ant>
</target>
<target name="clean.samples.xhtml_plus_css" description="remove the sample web output">
<delete dir="${sample.output.dir}"/>
</target>
</project>

View file

@ -0,0 +1,24 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- revise @PLACEHOLDER@ names and values-->
<!--
| basedir can be specified to other places base on your need.
|
| Note: input, output, and temp directories will base on the basedir if
| they are relative paths.
* -->
<project name="@PROJECT.NAME@_eclipsehelp" default="@DELIVERABLE.NAME@2eclipsehelp" basedir=".">
<!-- dita.dir should point to the toolkit's root directory -->
<property name="dita.dir" location="${basedir}${file.separator}..${file.separator}..${file.separator}.."/>
<target name="@DELIVERABLE.NAME@2eclipsehelp">
<ant antfile="${dita.dir}${file.separator}build.xml">
<!-- please refer to the toolkit's document for supported parameters, and
specify them base on your needs -->
<property name="args.input" location="@DITA.INPUT@"/>
<property name="output.dir" location="@OUTPUT.DIR@"/>
<property name="transtype" value="eclipsehelp"/>
</ant>
</target>
</project>

View file

@ -0,0 +1,24 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- revise @PLACEHOLDER@ names and values-->
<!--
| basedir can be specified to other places base on your need.
|
| Note: input, output, and temp directories will base on the basedir if
| they are relative paths.
* -->
<project name="@PROJECT.NAME@_htmlhelp" default="@DELIVERABLE.NAME@2htmlhelp" basedir=".">
<!-- dita.dir should point to the toolkit's root directory -->
<property name="dita.dir" location="${basedir}${file.separator}..${file.separator}..${file.separator}.."/>
<target name="@DELIVERABLE.NAME@2htmlhelp">
<ant antfile="${dita.dir}${file.separator}build.xml">
<!-- please refer to the toolkit's document for supported parameters, and
specify them base on your needs -->
<property name="args.input" location="@DITA.INPUT@"/>
<property name="output.dir" location="@OUTPUT.DIR@"/>
<property name="transtype" value="htmlhelp"/>
</ant>
</target>
</project>

View file

@ -0,0 +1,24 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- revise @PLACEHOLDER@ names and values-->
<!--
| basedir can be specified to other places base on your need.
|
| Note: input, output, and temp directories will base on the basedir if
| they are relative paths.
* -->
<project name="@PROJECT.NAME@_pdf" default="@DELIVERABLE.NAME@2pdf" basedir=".">
<!-- dita.dir should point to the toolkit's root directory -->
<property name="dita.dir" location="${basedir}${file.separator}..${file.separator}..${file.separator}.."/>
<target name="@DELIVERABLE.NAME@2pdf">
<ant antfile="${dita.dir}${file.separator}build.xml">
<!-- please refer to the toolkit's document for supported parameters, and
specify them base on your needs -->
<property name="args.input" location="@DITA.INPUT@"/>
<property name="output.dir" location="@OUTPUT.DIR@"/>
<property name="transtype" value="pdf"/>
</ant>
</target>
</project>

View file

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="conceptconcept" xml:lang="en-us">
<title>Garage Concepts</title>
<shortdesc>A well-stocked garage can be the envy of the neighborhood.</shortdesc>
<conbody/>
</concept>

View file

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="lawnmowerconcept" xml:lang="en-us">
<title>Lawnmower</title>
<shortdesc>The lawnmower is a machine used to cut grass in the yard.</shortdesc>
<conbody>
<p>Lawnmowers can be electric, gas-powered, or manual.</p>
</conbody>
</concept>

View file

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="oilconcept" xml:lang="en-us">
<title>Oil</title>
<shortdesc>Motor oil keeps your car's engine running smoothly.</shortdesc>
<conbody>
<p>Oil should be changed every 6000 kilometers.</p>
</conbody>
<related-links>
<link href="../tasks/changingtheoil.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="paintconcept" xml:lang="en-us">
<title>Paint</title>
<shortdesc>Paint is useful for refreshing the look of rooms and furniture.</shortdesc>
<conbody>
<p>Store unused paint in the garage.</p>
</conbody>
<related-links>
<link href="../tasks/spraypainting.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="shelvingconcept" xml:lang="en-us">
<title>Shelving</title>
<shortdesc>Wooden or metal shelving is useful for storing things in the garage.</shortdesc>
<conbody>
<p>Shelving also keeps things neat and organized.</p>
</conbody>
<related-links>
<link href="../tasks/organizing.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="snowshovelconcept" xml:lang="en-us">
<title>Snow shovel</title>
<shortdesc>Use the snow shovel to clear the drive way and side walk of snow in the winter.</shortdesc>
<conbody>
<p>A good snow shovel has a straight, wide scoop and a strong handle. To help snow come off the scoop, spray the
scoop with cooking spray.</p>
</conbody>
<related-links>
<link href="../tasks/shovellingsnow.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="toolboxconcept" xml:lang="en-us">
<title>Tool box</title>
<shortdesc>A tool box contains many compartments for organizing tools and hardware.</shortdesc>
<conbody>
<p>Keep the tool box handy for all sorts of jobs around the house.</p>
</conbody>
<related-links>
<link href="tools.xml" format="dita" type="concept"/>
<link href="../tasks/organizing.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="toolsconcept" xml:lang="en-us">
<title>Tools</title>
<shortdesc>Invest in a good set of tools for doing all kinds of tasks around the house.</shortdesc>
<conbody>
<p>Useful tools include the following items:</p>
<ul>
<li>Hammer</li>
<li>Screw driver set</li>
<li>Wrench set</li>
<li>Nails and screws</li>
<li>Level</li>
<li>Saws</li>
<li>Drill</li>
<li>Air pressure guage</li>
<li>Spade</li>
<li>Rake</li>
</ul>
<p>Keep your tools organized in a tool box.</p>
</conbody>
<related-links>
<link href="toolbox.xml" format="dita" type="concept"/>
<link href="../tasks/organizing.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="waterhoseconcept" xml:lang="en-us">
<title>Water hose</title>
<shortdesc>A water hose is useful for cleaning and gardening projects around the yard.</shortdesc>
<conbody>
<p>Keep the hose coiled on a large hook near a water spout.</p>
</conbody>
<related-links>
<link href="../tasks/washingthecar.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="wheelbarrow" xml:lang="en-us">
<title>Wheel barrow</title>
<shortdesc>A good wheel barrow will save your back from extensive trauma when you garden.</shortdesc>
<conbody> </conbody>
</concept>

View file

@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="workbenchconcept" xml:lang="en-us">
<title>Workbench</title>
<shortdesc>Use the workbench for storing tools and hardware, and for doing small projects.</shortdesc>
<conbody/>
<related-links>
<link href="../tasks/organizing.xml" format="dita" type="task"/>
</related-links>
</concept>

View file

@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="wwfluidconcept" xml:lang="en-us">
<title>Windshield washer fluid</title>
<shortdesc>Windshield washer fluid is required to keep your windshield wipers functioning properly.</shortdesc>
<conbody>
<p>Keep your car's windshield washer fluid topped up so you will have a clean windshield whatever the weather or
insect population.</p>
</conbody>
</concept>

View file

@ -0,0 +1,94 @@
/**
* This file is part of the DITA Open Toolkit project.
* See the accompanying LICENSE file for applicable license.
*
* This file uses a few simple settings to create a new look and feel
* for the generated XHTML output. Note that most elements are still
* styled based on the toolkit's default CSS file, while this CSS
* file only provides a few overrides to that core style.
*
* For a sample build that uses this CSS file, see the following Ant
* build file within the DITA-OT installation directory:
* `docsrc/samples/ant_sample/sample_xhtml_plus_css.xml`
*/
* {
margin: 0;
padding: 0;
top: auto;
}
.topictitle1 {
font-size: 2.5em;
}
body {
background: #fff;
background: linear-gradient(to bottom, #eee 0%, #fff);
color: #666;
float: left;
font-family: 'Trebuchet MS', 'Times New Roman', Times, serif;
font-size: 0.9em;
margin: 30px 0;
padding: 0 5px 0 30px;
text-align: left;
width: 640px;
}
h1,
h2,
h3 {
font-family: Arial, Helvetica, sans-serif;
margin-bottom: 15px;
padding-bottom: 10px;
text-transform: uppercase;
}
p,
ul,
ol,
dl {
margin-top: 1.5em;
}
ul,
ol,
dl {
margin-left: 3em;
}
dt {
font-weight: bold;
}
dd {
margin-left: 3em;
}
blockquote {
font-style: italic;
margin-left: 3em;
margin-right: 3em;
}
a {
color: #70a300;
text-decoration: none;
}
a:hover {
border: 0;
color: #70a300;
}
/* Inline Table of Contents */
nav[role='toc'] {
float: right;
max-width: 200px;
font-size: small;
border-left: 1px solid #70a300;
margin-left: 1em;
}
nav[role='toc'] > ul {
margin-top: 0;
}

View file

@ -0,0 +1,8 @@
# Use the latest official DITA-OT image as parent: ↓
FROM docker.pkg.github.com/dita-ot/dita-ot/dita-ot:3.6
# Install a custom plug-in from a remote location:
RUN dita --install https://github.com/infotexture/dita-bootstrap/archive/3.4.1.zip
# Install from the registry at dita-ot.org/plugins:
RUN dita --install org.dita-community.pdf-page-break

View file

@ -0,0 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<map>
<title>Working in the garage</title>
<topicref href="tasks/garagetaskoverview.xml" type="concept">
<topicref href="tasks/changingtheoil.xml" type="task"/>
<topicref href="tasks/organizing.xml" type="task"/>
<topicref href="tasks/shovellingsnow.xml" type="task"/>
<topicref href="tasks/spraypainting.xml" type="task"/>
<topicref href="tasks/takinggarbage.xml" type="task"/>
<topicref href="tasks/washingthecar.xml" type="task"/>
</topicref>
<topicref href="concepts/garageconceptsoverview.xml" type="concept">
<topicref href="concepts/lawnmower.xml" type="concept"/>
<topicref href="concepts/oil.xml" type="concept"/>
<topicref href="concepts/paint.xml" type="concept"/>
<topicref href="concepts/shelving.xml" type="concept"/>
<topicref href="concepts/snowshovel.xml" type="concept"/>
<topicref href="concepts/toolbox.xml" type="concept"/>
<topicref href="concepts/tools.xml" type="concept"/>
<topicref href="concepts/waterhose.xml" type="concept"/>
<topicref href="concepts/wheelbarrow.xml" type="concept"/>
<topicref href="concepts/workbench.xml" type="concept"/>
<topicref href="concepts/wwfluid.xml" type="concept"/>
</topicref>
</map>

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.9 KiB

View file

@ -0,0 +1,14 @@
<?xml version='1.0' encoding='UTF-8'?>
<project>
<target name="dita2html5-custom-css"
depends="dita2html5-custom-css.init,
dita2html5"/>
<target name="dita2html5-custom-css.init">
<property name="args.cssroot"
location="${dita.plugin.com.example.html5-custom-css.dir}/css"/>
<property name="args.css" value="custom.css"/>
<property name="args.copycss" value="yes"/>
<property name="args.csspath" value="css"/>
</target>
</project>

View file

@ -0,0 +1,5 @@
/* These custom styles extend or override DITA Open Toolkit default styles. */
body {
color: red;
}

View file

@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/plugin.rnc" type="application/relax-ng-compact-syntax"?>
<plugin id="com.example.html5-custom-css">
<require plugin="org.dita.html5"/>
<transtype name="html5-custom-css" extends="html5" desc="HTML5 with custom CSS"/>
<feature extension="ant.import" file="build_html5-custom-css.xml"/>
</plugin>

View file

@ -0,0 +1,11 @@
<?xml version='1.0' encoding='UTF-8'?>
<project>
<target name="dita2html5-javascript"
depends="dita2html5-javascript.init,
dita2html5"/>
<target name="dita2html5-javascript.init">
<property name="args.ftr"
location="${dita.plugin.com.example.html5-javascript.dir}/include/javascript.ftr.xml"/>
</target>
</project>

View file

@ -0,0 +1,15 @@
<div>
<!-- Google Analytics -->
<script>
console.log('Adding Google Analytics tracker');
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
</div>

View file

@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/plugin.rnc" type="application/relax-ng-compact-syntax"?>
<plugin id="com.example.html5-javascript">
<require plugin="org.dita.html5"/>
<transtype name="html5-javascript" extends="html5" desc="HTML5 with embedded JavaScript"/>
<feature extension="ant.import" file="build_html5-javascript.xml"/>
</plugin>

View file

@ -0,0 +1,16 @@
<?xml version='1.0' encoding='UTF-8'?>
<project>
<target name="dita2html5-webfont"
depends="dita2html5-webfont.init,
dita2html5"/>
<target name="dita2html5-webfont.init">
<property name="args.hdf"
location="${dita.plugin.com.example.html5-webfont.dir}/include/webfont.hdf.xml"/>
<property name="args.cssroot"
location="${dita.plugin.com.example.html5-webfont.dir}/css"/>
<property name="args.css" value="custom.css"/>
<property name="args.copycss" value="yes"/>
<property name="args.csspath" value="css"/>
</target>
</project>

View file

@ -0,0 +1,3 @@
body {
font-family: 'Noto Sans', sans-serif;
}

View file

@ -0,0 +1,3 @@
<div>
<link href="https://fonts.googleapis.com/css?family=Noto+Sans" rel="stylesheet"/>
</div>

View file

@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/plugin.rnc" type="application/relax-ng-compact-syntax"?>
<plugin id="com.example.html5-webfont">
<require plugin="org.dita.html5"/>
<transtype name="html5-webfont" extends="html5" desc="HTML5 with Noto Sans webfont"/>
<feature extension="ant.import" file="build_html5-webfont.xml"/>
</plugin>

View file

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<catalog prefer="system"
xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
<uri name="cfg:fo/attrs/custom.xsl" uri="fo/attrs/custom.xsl"/>
<uri name="cfg:fo/xsl/custom.xsl" uri="fo/xsl/custom.xsl"/>
</catalog>

View file

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="UTF-8"?>
<vars xmlns="http://www.idiominc.com/opentopic/vars">
<!-- Remove dot from list number -->
<variable id="Ordered List Number">
<param ref-name="number"/>
</variable>
<!-- Change unordered list bullet to an em dash -->
<variable id="Unordered List bullet">&#x2014;</variable>
</vars>

View file

@ -0,0 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="2.0">
<!-- Change page size to A4 -->
<xsl:variable name="page-width">210mm</xsl:variable>
<xsl:variable name="page-height">297mm</xsl:variable>
</xsl:stylesheet>

View file

@ -0,0 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format"
version="2.0">
<!-- Move figure title to top and description to bottom -->
<xsl:template match="*[contains(@class,' topic/fig ')]">
<fo:block xsl:use-attribute-sets="fig">
<xsl:call-template name="commonattributes"/>
<xsl:if test="not(@id)">
<xsl:attribute name="id">
<xsl:call-template name="get-id"/>
</xsl:attribute>
</xsl:if>
<xsl:apply-templates select="*[contains(@class,' topic/title ')]"/>
<xsl:apply-templates select="*[not(contains(@class,' topic/title ') or contains(@class,' topic/desc '))]"/>
<xsl:apply-templates select="*[contains(@class,' topic/desc ')]"/>
</fo:block>
</xsl:template>
</xsl:stylesheet>

View file

@ -0,0 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<project>
<target name="dita2print-pdf"
depends="dita2print-pdf.init,
dita2pdf2"/>
<target name="dita2print-pdf.init">
<property name="customization.dir"
location="${dita.plugin.com.example.print-pdf.dir}/cfg"/>
</target>
</project>

View file

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/plugin.rnc" type="application/relax-ng-compact-syntax"?>
<plugin id="com.example.print-pdf">
<require plugin="org.dita.pdf2"/>
<transtype name="print-pdf" extends="pdf" desc="PDF on A4 paper"/>
<feature extension="dita.transtype.print" value="print-pdf"/>
<feature extension="ant.import" file="integrator.xml"/>
</plugin>

View file

@ -0,0 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/project.rnc" type="application/relax-ng-compact-syntax"?>
<project xmlns="https://www.dita-ot.org/project">
<include href="html.xml"/>
<include href="htmlhelp.xml"/>
<include href="pdf.xml"/>
</project>

View file

@ -0,0 +1,11 @@
{
"contexts": [
{
"id": "html",
"input": "../../userguide.ditamap",
"profiles": {
"ditavals": ["../../resources/html.ditaval"]
}
}
]
}

View file

@ -0,0 +1,10 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/project.rnc" type="application/relax-ng-compact-syntax"?>
<project xmlns="https://www.dita-ot.org/project">
<context id="html" name="HTML">
<input href="../../userguide.ditamap"/>
<profile>
<ditaval href="../../resources/html.ditaval"/>
</profile>
</context>
</project>

View file

@ -0,0 +1,7 @@
---
contexts:
- id: 'html'
input: '../../userguide.ditamap'
profiles:
ditavals:
- '../../resources/html.ditaval'

View file

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/project.rnc" type="application/relax-ng-compact-syntax"?>
<project xmlns="https://www.dita-ot.org/project">
<include href="html.xml"/>
<include href="pdf.xml"/>
</project>

View file

@ -0,0 +1,51 @@
{
"includes": ["common.json"],
"deliverables": [
{
"name": "HTML5",
"context": {"idref": "html"},
"output": ".",
"publication": {
"transtype": "html5",
"params": [
{
"name": "args.copycss",
"value": "yes"
},
{
"name": "args.css",
"value": "dita-ot-doc.css"
},
{
"name": "args.csspath",
"value": "css"
},
{
"name": "args.cssroot",
"path": "../../resources"
},
{
"name": "args.gen.task.lbl",
"value": "YES"
},
{
"name": "args.hdr",
"href": "../../resources/header.xml"
},
{
"name": "html5.toc.generate",
"value": "no"
},
{
"name": "nav-toc",
"value": "partial"
},
{
"name": "processing-mode",
"value": "strict"
}
]
}
}
]
}

View file

@ -0,0 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/project.rnc" type="application/relax-ng-compact-syntax"?>
<project xmlns="https://www.dita-ot.org/project">
<include href="common.xml"/>
<deliverable name="HTML5" id="html">
<context idref="html"/>
<output href="."/>
<publication transtype="html5">
<param name="args.copycss" value="yes"/>
<param name="args.css" value="dita-ot-doc.css"/>
<param name="args.csspath" value="css"/>
<param name="args.cssroot" path="../../resources"/>
<param name="args.gen.task.lbl" value="YES"/>
<param name="args.hdr" href="../../resources/header.xml"/>
<param name="html5.toc.generate" value="no"/>
<param name="nav-toc" value="partial"/>
<param name="processing-mode" value="strict"/>
</publication>
</deliverable>
</project>

View file

@ -0,0 +1,29 @@
---
includes:
- 'common.yaml'
deliverables:
- name: 'HTML5'
context:
idref: 'html'
output: '.'
publication:
transtype: 'html5'
params:
- name: 'args.copycss'
value: 'yes'
- name: 'args.css'
value: 'dita-ot-doc.css'
- name: 'args.csspath'
value: 'css'
- name: 'args.cssroot'
path: '../../resources'
- name: 'args.gen.task.lbl'
value: 'YES'
- name: 'args.hdr'
href: '../../resources/header.xml'
- name: 'html5.toc.generate'
value: 'no'
- name: 'nav-toc'
value: 'partial'
- name: 'processing-mode'
value: 'strict'

View file

@ -0,0 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/project.rnc" type="application/relax-ng-compact-syntax"?>
<project xmlns="https://www.dita-ot.org/project">
<deliverable name="HTMLHelp" id="htmlhelp">
<context idref="html"/>
<output href="htmlhelp"/>
<publication transtype="htmlhelp">
<param name="args.copycss" value="yes"/>
<param name="args.css" value="dita-ot-doc.css"/>
<param name="args.csspath" value="css"/>
<param name="args.cssroot" path="../../resources"/>
<param name="args.gen.task.lbl" value="YES"/>
<param name="processing-mode" value="strict"/>
</publication>
</deliverable>
</project>

View file

@ -0,0 +1,17 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="https://www.dita-ot.org/rng/project.rnc" type="application/relax-ng-compact-syntax"?>
<project xmlns="https://www.dita-ot.org/project">
<deliverable id="pdf">
<context name="User Guide">
<input href="../../userguide-book.ditamap"/>
</context>
<output href="."/>
<publication transtype="pdf2">
<param name="args.chapter.layout" value="BASIC"/>
<param name="args.gen.task.lbl" value="YES"/>
<param name="include.rellinks" value="friend"/>
<param name="outputFile.base" value="userguide"/>
<param name="processing-mode" value="strict"/>
</publication>
</deliverable>
</project>

View file

@ -0,0 +1,2 @@
output.dir = out/chm
args.gen.task.lbl = YES

View file

@ -0,0 +1,26 @@
# Copy the custom .css file to the output directory:
args.copycss = yes
# Custom .css file used to style output:
args.css = dita-ot-doc.css
# Location of the copied .css file relative to the output:
args.csspath = css
# Directory that contains the custom .css file:
args.cssroot = resources
# Generate headings for sections within task topics:
args.gen.task.lbl = YES
# File that contains the running header content:
args.hdr = ${basedir}/resources/header.xml
# Skip Table of Contents file generation:
html5.toc.generate = no
# Generate a partial navigation TOC in topic pages:
nav-toc = partial
# Stop processing if there are any errors:
processing-mode = strict

View file

@ -0,0 +1,17 @@
# Copy the custom .css file to the output directory:
args.copycss = yes
# Custom .css file used to style output:
args.css = dita-ot-doc.css
# Location of the copied .css file relative to the output:
args.csspath = css
# Directory that contains the custom .css file:
args.cssroot = resources
# Generate headings for sections within task topics:
args.gen.task.lbl = YES
# Stop processing if there are any errors:
processing-mode = strict

View file

@ -0,0 +1,14 @@
# Disable default MiniToC layout
args.chapter.layout = BASIC
# Generate headings for sections within task topics:
args.gen.task.lbl = YES
# Include only related links from reltables
include.rellinks = friend
# Base file name of the generated PDF file:
outputFile.base = userguide
# Stop processing if there are any errors:
processing-mode = strict

View file

@ -0,0 +1,3 @@
output.dir = out/pdf
args.gen.task.lbl = YES
args.rellinks = nofamily

View file

@ -0,0 +1,14 @@
# Directory that contains the custom .css file:
args.cssroot = ${args.input.dir}/css/
# Custom .css file used to style output:
args.css = style.css
# Copy the custom .css file to the output directory:
args.copycss = yes
# Location of the copied .css file relative to the output:
args.csspath = branding
# Generate a full navigation TOC in topic pages:
nav-toc = full

View file

@ -0,0 +1,499 @@
# ============================================================================ #
#
# GENERATED PROPERTIES FILE FOR USE WITH THE DITA COMMAND
#
# Lines in this file that start with a number sign '#' are comments.
#
# To set a build parameter, remove the commenting '#' at the start of the line
# and specify the value for the parameter after the '=' sign, for example,
#
# args.filter = my-filter.ditaval
#
# Use the `dita` command with the `--propertyfile` option to use the build
# parameters specified in a properties file, for example:
#
# dita --input=my.ditamap --format=html5 --propertyfile=my.properties
#
# Build parameters in this file are grouped by transformation type.
# Supported parameter values are listed in brackets [] after each description,
# with an asterisk (*) indicating the default value where appropriate.
#
# ============================================================================ #
# ============================================================================ #
# COMMON
# ============================================================================ #
# args.draft = no
# Specifies whether the content of <draft-comment> and
# <required-cleanup> elements is included in the output.
# [ no ]*
# [ yes ]
# args.figurelink.style = NUMBER
# Specifies how cross references to figures are styled in
# output.
# [ NUMBER ]
# [ NUMTITLE ]
# [ TITLE ]
# args.filter =
# Specifies a filter file to be used to include, exclude, or
# flag content.
# args.gen.task.lbl = YES
# Specifies whether to generate headings for sections within
# task topics.
# [ NO ]
# [ YES ]
# args.grammar.cache = yes
# Specifies whether the grammar-caching feature of the XML
# parser is used.
# [ no ]
# [ yes ]*
# args.input.dir =
# Specifies the base directory for your documentation project.
# args.output.base =
# Specifies the name of the output file without file
# extension.
# args.rellinks = none
# Specifies which links to include in the output.
# [ all ] - All links are included.
# [ nofamily ] - Parent, child, next, and previous links are
# not included.
# [ none ] - No links are included.
# [ noparent ] - Parent links are not included.
# args.resources =
# Specifies resource files.
# args.tablelink.style = NUMBER
# Specifies how cross references to tables are styled.
# [ NUMBER ]
# [ NUMTITLE ]
# [ TITLE ]
# clean.temp = yes
# Specifies whether DITA-OT deletes the files in the temporary
# directory after it finishes a build.
# [ no ]
# [ yes ]*
# conserve-memory = false
# Conserve memory at the expense of processing speed.
# [ false ]*
# [ true ]
# default.language =
# Specifies the default language for source documents.
# dita.dir =
# Specifies where DITA-OT is installed.
# dita.temp.dir =
# Specifies the location of the temporary directory.
# filter-stage = early
# Specifies whether filtering is done before all other
# processing, or after key and conref processing.
# [ early ]*
# [ late ]
# force-unique = false
# Generate copy-to attributes to duplicate topicref elements.
# [ false ]*
# [ true ]
# generate-debug-attributes = true
# Specifies whether the @xtrf and @xtrc debugging attributes
# are generated in the temporary files.
# [ false ] - Disables generation of debugging attributes
# [ true ]* - Enables generation of debugging attributes
# generate.copy.outer = 1
# Adjust how output is generated for content that is located
# outside the directory containing the DITA map.
# [ 1 ]* - Do not generate output for content that is located
# outside the DITA map directory.
# [ 3 ] - Shift the output directory so that it contains all
# output for the publication.
# link-crawl = topic
# Specifies whether to crawl only those topic links found in
# maps, or all discovered topic links.
# [ map ]
# [ topic ]*
# onlytopic.in.map = false
# Specifies whether files that are linked to, or referenced
# with a @conref attribute, generate output.
# [ false ]*
# [ true ]
# outer.control = warn
# Specifies whether to warn or fail if content is located
# outside the directory containing the DITA map.
# [ fail ] - Fail quickly if files are going to be generated
# or copied outside of the directory.
# [ quiet ] - Quietly finish without generating warnings or
# errors.
# [ warn ]* - Complete the operation if files will be
# generated or copied outside of the directory, but log a
# warning.
# output.dir =
# Specifies the name and location of the output directory.
# parallel = false
# Run processes in parallel when possible.
# [ false ]*
# [ true ]
# processing-mode = lax
# Specifies how DITA-OT handles errors and error recovery.
# [ lax ]* - When an error is encountered, DITA-OT attempts to
# recover from it
# [ skip ] - When an error is encountered, DITA-OT continues
# processing but does not attempt error recovery
# [ strict ] - When an error is encountered, DITA-OT stops
# processing
# remove-broken-links = false
# Remove broken related links.
# [ false ]*
# [ true ]
# result.rewrite-rule.class =
# Specifies the name of the Java class used to rewrite
# filenames.
# result.rewrite-rule.xsl =
# Specifies the name of the XSLT file used to rewrite
# filenames.
# root-chunk-override =
# Override for map chunk attribute value.
# store-type = file
# Temporary file store type.
# [ file ]*
# [ memory ]
# validate = true
# Specifies whether DITA-OT validates the content.
# [ false ]
# [ true ]*
# ============================================================================ #
# ECLIPSE HELP
# ============================================================================ #
# args.eclipse.provider = DITA
# Specifies the name of the person or organization that
# provides the Eclipse help. Default value: DITA.
# args.eclipse.symbolic.name = org.sample.help.doc
# Specifies the symbolic name (aka plugin ID) in the output
# for an Eclipse Help project. Default value:
# org.sample.help.doc.
# args.eclipse.version = 0.0.0
# Specifies the version number to include in the output.
# Default value: 0.0.0.
# args.eclipsehelp.country =
# Specifies the region for the language that is specified by
# the args.
# args.eclipsehelp.jar.name =
# Specifies that the output should be zipped and returned
# using this name.
# args.eclipsehelp.language =
# Specifies the base language for translated content, such as
# en for English.
# ============================================================================ #
# HTML-BASED OUTPUT
# ============================================================================ #
# args.artlbl = no
# Specifies whether to generate a label for each image; the
# label will contain the image file name.
# [ no ]*
# [ yes ]
# args.copycss = no
# Specifies whether to copy the custom .css file to the output
# directory.
# [ no ]*
# [ yes ]
# args.css =
# Specifies the name of a custom .css file.
# args.csspath =
# Specifies the location of a copied .css file relative to the
# output directory.
# args.cssroot =
# Specifies the directory that contains the custom .css file.
# args.dita.locale =
# Specifies the language locale file to use for sorting index
# entries.
# args.ftr =
# Specifies an XML file that contains content for a running
# footer.
# args.gen.default.meta = no
# Generate metadata for parental control scanners, meta
# elements with name="security" and name="Robots".
# [ no ]*
# [ yes ]
# args.hdf =
# Specifies an XML file that contains content to be placed in
# the document head.
# args.hdr =
# Specifies an XML file that contains content for a running
# header.
# args.hide.parent.link = no
# Specifies whether to hide links to parent topics in the HTML
# or XHTML output.
# [ no ]*
# [ yes ]
# args.indexshow = no
# Specifies whether the content of <indexterm> elements are
# rendered in the output.
# [ no ]*
# [ yes ]
# args.outext = html
# Specifies the file extension for HTML or XHTML output.
# Default value: html.
# args.xhtml.classattr = yes
# Specifies whether to include the DITA class ancestry inside
# the XHTML elements.
# [ no ]
# [ yes ]*
# args.xsl =
# Specifies a custom XSL file to be used instead of the
# default XSL transformation.
# ============================================================================ #
# HTML5
# ============================================================================ #
# args.artlbl = no
# Specifies whether to generate a label for each image; the
# label will contain the image file name.
# [ no ]*
# [ yes ]
# args.copycss = no
# Specifies whether to copy the custom .css file to the output
# directory.
# [ no ]*
# [ yes ]
# args.css =
# Specifies the name of a custom .css file.
# args.csspath =
# Specifies the location of a copied .css file relative to the
# output directory.
# args.cssroot =
# Specifies the directory that contains the custom .css file.
# args.dita.locale =
# Specifies the language locale file to use for sorting index
# entries.
# args.ftr =
# Specifies an XML file that contains content for a running
# footer.
# args.gen.default.meta = no
# Generate metadata for parental control scanners, meta
# elements with name="security" and name="Robots".
# [ no ]*
# [ yes ]
# args.hdf =
# Specifies an XML file that contains content to be placed in
# the document head.
# args.hdr =
# Specifies an XML file that contains content for a running
# header.
# args.hide.parent.link = no
# Specifies whether to hide links to parent topics in the
# HTML5 output.
# [ no ]*
# [ yes ]
# args.html5.classattr = yes
# Specifies whether to include the DITA class ancestry inside
# the HTML5 elements.
# [ no ]
# [ yes ]*
# args.html5.contenttarget = contentwin
# Specifies the value of the @target attribute on the <base>
# element in the TOC file. Default value: contentwin.
# args.html5.toc = index
# Specifies the base name of the TOC file. Default value:
# index.
# args.html5.toc.class =
# Specifies the value of the @class attribute on the <body>
# element in the TOC file.
# args.html5.toc.xsl =
# Specifies a custom XSL file to be used for TOC generation.
# args.indexshow = no
# Specifies whether the content of <indexterm> elements are
# rendered in the output.
# [ no ]*
# [ yes ]
# args.outext = html
# Specifies the file extension for HTML5 output. Default
# value: html.
# args.xsl =
# Specifies a custom XSL file to be used instead of the
# default XSL transformation.
# html5.toc.generate = yes
# Generate TOC file from the DITA map.
# [ no ]
# [ yes ]*
# nav-toc = none
# Specifies whether to generate a navigation TOC in topic
# pages.
# [ full ] - Full TOC
# [ none ]* - No TOC
# [ partial ] - Partial TOC that shows the current topic
# ============================================================================ #
# MICROSOFT COMPILED HTML HELP
# ============================================================================ #
# args.htmlhelp.includefile =
# Specifies the name of a file that you want included in the
# HTML Help.
# ============================================================================ #
# PDF
# ============================================================================ #
# args.artlbl = no
# Specifies whether to generate a label for each image; the
# label will contain the image file name.
# [ no ]*
# [ yes ]
# args.bookmap-order = discard
# Specifies if the frontmatter and backmatter content order is
# retained in bookmap.
# [ discard ]*
# [ retain ]
# args.bookmark.style = EXPANDED
# Specifies whether PDF bookmarks are by default expanded or
# collapsed.
# [ COLLAPSE ]
# [ EXPANDED ]
# args.chapter.layout = MINITOC
# Specifies whether chapter level TOCs are generated.
# [ BASIC ]
# [ MINITOC ]*
# args.fo.userconfig =
# Specifies the user configuration file for FOP.
# args.xsl.pdf =
# Specifies an XSL file that is used to override the default
# XSL transformation.
# axf.cmd =
# Specifies the path to the Antenna House Formatter
# executable.
# axf.opt =
# Specifies the user configuration file for Antenna House
# Formatter.
# custom.xep.config =
# Specifies the user configuration file for RenderX.
# customization.dir =
# Specifies the customization directory.
# maxJavaMemory =
# Specifies the amount of memory allocated to the RenderX
# process.
# org.dita.pdf2.chunk.enabled = false
# Enables chunk attribute processing.
# [ false ]* - Disables chunk processing
# [ true ] - Enables chunk processing
# org.dita.pdf2.i18n.enabled = true
# Enables I18N font processing.
# [ false ] - Disables I18N processing
# [ true ]* - Enables I18N processing
# outputFile.base =
# Specifies the base file name of the generated PDF file.
# pdf.formatter = fop
# Specifies the XSL processor.
# [ ah ] - Antenna House Formatter
# [ fop ]* - Apache FOP
# [ xep ] - RenderX XEP Engine
# publish.required.cleanup = yes
# Specifies whether draft-comment and required-cleanup
# elements are included in the output.
# [ no ]
# [ yes ]
# ============================================================================ #
# XHTML
# ============================================================================ #
# args.xhtml.contenttarget = contentwin
# Specifies the value of the @target attribute on the <base>
# element in the TOC file. Default value: contentwin.
# args.xhtml.toc = index
# Specifies the base name of the TOC file. Default value:
# index.
# args.xhtml.toc.class =
# Specifies the value of the @class attribute on the <body>
# element in the TOC file.
# args.xhtml.toc.xsl =
# Specifies a custom XSL file to be used for TOC generation.

View file

@ -0,0 +1,24 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<map>
<title>Working in the garage</title>
<topicref href="tasks/changingtheoil.xml" type="task"/>
<topicref href="tasks/organizing.xml" type="task"/>
<topicref href="tasks/shovellingsnow.xml" type="task"/>
<topicref href="tasks/spraypainting.xml" type="task"/>
<topicref href="tasks/takinggarbage.xml" type="task"/>
<topicref href="tasks/washingthecar.xml" type="task"/>
<topicref href="concepts/lawnmower.xml" type="concept"/>
<topicref href="concepts/oil.xml" type="concept"/>
<topicref href="concepts/paint.xml" type="concept"/>
<topicref href="concepts/shelving.xml" type="concept"/>
<topicref href="concepts/snowshovel.xml" type="concept"/>
<topicref href="concepts/toolbox.xml" type="concept"/>
<topicref href="concepts/tools.xml" type="concept"/>
<topicref href="concepts/waterhose.xml" type="concept"/>
<topicref href="concepts/wheelbarrow.xml" type="concept"/>
<topicref href="concepts/workbench.xml" type="concept"/>
<topicref href="concepts/wwfluid.xml" type="concept"/>
</map>

View file

@ -0,0 +1,77 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "bookmap.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2007 All Rights Reserved. -->
<bookmap id="taskbook">
<booktitle>
<booklibrary>Retro Tools</booklibrary>
<mainbooktitle>Product tasks</mainbooktitle>
<booktitlealt>Tasks and what they can do</booktitlealt>
</booktitle>
<bookmeta>
<author>Howe Tuduit</author>
<bookid>
<isbn>071271271X</isbn>
<booknumber>SG99-9999-00</booknumber>
<maintainer>
<organization>Retro Tools</organization>
<person/>
</maintainer>
</bookid>
<bookrights>
<copyrfirst>
<year>2004</year>
</copyrfirst>
<copyrlast>
<year>2007</year>
</copyrlast>
<bookowner>
<organization>Retro Tools, Inc.</organization>
</bookowner>
</bookrights>
</bookmeta>
<frontmatter>
<booklists>
<toc/>
</booklists>
<bookabstract href="taskbook/taskbook-abstract.dita"/>
<notices href="taskbook/notices.dita">
<topicref href="taskbook/trademarks.dita"/>
</notices>
<preface href="taskbook/task_preface.dita"/>
</frontmatter>
<chapter href="taskbook/installing.dita">
<topicref href="taskbook/installstorage.dita">
<topicref href="taskbook/unscrewcover.dita"/>
<topicref href="taskbook/insertdrive.dita"/>
<topicref href="taskbook/replacecover.dita"/>
</topicref>
<topicref href="taskbook/installwebserver.dita">
<topicref href="taskbook/closeprograms.dita"/>
<topicref href="taskbook/runsetup.dita"/>
<topicref href="taskbook/restart.dita"/>
</topicref>
<topicref href="taskbook/installdb.dita"/>
</chapter>
<chapter href="taskbook/configuring.dita">
<topicref href="taskbook/configurestorage.dita"/>
<topicref href="taskbook/configurewebserver.dita"/>
<topicref href="taskbook/configuredatabase.dita"/>
</chapter>
<chapter href="taskbook/maintaining.dita">
<topicref href="taskbook/maintainstorage.dita"/>
<topicref href="taskbook/maintainserver.dita"/>
<topicref href="taskbook/maintaindatabase.dita"/>
</chapter>
<chapter href="taskbook/troubleshooting.dita">
<topicref href="taskbook/drivetrouble.dita"/>
<topicref href="taskbook/webtrouble.dita"/>
<topicref href="taskbook/databasetrouble.dita"/>
</chapter>
<appendix href="taskbook/task_appendix.dita"/>
<backmatter>
<booklists>
<indexlist/>
</booklists>
</backmatter>
</bookmap>

View file

@ -0,0 +1,32 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="closeprograms" xml:lang="en-us">
<title>Close all of your programs</title>
<shortdesc>You need to shut down everything else before installing major programs</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>Close programs</indexterm>
<indexterm>web server</indexterm>
<indexterm>database</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps>
<step>
<cmd>If you are on a Windows system, click the X in the corner of each program.</cmd>
</step>
<step>
<cmd>If you are on a Linux system, type kill -9 [PID] for each of your programs. </cmd>
<tutorialinfo>You might want to save your data first.</tutorialinfo>
</step>
<step>
<cmd>If you are on a Macintosh, you will have to ask someone else. I have a wonderful little iPod, but that is
the limit of my experience with Apple products.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,30 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="configuredatabase" xml:lang="en-us">
<title>Configuring a Database</title>
<shortdesc>Follow these instructions to properly configure your database.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>configure</indexterm>
<indexterm>database</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<context><note>In this instance, the technical writer knows nothing about his subject.</note></context>
<steps>
<step>
<cmd>Read the product documentation. It will tell you what options are available.</cmd>
</step>
<step>
<cmd>Read further in the product documentation. It will tell you how to change these options.</cmd>
</step>
<step>
<cmd>Make sure you store the product documentation in an easy-to-find location when you are done.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,35 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="configurestorage" xml:lang="en-us">
<title>Configuring hard storage devices</title>
<shortdesc>Most hard disks do not need any configuring. If they do, the instructions are relatively
simple.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>hard drive</indexterm>
<indexterm>configure</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<context>First check the documentation that came with your storage device. If the device requires configuring,
follow the steps below.</context>
<steps>
<step>
<cmd>If your system recognizes the device, it may be able to configure it without help. If so, do not try and
stop it.</cmd>
</step>
<step>
<cmd>Otherwise, your drive should come with software. Use this software to format and partition your
drive.</cmd>
</step>
<step>
<cmd>Once your drive is configured, restart the system. Just for fun. But be sure to remove any vendor software
from your system before doing so.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,38 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="configurewebserver" xml:lang="en-us">
<title>Configuring your Web Server</title>
<shortdesc>Configuring your Web Server can be as complex or as simple as you want it to be.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>web server</indexterm>
<indexterm>configure</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<context id="techwriter"><note>In this instance, the technical writer knows nothing about his
subject.</note></context>
<steps>
<step>
<cmd>Turn on the web server</cmd>
</step>
<step>
<cmd>Go to the Options menu</cmd>
</step>
<step>
<cmd>Follow that to "Web Server Preferences"</cmd>
</step>
<step>
<cmd>Make sure all of the right buttons are checked, or else you will never get it to work</cmd>
</step>
<step>
<cmd>Go to your site library and check out a book; any book, even about COBOL, is likely to be more helpful than
I am.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<topic id="configuring" xml:lang="en-us">
<title>Configuring</title>
<shortdesc>You configure components to set up or refine your solution.</shortdesc>
<body>
<p>You don't have to get the best configuration the first time. Instead, you might start with a simple configuration
and then refine it gradually as needed. </p>
</body>
</topic>

View file

@ -0,0 +1,32 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="databasetrouble" xml:lang="en-us">
<title>Troubleshooting a database</title>
<shortdesc>Databases rarely have problems, but this may be helpful if you find some.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>troubleshooting</indexterm>
<indexterm>database</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps-unordered>
<step>
<cmd>If performance is slow, try removing several thousand records.</cmd>
</step>
<step>
<cmd>If none of your commands work, make sure they are SQL commands and not SEQUEL commands.</cmd>
</step>
<step>
<cmd>If you cannot get anything to work at all, try uninstalling and reinstalling.</cmd>
</step>
<step>
<cmd>For more detailed troubleshooting help, see the online documentation shipped with your database.</cmd>
</step>
</steps-unordered>
</taskbody>
</task>

View file

@ -0,0 +1,42 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="drivetrouble" xml:lang="en-us">
<title>Troubleshooting your hard disk</title>
<shortdesc>Follow these steps to try and fix any problems with your hard drive.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>troubleshooting</indexterm>
<indexterm>hard drive</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps-unordered>
<step>
<cmd>Run scandisk on the drive. This may solve all of your problems.</cmd>
</step>
<step>
<cmd>Try defragmenting the drive. This could help with retrieval times.</cmd>
</step>
<step>
<cmd>If the drive is still slow, try deleting old or useless information.</cmd>
</step>
<step>
<cmd>If the drive cannot access anything, there are some expensive tools at Best Buy that my help you save some
of your information. But, you're probably out of luck.</cmd>
</step>
<step>
<cmd>If the drive makes funny clicking noises, back everything up as soon as possible.</cmd>
<info>You probably have some important data stored in bad sectors. This is going to be painful to fix. Make sure
you have a copy of your Operating System CDs.</info>
</step>
<step>
<cmd>If all else fails, you can always try calling technical support. However, this can be very expensive,
unless you call within 13 hours of your purchase.</cmd>
</step>
</steps-unordered>
</taskbody>
</task>

View file

@ -0,0 +1,35 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="insertdrive" xml:lang="en-us">
<title>Attach the drive to the system</title>
<shortdesc>The drive needs to be attached to power cables and other cables inside the computer.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>hard drive</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<prereq><note type="caution">You must be grounded before doing this.</note></prereq>
<steps>
<step>
<cmd>Find an empty bay for your drive.</cmd>
</step>
<step>
<cmd>Remove the drive from its electrostatic bag.</cmd>
</step>
<step>
<cmd>Screw the drive in to the frame.</cmd>
</step>
<step>
<cmd>Attach the multi-colored power cord to the drive.</cmd>
</step>
<step>
<cmd>Attach the cable that connects your hard drive to the motherboard.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="installdb" xml:lang="en-us">
<title>Installing your own Database</title>
<shortdesc>Installing a Database may sound tricky, but it is quite simple if you follow our instructions.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>Overview</indexterm>
<indexterm>database</indexterm>
<indexterm>install</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody/>
</task>

View file

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<topic id="installing" xml:lang="en-us">
<title>Installing</title>
<shortdesc>You install components to make them available for your solution.</shortdesc>
<body>
<p>Usually, you can install the components once and then forget about the details of this task. Before installing
the components, you should make a plan for what you need to accomplish and the components that will support these
goals. After installing the components, you will probably want to perform some preliminary configuration. </p>
</body>
</topic>

View file

@ -0,0 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="installstorage" xml:lang="en-us">
<title>Installing hard drives or other storage</title>
<shortdesc>A simple guide to installing hard drives.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>Overview</indexterm>
<indexterm>hard drive</indexterm>
<indexterm>install</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<prereq>First purchase a hard drive at your local electronics store or from a qualified representative.</prereq>
</taskbody>
</task>

View file

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="installwebserver" xml:lang="en-us">
<title>Installing your own Web Server</title>
<shortdesc>Installing a Web Server may sound tricky, but it is quite simple if you follow our
instructions.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>Overview</indexterm>
<indexterm>web server</indexterm>
<indexterm>install</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody/>
</task>

View file

@ -0,0 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="maintaindatabase" xml:lang="en-us">
<title>Maintaining a database</title>
<shortdesc>Maintaining a database does not take much work.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>database</indexterm>
<indexterm>maintain</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps-unordered>
<step>
<cmd>If the database crashes, restart it.</cmd>
</step>
<step>
<cmd>If the database is slow, tell people not to put so much in it.</cmd>
</step>
<step>
<cmd>Try to limit the number of records in your database. Too many records leads to confusion.</cmd>
</step>
</steps-unordered>
</taskbody>
</task>

View file

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<topic id="maintaining" xml:lang="en-us">
<title>Maintaining</title>
<shortdesc>You maintain your solution to ensure that all components are operating at maximum efficiency.</shortdesc>
<body>
<p>Maintenance is a task that you perform along with configuration to get the most from your solution. </p>
</body>
</topic>

View file

@ -0,0 +1,31 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="maintainserver" xml:lang="en-us">
<title>Maintaining a Web Server</title>
<shortdesc>Maintaining a web server is really quite easy.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>Web Server</indexterm>
<indexterm>maintain</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps-unordered>
<step>
<cmd>If the web server crashes, restart it.</cmd>
</step>
<step>
<cmd>Limit the number of connections to your server.</cmd>
<info>This will make it run faster.</info>
</step>
<step>
<cmd>Make sure you do not put confidential material on your server.</cmd>
<info>It should be kept in a separate folder named "Private."</info>
</step>
</steps-unordered>
</taskbody>
</task>

View file

@ -0,0 +1,36 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="maintainstorage" xml:lang="en-us">
<title>Maintaining your hard drive</title>
<shortdesc>Here are a few tips for maintaining your hard drive.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>hard drive</indexterm>
<indexterm>maintain</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<context>There is really not much to do to maintain a hard drive. However, if you want to keep it running for the
next 10 years or so, you should follow these suggestions.</context>
<steps-unordered>
<step>
<cmd>If your drive has a low-power mode, make sure this comes on when your drive is sitting idle.</cmd>
<stepresult>It will not get worn out as quickly if it is not needlessly spinning.</stepresult>
</step>
<step>
<cmd>Every once in a while, shake your computer.</cmd>
<info>This will cause the bits to fall more comfortably in to place.</info>
</step>
<step>
<cmd>Run Scandisk on the drive at least once a day.</cmd>
<info>This way you will ensure that problems with the drive are found quickly. If you share the drive with
others, it will also ensure that they are less likely to use it, because it will be so busy all of the
time.</info>
</step>
</steps-unordered>
</taskbody>
</task>

View file

@ -0,0 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2007 All Rights Reserved. -->
<concept id="notices" xml:lang="en-us">
<title>Notice</title>
<shortdesc>This information was developed for products and services offered in the U.S.A.</shortdesc>
<conbody>
<p>This product is meant for educational purposes only. Some of the trademarks mentioned in this product appear for
identification purposes only. Not responsible for direct, indirect, incidental or consequential damages resulting
from any defect, error or failure to perform. Any resemblance to real persons, living or dead is purely
coincidental. Void where prohibited. Some assembly required. Batteries not included. Use only as directed. Do not
use while operating a motor vehicle or heavy equipment. Do not fold, spindle or mutilate. Do not stamp. No
user-serviceable parts inside. Subject to change without notice. Drop in any mailbox. No postage necessary if
mailed in the United States. Postage will be paid by addressee. Post office will not deliver without postage. Some
equipment shown is optional. Objects in mirror may be closer than they appear. Not recommended for children. Your
mileage may vary.</p>
<p>No other warranty expressed or implied. This supersedes all previous notices.</p>
<section>
<title>COPYRIGHT LICENSE:</title>
<p>This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any
form without payment to IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating platform for which the sample
programs are written. These examples have not been thoroughly tested under all conditions. Retro Tools,
therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.</p>
</section>
</conbody>
</concept>

View file

@ -0,0 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="replacecover" xml:lang="en-us">
<title>Replace the cover of your system.</title>
<shortdesc>The cover needs to be put back on to reduce problems from dust.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>hard drive</indexterm>
<indexterm>Computer cover</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps>
<step>
<cmd>Retrieve the computer's cover from its safe place. Put it back on.</cmd>
</step>
<step>
<cmd>Retrieve the screws from the safe place. Put them back in.</cmd>
</step>
<step>
<cmd>Put away your screwdriver before you lose it.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,39 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="restart" xml:lang="en-us">
<title>Restart your system</title>
<shortdesc>This is standard procedure after installing any new software.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>Restarting</indexterm>
<indexterm>web server</indexterm>
<indexterm>database</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps>
<step>
<cmd>If you are on a Windows system, go to the start menu.</cmd>
<substeps>
<substep>
<cmd>Go to Start -> Shut Down...</cmd>
</substep>
<substep>
<cmd>Select "Restart" and hit OK.</cmd>
</substep>
</substeps>
</step>
<step>
<cmd>If you are on a Linux system, contact your system administrator for assistance. You may not need to
restart.</cmd>
</step>
<step>
<cmd>If you are on a Macintosh, go to Special -> Restart.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,38 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="runsetup" xml:lang="en-us">
<title>Run Setup.exe</title>
<shortdesc>As with any major program, you will need to run setup in order to install it.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>Setup</indexterm>
<indexterm>web server</indexterm>
<indexterm>database</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<context>Setup.exe can be found in the root directory of the CD-ROM with your software.</context>
<steps>
<step>
<cmd>Insert the CD-ROM.</cmd>
</step>
<step>
<cmd>Navigate to it from a typescript, DOS, or other command window.</cmd>
</step>
<step>
<cmd>Type <cmdname>setup.exe</cmdname> and hit enter.</cmd>
</step>
<step>
<cmd>Follow all of the prompts that appear.</cmd>
</step>
<step importance="optional">
<cmd>It is suggested that you follow all of the defaults, but you may select an alternate directory for the
install.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<topic id="task_appendix" xml:lang="en-us">
<title>Sample Appendix</title>
<shortdesc>This appendix describes things that you rarely need to know.</shortdesc>
<body>
<p>You can consult this section when you need detailed information about a specific component.</p>
</body>
</topic>

View file

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<topic id="task_preface" xml:lang="en-us">
<title>Sample Preface</title>
<shortdesc>This book explains each tasks separately. You can jump in anywhere, get the information you need, and
complete your work. </shortdesc>
<body>
<p>You can use this book to master tasks if you wish or just keep it handy as a resource so you can focus on other
issues. </p>
</body>
</topic>

View file

@ -0,0 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2007 All Rights Reserved. -->
<concept id="concept-1">
<title>Abstract</title>
<conbody>
<p>A brief summary of all operational knowledge including the evolution of human culture.</p>
</conbody>
</concept>

View file

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2007 All Rights Reserved. -->
<topic id="trademarks" xml:lang="en-us">
<title>Trademarks</title>
<shortdesc>The following terms are trademarks of the Retro Tools in the United States, other countries, or
both:</shortdesc>
<body>
<sl>
<sli><tm trademark="Retro" tmtype="reg" tmclass="RetroTools">RetroWrench</tm></sli>
</sl>
<p>The following terms are trademarks of other companies:</p>
<p>Red, Orange, Yellow, Green, Blue, Indigo, and Violot are registered trademarks of Rainbow Corporation and/or its
affiliates.</p>
<p>Linux is a trademark of Linus Torvalds in the United States, other countries, or both. </p>
<p>Other company, product, or service names may be trademarks or service marks of others. </p>
</body>
</topic>

View file

@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<topic id="troubleshooting" xml:lang="en-us">
<title>Troubleshooting</title>
<shortdesc>The troubleshooting tasks explain how to diagnose the cause of and recover from problems.</shortdesc>
<body>
<p>To fix a problem, you often have to configure or maintain a component. The troubleshooting tasks help you
determine what to work on to get back to normal operations. </p>
</body>
</topic>

View file

@ -0,0 +1,31 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="unscrewcover" xml:lang="en-us">
<title>Remove the cover of your system</title>
<shortdesc>This is a simple task requiring a screwdriver.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>hard drive</indexterm>
<indexterm>Computer cover</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<prereq>First be sure you are grounded.</prereq>
<context>Perform the operation in a well ventilated room.</context>
<steps>
<step>
<cmd>Unscrew the screws that hold the cover to your system.</cmd>
</step>
<step>
<cmd>Store them in a safe place.</cmd>
</step>
<step>
<cmd>Remove the cover and place it in a safe place as well.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,33 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->
<task id="webtrouble" xml:lang="en-us">
<title>Troublshooting Web Server problems</title>
<shortdesc>There are several things to try if your Web Server is not functioning properly.</shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm>troubleshooting</indexterm>
<indexterm>web server</indexterm>
</keywords>
</metadata>
</prolog>
<taskbody>
<steps-unordered>
<step>
<cmd>If others cannot connect to your server, try turning off their firewalls.</cmd>
</step>
<step>
<cmd>If your server is running slowly, try limiting it to 2 or 3 connections.</cmd>
</step>
<step>
<cmd>If your server keeps creating pop-up ads when people access it, please turn them off and things will run
faster.</cmd>
</step>
<step>
<cmd>If these directions are not helpful, please contact your service representative.</cmd>
</step>
</steps-unordered>
</taskbody>
</task>

View file

@ -0,0 +1,37 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<task id="changeoil" xml:lang="en-us">
<title>Changing the oil in your car</title>
<shortdesc>Once every 6000 kilometers or three months, change the oil in your car.</shortdesc>
<taskbody>
<context>
<p>Changing the oil regularly will help keep the engine in good condition. </p></context>
<steps>
<stepsection>To change the oil:</stepsection>
<step>
<cmd>Remove the old oil filter.</cmd>
</step>
<step>
<cmd>Drain the old oil.</cmd>
</step>
<step>
<cmd>Install a new oil filter and gasket.</cmd>
</step>
<step>
<cmd>Add new oil to the engine.</cmd>
</step>
<step>
<cmd>Check the air filter and replace or clean it.</cmd>
</step>
<step>
<cmd>Top up the windshield washer fluid.</cmd>
</step>
</steps>
</taskbody>
<related-links>
<link href="../concepts/oil.xml" format="dita" type="concept"/>
<link href="../concepts/wwfluid.xml" format="dita" type="concept"/>
</related-links>
</task>

View file

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<concept id="taskconcept" xml:lang="en-us">
<title>Garage Tasks</title>
<shortdesc>When you go into the garage, be prepared to get your hands dirty!</shortdesc>
<conbody/>
</concept>

View file

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<task id="organize" xml:lang="en-us">
<title>Organizing the workbench and tools</title>
<shortdesc>Keep your garage neat by organizing the things you keep in the garage.</shortdesc>
<taskbody/>
</task>

View file

@ -0,0 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<task id="shovellingsnow" xml:lang="en-us">
<title>Shovelling snow</title>
<shortdesc>Keep your driveway and sidewalks clear of snow and ice by shovelling after any snowfall.</shortdesc>
<taskbody>
<steps>
<step>
<cmd>Get the shovel out of the garage</cmd>
</step>
<step>
<cmd>Shovel the driveway, starting at the garage door and working out to the street.</cmd>
</step>
<step>
<cmd>Shovel the sidewalk in front of your house.</cmd>
</step>
<step>
<cmd>Shovel the walk to your front door.</cmd>
</step>
</steps>
</taskbody>
<related-links>
<link href="../concepts/snowshovel.xml" format="dita" type="concept"/>
</related-links>
</task>

View file

@ -0,0 +1,32 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<task id="spraypaint" xml:lang="en-us">
<title>Spray painting</title>
<shortdesc>When paint is applied using a spray nozzle, it is referred to as spray painting.</shortdesc>
<taskbody>
<context>
<p>The garage is a good place to spray paint.</p></context>
<steps>
<step>
<cmd>Move the car out of the garage to avoid getting paint on it.</cmd>
</step>
<step>
<cmd>Place newspaper, cardboard, or a drop-cloth on the garage floor.</cmd>
</step>
<step>
<cmd>Place the object to be painted on the covered area.</cmd>
</step>
<step>
<cmd>Follow the directions on the paint can to paint the object.</cmd>
</step>
<step>
<cmd>Let the paint dry thoroughly before you move the object.</cmd>
</step>
</steps>
</taskbody>
<related-links>
<link href="../concepts/paint.xml" format="dita" type="concept"/>
</related-links>
</task>

View file

@ -0,0 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<task id="takinggarbage" xml:lang="en-us">
<title>Taking out the garbage</title>
<shortdesc>Regular garbage removal is necessary for the proper functioning of a home.</shortdesc>
<taskbody>
<context>
<p>Your municipality collects garbage from homes once a week, usually early in the morning.</p></context>
<steps>
<step>
<cmd>Find out from the town what day of the week garbage is collected in your neighborhood.</cmd>
</step>
<step>
<cmd>The night before collection, place the garbage cans on the curb.</cmd>
</step>
<step>
<cmd>After the garbage has been collected, move the cans back into your garage.</cmd>
</step>
</steps>
</taskbody>
</task>

View file

@ -0,0 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
<!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. -->
<task id="washcar" xml:lang="en-us">
<title>Washing the car</title>
<shortdesc>Keep your car looking great by washing it regularly.</shortdesc>
<taskbody>
<steps>
<step>
<cmd>Move the car onto the driveway.</cmd>
</step>
<step>
<cmd>Attach the water hose to a spout and pull the free end over to the car.</cmd>
</step>
<step>
<cmd>Fill a bucket with soapy water.</cmd>
</step>
<step>
<cmd>Use a sponge to apply the soapy water to the car and scrub off the dirt.</cmd>
</step>
<step>
<cmd>Rinse the car by spraying clean water from the hose.</cmd>
</step>
<step>
<cmd>Dry the car using a dampened chamois.</cmd>
</step>
</steps>
<result>
<p>
<image href="../image/carwash.jpg" height="171" width="249">
<alt>washing the car</alt>
</image>
</p>
</result>
</taskbody>
<related-links>
<link href="../concepts/waterhose.xml" format="dita" type="concept"/>
</related-links>
</task>