Skip to content

Commit

Permalink
Removed YAST for Micro's articles versions.
Browse files Browse the repository at this point in the history
  • Loading branch information
@lvicoun
lvicoun committed May 10, 2024
1 parent fc251e1 commit ad719d7
Show file tree
Hide file tree
Showing 6 changed files with 297 additions and 2 deletions.
1 change: 1 addition & 0 deletions DC-Micro-ntp-time-synchronization
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
MAIN="ntp-time-synchronization.asm.xml"
# Point to the ID of the <structure> of your assembly
#ROOTID="article-example"
STRUCTID="ntp-time-synchronization-micro"
SRC_DIR="articles"
IMG_SRC_DIR="images"

Expand Down
1 change: 1 addition & 0 deletions DC-Micro-raids
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
## Basics
MAIN="raid.asm.xml"
SRC_DIR="articles"
STRUCTID="software-raid-micro"

## Profiling
PROFOS="slmicro"
Expand Down
1 change: 1 addition & 0 deletions DC-ntp-time-synchronization
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
MAIN="ntp-time-synchronization.asm.xml"
# Point to the ID of the <structure> of your assembly
#ROOTID="article-example"
STRUCTID="ntp-time-synchronization"
SRC_DIR="articles"
IMG_SRC_DIR="images"

Expand Down
18 changes: 18 additions & 0 deletions DC-raids
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
## ----------------------------
## Doc Config File for the DB Assembly test
## ----------------------------
##
## Basics
MAIN="raid.asm.xml"
SRC_DIR="articles"
STRUCID="software-raid"

## Profiling
PROFOS="sles"
#PROFARCH="x86_64;zseries;power;aarch64"

## stylesheet location
STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns"

DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
144 changes: 144 additions & 0 deletions articles/ntp-time-synchronization.asm.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -193,4 +193,148 @@
<module resourceref="_legal"/>
<module resourceref="_gfdl" renderas="appendix"/>
</structure>

<structure renderas="article" xml:id="ntp-time-synchronization-micro" xml:lang="en">
<merge>
<title>Synchronizing Time Using NTP</title>
<revhistory xml:id="rh-ntp-time-synchronization-micro">
<revision><date>2024-04-26</date>
<revdescription>
<para>
Initial version
</para>
</revdescription>
</revision>
</revhistory>
<!-- TODO: provide a listing of possible and validatable meta entry values. Maybe in our geekodoc repo? -->
<!-- add author's e-mail -->
<meta name="maintainer" content="[email protected]" its:translate="no"/>
<!-- ISO date of last update as YYYY-MM-DD -->
<meta name="updated" content="2024-04-26" its:translate="no"/>
<!-- this does not work yet. Use the dm tags listed below for now
<meta name="bugtracker" its:translate="no">
<phrase role="url">https://bugzilla.suse.com/enter_bug.cgi</phrase>
<phrase role="component">Non-product-specific documentation</phrase>
<phrase role="product">Smart Docs</phrase>
<phrase role="assignee">[email protected]</phrase>
</meta>
-->
<!-- not supported, yet. Use dm: tag for now
<meta name="translation" its:translate="no">
<phrase role="trans">yes</phrase>
<phrase role="language">de-de,cs-cz</phrase>
</meta>
-->
<!-- enter the platform identifier or a list of
identifiers, separated by ; -->
<meta name="architecture" its:translate="no">
<phrase>&x86-64;</phrase>
<phrase>&power;</phrase>
</meta>
<meta name="productname" its:translate="no">
<productname os="slmicro">&productname;</productname>
</meta>
<meta name="title" its:translate="yes">Time synchronization using NTP</meta>
<meta name="description" its:translate="yes">This article describes what
time synchronization is and how to configure it on the &productname; system.</meta>
<meta name="social-descr" its:translate="yes">Time synchronization using NTP</meta>
<!-- suitable categories -->
<meta name="category" its:translate="no">
<phrase>Systems Management</phrase>
</meta>
<meta name="task" its:translate="no">
<phrase>Configuration</phrase>
</meta>
<meta name="series" its:translate="no">Product &amp; Solutions</meta>

<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker>
<dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
<dm:component>Smart Docs</dm:component>
<dm:product>Documentation</dm:product>
<dm:assignee>[email protected]</dm:assignee>
</dm:bugtracker>
<dm:translation>yes</dm:translation>
</dm:docmanager>
<abstract>
<variablelist>
<varlistentry>
<term>WHAT?</term>
<listitem>
<para>
This article describes what time synchronization is and how to
configure it.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WHY?</term>
<listitem>
<para>
Keeping the system time synchronized is crucial when sharing
tasks and resources with other team members over the network.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>EFFORT</term>
<listitem>
<para>
Up to 60 minutes to read this article and perform a basic
configuration of time synchronization on your computer.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>REQUIREMENTS</term>
<listitem>
<itemizedlist>
<listitem>
<para>
A basic knowledge of Linux system administration is
required. Specific tasks require &rootuser; privileges.
</para>
</listitem>
<listitem>
<para>
Working network connection to the internal network or
Internet to reach the source time server.
</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</abstract>
</merge>
<module resourceref="_concept-ntp-time-synchronization" renderas="section">
<merge>
<title>Introduction</title>
</merge>
</module>

<module resourceref="_task-ntp-configure-configuration-file" renderas="section">
<merge>
<abstract>
<para>
When &chronyd; starts, it reads its configuration from the
<filename>/etc/chrony.conf</filename> file. The following sections
list important parameters that can affect &chronyd; behavior.
</para>
</abstract>
</merge>
</module>
<module resourceref="_concept-ntp-manage-with-chronyc" renderas="section">
<merge>
<abstract>
<para></para>
</abstract>
</merge>
</module>
<module resourceref="_reference-ntp-operate-chronyd-service"/>
<module resourceref="_glue-ntp-troubleshooting" renderas="section"/>
<module resourceref="_glue-ntp-more-info" renderas="section"/>
<module resourceref="_legal"/>
<module resourceref="_gfdl" renderas="appendix"/>
</structure>
</assembly>
134 changes: 132 additions & 2 deletions articles/raid.asm.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,137 @@
<phrase>&power;</phrase>
</meta>
<meta name="productname" its:translate="no">
<productname condition="16.0" os="sles">&productname;</productname>
<productname condition="16.0" os="sles">&productname;</productname>
</meta>
<meta name="title" its:translate="yes">Software RAID description and configuration</meta>
<meta name="description" its:translate="yes">The article focuses on configuring software RAID and provides detail about various levels of RAID.</meta>
<meta name="social-descr" its:translate="yes">Description of software RAID.</meta>
<!-- suitable category, comma-separated list of categories -->
<meta name="category" its:translate="no">
<phrase>Systems Management</phrase>
</meta>
<meta name="task" its:translate="no">
<phrase>Configuration</phrase>
<phrase>Storage</phrase>
<phrase>Monitoring</phrase>
</meta>
<meta name="series" its:translate="no">Product &amp; Solutions</meta>

<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker>
<dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
<dm:component>Smart Docs</dm:component>
<dm:product>Documentation</dm:product>
<dm:assignee>[email protected]</dm:assignee>
</dm:bugtracker>
<dm:translation>yes</dm:translation>
</dm:docmanager>
<abstract>
<variablelist>
<varlistentry>
<term>WHAT?</term>
<listitem>
<para>
Basic information about software RAIDs.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WHY?</term>
<listitem>
<para>
You need information on RAID levels, or you want to manage
or monitor a RAID.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>EFFORT</term>
<listitem>
<para>
15 minutes of reading time.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>GOAL</term>
<listitem>
<para>
You will be able to manage a software RAID using &yast;.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>REQUIREMENTS</term>
<listitem>
<itemizedlist>
<listitem>
<para>
A corresponding number of disks/partitions that will form the required RAID.
</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</abstract>
</merge>
<!-- pull in all the topic files you need -->
<!-- pick the appropriate type of include to match your needs -->
<!-- pull in a topic as is -->
<!-- pull in a topic and switch the title -->
<module resourceref="_raid-about-raids" renderas="section"/>
<module resourceref="_raid-raid-levels" renderas="section"/>

<module resourceref="_raid-configuring-using-yast" renderas="section"/>

<module resourceref="_raid-management" renderas="section">
<module resourceref="_raid-naming-raid" renderas="section"/>
<module resourceref="_raid-configuring-stripe-size" renderas="section"/>
<module resourceref="_raid-monitoring-raids" renderas="section"/>
</module>
<!-- Troubleshooting -->
<module resourceref="_legal"/>
<module resourceref="_gfdl" renderas="appendix"/>
</structure>

<structure renderas="article" xml:id="software-raid-micro" xml:lang="en">
<merge>
<title>Software RAID on &productname;</title>
<revhistory xml:id="rh-software-raid-micro">
<revision><date>2023-05-09</date>
<revdescription>
<para>
Initial version.
</para>
</revdescription>
</revision>
</revhistory>
<!-- TODO: provide a listing of possible and validatable meta entry values. Maybe in our geekodoc repo? -->
<!-- add author's e-mail -->
<meta name="maintainer" content="[email protected]" its:translate="no"/>
<!-- ISO date of last update as YYYY-MM-DD -->
<meta name="updated" content="2023-10-26" its:translate="no"/>
<!-- this does not work yet. Use the dm tags listed below for now
<meta name="bugtracker" its:translate="no">
<phrase role="url">https://bugzilla.suse.com/enter_bug.cgi</phrase>
<phrase role="component">Non-product-specific documentation</phrase>
<phrase role="product">Smart Docs</phrase>
<phrase role="assignee">[email protected]</phrase>
</meta>
-->
<!-- not supported, yet. Use dm: tag for now
<meta name="translation" its:translate="no">
<phrase role="trans">yes</phrase>
<phrase role="language">de-de,cs-cz</phrase>
</meta>
-->
<!-- enter the platform identifier or a list of identifiers -->
<meta name="architecture" its:translate="no">
<phrase>&x86-64;</phrase>
<phrase>&power;</phrase>
</meta>
<meta name="productname" its:translate="no">
<productname os="slemicro">&productname;</productname>
<productname os="slmicro">&productname;</productname>
</meta>
Expand Down Expand Up @@ -153,7 +283,7 @@
<term>GOAL</term>
<listitem>
<para>
You will be able to manage a software RAID using &yast;.
You will be able to manage a software RAID using <command>mdadm</command>.
</para>
</listitem>
</varlistentry>
Expand Down

0 comments on commit ad719d7

Please sign in to comment.