Versionify static assets (#2646)

* Versionify static assets

* Move tests around for 2.13 stable

* dartfmt

* Fix a template...

Author: jcollins-g

lib/resources/script.js

@@ -1,3 +1,8 @@
+/*
+ *
+ *  Update script.js versions in all lib/templates when modifying this file!
+ *
+ */
 function initSideNav() {
   const leftNavToggle = document.getElementById('sidenav-left-toggle');
   const leftDrawer = document.querySelector('.sidebar-offcanvas-left');

lib/resources/styles.css

@@ -1,3 +1,8 @@
+/*
+ *
+ *  Update styles.css versions in all lib/templates when modifying this file!
+ *
+ */
 
 /* Palette generated by Material Palette - materialpalette.com/blue/cyan */
 

lib/templates/html/_footer.html

@@ -12,8 +12,9 @@
 </footer>
 
 {{! TODO(jdkoren): unwrap ^useBaseHref sections when the option is removed.}}
-<script src="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/highlight.pack.js"></script>
-<script src="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/script.js"></script>
+{{! **Update versions for static assets when changed to force browsers to refresh them.** }}
+<script src="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/highlight.pack.js?v1"></script>
+<script src="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/script.js?v1"></script>
 
 {{{ customFooter }}}
 

lib/templates/html/_head.html

@@ -24,9 +24,10 @@
   <link rel="preconnect" href="https://fonts.gstatic.com">
   <link href="https://fonts.googleapis.com/css2?family=Roboto+Mono:ital,wght@0,300;0,400;0,500;0,700;1,400&display=swap" rel="stylesheet">
   <link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
-  <link rel="stylesheet" href="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/github.css">
-  <link rel="stylesheet" href="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/styles.css">
-  <link rel="icon" href="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/favicon.png">
+  {{! **Update versions for static assets when changed to force browsers to refresh them.** }}
+  <link rel="stylesheet" href="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/github.css?v1">
+  <link rel="stylesheet" href="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/styles.css?v1">
+  <link rel="icon" href="{{^useBaseHref}}%%__HTMLBASE_dartdoc_internal__%%{{/useBaseHref}}static-assets/favicon.png?v1">
 
   {{{ customHeader }}}
 </head>