Merge pull request #364 from openSUSE/wip-seo-link-rewrite

SEO: rewrite certain xml:id values and validate against Geekodoc
openSUSE · Jul 23, 2024 · bfafe8c · bfafe8c
2 parents c70deaf + 05a8958
commit bfafe8c
Show file tree

Hide file tree

Showing 86 changed files with 844 additions and 848 deletions.
diff --git a/DC-obs-admin-guide b/DC-obs-admin-guide
@@ -6,7 +6,7 @@
 ## Basics
 MAIN="MAIN-obs.xml"
 # See "book-obs-admin-guide.xml"
-ROOTID="book.obs-admin"
+ROOTID="book-obs-admin"
 
 ## Profiling
 PROFOS="opensuse;novell"
@@ -18,8 +18,9 @@ PROFCONDITION="bogus"
 STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
 FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse"
 
-## Use DocBook5 instead of GeekoDoc
-DOCBOOK5_RNG_URI="http://docbook.org/xml/5.2/rng/docbookxi.rng"
+### Use GeekoDoc
+#DOCBOOK5_RNG_URI="http://docbook.org/xml/5.2/rng/docbookxi.rng"
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
 
 ## Disabled SUSE logo
 XSLTPARAM="--param generate.logo=0"

diff --git a/DC-obs-all b/DC-obs-all
@@ -16,8 +16,9 @@ PROFCONDITION="bogus"
 STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
 FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse"
 
-## Use DocBook5 instead of GeekoDoc
-DOCBOOK5_RNG_URI="http://docbook.org/xml/5.2/rng/docbookxi.rng"
+### Use GeekoDoc
+#DOCBOOK5_RNG_URI="http://docbook.org/xml/5.2/rng/docbookxi.rng"
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
 
 ## enable sourcing
 export DOCCONF=$BASH_SOURCE
diff --git a/DC-obs-user-guide b/DC-obs-user-guide
@@ -6,7 +6,7 @@
 ## Basics
 MAIN="MAIN-obs.xml"
 # See "book-obs-user-guide.xml"
-ROOTID="book.obs-user"
+ROOTID="book-obs-user"
 
 ## Profiling
 PROFOS="opensuse;novell"
@@ -18,8 +18,9 @@ PROFCONDITION="bogus"
 STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
 FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse"
 
-## Use DocBook5 instead of GeekoDoc
-DOCBOOK5_RNG_URI="http://docbook.org/xml/5.2/rng/docbookxi.rng"
+### Use GeekoDoc
+#DOCBOOK5_RNG_URI="http://docbook.org/xml/5.2/rng/docbookxi.rng"
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
 
 ## Disabled SUSE logo
 XSLTPARAM="--param generate.logo=0"

diff --git a/README.md b/README.md
@@ -23,7 +23,7 @@ daps2docker DC-obs-user-guide validate
 or if you want to preview the HTML files you can use
 
 ```
-rm -rf /tmp/daps2docker-*; daps2docker DC-obs-user-guide html; xdg-open /tmp/daps2docker-*/obs-user-guide/html/book.obs-user/index.html
+rm -rf /tmp/daps2docker-*; daps2docker DC-obs-user-guide html; xdg-open /tmp/daps2docker-*/obs-user-guide/html/book-obs-user/index.html
 ```
 
 For more detailed information see

diff --git a/xml/MAIN-obs.xml b/xml/MAIN-obs.xml
@@ -7,7 +7,7 @@
   <!ENTITY % entities SYSTEM "entity-decl.ent">
   %entities;
 ]>
-<set version="5.1" xml:lang="en" xml:id="art_obs_quickstart"
+<set version="5.1" xml:lang="en"
   xmlns="http://docbook.org/ns/docbook"
   xmlns:dm="urn:x-suse:ns:docmanager"
   xmlns:xi="http://www.w3.org/2001/XInclude"
@@ -22,12 +22,6 @@
    </dm:bugtracker>
   </dm:docmanager>
  </info>
-<!--
-  <book xml:id="book.obs.techpaper">
-   <title>Technical Papers</title>
-   <info/>
-  </book>
--->
   <xi:include href="book-obs-user-guide.xml"/>
   <xi:include href="book-obs-admin-guide.xml"/>
 </set>