Skip to content

Commit d066393

Browse files
committed
[CI] Publish Documentation for 0a72a80
1 parent 6827243 commit d066393

File tree

170 files changed

+1160
-2059
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

170 files changed

+1160
-2059
lines changed

_/css/search.css

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
border: none;
1515
max-width: 600px;
1616
min-width: 500px;
17-
box-shadow: 0 1px 0 0 rgba(0, 0, 0, 0.2), 0 2px 3px 0 rgba(0, 0, 0, 0.1);
17+
box-shadow: 0 1px 0 0 rgb(0 0 0 / 20%), 0 2px 3px 0 rgb(0 0 0 / 10%);
1818
}
1919

2020
@media screen and (max-width: 768px) {
@@ -73,12 +73,12 @@
7373
}
7474

7575
.search-result-document-hit > a:hover {
76-
background-color: rgba(69, 142, 225, 0.05);
76+
background-color: rgb(69 142 225 / 5%);
7777
}
7878

7979
.search-result-document-hit .search-result-highlight {
8080
color: #174d8c;
81-
background: rgba(143, 187, 237, 0.1);
81+
background: rgb(143 187 237 / 10%);
8282
padding: 0.1em 0.05em;
8383
font-weight: 500;
8484
}
@@ -90,6 +90,14 @@
9090
margin-bottom: 0.25em;
9191
}
9292

93+
.search-result-document-hit .search-result-keywords {
94+
margin-top: 0.25em;
95+
}
96+
97+
.search-result-document-hit .search-result-keywords-field-label {
98+
font-weight: bold;
99+
}
100+
93101
#search-input {
94102
padding: 0.25em;
95103
}
@@ -103,13 +111,13 @@
103111
}
104112

105113
#search-field .filter {
106-
background: #fff linear-gradient(180deg,#e1e1e1 0,#e1e1e1) no-repeat 0/1px 50%;
114+
background: #fff linear-gradient(180deg, #e1e1e1 0, #e1e1e1) no-repeat 0 / 1px 50%;
107115
border: 1px solid #e1e1e1;
108116
border-left: none;
109117
border-radius: 0 0.1em 0.1em 0;
110118
color: #5d5d5d;
111119
cursor: pointer;
112-
font-size: .875em;
120+
font-size: 0.875em;
113121
display: flex;
114122
align-items: center;
115123
padding: 0 0.5rem;

_/js/search-ui.js

Lines changed: 76 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,29 @@
44
(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.antoraSearch = {}));
55
})(this, (function (exports) { 'use strict';
66

7+
/**
8+
* Splitting the text by the given positions.
9+
* The text within the positions getting the type "mark", all other text gets the type "text".
10+
* @param {string} text
11+
* @param {Object[]} positions
12+
* @param {number} positions.start
13+
* @param {number} positions.length
14+
* @param {number} snippetLength Maximum text length for text in the result.
15+
* @returns {[{text: string, type: string}]}
16+
*/
717
function buildHighlightedText (text, positions, snippetLength) {
818
const textLength = text.length;
9-
const validPositions = positions
10-
.filter((position) => position.length > 0 && position.start + position.length <= textLength);
19+
const validPositions = positions.filter(
20+
(position) => position.length > 0 && position.start + position.length <= textLength
21+
);
1122

1223
if (validPositions.length === 0) {
1324
return [
1425
{
1526
type: 'text',
16-
text: text.slice(0, snippetLength >= textLength ? textLength : snippetLength) + (snippetLength < textLength ? '...' : ''),
27+
text:
28+
text.slice(0, snippetLength >= textLength ? textLength : snippetLength) +
29+
(snippetLength < textLength ? '...' : ''),
1730
},
1831
]
1932
}
@@ -40,8 +53,9 @@
4053
});
4154
}
4255
let lastEndPosition = 0;
43-
const positionsWithinRange = orderedPositions
44-
.filter((position) => position.start >= range.start && position.start + position.length <= range.end);
56+
const positionsWithinRange = orderedPositions.filter(
57+
(position) => position.start >= range.start && position.start + position.length <= range.end
58+
);
4559

4660
for (const position of positionsWithinRange) {
4761
const start = position.start;
@@ -79,29 +93,20 @@
7993
*/
8094
function findTermPosition (lunr, term, text) {
8195
const str = text.toLowerCase();
82-
const len = str.length;
83-
84-
for (let sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) {
85-
const char = str.charAt(sliceEnd);
86-
const sliceLength = sliceEnd - sliceStart;
87-
88-
if ((char.match(lunr.tokenizer.separator) || sliceEnd === len)) {
89-
if (sliceLength > 0) {
90-
const value = str.slice(sliceStart, sliceEnd);
91-
// QUESTION: if we get an exact match without running the pipeline should we stop?
92-
if (value.includes(term)) {
93-
// returns the first match
94-
return {
95-
start: sliceStart,
96-
length: value.length,
97-
}
98-
}
96+
const index = str.indexOf(term);
97+
98+
if (index >= 0) {
99+
// extend term until word boundary to return the entire word
100+
const boundaries = str.substr(index).match(/^[\p{Alpha}]+/u);
101+
if (boundaries !== null && boundaries.length >= 0) {
102+
return {
103+
start: index,
104+
length: boundaries[0].length,
99105
}
100-
sliceStart = sliceEnd + 1;
101106
}
102107
}
103108

104-
// not found!
109+
// Not found
105110
return {
106111
start: 0,
107112
length: 0,
@@ -142,6 +147,15 @@
142147
return []
143148
}
144149

150+
function highlightKeyword (doc, terms) {
151+
const keyword = doc.keyword;
152+
if (keyword) {
153+
const positions = getTermPosition(keyword, terms);
154+
return buildHighlightedText(keyword, positions, snippetLength)
155+
}
156+
return []
157+
}
158+
145159
function highlightText (doc, terms) {
146160
const text = doc.text;
147161
const positions = getTermPosition(text, terms);
@@ -172,6 +186,7 @@
172186
pageTitleNodes: highlightPageTitle(doc.title, terms.title || []),
173187
sectionTitleNodes: highlightSectionTitle(sectionTitle, terms.title || []),
174188
pageContentNodes: highlightText(doc, terms.text || []),
189+
pageKeywordNodes: highlightKeyword(doc, terms.keyword || []),
175190
}
176191
}
177192

@@ -227,29 +242,24 @@
227242
const documentSectionTitle = document.createElement('div');
228243
documentSectionTitle.classList.add('search-result-section-title');
229244
documentHitLink.appendChild(documentSectionTitle);
230-
highlightingResult.sectionTitleNodes.forEach(function (node) {
231-
let element;
232-
if (node.type === 'text') {
233-
element = document.createTextNode(node.text);
234-
} else {
235-
element = document.createElement('span');
236-
element.classList.add('search-result-highlight');
237-
element.innerText = node.text;
238-
}
239-
documentSectionTitle.appendChild(element);
240-
});
245+
highlightingResult.sectionTitleNodes.forEach((node) => createHighlightedText(node, documentSectionTitle));
246+
}
247+
highlightingResult.pageContentNodes.forEach((node) => createHighlightedText(node, documentHitLink));
248+
249+
// only show keyword when we got a hit on them
250+
if (doc.keyword && highlightingResult.pageKeywordNodes.length > 1) {
251+
const documentKeywords = document.createElement('div');
252+
documentKeywords.classList.add('search-result-keywords');
253+
const documentKeywordsFieldLabel = document.createElement('span');
254+
documentKeywordsFieldLabel.classList.add('search-result-keywords-field-label');
255+
documentKeywordsFieldLabel.innerText = 'keywords: ';
256+
const documentKeywordsList = document.createElement('span');
257+
documentKeywordsList.classList.add('search-result-keywords-list');
258+
highlightingResult.pageKeywordNodes.forEach((node) => createHighlightedText(node, documentKeywordsList));
259+
documentKeywords.appendChild(documentKeywordsFieldLabel);
260+
documentKeywords.appendChild(documentKeywordsList);
261+
documentHitLink.appendChild(documentKeywords);
241262
}
242-
highlightingResult.pageContentNodes.forEach(function (node) {
243-
let element;
244-
if (node.type === 'text') {
245-
element = document.createTextNode(node.text);
246-
} else {
247-
element = document.createElement('span');
248-
element.classList.add('search-result-highlight');
249-
element.innerText = node.text;
250-
}
251-
documentHitLink.appendChild(element);
252-
});
253263
const searchResultItem = document.createElement('div');
254264
searchResultItem.classList.add('search-result-item');
255265
searchResultItem.appendChild(documentTitle);
@@ -260,6 +270,25 @@
260270
return searchResultItem
261271
}
262272

273+
/**
274+
* Creates an element from a highlightingResultNode and add it to the targetNode.
275+
* @param {Object} highlightingResultNode
276+
* @param {String} highlightingResultNode.type - type of the node
277+
* @param {String} highlightingResultNode.text
278+
* @param {Node} targetNode
279+
*/
280+
function createHighlightedText (highlightingResultNode, targetNode) {
281+
let element;
282+
if (highlightingResultNode.type === 'text') {
283+
element = document.createTextNode(highlightingResultNode.text);
284+
} else {
285+
element = document.createElement('span');
286+
element.classList.add('search-result-highlight');
287+
element.innerText = highlightingResultNode.text;
288+
}
289+
targetNode.appendChild(element);
290+
}
291+
263292
function createNoResult (text) {
264293
const searchResultItem = document.createElement('div');
265294
searchResultItem.classList.add('search-result-item');
@@ -278,7 +307,7 @@
278307
}
279308

280309
function filter (result, documents) {
281-
const facetFilter = facetFilterInput && facetFilterInput.checked && facetFilterInput.dataset.facetFilter;
310+
const facetFilter = facetFilterInput?.checked && facetFilterInput.dataset.facetFilter;
282311
if (facetFilter) {
283312
const [field, value] = facetFilter.split(':');
284313
return result.filter((item) => {

_/js/vendor/highlight.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

_/js/vendor/prism.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

guide/latest/categories/index.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ <h3 class="title"><a href="../index.html">Oracle SQL Features</a></h3>
186186
<a class="nav-link" href="sql/features/identity-columns.html">Identity Columns</a>
187187
</li>
188188
<li class="nav-item" data-depth="4">
189-
<a class="nav-link" href="sql/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
189+
<a class="nav-link" href="sql/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
190190
</li>
191191
<li class="nav-item" data-depth="4">
192192
<a class="nav-link" href="sql/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -279,7 +279,7 @@ <h3 class="title"><a href="../index.html">Oracle SQL Features</a></h3>
279279
<a class="nav-link" href="sql/23.2/if-not-exists.html">IF [NOT] EXISTS</a>
280280
</li>
281281
<li class="nav-item" data-depth="4">
282-
<a class="nav-link" href="sql/23.2/json-schema-validation-report.html">JSON Schema: check constraint</a>
282+
<a class="nav-link" href="sql/23.2/json-schema-check-constraint.html">JSON Schema: check constraint</a>
283283
</li>
284284
<li class="nav-item" data-depth="4">
285285
<a class="nav-link" href="sql/23.2/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -460,7 +460,7 @@ <h3 class="title"><a href="../index.html">Oracle SQL Features</a></h3>
460460
<a class="nav-link" href="../versions/23.2/features/inline-javascript.html">Inline JavaScript Procedures</a>
461461
</li>
462462
<li class="nav-item" data-depth="4">
463-
<a class="nav-link" href="../versions/23.2/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
463+
<a class="nav-link" href="../versions/23.2/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
464464
</li>
465465
<li class="nav-item" data-depth="4">
466466
<a class="nav-link" href="../versions/23.2/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -568,7 +568,7 @@ <h3 class="title"><a href="../index.html">Oracle SQL Features</a></h3>
568568
<a class="nav-link" href="../versions/23.2/sql/if-not-exists.html">IF [NOT] EXISTS</a>
569569
</li>
570570
<li class="nav-item" data-depth="4">
571-
<a class="nav-link" href="../versions/23.2/sql/json-schema-validation-report.html">JSON Schema: check constraint</a>
571+
<a class="nav-link" href="../versions/23.2/sql/json-schema-check-constraint.html">JSON Schema: check constraint</a>
572572
</li>
573573
<li class="nav-item" data-depth="4">
574574
<a class="nav-link" href="../versions/23.2/sql/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>

guide/latest/categories/javascript/12.1.0.1/index.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
186186
<a class="nav-link" href="../../sql/features/identity-columns.html">Identity Columns</a>
187187
</li>
188188
<li class="nav-item" data-depth="4">
189-
<a class="nav-link" href="../../sql/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
189+
<a class="nav-link" href="../../sql/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
190190
</li>
191191
<li class="nav-item" data-depth="4">
192192
<a class="nav-link" href="../../sql/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -279,7 +279,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
279279
<a class="nav-link" href="../../sql/23.2/if-not-exists.html">IF [NOT] EXISTS</a>
280280
</li>
281281
<li class="nav-item" data-depth="4">
282-
<a class="nav-link" href="../../sql/23.2/json-schema-validation-report.html">JSON Schema: check constraint</a>
282+
<a class="nav-link" href="../../sql/23.2/json-schema-check-constraint.html">JSON Schema: check constraint</a>
283283
</li>
284284
<li class="nav-item" data-depth="4">
285285
<a class="nav-link" href="../../sql/23.2/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -460,7 +460,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
460460
<a class="nav-link" href="../../../versions/23.2/features/inline-javascript.html">Inline JavaScript Procedures</a>
461461
</li>
462462
<li class="nav-item" data-depth="4">
463-
<a class="nav-link" href="../../../versions/23.2/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
463+
<a class="nav-link" href="../../../versions/23.2/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
464464
</li>
465465
<li class="nav-item" data-depth="4">
466466
<a class="nav-link" href="../../../versions/23.2/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -568,7 +568,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
568568
<a class="nav-link" href="../../../versions/23.2/sql/if-not-exists.html">IF [NOT] EXISTS</a>
569569
</li>
570570
<li class="nav-item" data-depth="4">
571-
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-validation-report.html">JSON Schema: check constraint</a>
571+
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-check-constraint.html">JSON Schema: check constraint</a>
572572
</li>
573573
<li class="nav-item" data-depth="4">
574574
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>

guide/latest/categories/javascript/12.1.0.2/index.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
186186
<a class="nav-link" href="../../sql/features/identity-columns.html">Identity Columns</a>
187187
</li>
188188
<li class="nav-item" data-depth="4">
189-
<a class="nav-link" href="../../sql/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
189+
<a class="nav-link" href="../../sql/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
190190
</li>
191191
<li class="nav-item" data-depth="4">
192192
<a class="nav-link" href="../../sql/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -279,7 +279,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
279279
<a class="nav-link" href="../../sql/23.2/if-not-exists.html">IF [NOT] EXISTS</a>
280280
</li>
281281
<li class="nav-item" data-depth="4">
282-
<a class="nav-link" href="../../sql/23.2/json-schema-validation-report.html">JSON Schema: check constraint</a>
282+
<a class="nav-link" href="../../sql/23.2/json-schema-check-constraint.html">JSON Schema: check constraint</a>
283283
</li>
284284
<li class="nav-item" data-depth="4">
285285
<a class="nav-link" href="../../sql/23.2/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -460,7 +460,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
460460
<a class="nav-link" href="../../../versions/23.2/features/inline-javascript.html">Inline JavaScript Procedures</a>
461461
</li>
462462
<li class="nav-item" data-depth="4">
463-
<a class="nav-link" href="../../../versions/23.2/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
463+
<a class="nav-link" href="../../../versions/23.2/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
464464
</li>
465465
<li class="nav-item" data-depth="4">
466466
<a class="nav-link" href="../../../versions/23.2/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -568,7 +568,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
568568
<a class="nav-link" href="../../../versions/23.2/sql/if-not-exists.html">IF [NOT] EXISTS</a>
569569
</li>
570570
<li class="nav-item" data-depth="4">
571-
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-validation-report.html">JSON Schema: check constraint</a>
571+
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-check-constraint.html">JSON Schema: check constraint</a>
572572
</li>
573573
<li class="nav-item" data-depth="4">
574574
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>

guide/latest/categories/javascript/21.3/index.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
186186
<a class="nav-link" href="../../sql/features/identity-columns.html">Identity Columns</a>
187187
</li>
188188
<li class="nav-item" data-depth="4">
189-
<a class="nav-link" href="../../sql/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
189+
<a class="nav-link" href="../../sql/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
190190
</li>
191191
<li class="nav-item" data-depth="4">
192192
<a class="nav-link" href="../../sql/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -279,7 +279,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
279279
<a class="nav-link" href="../../sql/23.2/if-not-exists.html">IF [NOT] EXISTS</a>
280280
</li>
281281
<li class="nav-item" data-depth="4">
282-
<a class="nav-link" href="../../sql/23.2/json-schema-validation-report.html">JSON Schema: check constraint</a>
282+
<a class="nav-link" href="../../sql/23.2/json-schema-check-constraint.html">JSON Schema: check constraint</a>
283283
</li>
284284
<li class="nav-item" data-depth="4">
285285
<a class="nav-link" href="../../sql/23.2/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -460,7 +460,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
460460
<a class="nav-link" href="../../../versions/23.2/features/inline-javascript.html">Inline JavaScript Procedures</a>
461461
</li>
462462
<li class="nav-item" data-depth="4">
463-
<a class="nav-link" href="../../../versions/23.2/features/json-schema-validation-report.html">JSON Schema: check constraint</a>
463+
<a class="nav-link" href="../../../versions/23.2/features/json-schema-check-constraint.html">JSON Schema: check constraint</a>
464464
</li>
465465
<li class="nav-item" data-depth="4">
466466
<a class="nav-link" href="../../../versions/23.2/features/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>
@@ -568,7 +568,7 @@ <h3 class="title"><a href="../../../index.html">Oracle SQL Features</a></h3>
568568
<a class="nav-link" href="../../../versions/23.2/sql/if-not-exists.html">IF [NOT] EXISTS</a>
569569
</li>
570570
<li class="nav-item" data-depth="4">
571-
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-validation-report.html">JSON Schema: check constraint</a>
571+
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-check-constraint.html">JSON Schema: check constraint</a>
572572
</li>
573573
<li class="nav-item" data-depth="4">
574574
<a class="nav-link" href="../../../versions/23.2/sql/json-schema-validate-rows.html">JSON Schema: validate rows in a table</a>

0 commit comments

Comments
 (0)