This little repository is just a proof of concept. It should serve as an example of an Installation and Setup Quick Start Guide.

1. Install the docbook_5 package from https://build.opensuse.org/package/show/Publishing/docbook_5.

2. Clone the DAPS repo: git clone https://github.com/openSUSE/daps Don't change directories now!

3. Switch to the right DAPS branch: git -C daps switch docbook_assemblies

4. Create an alias (ddaps = development DAPS) to run DAPS from the repo: alias ddaps="$PWD"'/daps/bin/daps --dapsroot '"$PWD"'/data/gits/daps/'

5. Clone this repo: git clone https://github.com/.../dbassembly-test

6. Go there: cd dbassembly-test

7. Run ddaps: ddaps -d DC-assembly validate

• Assembly: an XML structure that contains resources to other files, defines modules and relationships, and combine all this information into a structure.
• Realized Structure: The structure you get after processing your assembly file.
• Topic: Single unit of information, usually as a part of a greater organizational structure.

This repo contains the following files and directories:

• topics/

  Contain all topic related XML files (usually with the root element <topic>.

• topics/Installation_and_Setup_QuickStart_Guide.xml

  This is the assembly file. It contains references to other files, usually topics and forms the documentation structure.

• topics/topic*.xml

  Are "modules" or files that are units of specific information.

• https://tdg.docbook.org/tdg/5.1/ch06.html