[sdk/kdesrc-build] doc: doc: intro-toc - separate docbook

Andrew Shark null at kde.org
Fri Jan 5 19:07:02 GMT 2024


Git commit fae18088f19548e12d9aef2c24321bb8f6bc9c5f by Andrew Shark.
Committed on 05/01/2024 at 19:59.
Pushed by ashark into branch 'master'.

doc: intro-toc - separate docbook

M  +2    -22   doc/index.docbook
A  +22   -0    doc/intro-toc.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/fae18088f19548e12d9aef2c24321bb8f6bc9c5f

diff --git a/doc/index.docbook b/doc/index.docbook
index d506542a..3038d2d2 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -81,6 +81,7 @@
   <!ENTITY environment SYSTEM "environment.docbook">
   <!ENTITY features SYSTEM "features.docbook">
   <!ENTITY getting-started SYSTEM "getting-started.docbook">
+  <!ENTITY intro-toc SYSTEM "intro-toc.docbook">
 ]>
 
 <book id="kdesrc-build" lang="&language;">
@@ -206,28 +207,7 @@ workflow is what &kdesrc-build; automates for all &kde; modules.</para>
 </sect2>
 </sect1>
 
-<sect1 id="intro-toc">
-<title>Documentation Overview</title>
-
-<para>
-This guide is an overview to describe the following aspects of &kdesrc-build;
-operation:
-</para>
-
-<itemizedlist>
-<listitem><para>An <link linkend="getting-started">overview</link> of the steps
-required to get started.</para></listitem>
-<listitem><para>Notable <link linkend="features">features</link>.</para></listitem>
-<listitem><para>The <link linkend="configure-data">configuration file</link> syntax
-and options.</para></listitem>
-<listitem><para>The <link linkend="cmdline">command line options</link>.</para></listitem>
-</itemizedlist>
-
-<para>Also documented are the steps which you should perform using
-other tools (&ie; steps that are not automatically performed by &kdesrc-build;).
-</para>
-
-</sect1>
+&intro-toc;
 </chapter>
 
 &getting-started;
diff --git a/doc/intro-toc.docbook b/doc/intro-toc.docbook
new file mode 100644
index 00000000..00b36bf6
--- /dev/null
+++ b/doc/intro-toc.docbook
@@ -0,0 +1,22 @@
+<sect1 id="intro-toc">
+<title>Documentation Overview</title>
+
+<para>
+This guide is an overview to describe the following aspects of &kdesrc-build;
+operation:
+</para>
+
+<itemizedlist>
+<listitem><para>An <link linkend="getting-started">overview</link> of the steps
+required to get started.</para></listitem>
+<listitem><para>Notable <link linkend="features">features</link>.</para></listitem>
+<listitem><para>The <link linkend="configure-data">configuration file</link> syntax
+and options.</para></listitem>
+<listitem><para>The <link linkend="cmdline">command line options</link>.</para></listitem>
+</itemizedlist>
+
+<para>Also documented are the steps which you should perform using
+other tools (&ie; steps that are not automatically performed by &kdesrc-build;).
+</para>
+
+</sect1>



More information about the kde-doc-english mailing list