1. Introduction

This page is devoted to actions necessary to buildout the SWEHBVE version of the Handbook. 

The checklist for building the new version is in SWEHBDOC - New Version of SWEHB. 

2. Theme

2.1 Header And Footer Layout

The new theme will have the same layout except for the following: 

  • Header:
    • New images for SWEHBVE 
      • Draft - has "DRAFT" in the image
      • Production - "DRAFT" is removed from the image
    • New buttons pointing to Top Level Pages in SWEHBVE
  • Footer - No changes

The images are built in a PPT that is attached to the SWEHBVE - Book A. Introduction.  

  • The PPT where the images were built is "SWEHB Multiver Graphics.PPT"
  • Draft banner is the image "SWEHBVE_DRAFT.jpg"
  • Production banner is the image "SWEHBVE_banner.jpg"

2.1.2 DRAFT Image - SWEHBVE_draft.jpg"

2.1.2 Production Image - SWEHBVE_banner.jpg

2.2 Buttons in SWEHBVE

Buttons in the Header area of the theme match those in SWEHBVD except that they point to SWEHBVE and the appropriate Top Level Page in the new space. Buttons are in a theme code module "top.vm". IT manages the theme and makes changes in the "top.vm" module. 

The buttons in SWEHBVE are the same as those in SWEHBD. The targets for the buttons are created in SWEHBVE under the home page. In the code, each button target is identified by its space and title. The code from SWEHBVD will be used in the SWEHBVE theme and only the space codes (SWEHBVD and SWEHBVE) will need to be changed. This was requested 9/4/2025. 

2.3 Theme Promotion At New Version Release

When the SWEHBVE is promoted to be the "current version" the following changes will be made by IT: 

  • The SWEHBVD theme will be demoted to being the theme for only the SWEHBVD space
  • The SWEHBVE theme will be promoted to being the Default Theme. This will make SWEHBVE show up on both the SWEHBVE and SITE spaces.
  • All other versions of the handbook will continue to use their own custom theme. 

3. Top Level Pages

Some top level pages that will be moved into SWEHBVE manually. These are necessary to ensure that the buttons in the Header are working properly. A mass copy of the remaining pages will then be done. 

3.1 First Set of TLP

  • Book A. Introduction - this will become the anchor for the new version just like in SWEHBVD - Done, needs cleanup
  • Page Sections - to fix Page Top Messages - Copy complete - needs cleanup
  • B. Institutional Requirements - Copy complete -
  • C. Project Software Requirements - Copy complete -
  • D. Topics -Copy complete -
  • E. Tools, References, and Terms - with children - Copy complete -
  • Label database - Copy complete -
  • References Table - Copy complete -
  • SWE Pages - need children
  • Tools Table - Copy complete -
  • Topics Pages - need children


  • Protected Area - Cleanup before copying


4. Copy Instructions 

Copy instructions will be developed, tested and documented here so they can be reliably used when the real copy of SWEHBVE is done. 

4.1 Automatic Changes When Title Changes

Page Top Messages are in many pages including Top Level pages, all SWE and HR pages, and all Topic pages. To avoid manually going into each page to change it, use the following steps (this was done on the Intro page):

  • copied "Page Sections" from VD to VE.
  • In SWEHBVE Changed "2D" in Intro Page Top Message to "2E"
  • Checked Intro page and found that the 2D was changed to 2E automatically in the Excerpt-Include macro at the top of the page.
  • This technique worked for Major Page Message pages
  • It should also work for SWE and Topics pages when they are copied over 

4.2 Page Top Messages

Many pages will have an Excerpt-Include pointing to "SWEHBVD:2D-SWE Page Message" you will have to fix this in SWEHBVE pages by changing it to point to "2E-SWE Page Message". This takes the space key out (it is not needed in SWEHBVE space) and fixes the page name from "2D" to "2E". 


5. Page Naming

When pages are copied over to SWEHBVE links will be copied as well. The question here is: "what space is the link pointing to when the page is copied to SWEHBVE?" 

Test will be made here and instructions will be developed, tested and documented here so they can be reliably used when the real copy of SWEHBVE is done.