Skip to content

Commit e6a0e21

Browse files
committed
From refs/heads/main 4da7847
1 parent ceb306e commit e6a0e21

21 files changed

+551
-364
lines changed

.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: ec8abc018b81dc419654f69a25c8c2f8
3+
config: 18510e92f530ffc2ec78afa455962c72
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

.nojekyll

Whitespace-only changes.

README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
#GitHub Pages
2+
3+
Last update of sphinx html documentation from [4da7847](https://github.com/lanl/hydropop/tree/4da7847d0cd0096ca2082f94232010a5b2a39b3f)

_sources/modules.rst.txt

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
docs
2+
====
3+
4+
.. toctree::
5+
:maxdepth: 4
6+

_static/_sphinx_javascript_frameworks_compat.js

Lines changed: 3 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,9 @@
1-
/*
2-
* _sphinx_javascript_frameworks_compat.js
3-
* ~~~~~~~~~~
4-
*
5-
* Compatability shim for jQuery and underscores.js.
6-
*
7-
* WILL BE REMOVED IN Sphinx 6.0
8-
* xref RemovedInSphinx60Warning
1+
/* Compatability shim for jQuery and underscores.js.
92
*
3+
* Copyright Sphinx contributors
4+
* Released under the two clause BSD licence
105
*/
116

12-
/**
13-
* select a different prefix for underscore
14-
*/
15-
$u = _.noConflict();
16-
17-
187
/**
198
* small helper function to urldecode strings
209
*

_static/basic.css

Lines changed: 48 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
*
55
* Sphinx stylesheet -- basic theme.
66
*
7-
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
7+
* :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
88
* :license: BSD, see LICENSE for details.
99
*
1010
*/
@@ -236,17 +236,11 @@ div.body p, div.body dd, div.body li, div.body blockquote {
236236
a.headerlink {
237237
visibility: hidden;
238238
}
239-
a.brackets:before,
240-
span.brackets > a:before{
241-
content: "[";
242-
}
243239

244-
a.brackets:after,
245-
span.brackets > a:after {
246-
content: "]";
240+
a:visited {
241+
color: #551A8B;
247242
}
248243

249-
250244
h1:hover > a.headerlink,
251245
h2:hover > a.headerlink,
252246
h3:hover > a.headerlink,
@@ -334,11 +328,17 @@ aside.sidebar {
334328
p.sidebar-title {
335329
font-weight: bold;
336330
}
331+
332+
nav.contents,
333+
aside.topic,
337334
div.admonition, div.topic, blockquote {
338335
clear: left;
339336
}
340337

341338
/* -- topics ---------------------------------------------------------------- */
339+
340+
nav.contents,
341+
aside.topic,
342342
div.topic {
343343
border: 1px solid #ccc;
344344
padding: 7px;
@@ -377,13 +377,17 @@ div.body p.centered {
377377

378378
div.sidebar > :last-child,
379379
aside.sidebar > :last-child,
380+
nav.contents > :last-child,
381+
aside.topic > :last-child,
380382
div.topic > :last-child,
381383
div.admonition > :last-child {
382384
margin-bottom: 0;
383385
}
384386

385387
div.sidebar::after,
386388
aside.sidebar::after,
389+
nav.contents::after,
390+
aside.topic::after,
387391
div.topic::after,
388392
div.admonition::after,
389393
blockquote::after {
@@ -608,19 +612,27 @@ ol.simple p,
608612
ul.simple p {
609613
margin-bottom: 0;
610614
}
611-
dl.footnote > dt,
612-
dl.citation > dt {
615+
616+
aside.footnote > span,
617+
div.citation > span {
613618
float: left;
614-
margin-right: 0.5em;
615619
}
616-
617-
dl.footnote > dd,
618-
dl.citation > dd {
620+
aside.footnote > span:last-of-type,
621+
div.citation > span:last-of-type {
622+
padding-right: 0.5em;
623+
}
624+
aside.footnote > p {
625+
margin-left: 2em;
626+
}
627+
div.citation > p {
628+
margin-left: 4em;
629+
}
630+
aside.footnote > p:last-of-type,
631+
div.citation > p:last-of-type {
619632
margin-bottom: 0em;
620633
}
621-
622-
dl.footnote > dd:after,
623-
dl.citation > dd:after {
634+
aside.footnote > p:last-of-type:after,
635+
div.citation > p:last-of-type:after {
624636
content: "";
625637
clear: both;
626638
}
@@ -636,10 +648,6 @@ dl.field-list > dt {
636648
padding-left: 0.5em;
637649
padding-right: 5px;
638650
}
639-
dl.field-list > dt:after {
640-
content: ":";
641-
}
642-
643651

644652
dl.field-list > dd {
645653
padding-left: 0.5em;
@@ -666,6 +674,16 @@ dd {
666674
margin-left: 30px;
667675
}
668676

677+
.sig dd {
678+
margin-top: 0px;
679+
margin-bottom: 0px;
680+
}
681+
682+
.sig dl {
683+
margin-top: 0px;
684+
margin-bottom: 0px;
685+
}
686+
669687
dl > dd:last-child,
670688
dl > dd:last-child > :last-child {
671689
margin-bottom: 0;
@@ -734,6 +752,14 @@ abbr, acronym {
734752
cursor: help;
735753
}
736754

755+
.translated {
756+
background-color: rgba(207, 255, 207, 0.2)
757+
}
758+
759+
.untranslated {
760+
background-color: rgba(255, 207, 207, 0.2)
761+
}
762+
737763
/* -- code displays --------------------------------------------------------- */
738764

739765
pre {

_static/css/theme.css

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

_static/doctools.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
*
55
* Base JavaScript utilities for all Sphinx HTML documentation.
66
*
7-
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
7+
* :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
88
* :license: BSD, see LICENSE for details.
99
*
1010
*/

_static/documentation_options.js

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
1-
var DOCUMENTATION_OPTIONS = {
2-
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
1+
const DOCUMENTATION_OPTIONS = {
32
VERSION: '0.1',
43
LANGUAGE: 'en',
54
COLLAPSE_INDEX: false,

_static/language_data.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
* This script contains the language-specific data used by searchtools.js,
66
* namely the list of stopwords, stemmer, scorer and splitter.
77
*
8-
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
8+
* :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
99
* :license: BSD, see LICENSE for details.
1010
*
1111
*/

_static/pygments.css

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ span.linenos.special { color: #000000; background-color: #ffffc0; padding-left:
1717
.highlight .cs { color: #3D7B7B; font-style: italic } /* Comment.Special */
1818
.highlight .gd { color: #A00000 } /* Generic.Deleted */
1919
.highlight .ge { font-style: italic } /* Generic.Emph */
20+
.highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */
2021
.highlight .gr { color: #E40000 } /* Generic.Error */
2122
.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
2223
.highlight .gi { color: #008400 } /* Generic.Inserted */

_static/searchtools.js

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
*
55
* Sphinx JavaScript utilities for the full-text search.
66
*
7-
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
7+
* :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
88
* :license: BSD, see LICENSE for details.
99
*
1010
*/
@@ -57,12 +57,12 @@ const _removeChildren = (element) => {
5757
const _escapeRegExp = (string) =>
5858
string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string
5959

60-
const _displayItem = (item, searchTerms) => {
60+
const _displayItem = (item, searchTerms, highlightTerms) => {
6161
const docBuilder = DOCUMENTATION_OPTIONS.BUILDER;
62-
const docUrlRoot = DOCUMENTATION_OPTIONS.URL_ROOT;
6362
const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX;
6463
const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX;
6564
const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY;
65+
const contentRoot = document.documentElement.dataset.content_root;
6666

6767
const [docName, title, anchor, descr, score, _filename] = item;
6868

@@ -75,20 +75,24 @@ const _displayItem = (item, searchTerms) => {
7575
if (dirname.match(/\/index\/$/))
7676
dirname = dirname.substring(0, dirname.length - 6);
7777
else if (dirname === "index/") dirname = "";
78-
requestUrl = docUrlRoot + dirname;
78+
requestUrl = contentRoot + dirname;
7979
linkUrl = requestUrl;
8080
} else {
8181
// normal html builders
82-
requestUrl = docUrlRoot + docName + docFileSuffix;
82+
requestUrl = contentRoot + docName + docFileSuffix;
8383
linkUrl = docName + docLinkSuffix;
8484
}
8585
let linkEl = listItem.appendChild(document.createElement("a"));
8686
linkEl.href = linkUrl + anchor;
8787
linkEl.dataset.score = score;
8888
linkEl.innerHTML = title;
89-
if (descr)
89+
if (descr) {
9090
listItem.appendChild(document.createElement("span")).innerHTML =
9191
" (" + descr + ")";
92+
// highlight search terms in the description
93+
if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js
94+
highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted"));
95+
}
9296
else if (showSearchSummary)
9397
fetch(requestUrl)
9498
.then((responseData) => responseData.text())
@@ -97,6 +101,9 @@ const _displayItem = (item, searchTerms) => {
97101
listItem.appendChild(
98102
Search.makeSearchSummary(data, searchTerms)
99103
);
104+
// highlight search terms in the summary
105+
if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js
106+
highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted"));
100107
});
101108
Search.output.appendChild(listItem);
102109
};
@@ -115,14 +122,15 @@ const _finishSearch = (resultCount) => {
115122
const _displayNextItem = (
116123
results,
117124
resultCount,
118-
searchTerms
125+
searchTerms,
126+
highlightTerms,
119127
) => {
120128
// results left, load the summary and display it
121129
// this is intended to be dynamic (don't sub resultsCount)
122130
if (results.length) {
123-
_displayItem(results.pop(), searchTerms);
131+
_displayItem(results.pop(), searchTerms, highlightTerms);
124132
setTimeout(
125-
() => _displayNextItem(results, resultCount, searchTerms),
133+
() => _displayNextItem(results, resultCount, searchTerms, highlightTerms),
126134
5
127135
);
128136
}
@@ -360,7 +368,7 @@ const Search = {
360368
// console.info("search results:", Search.lastresults);
361369

362370
// print the results
363-
_displayNextItem(results, results.length, searchTerms);
371+
_displayNextItem(results, results.length, searchTerms, highlightTerms);
364372
},
365373

366374
/**

_static/sphinx_highlight.js

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,14 +29,19 @@ const _highlight = (node, addItems, text, className) => {
2929
}
3030

3131
span.appendChild(document.createTextNode(val.substr(pos, text.length)));
32+
const rest = document.createTextNode(val.substr(pos + text.length));
3233
parent.insertBefore(
3334
span,
3435
parent.insertBefore(
35-
document.createTextNode(val.substr(pos + text.length)),
36+
rest,
3637
node.nextSibling
3738
)
3839
);
3940
node.nodeValue = val.substr(0, pos);
41+
/* There may be more occurrences of search term in this node. So call this
42+
* function recursively on the remaining fragment.
43+
*/
44+
_highlight(rest, addItems, text, className);
4045

4146
if (isInSVG) {
4247
const rect = document.createElementNS(
@@ -140,5 +145,10 @@ const SphinxHighlight = {
140145
},
141146
};
142147

143-
_ready(SphinxHighlight.highlightSearchWords);
144-
_ready(SphinxHighlight.initEscapeListener);
148+
_ready(() => {
149+
/* Do not call highlightSearchWords() when we are on the search page.
150+
* It will highlight words from the *previous* search query.
151+
*/
152+
if (typeof Search === "undefined") SphinxHighlight.highlightSearchWords();
153+
SphinxHighlight.initEscapeListener();
154+
});

0 commit comments

Comments
 (0)