Imported chapters from Deployment guide (#1134)

* imported chapters from Deployment guide * fixed validation in opensuse
SUSE · Mar 29, 2022 · 86ddca3 · 86ddca3
1 parent 8bf8229
commit 86ddca3
Show file tree

Hide file tree

Showing 8 changed files with 54 additions and 125 deletions.
diff --git a/xml/book_administration.xml b/xml/book_administration.xml
@@ -43,9 +43,8 @@
   <xi:include href="adm_sudo.xml"/>
   <xi:include href="yast2_gui.xml"/>
   <xi:include href="yast2_ncurses.xml"/>
-  <xi:include href="yast2_userman.xml"/>
   <xi:include href="yast2_lang.xml"/>
-  <xi:include href="yast2_hw.xml"/>
+  <xi:include href="yast2_userman.xml"/>
   <xi:include href="yast2_you.xml"/>
   <xi:include href="yast2_sw.xml"/>
   <xi:include href="sw_managing_commandline.xml"/>
@@ -83,18 +82,17 @@
   <xi:include href="udev.xml"/>
   <xi:include href="suse_linux.xml"/>
   <xi:include href="nm.xml"/>
-  <xi:include href="powermanagement.xml"/>
-<!-- FIXME cwickert 2018-10-26: A single chapter doesn't justify a part of
- it's own. However, we might want to have a 'Hardware' part once we have
- more content. For now, the part is commented out.
--->
- <!-- </part> -->
+ </part>
  <!-- ===================================================================== -->
  <!-- Part: Hardware Configuration                                          -->
  <!-- ===================================================================== -->
- <!-- <part xml:id="part-hardware">
-  <title>Hardware configuration</title> -->
-  <xi:include href="hardware_vm_guest.xml"/>
+ <part xml:id="part-hardware">
+  <title>Hardware configuration</title>
+  <xi:include href="yast2_keymouse.xml"/>
+  <xi:include href="yast2_sound.xml"/>
+  <xi:include href="yast2_printer.xml"/>
+  <xi:include os="sled;osuse" href="yast2_scanner.xml"/>
+  <xi:include href="powermanagement.xml"/>
   <xi:include href="hardware_nvdimm.xml"/>
  </part>
 <!-- ===================================================================== -->

diff --git a/xml/book_startup-opensuse.xml b/xml/book_startup-opensuse.xml
@@ -38,7 +38,6 @@
   <title>Administration</title>
   <xi:include href="yast2_userman.xml"/>
   <xi:include href="yast2_lang.xml"/>
-  <xi:include href="yast2_hw.xml"/>
   <xi:include href="printing.xml"/>
   <xi:include href="fuse.xml"/>
  </part>
@@ -60,6 +59,17 @@
   <xi:include href="newbie_bash.xml"/>
   <xi:include href="adm_shell.xml"/>
  </part>
+ <!-- ===================================================================== -->
+ <!-- Part: Hardware Configuration                                          -->
+ <!-- ===================================================================== -->
+ <part xml:id="part-hardware">
+  <title>Hardware configuration</title>
+  <xi:include href="yast2_keymouse.xml"/>
+  <xi:include href="yast2_sound.xml"/>
+  <xi:include href="yast2_printer.xml"/>
+  <xi:include os="sled;osuse" href="yast2_scanner.xml"/>
+  <xi:include href="hardware_nvdimm.xml"/>
+ </part>
 <!-- ===================================================================== -->
 <!-- Part: Help and Troubleshooting                                        -->
 <!-- ===================================================================== -->

diff --git a/xml/hardware_vm_guest.xml b/xml/hardware_vm_guest.xml
diff --git a/xml/yast2_hw.xml b/xml/yast2_hw.xml
diff --git a/xml/yast2_keymouse.xml b/xml/yast2_keymouse.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect1
+<!DOCTYPE chapter
 [
   <!ENTITY % entities SYSTEM "generic-entities.ent">
     %entities;
 ]>
 
-<sect1 version="5.0" xml:id="sec-yast-hw-keym"
+<chapter version="5.0" xml:id="sec-yast-hw-keym"
   xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -51,8 +51,8 @@
   </step>
   <step>
    <para>
-    The result is stored in the files <filename>/etc/vconsole.conf</filename> 
-    (for text consoles) and 
+    The result is stored in the files <filename>/etc/vconsole.conf</filename>
+    (for text consoles) and
     <filename>/etc/X11/xorg.conf.d/00-keyboard.conf</filename> (for X11).
    </para>
   </step>
@@ -67,4 +67,4 @@
    </para>
   </step>
  </procedure>
-</sect1>
+</chapter>
diff --git a/xml/yast2_printer.xml b/xml/yast2_printer.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect1
+<!DOCTYPE chapter
 [
   <!ENTITY % entities SYSTEM "generic-entities.ent">
     %entities;
 ]>
 
-<sect1 version="5.0" xml:id="sec-yast-hw-print"
+<chapter version="5.0" xml:id="sec-yast-hw-print"
   xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -48,7 +48,7 @@
   </para>
  </note>
 
- <sect2 xml:id="sec-yast-hw-print-local">
+ <sect1 xml:id="sec-yast-hw-print-local">
   <title>Configuring printers</title>
   <para>
    Usually a USB printer is automatically detected. There are two possible
@@ -170,7 +170,7 @@
     </para>
    </step>
   </procedure>
-  <sect3 xml:id="sec-yast-hw-print-local-get-ppd">
+  <sect2 xml:id="sec-yast-hw-print-local-get-ppd">
    <title>Adding drivers with &yast;</title>
    <para>
     Not all printer drivers available for &productname; are installed by
@@ -279,8 +279,8 @@
      </para>
     </step>
    </procedure>
-  </sect3>
-  <sect3 xml:id="sec-yast-hw-print-local-tune">
+  </sect2>
+  <sect2 xml:id="sec-yast-hw-print-local-tune">
    <title>Editing a local printer configuration</title>
    <para>
     By editing an existing configuration for a printer you can change basic
@@ -324,10 +324,10 @@
      </para>
     </step>
    </procedure>
-  </sect3>
- </sect2>
+  </sect2>
+ </sect1>
 
- <sect2 xml:id="sec-yast-hw-print-network">
+ <sect1 xml:id="sec-yast-hw-print-network">
   <title>Configuring printing via the network with &yast;</title>
   <para>
    Network printers are not detected automatically. They must be configured
@@ -337,7 +337,7 @@
    network printing by choosing <guimenu>Printing via Network</guimenu> from
    the left pane in the &yast; printer module.
   </para>
-  <sect3 xml:id="sec-yast-hw-print-network-cups">
+  <sect2 xml:id="sec-yast-hw-print-network-cups">
    <title>Using CUPS</title>
    <para>
     In a Linux environment CUPS is usually used to print via the network. The
@@ -439,8 +439,8 @@
      </para>
     </step>
    </procedure>
-  </sect3>
-  <sect3 xml:id="sec-yast-hw-print-network-other">
+  </sect2>
+  <sect2 xml:id="sec-yast-hw-print-network-other">
    <title>Using print servers other than CUPS</title>
    <para>
     If your network offers print services via print servers other than CUPS,
@@ -451,10 +451,10 @@
     <guimenu>Connection Type</guimenu>. Ask your network administrator for
     details on configuring a network printer in your environment.
    </para>
-  </sect3>
- </sect2>
+  </sect2>
+ </sect1>
 
- <sect2 xml:id="sec-yast-hw-print-share">
+ <sect1 xml:id="sec-yast-hw-print-share">
   <title>Sharing printers over the network</title>
   <para>
    Printers managed by a local CUPS daemon can be shared over the network and
@@ -499,5 +499,5 @@
     </para>
    </step>
   </procedure>
- </sect2>
-</sect1>
+ </sect1>
+</chapter>
diff --git a/xml/yast2_scanner.xml b/xml/yast2_scanner.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect1
+<!DOCTYPE chapter
 [
   <!ENTITY % entities SYSTEM "generic-entities.ent">
     %entities;
 ]>
 
-<sect1 version="5.0" xml:id="sec-yast-hw-scan"
+<chapter version="5.0" xml:id="sec-yast-hw-scan"
   xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -72,7 +72,7 @@
   </step>
  </procedure>
 
- <sect2 xml:id="sec-yast-hw-scan-hp-allinone">
+ <sect1 xml:id="sec-yast-hw-scan-hp-allinone">
   <title>Configuring an HP all-in-one device</title>
   <para>
    An HP All-In-One device can be configured with &yast; even if it is
@@ -114,9 +114,9 @@
     </para>
    </step>
   </procedure>
- </sect2>
+ </sect1>
 
- <sect2 xml:id="sec-yast-hw-scan-network-server">
+ <sect1 xml:id="sec-yast-hw-scan-network-server">
   <title>Sharing a scanner over the network</title>
   <para>
    &productname; allows the sharing of a scanner over the network. To do
@@ -144,9 +144,9 @@
     </para>
    </step>
   </procedure>
- </sect2>
+ </sect1>
 
- <sect2 xml:id="sec-yast-hw-scan-network-client">
+ <sect1 xml:id="sec-yast-hw-scan-network-client">
   <title>Scanning over the network</title>
   <para>
    To use a scanner that is shared over the network, proceed as follows:
@@ -179,5 +179,5 @@
     </para>
    </step>
   </procedure>
- </sect2>
-</sect1>
+ </sect1>
+</chapter>
diff --git a/xml/yast2_sound.xml b/xml/yast2_sound.xml
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect1
+<!DOCTYPE chapter
 [
   <!ENTITY % entities SYSTEM "generic-entities.ent">
     %entities;
 ]>
 
 <!--taroth 2010-01-08: yast2 module maintainer: [email protected]-->
-<sect1 version="5.0" xml:id="sec-yast-hw-sound"
+<chapter version="5.0" xml:id="sec-yast-hw-sound"
   xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -54,10 +54,6 @@
   The dialog shows all sound cards that were detected.
  </para>
 
-<!--taroth 2010-01-18: removed information about probing for old sound chips as
- this referred to ISA sound cards only which are gone for several years already
- according to lslezak, no need to mention this any longer-->
-
  <procedure xml:id="pro-yast2-sound-add">
   <title>Configuring sound cards</title>
   <para>
@@ -260,4 +256,4 @@
   <filename>/etc/modprobe.d/sound</filename> and written to
   <filename>/etc/sysconfig/sound</filename>.
  </para>
-</sect1>
+</chapter>