Changeset 105417 in vbox for trunk/doc/manual/en_US/dita

Timestamp:

Jul 19, 2024 11:24:00 AM (10 months ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

164071

Message:

doc/manual: Throw out a lot of meaningless (or outright misleading) content from the ditamap, and do a lot of polishing of the PDF theme. bugref:10705

File:

• trunk/doc/manual/en_US/dita/UserManual.ditamap (modified) (3 diffs)

trunk/doc/manual/en_US/dita/UserManual.ditamap

@@ -2 +2 @@
 <!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "bookmap.dtd">
 <!-- The bookmap ID is imperative and matched the Jarvis GUID required to build and pretty much do anything -->
-<bookmap id="EN-VBOX-7-0-USER" xml:lang="en-US">
-   <!--
-         booklibrary renders in bold and is equivalent to title in docbook;
-         mainbooktitle is not in bold and is equivalent to subtitle
-
-         This information gets updated automatically to match the othermeta title value or PDB entry when you run:
-         'DitaUtils.py title -d template.ditamap' or 'DitaUtils.py map-prep -d template.ditamap'
-    -->
+<bookmap id="EN-VBOX-7-1-USER" xml:lang="en-US">
    <booktitle>
-      <booklibrary>Oracle VM VirtualBox</booklibrary>
-      <mainbooktitle>User Manual for Release 7.0</mainbooktitle>
+      <mainbooktitle>Oracle VirtualBox: User Guide for Release 7.1</mainbooktitle>
    </booktitle>
    <bookmeta>
@@ -18 +10 @@
          <published>
             <completed>
-               <month>November</month>
-               <year>2022</year>
+               <month>July</month>
+               <year>2024</year>
             </completed>
          </published>
       </publisherinformation>
 
-      <!--
-         The othermeta title is used as the title for the book in Jarvis and in OHC search.
-         If you don't set this, the value in PDB is used.
-         The booklibrary and mainbooktitle automatically get updated from this title!
-
-         Use a : character to distinguish booklibrary from mainbooktitle
-         To make sure the title is correctly set run:
-         'DitaUtils.py title -d template.ditamap'  or 'DitaUtils.py map-prep -d template.ditamap'
-      -->
-      <othermeta name="title" content="Oracle VM VirtualBox: User Guide for Release 7.0"/>
-
-      <!--
-           Th othermeta pubAlias detemines what the final part of the URL for your book will be (the pubalias in Jarvis).
-           If you don't set it, it will default to the docid in PDB.
-      -->
-         <othermeta name="pubAlias" content="user"/>
-         <othermeta name="jarvis-url" content="https://docs.oracle.com/en/virtualization/virtualbox/7.0/user/"/>
-      <!--
-         For SVN Revision information, you *must* do: `svn propset svn:keywords "Date Author Rev" template.ditamap`
-         on the ditamap when you first add it. You can automatically handle this by editing ~/.subversion/config
-         to add a line entry under [auto-props]:
-         *.ditamap = svn:mime-type=text/xml;svn:keywords=Author Date Id Rev URL;
-      -->
-      <othermeta name="revision" content="$Rev$"/>
-      <othermeta name="rev-date" content="$Date$"/>
-      <othermeta name="ditaval" content="ohc.ditaval"/>
-      <!-- The bookpartno matches the part and revision in PDB  -->
-         <bookid>
-            <bookpartno>F43655-03</bookpartno>
-         </bookid>
-         <bookrights>
-            <copyrfirst>
-               <year>2022</year>
-            </copyrfirst>
-            <bookowner>
-               <organization>Oracle and/or its affiliates. All rights reserved.</organization>
-            </bookowner>
-         </bookrights>
+      <bookrights>
+         <copyrfirst>
+            <year>2022</year>
+         </copyrfirst>
+         <bookowner>
+            <organization>Oracle and/or its affiliates. All rights reserved.</organization>
+         </bookowner>
+      </bookrights>
    </bookmeta>
-   <!--
-    Chunking at chapter level is handled automatically by running:
-    DitaUtils.py chunk -d template.ditamap or 'DitaUtils.py map-prep -d template.ditamap'
-  -->
-    <frontmatter>
+
+   <!-- Chunking should be set with chunk="to-content" in each chapter.  -->
+   <frontmatter>
        <mapref href="conkeyrefs.ditamap" format="ditamap" toc="no" processing-role="resource-only"/>
        <booklists>
@@ -74 +34 @@
           <tablelist/>
        </booklists>
-      <preface href="topics/preface.dita">
+      <preface href="topics/preface.dita" chunk="to-content">
          <topicref href="topics/preface-audience.dita"/>
          <topicref href="topics/preface-reldocs.dita"/>