publish online book

zhongsp · Dec 8, 2023 · c6d3d2d · c6d3d2d
1 parent 8623c03
commit c6d3d2d
Show file tree

Hide file tree

Showing 133 changed files with 4,344 additions and 2,480 deletions.
diff --git a/docs/404.html b/docs/404.html
diff --git a/docs/PREFACE.html b/docs/PREFACE.html
diff --git a/docs/ayu-highlight.css b/docs/ayu-highlight.css
@@ -8,6 +8,7 @@ Original by Dempfi (https://github.com/dempfi/ayu)
   overflow-x: auto;
   background: #191f26;
   color: #e6e1cf;
+  padding: 0.5em;
 }
 
 .hljs-comment,

diff --git a/docs/book.js b/docs/book.js
@@ -4,16 +4,14 @@
 window.onunload = function () { };
 
 // Global variable, shared between modules
-function playground_text(playground, hidden = true) {
+function playground_text(playground) {
     let code_block = playground.querySelector("code");
 
     if (window.ace && code_block.classList.contains("editable")) {
         let editor = window.ace.edit(code_block);
         return editor.getValue();
-    } else if (hidden) {
-        return code_block.textContent;
     } else {
-        return code_block.innerText;
+        return code_block.textContent;
     }
 }
 
@@ -68,7 +66,7 @@ function playground_text(playground, hidden = true) {
     }
 
     // updates the visibility of play button based on `no_run` class and
-    // used crates vs ones available on https://play.rust-lang.org
+    // used crates vs ones available on http://play.rust-lang.org
     function update_play_button(pre_block, playground_crates) {
         var play_button = pre_block.querySelector(".play-button");
 
@@ -168,6 +166,7 @@ function playground_text(playground, hidden = true) {
             .filter(function (node) {return node.classList.contains("editable"); })
             .forEach(function (block) { block.classList.remove('language-rust'); });
 
+        Array
         code_nodes
             .filter(function (node) {return !node.classList.contains("editable"); })
             .forEach(function (block) { hljs.highlightBlock(block); });
@@ -179,7 +178,7 @@ function playground_text(playground, hidden = true) {
     // even if highlighting doesn't apply
     code_nodes.forEach(function (block) { block.classList.add('hljs'); });
 
-    Array.from(document.querySelectorAll("code.hljs")).forEach(function (block) {
+    Array.from(document.querySelectorAll("code.language-rust")).forEach(function (block) {
 
         var lines = Array.from(block.querySelectorAll('.boring'));
         // If no lines were hidden, return
@@ -301,13 +300,6 @@ function playground_text(playground, hidden = true) {
         themePopup.querySelector("button#" + get_theme()).focus();
     }
 
-    function updateThemeSelected() {
-        themePopup.querySelectorAll('.theme-selected').forEach(function (el) {
-            el.classList.remove('theme-selected');
-        });
-        themePopup.querySelector("button#" + get_theme()).classList.add('theme-selected');
-    }
-
     function hideThemes() {
         themePopup.style.display = 'none';
         themeToggleButton.setAttribute('aria-expanded', false);
@@ -363,7 +355,6 @@ function playground_text(playground, hidden = true) {
 
         html.classList.remove(previousTheme);
         html.classList.add(theme);
-        updateThemeSelected();
     }
 
     // Set theme
@@ -601,7 +592,7 @@ function playground_text(playground, hidden = true) {
         text: function (trigger) {
             hideTooltip(trigger);
             let playground = trigger.closest("pre");
-            return playground_text(playground, false);
+            return playground_text(playground);
         }
     });
 

diff --git a/docs/css/chrome.css b/docs/css/chrome.css
@@ -2,6 +2,12 @@
 
 @import 'variables.css';
 
+::-webkit-scrollbar {
+    background: var(--bg);
+}
+::-webkit-scrollbar-thumb {
+    background: var(--scrollbar);
+}
 html {
     scrollbar-color: var(--scrollbar) var(--bg);
 }
@@ -12,19 +18,6 @@ a > .hljs {
     color: var(--links);
 }
 
-/*
-    body-container is necessary because mobile browsers don't seem to like
-    overflow-x on the body tag when there is a <meta name="viewport"> tag.
-*/
-#body-container {
-    /*
-        This is used when the sidebar pushes the body content off the side of
-        the screen on small screens. Without it, dragging on mobile Safari
-        will want to reposition the viewport in a weird way.
-    */
-    overflow-x: clip;
-}
-
 /* Menu Bar */
 
 #menu-bar,
@@ -215,63 +208,24 @@ pre {
 pre > .buttons {
     position: absolute;
     z-index: 100;
-    right: 0px;
-    top: 2px;
-    margin: 0px;
-    padding: 2px 0px;
+    right: 5px;
+    top: 5px;
 
     color: var(--sidebar-fg);
     cursor: pointer;
-    visibility: hidden;
-    opacity: 0;
-    transition: visibility 0.1s linear, opacity 0.1s linear;
-}
-pre:hover > .buttons {
-    visibility: visible;
-    opacity: 1
 }
 pre > .buttons :hover {
     color: var(--sidebar-active);
-    border-color: var(--icons-hover);
-    background-color: var(--theme-hover);
 }
 pre > .buttons i {
     margin-left: 8px;
 }
 pre > .buttons button {
+    color: inherit;
+    background: transparent;
+    border: none;
     cursor: inherit;
-    margin: 0px 5px;
-    padding: 3px 5px;
-    font-size: 14px;
-
-    border-style: solid;
-    border-width: 1px;
-    border-radius: 4px;
-    border-color: var(--icons);
-    background-color: var(--theme-popup-bg);
-    transition: 100ms;
-    transition-property: color,border-color,background-color;
-    color: var(--icons);
-}
-@media (pointer: coarse) {
-    pre > .buttons button {
-        /* On mobile, make it easier to tap buttons. */
-        padding: 0.3rem 1rem;
-    }
-}
-pre > code {
-    padding: 1rem;
-}
-
-/* FIXME: ACE editors overlap their buttons because ACE does absolute
-   positioning within the code block which breaks padding. The only solution I
-   can think of is to move the padding to the outer pre tag (or insert a div
-   wrapper), but that would require fixing a whole bunch of CSS rules.
-*/
-.hljs.ace_editor {
-  padding: 0rem 0rem;
 }
-
 pre > .result {
     margin-top: 10px;
 }
@@ -514,8 +468,6 @@ ul#searchresults span.teaser em {
     padding: 0;
     list-style: none;
     display: none;
-    /* Don't let the children's background extend past the rounded corners. */
-    overflow: hidden;
 }
 .theme-popup .default {
     color: var(--icons);
@@ -524,7 +476,7 @@ ul#searchresults span.teaser em {
     width: 100%;
     border: 0;
     margin: 0;
-    padding: 2px 20px;
+    padding: 2px 10px;
     line-height: 25px;
     white-space: nowrap;
     text-align: left;
@@ -536,10 +488,8 @@ ul#searchresults span.teaser em {
 .theme-popup .theme:hover {
     background-color: var(--theme-hover);
 }
-
-.theme-selected::before {
-    display: inline-block;
-    content: "✓";
-    margin-left: -14px;
-    width: 14px;
+.theme-popup .theme:hover:first-child,
+.theme-popup .theme:hover:last-child {
+    border-top-left-radius: inherit;
+    border-top-right-radius: inherit;
 }
diff --git a/docs/css/general.css b/docs/css/general.css
@@ -22,18 +22,8 @@ body {
 }
 
 code {
-    font-family: var(--mono-font) !important;
-    font-size: var(--code-font-size);
-}
-
-/* make long words/inline code not x overflow */
-main {
-    overflow-wrap: break-word;
-}
-
-/* make wide tables scroll if they overflow */
-.table-wrapper {
-    overflow-x: auto;
+    font-family: "Source Code Pro", Consolas, "Ubuntu Mono", Menlo, "DejaVu Sans Mono", monospace, monospace !important;
+    font-size: 0.875em; /* please adjust the ace font size accordingly in editor.js */
 }
 
 /* Don't change font size in headers. */
@@ -90,7 +80,8 @@ h6:target::before {
 
 .content {
     overflow-y: auto;
-    padding: 0 5px 50px 5px;
+    padding: 0 15px;
+    padding-bottom: 50px;
 }
 .content main {
     margin-left: auto;
@@ -148,18 +139,6 @@ blockquote {
     border-bottom: .1em solid var(--quote-border);
 }
 
-kbd {
-    background-color: var(--table-border-color);
-    border-radius: 4px;
-    border: solid 1px var(--theme-popup-border);
-    box-shadow: inset 0 -1px 0 var(--theme-hover);
-    display: inline-block;
-    font-size: var(--code-font-size);
-    font-family: var(--mono-font);
-    line-height: 10px;
-    padding: 4px 5px;
-    vertical-align: middle;
-}
 
 :not(.footnote-definition) + .footnote-definition,
 .footnote-definition + :not(.footnote-definition) {

diff --git a/docs/css/variables.css b/docs/css/variables.css
@@ -6,8 +6,6 @@
     --page-padding: 15px;
     --content-max-width: 750px;
     --menu-bar-height: 50px;
-    --mono-font: "Source Code Pro", Consolas, "Ubuntu Mono", Menlo, "DejaVu Sans Mono", monospace, monospace;
-    --code-font-size: 0.875em /* please adjust the ace font size accordingly in editor.js */
 }
 
 /* Themes */

diff --git a/docs/highlight.css b/docs/highlight.css
@@ -61,6 +61,7 @@
   overflow-x: auto;
   background: #f6f7f6;
   color: #000;
+  padding: 0.5em;
 }
 
 .hljs-emphasis {

diff --git a/docs/index.html b/docs/index.html
diff --git a/docs/print.html b/docs/print.html
diff --git a/docs/searchindex.js b/docs/searchindex.js
diff --git a/docs/searchindex.json b/docs/searchindex.json
diff --git a/docs/tomorrow-night.css b/docs/tomorrow-night.css
@@ -1,7 +1,7 @@
 /* Tomorrow Night Theme */
-/* https://github.com/jmblog/color-themes-for-highlightjs */
+/* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
 /* Original theme - https://github.com/chriskempson/tomorrow-theme */
-/* https://github.com/jmblog/color-themes-for-highlightjs */
+/* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
 
 /* Tomorrow Comment */
 .hljs-comment {
@@ -81,6 +81,8 @@
   overflow-x: auto;
   background: #1d1f21;
   color: #c5c8c6;
+  padding: 0.5em;
+  -webkit-text-size-adjust: none;
 }
 
 .coffeescript .javascript,

diff --git a/docs/zh/breaking-changes/index.html b/docs/zh/breaking-changes/index.html
diff --git a/docs/zh/breaking-changes/typescript-1.4.html b/docs/zh/breaking-changes/typescript-1.4.html
diff --git a/docs/zh/breaking-changes/typescript-1.5.html b/docs/zh/breaking-changes/typescript-1.5.html
diff --git a/docs/zh/breaking-changes/typescript-1.6.html b/docs/zh/breaking-changes/typescript-1.6.html
diff --git a/docs/zh/breaking-changes/typescript-1.7.html b/docs/zh/breaking-changes/typescript-1.7.html
diff --git a/docs/zh/breaking-changes/typescript-1.8.html b/docs/zh/breaking-changes/typescript-1.8.html
diff --git a/docs/zh/breaking-changes/typescript-2.0.html b/docs/zh/breaking-changes/typescript-2.0.html
diff --git a/docs/zh/breaking-changes/typescript-2.1.html b/docs/zh/breaking-changes/typescript-2.1.html
diff --git a/docs/zh/breaking-changes/typescript-2.2.html b/docs/zh/breaking-changes/typescript-2.2.html
diff --git a/docs/zh/breaking-changes/typescript-2.3.html b/docs/zh/breaking-changes/typescript-2.3.html
diff --git a/docs/zh/breaking-changes/typescript-2.4.html b/docs/zh/breaking-changes/typescript-2.4.html
diff --git a/docs/zh/breaking-changes/typescript-2.6.html b/docs/zh/breaking-changes/typescript-2.6.html
diff --git a/docs/zh/breaking-changes/typescript-2.7.html b/docs/zh/breaking-changes/typescript-2.7.html
diff --git a/docs/zh/breaking-changes/typescript-2.8.html b/docs/zh/breaking-changes/typescript-2.8.html
diff --git a/docs/zh/breaking-changes/typescript-2.9.html b/docs/zh/breaking-changes/typescript-2.9.html
diff --git a/docs/zh/breaking-changes/typescript-3.0.html b/docs/zh/breaking-changes/typescript-3.0.html
diff --git a/docs/zh/breaking-changes/typescript-3.1.html b/docs/zh/breaking-changes/typescript-3.1.html
diff --git a/docs/zh/breaking-changes/typescript-3.2.html b/docs/zh/breaking-changes/typescript-3.2.html
diff --git a/docs/zh/breaking-changes/typescript-3.4.html b/docs/zh/breaking-changes/typescript-3.4.html
diff --git a/docs/zh/breaking-changes/typescript-3.5.html b/docs/zh/breaking-changes/typescript-3.5.html
diff --git a/docs/zh/breaking-changes/typescript-3.6.html b/docs/zh/breaking-changes/typescript-3.6.html
diff --git a/docs/zh/declaration-files/by-example.html b/docs/zh/declaration-files/by-example.html
diff --git a/docs/zh/declaration-files/consumption.html b/docs/zh/declaration-files/consumption.html
diff --git a/docs/zh/declaration-files/deep-dive.html b/docs/zh/declaration-files/deep-dive.html
diff --git a/docs/zh/declaration-files/do-s-and-don-ts.html b/docs/zh/declaration-files/do-s-and-don-ts.html
diff --git a/docs/zh/declaration-files/index.html b/docs/zh/declaration-files/index.html
diff --git a/docs/zh/declaration-files/introduction.html b/docs/zh/declaration-files/introduction.html
diff --git a/docs/zh/declaration-files/library-structures.html b/docs/zh/declaration-files/library-structures.html
diff --git a/docs/zh/declaration-files/publishing.html b/docs/zh/declaration-files/publishing.html
diff --git a/docs/zh/declaration-files/templates.html b/docs/zh/declaration-files/templates.html
diff --git a/docs/zh/handbook-v2/index.html b/docs/zh/handbook-v2/index.html
diff --git a/docs/zh/handbook-v2/type-manipulation/template-literal-types.html b/docs/zh/handbook-v2/type-manipulation/template-literal-types.html
diff --git a/docs/zh/handbook/basic-types.html b/docs/zh/handbook/basic-types.html
diff --git a/docs/zh/handbook/classes.html b/docs/zh/handbook/classes.html
diff --git a/docs/zh/handbook/enums.html b/docs/zh/handbook/enums.html
diff --git a/docs/zh/handbook/functions.html b/docs/zh/handbook/functions.html
diff --git a/docs/zh/handbook/generics.html b/docs/zh/handbook/generics.html
diff --git a/docs/zh/handbook/index.html b/docs/zh/handbook/index.html
diff --git a/docs/zh/handbook/interfaces.html b/docs/zh/handbook/interfaces.html
diff --git a/docs/zh/handbook/literal-types.html b/docs/zh/handbook/literal-types.html
diff --git a/docs/zh/handbook/unions-and-intersections.html b/docs/zh/handbook/unions-and-intersections.html
diff --git a/docs/zh/javascript/type-checking-javascript-files.html b/docs/zh/javascript/type-checking-javascript-files.html
diff --git a/docs/zh/project-config/compiler-options-in-msbuild.html b/docs/zh/project-config/compiler-options-in-msbuild.html
diff --git a/docs/zh/project-config/compiler-options.html b/docs/zh/project-config/compiler-options.html
diff --git a/docs/zh/project-config/configuring-watch.html b/docs/zh/project-config/configuring-watch.html
diff --git a/docs/zh/project-config/index.html b/docs/zh/project-config/index.html
diff --git a/docs/zh/project-config/integrating-with-build-tools.html b/docs/zh/project-config/integrating-with-build-tools.html
diff --git a/docs/zh/project-config/nightly-builds.html b/docs/zh/project-config/nightly-builds.html
diff --git a/docs/zh/project-config/project-references.html b/docs/zh/project-config/project-references.html
diff --git a/docs/zh/project-config/tsconfig.json.html b/docs/zh/project-config/tsconfig.json.html
diff --git a/docs/zh/project-config/typings-for-npm-packages.html b/docs/zh/project-config/typings-for-npm-packages.html
diff --git a/docs/zh/reference/advanced-types.html b/docs/zh/reference/advanced-types.html
diff --git a/docs/zh/reference/declaration-merging.html b/docs/zh/reference/declaration-merging.html
diff --git a/docs/zh/reference/decorators.html b/docs/zh/reference/decorators.html
diff --git a/docs/zh/reference/index.html b/docs/zh/reference/index.html
diff --git a/docs/zh/reference/iterators-and-generators.html b/docs/zh/reference/iterators-and-generators.html
diff --git a/docs/zh/reference/jsx.html b/docs/zh/reference/jsx.html
diff --git a/docs/zh/reference/mixins.html b/docs/zh/reference/mixins.html
diff --git a/docs/zh/reference/module-resolution.html b/docs/zh/reference/module-resolution.html
diff --git a/docs/zh/reference/modules.html b/docs/zh/reference/modules.html
diff --git a/docs/zh/reference/namespaces-and-modules.html b/docs/zh/reference/namespaces-and-modules.html
diff --git a/docs/zh/reference/namespaces.html b/docs/zh/reference/namespaces.html
diff --git a/docs/zh/reference/symbols.html b/docs/zh/reference/symbols.html
diff --git a/docs/zh/reference/triple-slash-directives.html b/docs/zh/reference/triple-slash-directives.html
diff --git a/docs/zh/reference/type-compatibility.html b/docs/zh/reference/type-compatibility.html
diff --git a/docs/zh/reference/type-inference.html b/docs/zh/reference/type-inference.html
diff --git a/docs/zh/reference/utility-types.html b/docs/zh/reference/utility-types.html
diff --git a/docs/zh/reference/variable-declarations.html b/docs/zh/reference/variable-declarations.html
diff --git a/docs/zh/release-notes/index.html b/docs/zh/release-notes/index.html
diff --git a/docs/zh/release-notes/typescript-1.1.html b/docs/zh/release-notes/typescript-1.1.html
diff --git a/docs/zh/release-notes/typescript-1.3.html b/docs/zh/release-notes/typescript-1.3.html
diff --git a/docs/zh/release-notes/typescript-1.4.html b/docs/zh/release-notes/typescript-1.4.html
diff --git a/docs/zh/release-notes/typescript-1.5.html b/docs/zh/release-notes/typescript-1.5.html
diff --git a/docs/zh/release-notes/typescript-1.6.html b/docs/zh/release-notes/typescript-1.6.html
diff --git a/docs/zh/release-notes/typescript-1.7.html b/docs/zh/release-notes/typescript-1.7.html
diff --git a/docs/zh/release-notes/typescript-1.8.html b/docs/zh/release-notes/typescript-1.8.html
diff --git a/docs/zh/release-notes/typescript-2.0.html b/docs/zh/release-notes/typescript-2.0.html
diff --git a/docs/zh/release-notes/typescript-2.1.html b/docs/zh/release-notes/typescript-2.1.html
diff --git a/docs/zh/release-notes/typescript-2.2.html b/docs/zh/release-notes/typescript-2.2.html
diff --git a/docs/zh/release-notes/typescript-2.3.html b/docs/zh/release-notes/typescript-2.3.html
diff --git a/docs/zh/release-notes/typescript-2.4.html b/docs/zh/release-notes/typescript-2.4.html
diff --git a/docs/zh/release-notes/typescript-2.5.html b/docs/zh/release-notes/typescript-2.5.html
diff --git a/docs/zh/release-notes/typescript-2.6.html b/docs/zh/release-notes/typescript-2.6.html
diff --git a/docs/zh/release-notes/typescript-2.7.html b/docs/zh/release-notes/typescript-2.7.html
diff --git a/docs/zh/release-notes/typescript-2.8.html b/docs/zh/release-notes/typescript-2.8.html
diff --git a/docs/zh/release-notes/typescript-2.9.html b/docs/zh/release-notes/typescript-2.9.html
diff --git a/docs/zh/release-notes/typescript-3.0.html b/docs/zh/release-notes/typescript-3.0.html
diff --git a/docs/zh/release-notes/typescript-3.1.html b/docs/zh/release-notes/typescript-3.1.html
diff --git a/docs/zh/release-notes/typescript-3.2.html b/docs/zh/release-notes/typescript-3.2.html
diff --git a/docs/zh/release-notes/typescript-3.3.html b/docs/zh/release-notes/typescript-3.3.html
diff --git a/docs/zh/release-notes/typescript-3.4.html b/docs/zh/release-notes/typescript-3.4.html
diff --git a/docs/zh/release-notes/typescript-3.5.html b/docs/zh/release-notes/typescript-3.5.html
diff --git a/docs/zh/release-notes/typescript-3.6.html b/docs/zh/release-notes/typescript-3.6.html
diff --git a/docs/zh/release-notes/typescript-3.7.html b/docs/zh/release-notes/typescript-3.7.html
diff --git a/docs/zh/release-notes/typescript-3.8.html b/docs/zh/release-notes/typescript-3.8.html
diff --git a/docs/zh/release-notes/typescript-3.9.html b/docs/zh/release-notes/typescript-3.9.html
diff --git a/docs/zh/release-notes/typescript-4.0.html b/docs/zh/release-notes/typescript-4.0.html
diff --git a/docs/zh/release-notes/typescript-4.1.html b/docs/zh/release-notes/typescript-4.1.html
diff --git a/docs/zh/release-notes/typescript-4.2.html b/docs/zh/release-notes/typescript-4.2.html
diff --git a/docs/zh/release-notes/typescript-4.3.html b/docs/zh/release-notes/typescript-4.3.html
diff --git a/docs/zh/release-notes/typescript-4.4.html b/docs/zh/release-notes/typescript-4.4.html
diff --git a/docs/zh/release-notes/typescript-4.5.html b/docs/zh/release-notes/typescript-4.5.html
diff --git a/docs/zh/release-notes/typescript-4.6.html b/docs/zh/release-notes/typescript-4.6.html
diff --git a/docs/zh/release-notes/typescript-4.7.html b/docs/zh/release-notes/typescript-4.7.html
diff --git a/docs/zh/release-notes/typescript-4.8.html b/docs/zh/release-notes/typescript-4.8.html
diff --git a/docs/zh/release-notes/typescript-4.9.html b/docs/zh/release-notes/typescript-4.9.html
diff --git a/docs/zh/release-notes/typescript-5.0.html b/docs/zh/release-notes/typescript-5.0.html
diff --git a/docs/zh/release-notes/typescript-5.1.html b/docs/zh/release-notes/typescript-5.1.html
diff --git a/docs/zh/release-notes/typescript-5.2.html b/docs/zh/release-notes/typescript-5.2.html
diff --git a/docs/zh/release-notes/typescript-5.3.html b/docs/zh/release-notes/typescript-5.3.html
diff --git a/docs/zh/tutorials/angular-2.html b/docs/zh/tutorials/angular-2.html
diff --git a/docs/zh/tutorials/asp.net-4.html b/docs/zh/tutorials/asp.net-4.html
diff --git a/docs/zh/tutorials/asp.net-core.html b/docs/zh/tutorials/asp.net-core.html
diff --git a/docs/zh/tutorials/gulp.html b/docs/zh/tutorials/gulp.html
diff --git a/docs/zh/tutorials/index.html b/docs/zh/tutorials/index.html
diff --git a/docs/zh/tutorials/knockout.html b/docs/zh/tutorials/knockout.html
diff --git a/docs/zh/tutorials/migrating-from-javascript.html b/docs/zh/tutorials/migrating-from-javascript.html
diff --git a/docs/zh/tutorials/react-and-webpack.html b/docs/zh/tutorials/react-and-webpack.html
diff --git a/docs/zh/tutorials/react.html b/docs/zh/tutorials/react.html
diff --git a/docs/zh/tutorials/typescript-in-5-minutes.html b/docs/zh/tutorials/typescript-in-5-minutes.html