Skip to content

Commit 156544d

Browse files
author
Documenter.jl
committed
build based on a3565aa
1 parent bcdfc37 commit 156544d

File tree

13 files changed

+104
-42
lines changed

13 files changed

+104
-42
lines changed

dev/.documenter-siteinfo.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
{"documenter":{"julia_version":"1.12.5","generation_timestamp":"2026-02-16T13:47:41","documenter_version":"1.16.1"}}
1+
{"documenter":{"julia_version":"1.12.5","generation_timestamp":"2026-03-12T22:45:24","documenter_version":"1.17.0"}}

dev/assets/documenter.js

Lines changed: 13 additions & 7 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

dev/assets/warner.js

Lines changed: 61 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,40 @@ function maybeAddWarning() {
3737
closer.addEventListener("click", function () {
3838
document.body.removeChild(div);
3939
});
40-
const href = window.documenterBaseURL + "/../" + window.DOCUMENTER_STABLE;
40+
var target_href =
41+
window.documenterBaseURL + "/../" + window.DOCUMENTER_STABLE;
42+
43+
// try to stay on the same page when linking to the stable version
44+
// get the current page path relative to the version root
45+
var current_page = window.location.pathname;
46+
47+
// resolve the documenterBaseURL to an absolute path
48+
// documenterBaseURL is a relative path (usually "."), so we need to resolve it
49+
var base_url_absolute = new URL(documenterBaseURL, window.location.href)
50+
.pathname;
51+
if (!base_url_absolute.endsWith("/")) {
52+
base_url_absolute = base_url_absolute + "/";
53+
}
54+
55+
// extract the page path after the version directory
56+
// e.g., if we're on /stable/man/guide.html, we want "man/guide.html"
57+
var page_path = "";
58+
if (current_page.startsWith(base_url_absolute)) {
59+
page_path = current_page.substring(base_url_absolute.length);
60+
}
61+
62+
// construct the target URL with the same page path
63+
var target_url = target_href;
64+
if (page_path && page_path !== "" && page_path !== "index.html") {
65+
// ensure target_href ends with a slash before appending page path
66+
if (!target_url.endsWith("/")) {
67+
target_url = target_url + "/";
68+
}
69+
target_url = target_url + page_path;
70+
}
71+
72+
// preserve the anchor (hash) from the current page
73+
var current_hash = window.location.hash;
4174

4275
// Determine if this is a development version or an older release
4376
let warningMessage = "";
@@ -51,12 +84,35 @@ function maybeAddWarning() {
5184
"This documentation is for an <strong>older version</strong> that may be missing recent changes.<br>";
5285
}
5386

54-
warningMessage +=
55-
'<a href="' +
56-
href +
57-
'">Click here to go to the documentation for the latest stable release.</a>';
87+
// Create the link element with same-page navigation
88+
const link = document.createElement("a");
89+
link.href = target_url + current_hash;
90+
link.textContent =
91+
"Click here to go to the documentation for the latest stable release.";
92+
93+
// If we're trying to stay on the same page, verify it exists first
94+
if (page_path && page_path !== "" && page_path !== "index.html") {
95+
link.addEventListener("click", function (e) {
96+
e.preventDefault();
97+
// check if the target page exists, fallback to homepage if it doesn't
98+
fetch(target_url, { method: "HEAD" })
99+
.then(function (response) {
100+
if (response.ok) {
101+
window.location.href = target_url + current_hash;
102+
} else {
103+
// page doesn't exist in the target version, go to homepage
104+
window.location.href = target_href;
105+
}
106+
})
107+
.catch(function (error) {
108+
// network error or other failure - use homepage
109+
window.location.href = target_href;
110+
});
111+
});
112+
}
58113

59114
div.innerHTML = warningMessage;
115+
div.appendChild(link);
60116
div.appendChild(closer);
61117
document.body.appendChild(div);
62118
}

dev/compat/index.html

Lines changed: 2 additions & 2 deletions
Large diffs are not rendered by default.

dev/conversion-to-julia/index.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

dev/conversion-to-python/index.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

dev/faq/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,4 @@
1717

1818
using PythonCall
1919

20-
np = pyimport(&quot;numpy&quot;)</code></pre><h2 id="What-versions-of-Python-and-Julia-do-you-support?"><a class="docs-heading-anchor" href="#What-versions-of-Python-and-Julia-do-you-support?">What versions of Python and Julia do you support?</a><a id="What-versions-of-Python-and-Julia-do-you-support?-1"></a><a class="docs-heading-anchor-permalink" href="#What-versions-of-Python-and-Julia-do-you-support?" title="Permalink"></a></h2><p>Each release of PythonCall and JuliaCall will support and require:</p><ul><li>Any currently supported version of Python, <a href="https://devguide.python.org/versions/">see here</a>. Currently 3.10+.</li><li>The current Julia LTS version and newer, <a href="https://julialang.org/downloads/#long_term_support_release">see here</a>. Currently 1.10+.</li></ul><p>Only the latest patch release within each minor version is supported.</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../compat/">« Compatibility Tools</a><a class="docs-footer-nextpage" href="../releasenotes/">Release Notes »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Monday 16 February 2026 13:47">Monday 16 February 2026</span>. Using Julia version 1.12.5.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
20+
np = pyimport(&quot;numpy&quot;)</code></pre><h2 id="What-versions-of-Python-and-Julia-do-you-support?"><a class="docs-heading-anchor" href="#What-versions-of-Python-and-Julia-do-you-support?">What versions of Python and Julia do you support?</a><a id="What-versions-of-Python-and-Julia-do-you-support?-1"></a><a class="docs-heading-anchor-permalink" href="#What-versions-of-Python-and-Julia-do-you-support?" title="Permalink"></a></h2><p>Each release of PythonCall and JuliaCall will support and require:</p><ul><li>Any currently supported version of Python, <a href="https://devguide.python.org/versions/">see here</a>. Currently 3.10+.</li><li>The current Julia LTS version and newer, <a href="https://julialang.org/downloads/#long_term_support_release">see here</a>. Currently 1.10+.</li></ul><p>Only the latest patch release within each minor version is supported.</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../compat/">« Compatibility Tools</a><a class="docs-footer-nextpage" href="../releasenotes/">Release Notes »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.17.0 on <span class="colophon-date" title="Thursday 12 March 2026 22:45">Thursday 12 March 2026</span>. Using Julia version 1.12.5.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>

dev/index.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

dev/juliacall-reference/index.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

dev/juliacall/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,4 +37,4 @@
3737
state = wait(fs, timeout=0.1)
3838
# if they finished then stop otherwise try again
3939
if not state.not_done:
40-
break</code></pre><p>Set the <code>timeout</code> parameter smaller to let Julia&#39;s scheduler cycle more frequently.</p><p>Future versions of JuliaCall may provide tooling to make this simpler.</p><h3 id="py-multi-threading-signal-handling"><a class="docs-heading-anchor" href="#py-multi-threading-signal-handling">Caveat: Signal handling</a><a id="py-multi-threading-signal-handling-1"></a><a class="docs-heading-anchor-permalink" href="#py-multi-threading-signal-handling" title="Permalink"></a></h3><p>We recommend setting <a href="#julia-config"><code>PYTHON_JULIACALL_HANDLE_SIGNALS=yes</code></a> before importing JuliaCall with multiple threads.</p><p>This is because Julia intentionally causes segmentation faults as part of the GC safepoint mechanism. If unhandled, these segfaults will result in termination of the process. See discussion <a href="https://github.com/JuliaPy/PythonCall.jl/issues/219#issuecomment-1605087024">here</a> for more information.</p><p>Note however that this interferes with Python&#39;s own signal handling, so for example Ctrl-C will not raise <code>KeyboardInterrupt</code>.</p><p>Future versions of JuliaCall may make this the default behaviour when using multiple threads.</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../pythoncall-reference/">« Reference</a><a class="docs-footer-nextpage" href="../juliacall-reference/">Reference »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Monday 16 February 2026 13:47">Monday 16 February 2026</span>. Using Julia version 1.12.5.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
40+
break</code></pre><p>Set the <code>timeout</code> parameter smaller to let Julia&#39;s scheduler cycle more frequently.</p><p>Future versions of JuliaCall may provide tooling to make this simpler.</p><h3 id="py-multi-threading-signal-handling"><a class="docs-heading-anchor" href="#py-multi-threading-signal-handling">Caveat: Signal handling</a><a id="py-multi-threading-signal-handling-1"></a><a class="docs-heading-anchor-permalink" href="#py-multi-threading-signal-handling" title="Permalink"></a></h3><p>We recommend setting <a href="#julia-config"><code>PYTHON_JULIACALL_HANDLE_SIGNALS=yes</code></a> before importing JuliaCall with multiple threads.</p><p>This is because Julia intentionally causes segmentation faults as part of the GC safepoint mechanism. If unhandled, these segfaults will result in termination of the process. See discussion <a href="https://github.com/JuliaPy/PythonCall.jl/issues/219#issuecomment-1605087024">here</a> for more information.</p><p>Note however that this interferes with Python&#39;s own signal handling, so for example Ctrl-C will not raise <code>KeyboardInterrupt</code>.</p><p>Future versions of JuliaCall may make this the default behaviour when using multiple threads.</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../pythoncall-reference/">« Reference</a><a class="docs-footer-nextpage" href="../juliacall-reference/">Reference »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.17.0 on <span class="colophon-date" title="Thursday 12 March 2026 22:45">Thursday 12 March 2026</span>. Using Julia version 1.12.5.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>

0 commit comments

Comments
 (0)