Clean up shared assets for API reference

This PR promotes the CSS, JS and FONTS files used by API reference to
the `static/css`, `static/js` and `static/fonts` directories
respectively. The intent is that for future releases, when generating
API reference docs, only the `index.html` and `navData.js` files need to
be copied from the generator tools.

Details of changes:

- `jquery-3.2.1.min.js` file is replaced by `jquery-3.3.1.min.js` to
  align with the version used by Docsy. We can investigate in the future
  whether this can be shared. Converging to the same version at least
  can reduce the risks of compatibility.
- `jquery.scrollTo.min.js` moved to `static/js` file and renamed to
  `jquery.scrollTo-2.1.2.min.js` so we know the version from file name.
- `scroll.js` moved to `static/js` and renamed to `scroll-apiref.js` to
  siginify that it is used by API reference.
- A `README.md` file is added to `static/js` directory for describing
  the purposes of the these files.
- `bootstrap.min.css` moved to `static/css` and renamed to
  `bootstrap-4.3.1.min.css` so that it can be shared and its version can
  be easily discovered.
- `font-awesome.min.css` moved to `static/css` and renamed to
  `fontawesome-4.7.0.min.css` for the same reason.
- `stylesheet.css` moved to `static/css` and renamed to
  `style_apiref.css` to siginify its purpose.
- A `README.md` file is added to `static/css` directory for describing
  the purposes of the these files.
- FontAwesome fonts files moved to `static/fonts` so that they can be
  shared across API reference versions.
- Current API reference (1.18) is modified to reference the relocated
  files. Upstream generator change on the way
  (kubernetes-sigs/reference-tools/#161).

Related: #22016, #22023, #22041, #22024, #22064
This commit is contained in:
Qiming Teng 2020-07-05 13:41:19 +08:00
parent ece28880f9
commit 162e5edb39
20 changed files with 32 additions and 10 deletions

13
static/css/README.md Normal file
View File

@ -0,0 +1,13 @@
# NOTE
This directory contains stylesheet files reference by different sections of
the website. Please use caution when moving/renaming them.
## Style Sheets used by API reference
- bootstrap-4.3.1.min.css
- fontawesome-4.7.0.min.css
- style_apiref.css

0
static/css/style_blablacar.css Executable file → Normal file
View File

0
static/css/style_buffer.css Executable file → Normal file
View File

0
static/css/style_wink.css Executable file → Normal file
View File

View File

@ -4,9 +4,9 @@
<META charset="UTF-8">
<TITLE>Kubernetes API Reference Docs</TITLE>
<LINK rel="shortcut icon" href="favicon.ico" type="image/vnd.microsoft.icon">
<LINK rel="stylesheet" href="css/bootstrap.min.css">
<LINK rel="stylesheet" href="css/font-awesome.min.css" type="text/css">
<LINK rel="stylesheet" href="css/stylesheet.css" type="text/css">
<LINK rel="stylesheet" href="/css/bootstrap-4.3.1.min.css">
<LINK rel="stylesheet" href="/css/fontawesome-4.7.0.min.css" type="text/css">
<LINK rel="stylesheet" href="/css/style_apiref.css" type="text/css">
</HEAD>
<BODY>
<DIV id="wrapper" class="container-fluid">
@ -47944,10 +47944,10 @@ The contents of the target Secret&#39;s Data field will be presented in a volume
</DIV>
</DIV>
</DIV>
<SCRIPT src="/js/jquery-3.2.1.min.js"></SCRIPT>
<SCRIPT src="js/jquery.scrollTo.min.js"></SCRIPT>
<SCRIPT src="/js/jquery-3.3.1.min.js"></SCRIPT>
<SCRIPT src="/js/jquery.scrollTo-2.1.2.min.js"></SCRIPT>
<SCRIPT src="/js/bootstrap-4.3.1.min.js"></SCRIPT>
<SCRIPT src="js/navData.js"></SCRIPT>
<SCRIPT src="js/scroll.js"></SCRIPT>
<SCRIPT src="/js/scroll-apiref.js"></SCRIPT>
</BODY>
</HTML>

View File

Before

Width:  |  Height:  |  Size: 434 KiB

After

Width:  |  Height:  |  Size: 434 KiB

11
static/js/README.md Normal file
View File

@ -0,0 +1,11 @@
# NOTE
This directory contains scripts files reference by different sections of
the website. Please use caution when moving/renaming them.
## Scripts used by API reference
- bootstrap-4.3.1.min.js
- jquery-3.3.1.min.js (indirect dependency from bootstrap-4.3.1.min.js)
- jquery.scrollTo-2.1.1.min.js

File diff suppressed because one or more lines are too long

2
static/js/jquery-3.3.1.min.js vendored Normal file

File diff suppressed because one or more lines are too long

0
static/js/script.js Executable file → Normal file
View File