Changeset 99060 in vbox for trunk/doc

Timestamp:

Mar 20, 2023 2:45:41 AM (21 months ago)

Author:

vboxsync

Message:

manual/Makefile.kmk: Cleaning up the makefile step by step... bugref:10348 bugref:10302

File:

• trunk/doc/manual/Makefile.kmk (modified) (3 diffs)

trunk/doc/manual/Makefile.kmk

@@ -669 +669 @@
  #    then used at the end of each conversion to fix the hrefs.
  #
+ #    Steps taken converting individual Docbook refentry files:
+ #        1. refsect2_to_refsect1.py flattens the refsect1/refsect2 hierarchy,
+ #           creating a .xml version next to the final dita file.
+ #        2. docbook2dita.xsl takes that and produces a .dita-file.
+ #        3. mark_external_urls.xsl marks external links in the .dita-file.
+ #        4. add_file_to_id_only_references.py converts ID-only hrefs into
+ #           href="filename.dita#ID" using the mapping DB.
 
  ##
@@ -713 +720 @@
                 "$$<" \
                 $$(VBOX_PATH_MANUAL_OUTBASE)/$1/user_isomakercmd-man.xml
- endef
+ endef # def_vbox_refentry_to_dita
 
  ## Convert a single refentry file to dita.
@@ -746 +753 @@
         $$(QUIET)$$(VBOX_BLD_PYTHON) $$(VBOX_PATH_MANUAL_SRC)/add_file_to_id_only_references.py \
                 --mapping-file "$$(VBOX_USER_MANUAL_ID_MAPPING_FILE_$1)" "$$@"
- endef
+ endef # def_vbox_refentry_file_to_dita
+
  $(foreach lang,$(VBOX_MANUAL_ALL_LANGUAGES) \
         ,$(evalcall2 def_vbox_refentry_to_dita,$(lang)) \