Files
help/navody/immich.html
T

704 lines
32 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
<meta charset="utf-8">
<meta name="generator" content="quarto-1.8.27">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<meta name="author" content="David Spáčil">
<meta name="dcterms.date" content="2026-07-10">
<title>Návod na používání Immich – Nápověda</title>
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
div.columns{display: flex; gap: min(4vw, 1.5em);}
div.column{flex: auto; overflow-x: auto;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
ul.task-list li input[type="checkbox"] {
width: 0.8em;
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
vertical-align: middle;
}
</style>
<script src="../site_libs/quarto-nav/quarto-nav.js"></script>
<script src="../site_libs/quarto-nav/headroom.min.js"></script>
<script src="../site_libs/clipboard/clipboard.min.js"></script>
<script src="../site_libs/quarto-search/autocomplete.umd.js"></script>
<script src="../site_libs/quarto-search/fuse.min.js"></script>
<script src="../site_libs/quarto-search/quarto-search.js"></script>
<meta name="quarto:offset" content="../">
<script src="../site_libs/quarto-html/quarto.js" type="module"></script>
<script src="../site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
<script src="../site_libs/quarto-html/axe/axe-check.js" type="module"></script>
<script src="../site_libs/quarto-html/popper.min.js"></script>
<script src="../site_libs/quarto-html/tippy.umd.min.js"></script>
<script src="../site_libs/quarto-html/anchor.min.js"></script>
<link href="../site_libs/quarto-html/tippy.css" rel="stylesheet">
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-b1010ed3cd212492f61910bf2317df72.css" rel="stylesheet" id="quarto-text-highlighting-styles">
<script src="../site_libs/bootstrap/bootstrap.min.js"></script>
<link href="../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
<link href="../site_libs/bootstrap/bootstrap-a35d343c8bdbcb87d3b82ed68e48a46c.min.css" rel="stylesheet" append-hash="true" id="quarto-bootstrap" data-mode="light">
<script id="quarto-search-options" type="application/json">{
"location": "sidebar",
"copy-button": false,
"collapse-after": 3,
"panel-placement": "start",
"type": "textbox",
"limit": 50,
"keyboard-shortcut": [
"f",
"/",
"s"
],
"show-item-context": false,
"language": {
"search-no-results-text": "No results",
"search-matching-documents-text": "matching documents",
"search-copy-link-title": "Copy link to search",
"search-hide-matches-text": "Hide additional matches",
"search-more-match-text": "more match in this document",
"search-more-matches-text": "more matches in this document",
"search-clear-button-title": "Clear",
"search-text-placeholder": "",
"search-detached-cancel-button-title": "Cancel",
"search-submit-button-title": "Submit",
"search-label": "Search"
}
}</script>
<link rel="stylesheet" href="../styles.css">
</head>
<body class="nav-sidebar docked quarto-light">
<div id="quarto-search-results"></div>
<header id="quarto-header" class="headroom fixed-top">
<nav class="quarto-secondary-nav">
<div class="container-fluid d-flex">
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
<i class="bi bi-layout-text-sidebar-reverse"></i>
</button>
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../navody/immich.html">Návody</a></li><li class="breadcrumb-item"><a href="../navody/immich.html">Návod na používání Immich</a></li></ol></nav>
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
</a>
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
<i class="bi bi-search"></i>
</button>
</div>
</nav>
</header>
<!-- content -->
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article">
<!-- sidebar -->
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
<div class="pt-lg-2 mt-2 text-left sidebar-header">
<div class="sidebar-title mb-0 py-0">
<a href="../">Nápověda</a>
</div>
</div>
<div class="mt-2 flex-shrink-0 align-items-center">
<div class="sidebar-search">
<div id="quarto-search" class="" title="Search"></div>
</div>
</div>
<div class="sidebar-menu-container">
<ul class="list-unstyled mt-1">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="../index.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Home</span></a>
</div>
</li>
<li class="sidebar-item sidebar-item-section">
<div class="sidebar-item-container">
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
<span class="menu-text">Návody</span></a>
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
<i class="bi bi-chevron-right ms-2"></i>
</a>
</div>
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="../navody/immich.html" class="sidebar-item-text sidebar-link active">
<span class="menu-text">Návod na používání Immich</span></a>
</div>
</li>
</ul>
</li>
</ul>
</div>
</nav>
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
<!-- margin-sidebar -->
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar">
<nav id="TOC" role="doc-toc" class="toc-active">
<h2 id="toc-title">On this page</h2>
<ul>
<li><a href="#registrace-přihlášení" id="toc-registrace-přihlášení" class="nav-link active" data-scroll-target="#registrace-přihlášení">Registrace / přihlášení</a></li>
<li><a href="#orientace-v-prostředí" id="toc-orientace-v-prostředí" class="nav-link" data-scroll-target="#orientace-v-prostředí">Orientace v prostředí</a>
<ul class="collapse">
<li><a href="#přidávání-fotek" id="toc-přidávání-fotek" class="nav-link" data-scroll-target="#přidávání-fotek">Přidávání fotek</a></li>
</ul></li>
<li><a href="#sdílení-fotek" id="toc-sdílení-fotek" class="nav-link" data-scroll-target="#sdílení-fotek">Sdílení fotek</a>
<ul class="collapse">
<li><a href="#sdílení-pomocí-odkazu" id="toc-sdílení-pomocí-odkazu" class="nav-link" data-scroll-target="#sdílení-pomocí-odkazu">Sdílení pomocí odkazu</a></li>
<li><a href="#sdílení-uživatelům" id="toc-sdílení-uživatelům" class="nav-link" data-scroll-target="#sdílení-uživatelům">Sdílení uživatelům</a></li>
</ul></li>
</ul>
<div class="toc-actions"><ul><li><a href="https://gitea.spacilovi.eu/david-spacil/help/issues/new" class="toc-action"><i class="bi bi-git"></i>Report an issue</a></li></ul></div></nav>
</div>
<!-- main -->
<main class="content" id="quarto-document-content">
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../navody/immich.html">Návody</a></li><li class="breadcrumb-item"><a href="../navody/immich.html">Návod na používání Immich</a></li></ol></nav>
<div class="quarto-title">
<h1 class="title">Návod na používání Immich</h1>
</div>
<div class="quarto-title-meta">
<div>
<div class="quarto-title-meta-heading">Author</div>
<div class="quarto-title-meta-contents">
<p>David Spáčil </p>
</div>
</div>
<div>
<div class="quarto-title-meta-heading">Published</div>
<div class="quarto-title-meta-contents">
<p class="date">July 10, 2026</p>
</div>
</div>
</div>
</header>
<p>Immich je open-source aplikace na zálohování a správu fotek a videí, kterou si provozujeme na vlastním serveru místo placených služeb jako Google Photos nebo iCloud. Funguje podobně – fotky z telefonu se automaticky zálohují na server, dají se procházet podle data, míst nebo lidí na fotkách, a přístup k nim máte z mobilu i z webového prohlížeče. Výhodou je, že si o svá data staráme sami a nejsme závislí na cizí firmě ani na jejích cenách či omezeních.</p>
<section id="registrace-přihlášení" class="level2">
<h2 class="anchored" data-anchor-id="registrace-přihlášení">Registrace / přihlášení</h2>
<p>Z důvodu zabezpečení není možná registrace bez předchozího založení účtu administrátorem. Ze stejného důvodu je umožněno následné <strong>přihlašování pouze pomocí Google účtu</strong>. Administrátor v případě požadavku založí účet s uživatelským e-mailem spárovaným s Google účtem, poté je možné se do systému přihlásit (viz obrazovku níže).</p>
<p>Adresa Immich instance: <a href="https://immich.spacilovi.eu/">https://immich.spacilovi.eu/</a>.</p>
<div class="quarto-figure quarto-figure-center">
<figure class="figure">
<p><img src="figs/immich-login.png" class="img-fluid figure-img"></p>
<figcaption>Přihlašovací obrazovka Immich</figcaption>
</figure>
</div>
<p>Po prvním přihlášení se objeví prázdná úvodní obrazovka, kterou je ideálně potřeba zaplnit.</p>
<div class="quarto-figure quarto-figure-center">
<figure class="figure">
<p><img src="figs/immich-main-page.png" class="img-fluid figure-img"></p>
<figcaption>Úvodní obrazovka Immich</figcaption>
</figure>
</div>
</section>
<section id="orientace-v-prostředí" class="level2">
<h2 class="anchored" data-anchor-id="orientace-v-prostředí">Orientace v prostředí</h2>
<p><img src="figs/immich-main-tools.png" class="img-float-left img-fluid"></p>
<ul>
<li><code>Fotky</code>, stejně jako třeba ve Fotkách Google, představují hlavní prvek Immich – časovou osu se všemi nahranými fotkami (tedy kromě těch, které jsou archivované nebo v koši).</li>
<li><code>Prozkoumat</code>: po přidání prvních několika fotek se v této záložce objeví identifikovaní lidé, místa a nedávno přidané fotky.</li>
<li><code>Mapa</code>: modul zobrazuje fotografie s prostorovými informacemi na mapě (týká se většiny fotek z mobilu).</li>
<li><code>Lidé</code>: představuje seznam všech na fotkách identifikovaných osob (záložku je potřeba povolit v nastavení).</li>
<li><code>Sdílení</code>: v modulu se ukazuje „partnerské sdílení“ a sdílená alba.</li>
<li><code>Oblíbené</code>: podobně jako <code>Fotky</code> ukazuje časovou osu fotek, ovšem pouze těch, které byly označeny srdíčkem.</li>
<li><code>Alba</code>: zobrazuje vytvořená alba s fotkami seřazená podle data.</li>
<li><code>Nástroje</code>: především nabízí možnosti údržby knihovny a hromadné správy fotek (např. kontrolu duplicit a kontrolu velkých souborů).</li>
<li><code>Archiv</code>: do archivu se ukládají fotografie, u kterých je z nějakého důvodu nežádoucí jejich zobrazování na hlavní časové ose.</li>
<li><code>Uzamčená složka</code>: slouží jako trezor chráněný PIN kódem.</li>
<li><code>Koš</code>: sem putují smazané fotografie. Po 30 dnech dojde k jejich trvalému odstranění.</li>
</ul>
<section id="přidávání-fotek" class="level3">
<h3 class="anchored" data-anchor-id="přidávání-fotek">Přidávání fotek</h3>
<p>Přidání svých fotek do Immich je snadné. Stačí pouze přetáhnout fotky, složky s fotkami nebo kombinaci obojího z okna průzkumníku souborů do okna Immich. Tímto se fotky automaticky nahrají do časové osy a seřadí se podle data pořízení.</p>
<section id="přidávání-fotek-do-alb" class="level4">
<h4 class="anchored" data-anchor-id="přidávání-fotek-do-alb">Přidávání fotek do alb</h4>
<p>Pro workflow typu <em>mám fotky lokálně roztříděné do složek podle data/události</em> se ale více hodí přímý upload do předpřipravených alb.</p>
<ol type="1">
<li>V záložce <code>Alba</code> klepneme na možnost <code>Vytvořit album</code>.</li>
<li>Klepnutím na <code>Přidat název</code> vytvoříme pro album vhodný název, např. <em>Dovolená x</em>.</li>
<li>Přetáhneme fotografie z průzkumníku souborů do okna Immich (do prostoru alba).</li>
</ol>
<div class="quarto-figure quarto-figure-center">
<figure class="figure">
<p><img src="figs/immich-upload.webp" class="img-fluid figure-img"></p>
<figcaption>Nahrávání fotek do alba</figcaption>
</figure>
</div>
</section>
</section>
</section>
<section id="sdílení-fotek" class="level2">
<h2 class="anchored" data-anchor-id="sdílení-fotek">Sdílení fotek</h2>
<p>Fotky lze v Immich sdílet více způsoby. Je možné sdílet jednotlivé fotografie, skupiny fotografií nebo celá alba. Fotky lze sdílet jak s ostatními uživateli Immich, tak i externě pomocí odkazu.</p>
<section id="sdílení-pomocí-odkazu" class="level3">
<h3 class="anchored" data-anchor-id="sdílení-pomocí-odkazu">Sdílení pomocí odkazu</h3>
<p>Sdílení pomocí odkazu je nejjednodušší a nejverzatilnější způsob sdílení. Umožňuje fotky za odkazem chránit heslem nebo třeba nastavit dobu platnosti odkazu.</p>
<p>Postup:</p>
<ol type="1">
<li>Vybereme jednu či více fotek, případně album.</li>
<li>Klikneme na tlačítko <code>Sdílet</code>.
<ol type="a">
<li>V případě přímého výběru fotek se zobrazí přímo dialog sdílení přes odkaz. Stačí nechat výchozí hodnoty a stisknout <code>Vytvořit odkaz</code>.</li>
<li>V případě sdílení alba je potřeba ještě navíc v sekci <code>Sdílené odkazy</code> klepnout na shodně pojmenovaný link <code>Vytvořit odkaz</code>. Pak je postup shodný jako v případě sdílení samostatných fotek.</li>
</ol></li>
</ol>
<div class="quarto-figure quarto-figure-center">
<figure class="figure">
<p><img src="figs/immich-share-link.webp" class="img-fluid figure-img"></p>
<figcaption>Sdílení fotek přes odkaz</figcaption>
</figure>
</div>
</section>
<section id="sdílení-uživatelům" class="level3">
<h3 class="anchored" data-anchor-id="sdílení-uživatelům">Sdílení uživatelům</h3>
<p>Sdílení uživatelům je dostupné pouze pro alba, ne pro samostatné fotografie. Tento způsob sdílení je preferovaný v případě, že sdílíme album osobám, které mají v Immich rovněž založený účet. Album sdílené s ostatními uživateli jim totiž zůstane připnuto v jejich záložce <code>Alba</code>. U uživatele, kterému má být album sdíleno, je možné vybrat jeho roli (<code>Editor</code> má možnost měnit úvodní obrázek alba a přidávat další fotografie, <code>Divák</code> může album pouze procházet). Pozvaným uživatelům přijde upozornění o sdílení jak v aplikaci Immich, tak na uvedený e-mail.</p>
<p>Postup:</p>
<ol type="1">
<li>U alba, které chceme sdílet, klepneme na tři tečky (<em>Zobrazit možnosti alba</em>).</li>
<li>Vybereme možnost <code>Sdílet</code>.</li>
<li>V sekci <code>Lidé</code> klepneme na tlačítko <code>+ Pozvat lidi</code>.</li>
<li>Vybereme klepnutím všechny uživatele, kterým chceme album sdílet, a klepneme na <code>Přidat</code>.</li>
<li>Následně lze u uživatelů v roletce měnit roli.</li>
</ol>
<div class="quarto-figure quarto-figure-center">
<figure class="figure">
<p><img src="figs/immich-share-user.webp" class="img-fluid figure-img"></p>
<figcaption>Sdílení fotek ostatním uživatelům</figcaption>
</figure>
</div>
</section>
</section>
</main> <!-- /main -->
<script id="quarto-html-after-body" type="application/javascript">
window.document.addEventListener("DOMContentLoaded", function (event) {
const icon = "";
const anchorJS = new window.AnchorJS();
anchorJS.options = {
placement: 'right',
icon: icon
};
anchorJS.add('.anchored');
const isCodeAnnotation = (el) => {
for (const clz of el.classList) {
if (clz.startsWith('code-annotation-')) {
return true;
}
}
return false;
}
const onCopySuccess = function(e) {
// button target
const button = e.trigger;
// don't keep focus
button.blur();
// flash "checked"
button.classList.add('code-copy-button-checked');
var currentTitle = button.getAttribute("title");
button.setAttribute("title", "Copied!");
let tooltip;
if (window.bootstrap) {
button.setAttribute("data-bs-toggle", "tooltip");
button.setAttribute("data-bs-placement", "left");
button.setAttribute("data-bs-title", "Copied!");
tooltip = new bootstrap.Tooltip(button,
{ trigger: "manual",
customClass: "code-copy-button-tooltip",
offset: [0, -8]});
tooltip.show();
}
setTimeout(function() {
if (tooltip) {
tooltip.hide();
button.removeAttribute("data-bs-title");
button.removeAttribute("data-bs-toggle");
button.removeAttribute("data-bs-placement");
}
button.setAttribute("title", currentTitle);
button.classList.remove('code-copy-button-checked');
}, 1000);
// clear code selection
e.clearSelection();
}
const getTextToCopy = function(trigger) {
const outerScaffold = trigger.parentElement.cloneNode(true);
const codeEl = outerScaffold.querySelector('code');
for (const childEl of codeEl.children) {
if (isCodeAnnotation(childEl)) {
childEl.remove();
}
}
return codeEl.innerText;
}
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
text: getTextToCopy
});
clipboard.on('success', onCopySuccess);
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
text: getTextToCopy,
container: window.document.getElementById('quarto-embedded-source-code-modal')
});
clipboardModal.on('success', onCopySuccess);
}
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
var mailtoRegex = new RegExp(/^mailto:/);
var filterRegex = new RegExp('/' + window.location.host + '/');
var isInternal = (href) => {
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
}
// Inspect non-navigation links and adorn them if external
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
for (var i=0; i<links.length; i++) {
const link = links[i];
if (!isInternal(link.href)) {
// undo the damage that might have been done by quarto-nav.js in the case of
// links that we want to consider external
if (link.dataset.originalHref !== undefined) {
link.href = link.dataset.originalHref;
}
// target, if specified
link.setAttribute("target", "_blank");
if (link.getAttribute("rel") === null) {
link.setAttribute("rel", "noopener");
}
// default icon
link.classList.add("external");
}
}
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
const config = {
allowHTML: true,
maxWidth: 500,
delay: 100,
arrow: false,
appendTo: function(el) {
return el.parentElement;
},
interactive: true,
interactiveBorder: 10,
theme: 'quarto',
placement: 'bottom-start',
};
if (contentFn) {
config.content = contentFn;
}
if (onTriggerFn) {
config.onTrigger = onTriggerFn;
}
if (onUntriggerFn) {
config.onUntrigger = onUntriggerFn;
}
window.tippy(el, config);
}
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
for (var i=0; i<noterefs.length; i++) {
const ref = noterefs[i];
tippyHover(ref, function() {
// use id or data attribute instead here
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
try { href = new URL(href).hash; } catch {}
const id = href.replace(/^#\/?/, "");
const note = window.document.getElementById(id);
if (note) {
return note.innerHTML;
} else {
return "";
}
});
}
const xrefs = window.document.querySelectorAll('a.quarto-xref');
const processXRef = (id, note) => {
// Strip column container classes
const stripColumnClz = (el) => {
el.classList.remove("page-full", "page-columns");
if (el.children) {
for (const child of el.children) {
stripColumnClz(child);
}
}
}
stripColumnClz(note)
if (id === null || id.startsWith('sec-')) {
// Special case sections, only their first couple elements
const container = document.createElement("div");
if (note.children && note.children.length > 2) {
container.appendChild(note.children[0].cloneNode(true));
for (let i = 1; i < note.children.length; i++) {
const child = note.children[i];
if (child.tagName === "P" && child.innerText === "") {
continue;
} else {
container.appendChild(child.cloneNode(true));
break;
}
}
if (window.Quarto?.typesetMath) {
window.Quarto.typesetMath(container);
}
return container.innerHTML
} else {
if (window.Quarto?.typesetMath) {
window.Quarto.typesetMath(note);
}
return note.innerHTML;
}
} else {
// Remove any anchor links if they are present
const anchorLink = note.querySelector('a.anchorjs-link');
if (anchorLink) {
anchorLink.remove();
}
if (window.Quarto?.typesetMath) {
window.Quarto.typesetMath(note);
}
if (note.classList.contains("callout")) {
return note.outerHTML;
} else {
return note.innerHTML;
}
}
}
for (var i=0; i<xrefs.length; i++) {
const xref = xrefs[i];
tippyHover(xref, undefined, function(instance) {
instance.disable();
let url = xref.getAttribute('href');
let hash = undefined;
if (url.startsWith('#')) {
hash = url;
} else {
try { hash = new URL(url).hash; } catch {}
}
if (hash) {
const id = hash.replace(/^#\/?/, "");
const note = window.document.getElementById(id);
if (note !== null) {
try {
const html = processXRef(id, note.cloneNode(true));
instance.setContent(html);
} finally {
instance.enable();
instance.show();
}
} else {
// See if we can fetch this
fetch(url.split('#')[0])
.then(res => res.text())
.then(html => {
const parser = new DOMParser();
const htmlDoc = parser.parseFromString(html, "text/html");
const note = htmlDoc.getElementById(id);
if (note !== null) {
const html = processXRef(id, note);
instance.setContent(html);
}
}).finally(() => {
instance.enable();
instance.show();
});
}
} else {
// See if we can fetch a full url (with no hash to target)
// This is a special case and we should probably do some content thinning / targeting
fetch(url)
.then(res => res.text())
.then(html => {
const parser = new DOMParser();
const htmlDoc = parser.parseFromString(html, "text/html");
const note = htmlDoc.querySelector('main.content');
if (note !== null) {
// This should only happen for chapter cross references
// (since there is no id in the URL)
// remove the first header
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
note.children[0].remove();
}
const html = processXRef(null, note);
instance.setContent(html);
}
}).finally(() => {
instance.enable();
instance.show();
});
}
}, function(instance) {
});
}
let selectedAnnoteEl;
const selectorForAnnotation = ( cell, annotation) => {
let cellAttr = 'data-code-cell="' + cell + '"';
let lineAttr = 'data-code-annotation="' + annotation + '"';
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
return selector;
}
const selectCodeLines = (annoteEl) => {
const doc = window.document;
const targetCell = annoteEl.getAttribute("data-target-cell");
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
const lineIds = lines.map((line) => {
return targetCell + "-" + line;
})
let top = null;
let height = null;
let parent = null;
if (lineIds.length > 0) {
//compute the position of the single el (top and bottom and make a div)
const el = window.document.getElementById(lineIds[0]);
top = el.offsetTop;
height = el.offsetHeight;
parent = el.parentElement.parentElement;
if (lineIds.length > 1) {
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
height = bottom - top;
}
if (top !== null && height !== null && parent !== null) {
// cook up a div (if necessary) and position it
let div = window.document.getElementById("code-annotation-line-highlight");
if (div === null) {
div = window.document.createElement("div");
div.setAttribute("id", "code-annotation-line-highlight");
div.style.position = 'absolute';
parent.appendChild(div);
}
div.style.top = top - 2 + "px";
div.style.height = height + 4 + "px";
div.style.left = 0;
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
if (gutterDiv === null) {
gutterDiv = window.document.createElement("div");
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
gutterDiv.style.position = 'absolute';
const codeCell = window.document.getElementById(targetCell);
const gutter = codeCell.querySelector('.code-annotation-gutter');
gutter.appendChild(gutterDiv);
}
gutterDiv.style.top = top - 2 + "px";
gutterDiv.style.height = height + 4 + "px";
}
selectedAnnoteEl = annoteEl;
}
};
const unselectCodeLines = () => {
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
elementsIds.forEach((elId) => {
const div = window.document.getElementById(elId);
if (div) {
div.remove();
}
});
selectedAnnoteEl = undefined;
};
// Handle positioning of the toggle
window.addEventListener(
"resize",
throttle(() => {
elRect = undefined;
if (selectedAnnoteEl) {
selectCodeLines(selectedAnnoteEl);
}
}, 10)
);
function throttle(fn, ms) {
let throttle = false;
let timer;
return (...args) => {
if(!throttle) { // first call gets through
fn.apply(this, args);
throttle = true;
} else { // all the others get throttled
if(timer) clearTimeout(timer); // cancel #2
timer = setTimeout(() => {
fn.apply(this, args);
timer = throttle = false;
}, ms);
}
};
}
// Attach click handler to the DT
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
for (const annoteDlNode of annoteDls) {
annoteDlNode.addEventListener('click', (event) => {
const clickedEl = event.target;
if (clickedEl !== selectedAnnoteEl) {
unselectCodeLines();
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
if (activeEl) {
activeEl.classList.remove('code-annotation-active');
}
selectCodeLines(clickedEl);
clickedEl.classList.add('code-annotation-active');
} else {
// Unselect the line
unselectCodeLines();
clickedEl.classList.remove('code-annotation-active');
}
});
}
const findCites = (el) => {
const parentEl = el.parentElement;
if (parentEl) {
const cites = parentEl.dataset.cites;
if (cites) {
return {
el,
cites: cites.split(' ')
};
} else {
return findCites(el.parentElement)
}
} else {
return undefined;
}
};
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
for (var i=0; i<bibliorefs.length; i++) {
const ref = bibliorefs[i];
const citeInfo = findCites(ref);
if (citeInfo) {
tippyHover(citeInfo.el, function() {
var popup = window.document.createElement('div');
citeInfo.cites.forEach(function(cite) {
var citeDiv = window.document.createElement('div');
citeDiv.classList.add('hanging-indent');
citeDiv.classList.add('csl-entry');
var biblioDiv = window.document.getElementById('ref-' + cite);
if (biblioDiv) {
citeDiv.innerHTML = biblioDiv.innerHTML;
}
popup.appendChild(citeDiv);
});
return popup.innerHTML;
});
}
}
});
</script>
</div> <!-- /content -->
<footer class="footer"><div class="nav-footer"><div class="nav-footer-center"><div class="toc-actions d-sm-block d-md-none"><ul><li><a href="https://gitea.spacilovi.eu/david-spacil/help/issues/new" class="toc-action"><i class="bi bi-git"></i>Report an issue</a></li></ul></div></div></div></footer></body></html>