ISIS Application Docs style overhaul (#5617)

* home, header, toc (minus images/icons) * application docs overview, parameters * formatting on specific isis docs * style changes - examples, print * usgs footer * print friendly css * isis-docs-sitewide css * header lock, add footer to main * icon assets (pd) * removed PrinterFriendly doc builds and old footers * mobile menu * header remove search, tabs scroll * menuPath for header assets, s3 common for fonts * remove ancient menu assets
DOI-USGS · Oct 1, 2024 · 636eb25 · 636eb25
1 parent 778abcb
commit 636eb25
Show file tree

Hide file tree

Showing 76 changed files with 33,396 additions and 4,584 deletions.
diff --git a/isis/cmake/BuildDocs.cmake b/isis/cmake/BuildDocs.cmake
@@ -167,19 +167,14 @@ function(build_application_docs)
   #  locations instead of copying them to a temporary build directory?
 
   set(appFolder            "${docBuildFolder}/Application")
-  set(printerStyleFolder   "${appFolder}/presentation/PrinterFriendly/styles")
   set(tabbedStyleFolder    "${appFolder}/presentation/Tabbed/styles")
 
   set(installAppFolder     "${docInstallFolder}/${docVersion}/Application")
-  set(installPrinterFolder "${installAppFolder}/presentation/PrinterFriendly")
   set(installTabbedFolder  "${installAppFolder}/presentation/Tabbed")
 
   # Make output directories and copy the styles
-  file(MAKE_DIRECTORY "${installPrinterFolder}")
   file(MAKE_DIRECTORY "${installTabbedFolder}")
-  file(MAKE_DIRECTORY "${installPrinterFolder}/styles")
   file(MAKE_DIRECTORY "${installTabbedFolder}/styles")
-  copy_wildcard("${printerStyleFolder}/*.css" ${installPrinterFolder}/styles/)
   copy_wildcard("${tabbedStyleFolder}/*.css"  ${installTabbedFolder}/styles/ )
 
   # Loop through module folders
@@ -193,17 +188,13 @@ function(build_application_docs)
       get_filename_component(appName ${f} NAME)
 
       # Get printer-friendly and tabbed output folders
-      set(pfAppFolder ${installPrinterFolder}/${appName})
       set(tbAppFolder ${installTabbedFolder}/${appName})
-      file(MAKE_DIRECTORY "${pfAppFolder}")
       file(MAKE_DIRECTORY "${tbAppFolder}")
 
       if(EXISTS ${f}/assets)
-        copy_folder(${f}/assets ${pfAppFolder})
         copy_folder(${f}/assets ${tbAppFolder})
       endif()
 
-      execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../../../../\" ${XALAN_OUTFILE_OPTION} ${pfAppFolder}/${appName}.html ${XALAN_INFILE_OPTION} ${f}/${appName}.xml ${XALAN_XSL_OPTION} ${printerStyleFolder}/IsisApplicationDocStyle.xsl)
       execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../../../../\" ${XALAN_OUTFILE_OPTION} ${tbAppFolder}/${appName}.html ${XALAN_INFILE_OPTION} ${f}/${appName}.xml ${XALAN_XSL_OPTION} ${tabbedStyleFolder}/IsisApplicationDocStyle.xsl)
 
     endforeach() # End loop through app folders

diff --git a/isis/src/base/apps/automos/automos.xml b/isis/src/base/apps/automos/automos.xml
diff --git a/isis/src/base/apps/deriv/work/deriv.html b/isis/src/base/apps/deriv/work/deriv.html
@@ -116,7 +116,6 @@
                text-decoration: none ;
                margin-top:2px;
                margin-bottom:3px;
-               background-color: #88AACC ;
                padding: 3px ;
               }
 

diff --git a/isis/src/base/apps/maptemplate/maptemplate.xml b/isis/src/base/apps/maptemplate/maptemplate.xml
@@ -125,7 +125,7 @@ Group = Mapping
      software like <i>cam2map</i>, an error will occur. Below is a list of
      projections and the keywords that must be in the Map File Template:<br />
 
-<table class="tableFormattedInformation" border="1" style="width:700px;">
+<table class="tableFormattedInformation">
 <tr>
    <th>
       PROJECTION
@@ -182,7 +182,7 @@ Group = Mapping
 <p>
 <b>How the defaults are set for Mapping Group keywords:</b>
 
-<table class="tableFormattedInformation" border="1" style="width:700px;">
+<table class="tableFormattedInformation">
 <tr>
    <th>
       DEFAULT SOURCE
@@ -269,7 +269,7 @@ Group = Mapping
    <p>
      <b>Parameter Setting Action</b>
 
-     <table class="tableFormattedInformation" border="1" style="width:700px;">
+     <table class="tableFormattedInformation">
 
      <tr>
        <th>

diff --git a/isis/src/docsys/Application/build/TOCindex.xsl b/isis/src/docsys/Application/build/TOCindex.xsl
@@ -42,8 +42,6 @@ Deborah Lee Soltesz
             USGS: ISIS Application Table of Contents
         </title>
         <link rel="stylesheet" href="../assets/styles/IsisStyleCommon.css"></link>
-        <link rel="stylesheet" href="presentation/PrinterFriendly/styles/IsisApplicationDocStyle.css"></link>
-        <link rel="stylesheet" href="../assets/styles/menu.css"/>
         <link rel="stylesheet" media="print" href="../assets/styles/print.css"/>
 
         <meta name="keywords" content="Isis, applications, table of contents, image processing"/>

diff --git a/isis/src/docsys/Application/build/TOCindex_alpha.xsl b/isis/src/docsys/Application/build/TOCindex_alpha.xsl
@@ -21,9 +21,14 @@ Deborah Lee Soltesz
     doctype-system="http://www.w3.org/TR/html4/loose.dtd"
     indent="yes"
     encoding="utf-8"
-    omit-xml-declaration="yes"/>
+    omit-xml-declaration="yes"
+  />
+
+  <xsl:param name="menuPath"/>
 
   <xsl:include href="../../build/menu.xsl"/>
+  <xsl:include href="../../build/header.xsl"/>
+  <xsl:include href="../../build/footer.xsl"/>
 
 
   <xsl:key name="categoryMatch" match="/tableofcontents/application" use="category/categoryItem"/>
@@ -40,11 +45,19 @@ Deborah Lee Soltesz
         <title>
             USGS: ISIS Application Table of Contents (Alphabetical Listing)
         </title>
-        <link rel="stylesheet" href="../assets/styles/IsisStyleCommon.css"></link>
-        <link rel="stylesheet" href="presentation/PrinterFriendly/styles/IsisApplicationDocStyle.css"></link>
-        <link rel="stylesheet" href="../assets/styles/menu.css"/>
+
+        <!-- ISIS Docs -->
+        <link rel="stylesheet" href="../assets/styles/IsisStyleCommon.css"/>
         <link rel="stylesheet" media="print" href="../assets/styles/print.css"/>
 
+        <!-- USGS -->
+        <link rel="stylesheet" href="../assets/styles/usgs/common.css" />
+        <link rel="stylesheet" href="../assets/styles/usgs/custom.css" />
+
+        <!-- Govt -->
+        <link rel="stylesheet" href="../assets/styles/uswds.css"/>
+        <script src="../assets/scripts/uswds-init.min.js"></script>
+
         <meta name="keywords" content="Isis, applications, table of contents, image processing"/>
 
         <meta name="description" content="Isis Applications Table of Contents listed in alphabetical order"/>
@@ -58,95 +71,47 @@ Deborah Lee Soltesz
         <meta name="city" content="Flagstaff"/>
         <meta name="zip" content="86001"/>
 
-        <!-- Dynamic analytics insertion to prevent running on local URLs -->
-        <xsl:text>&#xa;</xsl:text>
-        <script type="text/javascript">
-          //<xsl:comment><![CDATA[
-          (function() {
-            var usgsAnalytics = document.createElement('script');
-            usgsAnalytics.type = 'text/javascript';
-            usgsAnalytics.async = true;
-            usgsAnalytics.src = 'http://www.usgs.gov/scripts/analytics/usgs-analytics.js';
-            if('http:' == document.location.protocol) {
-              var s = document.getElementsByTagName('script')[0];
-              s.parentNode.insertBefore(usgsAnalytics, s);
-            }
-          })();
-          ]]></xsl:comment>
-        <xsl:text>&#xa;</xsl:text>
-        </script>
-
        </head>
 
       <body>
 
-        <div class="isisMenu">
-         <xsl:call-template  name="writeMenu"/>
-        </div>
-
-        <div class="isisContent">
-
-        <a href="http://www.usgs.gov">
-        <img src="../assets/icons/littleVIS.gif" width="80" height="22" border="0" alt="USGS"/></a><br/>
-
-
-        <p style="margin-top:10px; margin-bottom:0px;">
-        ISIS Application Documentation</p>
-
-        <hr/>
-
+        <script src="../assets/scripts/uswds.min.js"></script>
+
+        <xsl:call-template name="writeHeader"/>
 
-        <table width="100%" cellpadding="0" border="0" cellspacing="0">
-          <tr valign="top">
-            <td align="right" class="caption">
-              <a href="index.html">Categorical</a> |
-              <a href="oldvnew.html">Old vs. New</a> |
-              <a href="../index.html">Home</a>
-            </td>
-          </tr>
-          <tr valign="top">
-            <td align="left">
-              <h1>
-                Alphabetical Listing of Applications
-              </h1>
-            </td>
-          </tr>
-        </table>
+        <div id="page">
 
+          <div class="isisMenu">
+            <xsl:call-template  name="writeMenu"/>
+          </div>
 
+          <main class="isisContent">
 
+            <h1>
+              Alphabetical Listing of Applications
+            </h1>
 
-<!-- Alphabetical tables of links to documentation -->
-
+            <!-- Alphabetical tables of links to documentation -->
             <table>
             <xsl:for-each select="/tableofcontents/application">
               <xsl:sort order="ascending" select="name"/>
                 <tr>
-                  <th class="tableCellLevel1_th">
+                  <th>
                     <xsl:variable name="appName" select="normalize-space(name)"/>
                     <a href="presentation/Tabbed/{$appName}/{$appName}.html">
                     <xsl:value-of select="$appName"/></a>
                   </th>
-                  <td class="tableCellLevel1">
+                  <td>
                     <xsl:if test="brief">
                     <xsl:value-of select="brief"/><br/>
                     </xsl:if>
                   </td>
                 </tr>
             </xsl:for-each>
             </table>
-
-
-
-
-
-
-
-<!-- FOOTER -->
-<script type="text/javascript" language="JavaScript" src="../assets/scripts/footer.js"></script>
-</div>
-
-
+          </main>
+        </div>
+        <xsl:call-template name="writeFooter"/>
       </body>
     </html>