302 lines
82 KiB
HTML
302 lines
82 KiB
HTML
|
<!doctype html><html class=position-relative itemscope itemtype=https://schema.org/WebPage lang=de data-bs-theme=auto data-palette=blue><head><script src=/assets/init/bundle.min.a63b05c8004831f165aca508cfe52bdc3b3c568ce762c0e22f82b1fe1ed14173.js integrity="sha256-pjsFyABIMfFlrKUIz+Ur3Ds8VoznYsDiL4Kx/h7RQXM=" crossorigin=anonymous></script><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><title>Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis - Natenoms Blog</title>
|
|||
|
|
<link rel=icon href=/favicon_hudc94279ded70d7b83fccc56e43bdd2fa_24074_16x16_resize_catmullrom_3.png sizes=16x16 type=image/png><link rel=icon href=/favicon_hudc94279ded70d7b83fccc56e43bdd2fa_24074_32x32_resize_catmullrom_3.png sizes=32x32 type=image/png><link rel=icon href=/favicon_hudc94279ded70d7b83fccc56e43bdd2fa_24074_150x150_resize_catmullrom_3.png sizes=150x150 type=image/png><link rel=apple-touch-icon href=/favicon_hudc94279ded70d7b83fccc56e43bdd2fa_24074_180x180_resize_catmullrom_3.png sizes=180x180 type=image/png><link rel=icon href=/favicon_hudc94279ded70d7b83fccc56e43bdd2fa_24074_192x192_resize_catmullrom_3.png sizes=192x192 type=image/png><link rel=mask-icon href=/safari-pinned-tab.svg color=#6f42c1><meta name=keywords content="Verkehrswende,Fahrrad,CriticalMass,OpenBikeSensor,SimRa,Mumble,Open Source,Minimalismus,OpenStreetMap,Müllsammeln,Fotografie,Malen,Zeichnen"><meta name=description content="Einer Erläuterung der Schritte, um mein neues Wiki so einzurichten, wie man es in ein paar Tagen online sehen wird."><meta name=twitter:card content="summary_large_image"><meta name=twitter:image content="https://natenom.de/2022/03/umzug-dokuwiki-hugo-3-einrichtung/cover.png"><meta name=twitter:title content="Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis"><meta name=twitter:description content="Einer Erläuterung der Schritte, um mein neues Wiki so einzurichten, wie man es in ein paar Tagen online sehen wird."><meta property="og:title" content="Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis"><meta property="og:description" content="Einer Erläuterung der Schritte, um mein neues Wiki so einzurichten, wie man es in ein paar Tagen online sehen wird."><meta property="og:type" content="article"><meta property="og:url" content="https://natenom.de/2022/03/umzug-dokuwiki-hugo-3-einrichtung/"><meta property="og:image" content="https://natenom.de/2022/03/umzug-dokuwiki-hugo-3-einrichtung/cover.png"><meta property="article:section" content="posts"><meta property="article:published_time" content="2022-03-19T11:10:02+01:00"><meta property="article:modified_time" content="2022-03-19T11:10:02+01:00"><meta itemprop=name content="Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis"><meta itemprop=description content="Einer Erläuterung der Schritte, um mein neues Wiki so einzurichten, wie man es in ein paar Tagen online sehen wird."><meta itemprop=datePublished content="2022-03-19T11:10:02+01:00"><meta itemprop=dateModified content="2022-03-19T11:10:02+01:00"><meta itemprop=wordCount content="1830"><meta itemprop=image content="https://natenom.de/2022/03/umzug-dokuwiki-hugo-3-einrichtung/cover.png"><meta itemprop=keywords content="Natenom,Wiki,DokuWiki,Hugo,Web,Themes,Thema,Docsy,Schriften,"><meta property="og:image:alt" content="Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis"><meta name=twitter:image:alt content="Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis"><link data-precache rel=stylesheet href="/assets/main/bundle.min.b189232e48c49a02f23e6616502e93a36137102626fd47589f55ab6447b15b4d.css" integrity="sha256-sYkjLkjEmgLyPmYWUC6To2E3ECYm/UdYn1WrZEexW00=" crossorigin=anonymous></head><body><header class="mb-4 sticky-top"><nav class="top-app-bar shadow navbar navbar-expand-xxl"><div class=container><a class="navbar-brand d-flex align-items-center flex-grow-1 flex-xxl-grow-0 justify-content-xxl-start ms-2 ms-xxl-0 mx-auto me-xxl-2" href=https://natenom.de/><picture><img class=logo alt=Logo src=https://natenom.de/images/logo.svg loading=lazy>
|
|||
|
|
</picture>Natenoms Blog</a><div class="offcanvas-xxl offcanvas-end flex-grow-1" data-bs-scroll=true tabindex=-1 id=navbarMenus aria-labelledby=navbarMenusLabel><div class="offcanvas-header px-4 pb-0"><div class="offcanvas-title h5" id=navbarMenusLabel>Natenoms Blog</div><button type=button class="btn-close btn-close-white" data-bs-dismiss=offcanvas data-bs-target=#navbarMenus aria-label=Close></button></div><div class="offcanvas-body p-4 pt-0 p-xxl-0"><hr class=d-xxl-none><ul class="navbar-nav flex-row flex-wrap align-items-center me-auto"><li class="nav-item col-6 col-xxl-auto"><a class="nav-link py-2 px-0 px-xxl-2" href=https://natenom.de/><i class="fas fa-home me-1"></i></a></li><li class="nav-item col-6 col-xxl-auto"><a class="nav-link py-2 px-0 px-xxl-2" href=https://natenom.de/ueber/>Über</a></li><li class="nav-item col-6 col-xxl-auto"><a class="nav-link py-2 px-0 px-xxl-2" href=https://wiki.natenom.de/ target=_blank rel="noopener noreferrer">Wiki</a></li><li class="nav-item col-6 col-xxl-auto"><a class="nav-link py-2 px-0 px-xxl-2" href=https://natenom.de/blogroll/>Blogroll</a></li><li class="nav-item col-6 col-xxl-auto"><a class="nav-link py-2 px-0 px-xxl-2" href=https://kagube.de/ target=_blank rel="noopener noreferrer">Blog vom kleinen 🐘</a></li></ul><hr class=d-xxl-none><form class="search-bar ms-auto my-auto" action=/search/ novalidate><div class="input-group align-items-center"><span class="btn btn-search disabled position-absolute left-0 border-0 px-1"><i class="fas fa-fw fa-search fa-lg"></i>
|
|||
|
|
</span><input class="my-1 form-control border-white rounded-5 search-input bg-body" name=q type=search placeholder=Suchen aria-label=Search required>
|
|||
|
|
<span class="search-shortcut position-absolute end-0 top-0 me-2"><kbd class="text-dark bg-white opacity-75 rounded-3 shadow border border-primary py-1 fw-bold">/</kbd></span></div></form><hr class=d-xxl-none><ul class="navbar-nav flex-row flex-wrap align-items-center ms-md-auto"><li class="nav-item py-2 py-xxl-1 col-12 col-xxl-auto"><nav class="social-links nav justify-content-center flex-row"><a class="nav-link social-link col-6 col-xxl-auto p-1" target=_blank href=https://digitalcourage.social/@natenom title=Mastodon rel=me><i class="fa-fw fab fa-mastodon"></i>
|
|||
|
|
<span class="ms-1 d-xxl-none">Mastodon</span>
|
|||
|
|
</a><a class="nav-link social-link col-6 col-xxl-auto p-1" target=_blank href=/index.xml title=RSS rel=me><i class="fas fa-fw fa-rss"></i>
|
|||
|
|
<span class="ms-1 d-xxl-none">RSS</span></a></nav></li><li class="nav-item py-2 py-xxl-1 col-12 col-xxl-auto"><div class="vr d-none d-xxl-flex h-100 mx-xxl-2 text-white"></div><hr class="d-xxl-none my-2"></li><li class="nav-item dropdown col-6 col-xxl-auto"><a class="nav-link px-0 py-2 px-xxl-1" href=# id=fontSizeDropdown role=button data-bs-toggle=dropdown aria-expanded=false><i class="fas fa-fw fa-font"></i>
|
|||
|
|
<span class=d-xxl-none>Schriftgröße</span></a><ul class="font-size-dropdown-menu dropdown-menu dropdown-menu-end" aria-labelledby=fontSizeDropdown><li><button class="font-size-item dropdown-item" data-size=xs>
|
|||
|
|
Extra klein</button></li><li><button class="font-size-item dropdown-item" data-size=sm>
|
|||
|
|
Klein</button></li><li><button class="font-size-item dropdown-item active" data-size=md>
|
|||
|
|
Mittel</button></li><li><button class="font-size-item dropdown-item" data-size=lg>
|
|||
|
|
Groß</button></li><li><button class="font-size-item dropdown-item" data-size=xl>
|
|||
|
|
Extra groß</button></li></ul></li><li class="nav-item dropdown col-6 col-xxl-auto"><a class="nav-link px-0 py-2 px-xxl-1" href=# id=paletteDropdown role=button data-bs-toggle=dropdown aria-expanded=false><i class="fas fa-fw fa-palette"></i>
|
|||
|
|
<span class=d-xxl-none>Palette</span></a><ul class="palette-dropdown-menu dropdown-menu dropdown-menu-end px-2 row g-2" aria-labelledby=paletteDropdown><li class="col-4 my-1"><a role=button id=palette-blue aria-label=Blau class="btn btn-sm w-100 palette text-bg-blue" data-palette=blue></a></li><li class="col-4 my-1"><a role=button id=palette-blue-gray aria-label=Blaugrau class="btn btn-sm w-100 palette text-bg-blue-gray" data-palette=blue-gray></a></li><li class="col-4 my-1"><a role=button id=palette-brown aria-label=Braun class="btn btn-sm w-100 palette text-bg-brown" data-palette=brown></a></li><li class="col-4 my-1"><a role=button id=palette-cyan aria-label=Cyan class="btn btn-sm w-100 palette text-bg-cyan" data-palette=cyan></a></li><li class="col-4 my-1"><a role=button id=palette-green aria-label=Grün class="btn btn-sm w-100 palette text-bg-green" data-palette=green></a></li><li class="col-4 my-1"><a role=button id=palette-indigo aria-label=Indigo class="btn btn-sm w-100 palette text-bg-indigo" data-palette=indigo></a></li><li class="col-4 my-1"><a role=button id=palette-orange aria-label=Orange class="btn btn-sm w-100 palette text-bg-orange" data-palette=orange></a></li><li class="col-4 my-1"><a role=button id=palette-pink aria-label=Rosa class="btn btn-sm w-100 palette text-bg-pink" data-palette=pink></a></li><li class="col-4 my-1"><a role=button id=palette-purple aria-label=Purpur class="btn btn-sm w-100 palette text-bg-purple" data-palette=purple></a></li><li class="col-4 my-1"><a role=button id=palette-red aria-label=Rot class="btn btn-sm w-100 palette text-bg-red" data-palette=red></a></li><li class="col-4 my-1"><a role=button id=palette-teal aria-label=Teal class="btn btn-sm w-100 palette text-bg-teal" data-palette=teal></a></li><li class="col-4 my-1"><a role=button id=palette-yellow aria-label=Gelb class="btn btn-sm w-100 palette text-bg-yellow" data-palette=yellow></a></li></ul></li><li class="nav-item dropdown col-6 col-xxl-auto"><a class="nav-link px-0 py-2 px-xxl-1" href=# id=modeDropdown role=button data-bs-toggle=dropdown aria-expanded=false><i class="mode-icon fas fa-fw fa-adjust" id=modeIcon></i>
|
|||
|
|
<span class=d-xxl-none>Modus</span></a><ul class="mode-dropdown-menu dropdown-menu dropdown-menu-end" aria-labelledby=modeDropdown><li class=mode-item data-color-mode=light data-icon=sun><button class=dropdown-item>
|
|||
|
|
<i class="mode-icon fas fa-fw fa-sun"></i> Hell</button></li><li class=mode-item data-color-mode=dark data-icon=moon><button class=dropdown-item>
|
|||
|
|
<i class="mode-icon fas fa-fw fa-moon"></i> Dunkel</button></li><li class="mode-item active" data-color-mode=auto data-icon=adjust><button class=dropdown-item>
|
|||
|
|
<i class="mode-icon fas fa-fw fa-adjust"></i> Auto</button></li></ul></li></ul></div></div><div class=d-flex><button class="navbar-toggler order-5 border-0" type=button data-bs-toggle=offcanvas data-bs-target=#navbarMenus aria-controls=navbarMenus aria-expanded=false aria-label="Toggle navigation">
|
|||
|
|
<i class="fas fa-ellipsis-h"></i></button></div></div></nav></header><main class=container><div class="row content"><noscript><div class="alert alert-danger" role=alert>Dein Browser unterstützt kein JavaScript.</div></noscript><div class=col-xxl-8><div class=container><nav class="row card component" aria-label=breadcrumb><div class="card-body pb-0"><ol class="hbs-breadcrumb breadcrumb flex-nowrap"><li class="breadcrumb-item text-surface"><a href=/>Blog</a></li><li class="breadcrumb-item text-surface"><a href=/posts/>Posts</a></li><li class="breadcrumb-item active">Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis</li></ol></div></nav><div class="post-panel-wrapper position-relative d-flex justify-content-center"><div class="d-flex flex-row justify-content-center rounded-5 border post-panel position-fixed px-3 py-1 surface shadow-1"><a class="action action-toc d-none d-xxl-block" href=#postTOC role=button title=Inhaltsverzeichnis><i class="fas fa-fw fa-list-alt"></i>
|
|||
|
|
</a><a class="action action-toc d-block d-xxl-none" href=#post-toc-container role=button title=Inhaltsverzeichnis><i class="fas fa-fw fa-list-alt"></i>
|
|||
|
|
</a><a class="action action-post-comments" href=#post-comments role=button aria-label=Comments title=Kommentare><i class="fas fa-fw fa-comments"></i>
|
|||
|
|
</a><a id=sidebarToggler class="action action-sidebar-toggler d-none d-xxl-block" role=button title><i class="fas fa-fw fa-expand-alt" data-fa-transform=rotate-45></i></a></div></div><article class="row card component mb-4 post"><div class=card-header><h1 class="card-title post-title my-2">Umzug von DokuWiki nach Hugo – Teil 3 – Einrichtung des neuen Wikis</h1></div><div class=card-body><div class="post-meta mb-3"><span class="post-date me-1 mb-1" title="Erstellt am 2022-03-19 11:10:02 +0100 CET.">Samstag, 19. März 2022</span><span class="post-reading-time me-1 mb-1">9 Min. Lesezeit</span><a href=/categories/web/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-category">
|
|||
|
|
<i class="fas fa-fw fa-folder me-1"></i>Web</a><a href=/tags/docsy/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Docsy</a><a href=/tags/dokuwiki/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">DokuWiki</a><a href=/tags/hugo/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Hugo</a><a href=/tags/natenom/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Natenom</a><a href=/tags/schriften/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Schriften</a><a href=/tags/thema/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Thema</a><a href=/tags/themes/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Themes</a><a href=/tags/web/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Web</a><a href=/tags/wiki/ class="btn btn-sm btn-secondary mb-1 me-2 py-0 pe-1 post-taxonomy post-taxonomy-sm post-tag">Wiki</a></div><p class="lead mb-3 text-body-emphasis">Einer Erläuterung der Schritte, um mein neues Wiki so einzurichten, wie man es in ein paar Tagen online sehen wird.</p><div id=postTOC class=toc-details><details open><summary>Inhaltsverzeichnis</summary><nav id=TableOfContents><ul><li><a href=#neue-website-mit-hugo-erstellen>Neue Website mit Hugo erstellen</a></li><li><a href=#installation-von-postcss>Installation von PostCSS</a></li><li><a href=#eigenes-css>Eigenes CSS</a></li><li><a href=#shortcodes>Shortcodes</a></li><li><a href=#alte-bilddateien>Alte Bilddateien</a></li><li><a href=#keine-externen-ressourcen>Keine externen Ressourcen</a><ul><li><a href=#javascript-und-css>JavaScript und CSS</a></li><li><a href=#schriften>Schriften</a></li></ul></li><li><a href=#schriften-selbst-hosten>Schriften selbst hosten</a></li><li><a href=#lokale-suche-aktivieren>Lokale Suche aktivieren</a></li><li><a href=#kaskadierung--docsabc-vs-abc>Kaskadierung – “/docs/abc” vs “/abc”</a></li><li><a href=#verzeichnisstruktur>Verzeichnisstruktur</a></li><li><a href=#bilder-zusammen-mit-markdown-dateien>Bilder zusammen mit Markdown-Dateien</a></li><li><a href=#entwurfsmodus-für-ganze-namensräume>Entwurfsmodus für ganze Namensräume</a></li><li><a href=#teilweiser-umzug>Teilweiser Umzug</a></li><li><a href=#about-seite>About-Seite</a></li><li><a href=#impressumdatenschutz>Impressum/Datenschutz</a></li><li><a href=#aus-der-suche-ausschließen>Aus der Suche ausschließen</a></li><li><a href=#liste-aller-tags-aus-der-sidebar-entfernen>Liste aller Tags aus der Sidebar entfernen</a></li><li><a href=#404-fehlerseite>404 Fehlerseite</a></li><li><a href=#interwiki-links>Interwiki-Links</a></li><li><a href=#datenschutz-und-impressum-in-den-footer>Datenschutz und Impressum in den Footer</a></li><li><a href=#icons-links-unten>Icons links unten</a></li><li><a href=#videos-extern-hosten>Videos (extern) hosten</a></li><li><a href=#dauer-fürs-rendern>Dauer fürs Rendern</a></li><li><a href=#ergebnis>Ergebnis</a></li><li><a href=#todo>Todo</a></li></ul></nav></details></div><div class="post-content mb-3" data-bs-spy=scroll data-bs-target=#TableOfContents tabindex=0><div id=post-content-body><p>Ich bin schon seit ein paar Tagen dabei, das neue Wiki einzurichten und die Inhalte umzuziehen und anzupassen. Das neue Wiki ist zwar bereits online, aber bis zur Fertigstellung noch mit einem Passwort geschützt.</p><p>Hier erkläre ich, was ich alles gemacht habe, um mein neues Wiki so einzurichten, wie man es in ein paar Tagen online sehen wird.</p><h2 id=neue-website-mit-hugo-erstellen data-numberify>Neue Website mit Hugo erstellen<a class="anchor ms-1" href=#neue-website-mit-hugo-erstellen></a></h2><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-bash data-lang=bash><span style=display:flex><span>hugo
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span>cd wiki.natenom.com
|
|||
|
|
</span></span><span style=display:flex><span>git init .
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span>cd themes
|
|||
|
|
</span></span><span style=display:flex><span>git submodule add https://github.com/google/docsy.git
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span>cd docsy
|
|||
|
|
</span></span><span style=display:flex><span>git submodule sync <span style=color:#f92672>&&</span> git submodule update --init --recursive
|
|||
|
|
</span></span></code></pre></div><h2 id=installation-von-postcss data-numberify>Installation von PostCSS<a class="anchor ms-1" href=#installation-von-postcss></a></h2><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-bash data-lang=bash><span style=display:flex><span>npm install -D autoprefixer
|
|||
|
|
</span></span><span style=display:flex><span>npm install -D postcss-cli
|
|||
|
|
</span></span><span style=display:flex><span>npm install -D postcss
|
|||
|
|
</span></span></code></pre></div><p><a class=urlextern href=https://www.docsy.dev/docs/getting-started/#install-postcss>Dokumentation</a></p><h2 id=eigenes-css data-numberify>Eigenes CSS<a class="anchor ms-1" href=#eigenes-css></a></h2><p>Eigenes CSS kommt in die Datei <code>assets/scss/_styles_project.scss</code>.</p><p><a class=urlextern href=https://www.docsy.dev/docs/adding-content/lookandfeel/#project-style-files>Dokumentation</a>.</p><h2 id=shortcodes data-numberify>Shortcodes<a class="anchor ms-1" href=#shortcodes></a></h2><p>Ich verwende einige meiner Shortcods aus meinem Blog.</p><p>Das Theme Docsy liefert viele Shortcodes bereits mit, <a class=urlextern href=https://www.docsy.dev/docs/adding-content/shortcodes/>siehe hier</a>.</p><h2 id=alte-bilddateien data-numberify>Alte Bilddateien<a class="anchor ms-1" href=#alte-bilddateien></a></h2><p>Alte Bilddateien habe ich erst einmal nach <code>static/_media/</code> kopiert damit sie noch eine Zeit lang unter der selben URL zu erreichen sind wie bisher auch, wenn auch auf einer neuen Domain, zum Beispiel <code>https://wiki.natenom.de/_media/minimalismus.jpg</code>.</p><h2 id=keine-externen-ressourcen data-numberify>Keine externen Ressourcen<a class="anchor ms-1" href=#keine-externen-ressourcen></a></h2><p>Per Voreinstellung bindet das Theme leider ein paar externe Ressourcen ein. Diese werden in den Dateien <code>theme/docsy/layouts/partials/scripts.html</code> und <code>theme/docsy/layouts/partials/head.html</code> referenziert.</p><h3 id=javascript-und-css data-numberify>JavaScript und CSS<a class="anchor ms-1" href=#javascript-und-css></a></h3><p>Doch man kann die referenzierten Dateien auch herunterladen und selbst in Hugo vorhalten. <sup id=fnref:1><a href=#fn:1 class=footnote-ref role=doc-noteref>1</a></sup></p><p>Dazu kopiert man die eben genannte Datei nach <code>hugo/layouts/partials/</code>. Somit werden unsere eigenen Version verwendet statt der im Theme mitgelieferten.</p><p>Dann erstellt man in <code>hugo/static</code> ein Verzeichnis <code>externals</code> und lädt dorthin alle eingebundenen Dateien herunter und ändert anschließend die URLs der eingebundenen Dateien. Aus <code>https://...</code> wird <code>/externals/...</code>.</p><p>Ursprüngliche Datei <code>scripts.html</code>:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-html data-lang=html><span style=display:flex><span>[…]
|
|||
|
|
</span></span><span style=display:flex><span><<span style=color:#f92672>script</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>defer</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>src</span><span style=color:#f92672>=</span><span style=color:#e6db74>"https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/katex.min.js"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>integrity</span><span style=color:#f92672>=</span><span style=color:#e6db74>"sha512-5ufNcHqOYgilGEHPfuRIQ5B/vDS1M8+UC+DESZ5CwVgGTg+b2Ol/15rYL/GiCWJ/Sx8oVo0FPFok1dPk8U9INQ=="</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>crossorigin</span><span style=color:#f92672>=</span><span style=color:#e6db74>"anonymous"</span>
|
|||
|
|
</span></span><span style=display:flex><span>></<span style=color:#f92672>script</span>>
|
|||
|
|
</span></span><span style=display:flex><span>[…]
|
|||
|
|
</span></span></code></pre></div><p>Veränderte Datei <code>scripts.html</code>:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-html data-lang=html><span style=display:flex><span>[…]
|
|||
|
|
</span></span><span style=display:flex><span><<span style=color:#f92672>script</span> <span style=color:#a6e22e>defer</span> <span style=color:#a6e22e>src</span><span style=color:#f92672>=</span><span style=color:#e6db74>"/externals/katex.min.js"</span> <span style=color:#a6e22e>crossorigin</span><span style=color:#f92672>=</span><span style=color:#e6db74>"anonymous"</span>></<span style=color:#f92672>script</span>>
|
|||
|
|
</span></span><span style=display:flex><span>[…]
|
|||
|
|
</span></span></code></pre></div><p>Das sind die Dateien, die von extern eingebunden werden:</p><ul><li>auto-render.min.js</li><li>bootstrap.min.js</li><li>katex.min.css</li><li>markmap-autoloader</li><li>mermaid.min.js</li><li>mhchem.min.js</li><li>popper.min.js</li></ul><h3 id=schriften data-numberify>Schriften<a class="anchor ms-1" href=#schriften></a></h3><p>Dann werden auch noch Fonts eingebunden in:</p><ul><li><code>docsy/assets/scss/rtl/_main.scss</code><ul><li>Hierfür erstellt man die neue Datei <code>assets/scss/rtl/_main.scss</code> ohne Inhalt. Damit wird die Originaldatei vom Theme überlagert. Auch das habe ich bei OpenBikeSensor gefunden, <a class=urlextern href=https://github.com/openbikesensor/openbikesensor.github.io/commit/57ff2c56784219888b5b22558324fdcf167d6639>siehe hier</a>.</li></ul></li><li><code>docsy/assets/scss/_variables.scss</code>.<ul><li>Hierfür erstellt man die neue Datei <code>assets/scss/_variables_project.scss</code> mit folgendem Inhalt:<div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-scss data-lang=scss><span style=display:flex><span>$td-enable-google-fonts<span style=color:#f92672>:</span> false;</span></span></code></pre></div></li></ul></li></ul><h2 id=schriften-selbst-hosten data-numberify>Schriften selbst hosten<a class="anchor ms-1" href=#schriften-selbst-hosten></a></h2><p>Da mir die im Original-Theme verwendete Schriftart gefällt, binde ich sie lokal ein. Wie das geht, habe ich auf der Projektseite von OpenBikeSensor gefunden, <a class=urlextern href=https://github.com/openbikesensor/openbikesensor.github.io/commit/b917df236d556f0fcbc8d65a99220122e211a869>siehe hier</a>.</p><p>Hier eine <a href=https://wiki.natenom.de/docs/sammelsurium/wordpress/twentyfourteen-theme/>Anleitung, wie man an die Schriftdateien kommt</a>.</p><p>Dazu kommt zusätzlich in die Datei <code>assets/scss/_variables_project.scss</code>:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-scss data-lang=scss><span style=display:flex><span>$font-family-sans-serif<span style=color:#f92672>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>"Open Sans"</span><span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#f92672>-</span>apple-system<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> BlinkMacSystemFont<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>"Segoe UI"</span><span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> Roboto<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>"Helvetica Neue"</span><span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> Arial<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> sans-serif<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>"Apple Color Emoji"</span><span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>"Segoe UI Emoji"</span><span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>"Segoe UI Symbol"</span>;
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#75715e>/* open-sans-300 - latin */</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#66d9ef>@font-face</span> {
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-family</span><span style=color:#f92672>:</span> <span style=color:#e6db74>"Open Sans"</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-style</span><span style=color:#f92672>:</span> normal;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-weight</span><span style=color:#f92672>:</span> <span style=color:#ae81ff>300</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>src</span><span style=color:#f92672>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>local</span>(<span style=color:#e6db74>""</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-300.woff2")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff2"</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#75715e>/* Chrome 26+, Opera 23+, Firefox 39+ </span><span style=color:#75715e>*/</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-300.woff")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff"</span>); <span style=color:#75715e>/* Chrome 6+, Firefox 3.6+, IE 9+, Safari 5.1+ */</span>
|
|||
|
|
</span></span><span style=display:flex><span>}
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#75715e>/* open-sans-500 - latin */</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#66d9ef>@font-face</span> {
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-family</span><span style=color:#f92672>:</span> <span style=color:#e6db74>"Open Sans"</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-style</span><span style=color:#f92672>:</span> normal;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-weight</span><span style=color:#f92672>:</span> <span style=color:#ae81ff>500</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>src</span><span style=color:#f92672>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>local</span>(<span style=color:#e6db74>""</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-500.woff2")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff2"</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#75715e>/* Chrome 26+, Opera 23+, Firefox 39+ </span><span style=color:#75715e>*/</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-500.woff")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff"</span>); <span style=color:#75715e>/* Chrome 6+, Firefox 3.6+, IE 9+, Safari 5.1+ */</span>
|
|||
|
|
</span></span><span style=display:flex><span>}
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#75715e>/* open-sans-regular - latin */</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#66d9ef>@font-face</span> {
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-family</span><span style=color:#f92672>:</span> <span style=color:#e6db74>"Open Sans"</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-style</span><span style=color:#f92672>:</span> normal;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-weight</span><span style=color:#f92672>:</span> <span style=color:#ae81ff>400</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>src</span><span style=color:#f92672>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>local</span>(<span style=color:#e6db74>""</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-regular.woff2")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff2"</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#75715e>/* Chrome 26+, Opera 23+, Firefox 39+ </span><span style=color:#75715e>*/</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-regular.woff")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff"</span>); <span style=color:#75715e>/* Chrome 6+, Firefox 3.6+, IE 9+, Safari 5.1+ */</span>
|
|||
|
|
</span></span><span style=display:flex><span>}
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#75715e>/* open-sans-700 - latin */</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#66d9ef>@font-face</span> {
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-family</span><span style=color:#f92672>:</span> <span style=color:#e6db74>"Open Sans"</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-style</span><span style=color:#f92672>:</span> normal;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>font-weight</span><span style=color:#f92672>:</span> <span style=color:#ae81ff>700</span>;
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>src</span><span style=color:#f92672>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>local</span>(<span style=color:#e6db74>""</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-700.woff2")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff2"</span>)<span style=color:#f92672>,</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#75715e>/* Chrome 26+, Opera 23+, Firefox 39+ </span><span style=color:#75715e>*/</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#e6db74>url("/fonts/open-sans-v27-latin-700.woff")</span> <span style=color:#a6e22e>format</span>(<span style=color:#e6db74>"woff"</span>); <span style=color:#75715e>/* Chrome 6+, Firefox 3.6+, IE 9+, Safari 5.1+ */</span>
|
|||
|
|
</span></span><span style=display:flex><span>}
|
|||
|
|
</span></span></code></pre></div><p>Die acht heruntergeladenen woff- und woff2-Dateien kommen dann nach <code>static/fonts/</code>.</p><ul><li>open-sans-v27-latin-300.woff</li><li>open-sans-v27-latin-300.woff2</li><li>open-sans-v27-latin-500.woff</li><li>open-sans-v27-latin-500.woff2</li><li>open-sans-v27-latin-700.woff</li><li>open-sans-v27-latin-700.woff2</li><li>open-sans-v27-latin-regular.woff</li><li>open-sans-v27-latin-regular.woff2</li></ul><p>Die Dokumentation zu Fonts in Docsy <a class=urlextern href=https://www.docsy.dev/docs/adding-content/lookandfeel/#fonts>gibt es hier</a>.</p><h2 id=lokale-suche-aktivieren data-numberify>Lokale Suche aktivieren<a class="anchor ms-1" href=#lokale-suche-aktivieren></a></h2><p>In die <code>config.toml</code> eintragen:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-toml data-lang=toml><span style=display:flex><span>[<span style=color:#a6e22e>params</span>]
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>offlineSearch</span> = <span style=color:#66d9ef>true</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>algolia_docsearch</span> = <span style=color:#66d9ef>false</span>
|
|||
|
|
</span></span></code></pre></div><p><a class=urlextern href=https://www.docsy.dev/docs/adding-content/navigation/#configure-local-search-with-lunr>Dokumentation</a></p><h2 id=kaskadierung--docsabc-vs-abc data-numberify>Kaskadierung – “/docs/abc” vs “/abc”<a class="anchor ms-1" href=#kaskadierung--docsabc-vs-abc></a></h2><div class="shortcode-notice hinweis"><div class="shortcode-notice-title hinweis">Hinweis</div><div class=notice-content>Ich habe mich später dazu entschieden, keine Kaskadierung zu verwenden, um in Zukunft die Möglichkeit zu haben, einfach auf ein anderes Theme wechseln zu können, ohne viele Anpassungen machen zu müssen. Auch könnte ich in Zukunft, passendes Theme vorausgesetzt, Blog und Wiki zusammenführen. Dazu will ich aber ein Theme nutzen, das von Haus aus sowohl für <code>/blogs/</code> als auch für <code>/docs/</code> gut aussieht.</div></div><p>Per Voreinstellung des Themes sollen alle Dokumentationsinhalt im Unterverzeichnis <code>content/<sprache>/docs/</code> eingefügt werden und <code>/docs/</code> ist dann überall in der URL zu sehen. Man landet auch immer auf einer Startseite, die per Voreinstellung leer ist und muss dann für mein Wiki erst einmal rechts oben auf den Eintrag <code>Wiki</code> klicken. Das liegt daran, dass für das Theme <code>docs</code> nur ein Inhaltstyp von mehreren ist. Daneben gibt es z. B. noch <code>blog</code>.</p><p>Da ich schon hier einen Blog betreibe und neben der Dokumentation keine weiteren Inhaltstypen im Wiki benötige, habe ich das Theme so umgestellt, dass <code>content/<sprache>/docs/</code> nicht benötigt wird. Stattdessen liegen alle Inhalte direkt im Hauptverzeichnis <code>content/<sprache>/</code>.</p><p>Zuerst werden alle Dateien und Verzeichnisse aus <code>content/<sprache>/docs/</code> nach <code>content/<sprache>/</code> verschoben.</p><p>Dann erstellt man die Datei <code>content/<sprache>/_index.md</code> mit folgendem Inhalt: <sup id=fnref:2><a href=#fn:2 class=footnote-ref role=doc-noteref>2</a></sup></p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-toml data-lang=toml><span style=display:flex><span><span style=color:#a6e22e>---</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>title</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"Wiki"</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>linkTitle</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"Wiki"</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>type</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"docs"</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>weight</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#ae81ff>20</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>menu</span><span style=color:#960050;background-color:#1e0010>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>main</span><span style=color:#960050;background-color:#1e0010>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>weight</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#ae81ff>20</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>cascade</span><span style=color:#960050;background-color:#1e0010>:</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>-</span> <span style=color:#a6e22e>_target</span><span style=color:#960050;background-color:#1e0010>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>path</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"/blog/**"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>type</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"blog"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#75715e># set to false to include a blog section in the section nav along with docs</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>toc_root</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#66d9ef>true</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>-</span> <span style=color:#a6e22e>_target</span><span style=color:#960050;background-color:#1e0010>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>path</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"/**"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>kind</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"page"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>type</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"docs"</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>-</span> <span style=color:#a6e22e>_target</span><span style=color:#960050;background-color:#1e0010>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>path</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"/**"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>kind</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"section"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>type</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"docs"</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>-</span> <span style=color:#a6e22e>_target</span><span style=color:#960050;background-color:#1e0010>:</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>path</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"/**"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>kind</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"section"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>type</span><span style=color:#960050;background-color:#1e0010>:</span> <span style=color:#e6db74>"home"</span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>---</span>
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span><span style=color:#a6e22e>Natenoms</span> <span style=color:#a6e22e>neues</span> <span style=color:#a6e22e>Wiki</span>. <span style=color:#a6e22e>Mein</span> <span style=color:#a6e22e>altes</span> <span style=color:#a6e22e>Wiki</span> <span style=color:#a6e22e>unter</span> <span style=color:#a6e22e>https</span><span style=color:#960050;background-color:#1e0010>://</span><span style=color:#a6e22e>wiki</span>.<span style=color:#a6e22e>natenom</span>.<span style=color:#a6e22e>de</span> <span style=color:#a6e22e>wird</span> <span style=color:#a6e22e>weiterhin</span> <span style=color:#a6e22e>bestehen</span> <span style=color:#a6e22e>bleiben</span>. <span style=color:#a6e22e>Jedoch</span> <span style=color:#a6e22e>werde</span> <span style=color:#a6e22e>ich</span> <span style=color:#a6e22e>neue</span> <span style=color:#a6e22e>Inhalte</span> <span style=color:#a6e22e>nur</span> <span style=color:#a6e22e>noch</span> <span style=color:#a6e22e>hier</span> <span style=color:#a6e22e>erstellen</span> <span style=color:#a6e22e>und</span> <span style=color:#a6e22e>die</span> <span style=color:#a6e22e>alten</span> <span style=color:#a6e22e>Inhalte</span> <span style=color:#a6e22e>langsam</span> <span style=color:#a6e22e>nach</span> <span style=color:#a6e22e>hierher</span> <span style=color:#a6e22e>umziehen</span>. <span style=color:#a6e22e>Die</span> <span style=color:#a6e22e>ganz</span> <span style=color:#a6e22e>alten</span> <span style=color:#a6e22e>Sachen</span> <span style=color:#a6e22e>werden</span> <span style=color:#a6e22e>dauerhaft</span> <span style=color:#a6e22e>im</span> <span style=color:#a6e22e>alten</span> <span style=color:#a6e22e>Wiki</span> <span style=color:#a6e22e>verbleiben</span>.
|
|||
|
|
</span></span></code></pre></div><p><a class=urlextern href=https://www.docsy.dev/docs/adding-content/content/#alternative-site-structure>Dokumentation zu cascade auf docsy.dev</a> und auf <a class=urlextern href=https://gohugo.io/content-management/front-matter/#front-matter-cascade>gohugo.io</a>.</p><h2 id=verzeichnisstruktur data-numberify>Verzeichnisstruktur<a class="anchor ms-1" href=#verzeichnisstruktur></a></h2><p>Die von DokuWiki exporierte Verzeichnisstruktur muss noch angepasst werden, damit sie in Hugo richtig angezeigt wird. Hier am Beispiel des Namensraums “Orte”.</p><p>Zuerst die Struktur, wie sie exportiert wurde (und wie sie auch in DokuWiki war):</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-text data-lang=text><span style=display:flex><span>.
|
|||
|
|
</span></span><span style=display:flex><span>├── orte
|
|||
|
|
</span></span><span style=display:flex><span>│ ├── enzkreis.md
|
|||
|
|
</span></span><span style=display:flex><span>│ ├── landkreis_calw.md
|
|||
|
|
</span></span><span style=display:flex><span>│ ├── neuhausen_enzkreis.md
|
|||
|
|
</span></span><span style=display:flex><span>│ └── pforzheim.md
|
|||
|
|
</span></span><span style=display:flex><span>├── orte.md
|
|||
|
|
</span></span></code></pre></div><p>Und die angepasste Struktur:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-text data-lang=text><span style=display:flex><span>.
|
|||
|
|
</span></span><span style=display:flex><span>├── orte
|
|||
|
|
</span></span><span style=display:flex><span>│ ├── enzkreis.md
|
|||
|
|
</span></span><span style=display:flex><span>│ ├── _index.md
|
|||
|
|
</span></span><span style=display:flex><span>│ ├── landkreis_calw.md
|
|||
|
|
</span></span><span style=display:flex><span>│ ├── neuhausen_enzkreis.md
|
|||
|
|
</span></span><span style=display:flex><span>│ └── pforzheim.md
|
|||
|
|
</span></span></code></pre></div><p>Die Änderungen haben meinem Verständnis nach vor allem mit <code>Page Bundles</code> zu tun.</p><p>Während z. B. in DokuWiki der Hauptbereich <code>orte</code> aus dem Verzeichnis <code>orte</code> und einer auf gleicher Ebene liegenden Datei <code>orte.txt</code> besteht, so benötigt Hugo eine Struktur in der Form, dass es ein Verzeichnis <code>orte</code> gibt, in dem die Datei <code>_index.md</code> liegt, die der Datei <code>orte.txt</code> (bzw. <code>orte.md</code> im exportierten Verzeichnis) von DokuWiki entspricht.</p><h2 id=bilder-zusammen-mit-markdown-dateien data-numberify>Bilder zusammen mit Markdown-Dateien<a class="anchor ms-1" href=#bilder-zusammen-mit-markdown-dateien></a></h2><p>In DokuWiki liegen Dateien in <code>dokuwiki/media/</code> und Seiten in <code>dokuwiki/pages/</code>. In Hugo liegen Bilder, Videos, usw. in den selben Verzeichnissen wie auch die Markdown-Dateien. Würden sie in einer eigenen Verzeichnisstruktur liegen, wäre es z. B. nicht möglich, automatisiert kleinere Varianten dieser Bilder zu erstellen. Das hat was mit <code>Page Bundles</code> zu tun.</p><p>Ich glaube ich habe das Konzept von <code>Page Bundles</code> einigermaßen verstanden, so, dass ich es nutzen kann. Erklären kann ich es aber nicht. Bitte selbst die <a class=urlextern href=https://gohugo.io/content-management/page-bundles/>Dokumentation</a> lesen.</p><h2 id=entwurfsmodus-für-ganze-namensräume data-numberify>Entwurfsmodus für ganze Namensräume<a class="anchor ms-1" href=#entwurfsmodus-für-ganze-namensräume></a></h2><p>Fügt man in das Front Matter einer <code>_index.md</code>-Datei das Tag <code>draft</code> mit dem Wert <code>true</code> ein, dann befindet sich der gesamte Namensraum im Entwurfsmodus. D. h. er wird nur gerendert, wenn man hugo mit dem Parameter <code>-D</code> aufruft.</p><p>D. h. ich stelle die Namensräume, die noch nicht fertig sind, auf Entwurf um.</p><p>Man muss allerdings bedenken, dass es eine Fehlermeldung gibt, wenn man den Shortcode <code>ref</code> (<a class=urlextern href=https://gohugo.io/content-management/shortcodes/#ref-and-relref>Dokumentation</a>) verwendet, um auf URL innerhalb der Website zu verlinken, die dann in der gerenderten Website gar nicht existieren wird.</p><p>Eine Liste aller im Entwurfsmodus befindlichen Seiten erhält man z. B. mit grep, wenn man nach <code>draft: …</code> sucht oder noch einfacher mit:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-bash data-lang=bash><span style=display:flex><span>hugo list drafts
|
|||
|
|
</span></span></code></pre></div><p>Das Kommando muss dabei im Basisverzeichnis der Hugo-Website ausgeführt werden.</p><h2 id=teilweiser-umzug data-numberify>Teilweiser Umzug<a class="anchor ms-1" href=#teilweiser-umzug></a></h2><p>Sobald ein Namensraum der Hauptebene fertig ist, stelle ich <code>draft: false</code> ein, lasse die Website rendern und lade das Ergebnis hoch.</p><p>In der Nginx-Konfiguration richte ich dann Weiterleitungen für diesen Namensraum ein. Entweder einen Eintrag für den gesamten Namensraum, wenn sich an dessen URL-Struktur nichts verändert hat oder einzeln je Seite, wenn ich die Struktur verändert habe.</p><h2 id=about-seite data-numberify>About-Seite<a class="anchor ms-1" href=#about-seite></a></h2><p>Wenn es eine Seite mit dem Namen <code>about</code> gibt, so wird diese automatisch unten im Footer aufgelistet.</p><p>Dies kann man in der <code>config.toml</code> abschalten mit:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-toml data-lang=toml><span style=display:flex><span> [<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>ui</span>]
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>footer_about_disable</span> = <span style=color:#66d9ef>true</span>
|
|||
|
|
</span></span></code></pre></div><h2 id=impressumdatenschutz data-numberify>Impressum/Datenschutz<a class="anchor ms-1" href=#impressumdatenschutz></a></h2><p>Ganz wichtig im Land, in dem Kennzeichen schützenswerter sind als Menschen: Man benötigt Links zu Impressum und zu Datenschutz.</p><p>Dazu habe ich das Verzeichnis <code>content/de/ueber/</code> erstellt. Hier landen alle Inhalte, in denen es über mein neues Wiki geht.</p><p>Optional kann man die Seite im Seitenverzeichnis verstecken, in dem man ins Front Matter <code>toc_hide: true</code> einträgt. <sup id=fnref:3><a href=#fn:3 class=footnote-ref role=doc-noteref>3</a></sup></p><h2 id=aus-der-suche-ausschließen data-numberify>Aus der Suche ausschließen<a class="anchor ms-1" href=#aus-der-suche-ausschließen></a></h2><p>Mit dem Eintrag <code>exclude_search: true</code> im <code>Front Matter</code> kann man die Inhalte einzelner Seite von der Indexierung der Suchfunktion ausschließen.</p><p><a class=urlextern href=https://www.docsy.dev/docs/adding-content/navigation/#excluding-pages-from-local-search-results>Dokumentation</a></p><h2 id=liste-aller-tags-aus-der-sidebar-entfernen data-numberify>Liste aller Tags aus der Sidebar entfernen<a class="anchor ms-1" href=#liste-aller-tags-aus-der-sidebar-entfernen></a></h2><p>Mir gefällt es gar nicht, dass im verwendeten Theme rechts immer alle vorhandenen Tags des gesamten Wikis angezeigt werden. Das ist meiner Ansicht nach unnötig und sehr störend, da es in meinem Wiki (noch) hunderte Tags gibt.</p><p>Um das zu entfernen habe ich die Datei <code>hugo/themes/docsy/layouts/partials/taxonomy_terms_clouds.html</code> aus dem Theme-Verzeichnis nach <code>hugo/layouts/partials/</code> kopiert und den Inhalt gelöscht.</p><h2 id=404-fehlerseite data-numberify>404 Fehlerseite<a class="anchor ms-1" href=#404-fehlerseite></a></h2><p>Es wird automatisch eine 404-Fehlerseite erzeugt. Diese kann man z. B. in der Nginx-Konfiguration aktivieren mit:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-nginx data-lang=nginx><span style=display:flex><span><span style=color:#66d9ef>error_page</span> <span style=color:#ae81ff>404</span> <span style=color:#e6db74>/404.html</span>;
|
|||
|
|
</span></span></code></pre></div><h2 id=interwiki-links data-numberify>Interwiki-Links<a class="anchor ms-1" href=#interwiki-links></a></h2><p>Ich kann im neuen Wiki die Interwiki-Links nutzen, die ich gerade erst implementiert habe. <a href=/2022/03/interwiki-links-richtig-implementiert/>Siehe hier</a>.</p><h2 id=datenschutz-und-impressum-in-den-footer data-numberify>Datenschutz und Impressum in den Footer<a class="anchor ms-1" href=#datenschutz-und-impressum-in-den-footer></a></h2><p>Die Datei <code>hugo/themes/docsy/layouts/partials/footer.html</code> nach <code>hugo/layouts/partials/footer.html</code> kopieren und in Zeile unten einfügen:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-html data-lang=html><span style=display:flex><span><<span style=color:#f92672>p</span> <span style=color:#a6e22e>class</span><span style=color:#f92672>=</span><span style=color:#e6db74>"mt-2"</span>>
|
|||
|
|
</span></span><span style=display:flex><span> <<span style=color:#f92672>small</span>>
|
|||
|
|
</span></span><span style=display:flex><span> <<span style=color:#f92672>a</span> <span style=color:#a6e22e>href</span><span style=color:#f92672>=</span><span style=color:#e6db74>"/impressum/"</span>>Impressum</<span style=color:#f92672>a</span>>
|
|||
|
|
</span></span><span style=display:flex><span> <<span style=color:#f92672>a</span> <span style=color:#a6e22e>href</span><span style=color:#f92672>=</span><span style=color:#e6db74>"/docs/ueber/datenschutz/"</span>>Datenschutz</<span style=color:#f92672>a</span>></<span style=color:#f92672>small</span>
|
|||
|
|
</span></span><span style=display:flex><span> >
|
|||
|
|
</span></span><span style=display:flex><span></<span style=color:#f92672>p</span>>
|
|||
|
|
</span></span></code></pre></div><h2 id=icons-links-unten data-numberify>Icons links unten<a class="anchor ms-1" href=#icons-links-unten></a></h2><p>Das Theme bietet die Möglichkeit, dass man links unten (und rechts unten) verschiedene Icons einfügt, die auf verschiedene andere Webseiten wie z. B. auf ein Maston-Profil verlinken.</p><p>In die <code>config.toml</code> eintragen:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-toml data-lang=toml><span style=display:flex><span>[<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>links</span>]
|
|||
|
|
</span></span><span style=display:flex><span>[[<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>links</span>.<span style=color:#a6e22e>user</span>]]
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>name</span> = <span style=color:#e6db74>"Über Natenom"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>url</span> = <span style=color:#e6db74>"/about/"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>icon</span> = <span style=color:#e6db74>"fas fa-user-circle"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>desc</span> = <span style=color:#e6db74>"Über Natenom"</span>
|
|||
|
|
</span></span><span style=display:flex><span>[[<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>links</span>.<span style=color:#a6e22e>user</span>]]
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>name</span> = <span style=color:#e6db74>"Mumble"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>url</span> = <span style=color:#e6db74>"https://wikiarchiv.natenom.de/ueber/natemologie-zentrum"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>icon</span> = <span style=color:#e6db74>"fa fa-mobile"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>desc</span> = <span style=color:#e6db74>"Mumble"</span>
|
|||
|
|
</span></span><span style=display:flex><span>[[<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>links</span>.<span style=color:#a6e22e>user</span>]]
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>name</span> = <span style=color:#e6db74>"E-Mail"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>url</span> = <span style=color:#e6db74>"mailto:user@tld.org"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>icon</span> = <span style=color:#e6db74>"fa fa-envelope"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>desc</span> = <span style=color:#e6db74>"E-Mail"</span>
|
|||
|
|
</span></span><span style=display:flex><span>[[<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>links</span>.<span style=color:#a6e22e>user</span>]]
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>name</span> = <span style=color:#e6db74>"Github"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>url</span> = <span style=color:#e6db74>"https://github.com/natenom"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>icon</span> = <span style=color:#e6db74>"fab fa-github"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>desc</span> = <span style=color:#e6db74>"Github"</span>
|
|||
|
|
</span></span><span style=display:flex><span>[[<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>links</span>.<span style=color:#a6e22e>user</span>]]
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>name</span> = <span style=color:#e6db74>"Twitter"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>url</span> = <span style=color:#e6db74>"https://twitter.com/natenom"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>icon</span> = <span style=color:#e6db74>"fab fa-twitter"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>desc</span> = <span style=color:#e6db74>"Github"</span>
|
|||
|
|
</span></span><span style=display:flex><span>[[<span style=color:#a6e22e>params</span>.<span style=color:#a6e22e>links</span>.<span style=color:#a6e22e>user</span>]]
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>name</span> = <span style=color:#e6db74>"Mastodon"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>url</span> = <span style=color:#e6db74>"https://social.anoxinon.de/users/natenom"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>icon</span> = <span style=color:#e6db74>"fab fa-mastodon"</span>
|
|||
|
|
</span></span><span style=display:flex><span> <span style=color:#a6e22e>desc</span> = <span style=color:#e6db74>"Mastodon"</span>
|
|||
|
|
</span></span></code></pre></div><p>So sieht es aus:</p><p></p><figure class=image-caption><picture><source type=png srcset=/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-screenshot-footer.png><img alt src=/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-screenshot-footer.png title width=652 height=158 loading=lazy></picture><figcaption></figcaption></figure><p></p><p>Damit die Icons rechts landen, nutzt man statt <code>params.links.user</code> die Zeichenkette <code>params.links.developer</code>.</p><h2 id=videos-extern-hosten data-numberify>Videos (extern) hosten<a class="anchor ms-1" href=#videos-extern-hosten></a></h2><p>Im alten Wiki sind einige Videos enthalten. Diese werde ich in Zukunft auf <code>f.natenom.de</code> hosten, damit das Git-Repo des Wikis nicht unnötig groß wird. Außerdem will ich nicht, dass die Videos für immer im Repo verbleiben.</p><h2 id=dauer-fürs-rendern data-numberify>Dauer fürs Rendern<a class="anchor ms-1" href=#dauer-fürs-rendern></a></h2><p>Das neue Wiki braucht aktuell circa 10 Sekunden, um komplett gerendert zu werden:</p><div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-text data-lang=text><span style=display:flex><span> | DE
|
|||
|
|
</span></span><span style=display:flex><span>-------------------+-------
|
|||
|
|
</span></span><span style=display:flex><span>Pages | 1289
|
|||
|
|
</span></span><span style=display:flex><span>Paginator pages | 0
|
|||
|
|
</span></span><span style=display:flex><span>Non-page files | 143
|
|||
|
|
</span></span><span style=display:flex><span>Static files | 105
|
|||
|
|
</span></span><span style=display:flex><span>Processed images | 102
|
|||
|
|
</span></span><span style=display:flex><span>Aliases | 0
|
|||
|
|
</span></span><span style=display:flex><span>Sitemaps | 1
|
|||
|
|
</span></span><span style=display:flex><span>Cleaned | 0
|
|||
|
|
</span></span><span style=display:flex><span>
|
|||
|
|
</span></span><span style=display:flex><span>Built in 9771 ms
|
|||
|
|
</span></span></code></pre></div><h2 id=ergebnis data-numberify>Ergebnis<a class="anchor ms-1" href=#ergebnis></a></h2><p>Und so sieht derzeit mein neues Wiki aus:</p><p></p><figure class=image-caption><a href=/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite.png><picture><source type=image/webp srcset="/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_360x0_resize_q95_h2_catmullrom_3.webp 360w,/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_500x0_resize_q95_h2_catmullrom_3.webp 500w,/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_816x0_resize_q95_h2_catmullrom_3.webp 816w, /2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_1632x0_resize_q95_h2_catmullrom_3.webp 1632w" sizes="(max-width: 424px) 360px, (max-width: 596px) 500px, (min-width: 565px) 816px,(min-width: 1200px) 1632px"><img alt srcset="/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_360x0_resize_q95_h2_catmullrom_3.webp 360w, /2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_500x0_resize_q95_h2_catmullrom_3.webp 500w, /2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_816x0_resize_q95_h2_catmullrom_3.webp 816w,/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_1632x0_resize_q95_h2_catmullrom_3.webp 1632w" sizes="(max-width: 424px) 360px, (max-width: 596px) 500px, (min-width: 565px) 816px,(min-width: 1200px) 1632px" src=/2022/03/umzug-dokuwiki-hugo-3-einrichtung/images/2022-03-19-wiki.natenom.com-startseite_hub1e3fcb9e31b5e99f33583702468adf1_392681_816x0_resize_q95_h2_catmullrom_3.webp title="Mein neues Wiki" loading=lazy width=816 height=425></picture></a><figcaption>Mein neues Wiki</figcaption></figure><p></p><h2 id=todo data-numberify>Todo<a class="anchor ms-1" href=#todo></a></h2><p>Was mir noch fehlt:</p><ul><li>Nummerierung der Überschriften (Inhalt und Inhaltsverzeichnis).</li><li>Favicons einrichten (<a class=urlextern href=https://www.docsy.dev/docs/adding-content/iconsimages/#add-your-favicons>Dokumentation</a>)</li></ul><div class=footnotes role=doc-endnotes><hr><ol><li id=fn:1><p>Es gibt dazu seit 2021 einen offenen Issue, <a class=urlextern href=https://github.com/google/docsy/issues/605>siehe hier</a>. <a href=#fnref:1 class=footnote-backref role=doc-backlink>↩︎</a></p></li><li id=fn:2><p>Das Beispiel habe ich von <a class=urlextern href=https://github.com/gwatts/mostlydocs/blob/main/content/en/_index.md>hier</a>. <a href=#fnref:2 class=footnote-backref role=doc-backlink>↩︎</a></p></li><li id=fn:3><p><a class=urlextern href=https://www.docsy.dev/docs/adding-content/navigation/#section-menu>Dokumentation</a> <a href=#fnref:3 class=footnote-backref role=doc-backlink>↩︎</a></p></li></ol></div></div></div></div><div class=card-footer><div class="post-navs d-flex justify-content-evenly"><div class="post-nav post-prev"><i class="fas fa-fw fa-chevron-down post-prev-icon me-1" data-fa-transform=rotate-90></i>
|
|||
|
|
<a href=/2022/03/interwiki-links-richtig-implementiert/>Interwiki-Links für Hugo richtig implementiert</a></div><div class="post-nav post-next"><a href=/2022/03/umzug-dokuwiki-hugo-4-einrichtung-fertig/>Umzug von DokuWiki nach Hugo – Teil 4 – Einrichten und fertig</a>
|
|||
|
|
<i class="fas fa-fw fa-chevron-down post-next-icon ms-1" data-fa-transform=rotate-270></i></div></div></div></article><section class="related-posts row card component"><div class=card-header><h2 class="card-title fs-4 my-2 text-surface">Ähnliche Beiträge</h2></div><div class=card-body><ul class="post-list list-styled"><li><a href=https://natenom.de/2022/03/umzug-dokuwiki-hugo-1-vorarbeiten/>Umzug von DokuWiki nach Hugo – Teil 1 – Vorarbeiten</a></li><li><a href=https://natenom.de/2022/03/umzug-dokuwiki-hugo-2-pandoc/>Umzug von DokuWiki nach Hugo – Teil 2 – Export mit Pandoc</a></li><li><a href=https://natenom.de/2019/11/neues-design-fuer-meinen-blog/>Neues Design für meinen Blog</a></li><li><a href=https://natenom.de/2022/03/interwiki-links-richtig-implementiert/>Interwiki-Links für Hugo richtig implementiert</a></li><li><a href=https://natenom.de/2022/03/tools-export-dokuwiki-nach-markdown-hugo/>Tools zum Export von DokuWiki nach Markdown (Hugo)</a></li><li><a href=https://natenom.de/2022/02/aenderungen-blog-hoehere-aufloesung-hovereffekt/>Änderungen im Blog – Bessere Auflösung in den Galerien</a></li><li><a href=https://natenom.de/2022/02/bleibt-alles-wie-es-ist-fast/>Es bleibt alles wie es ist – fast</a></li><li><a href=https://natenom.de/2022/02/linkdump-2-2022/>Linkdump 2/2022</a></li><li><a href=https://natenom.de/2020/10/wieder-ein-paar-schoene-neuerungen-fuer-meine-webseiten-dank-vrifox/>Wieder ein paar schöne Neuerungen für meine Webseiten – dank Vrifox</a></li><li><a href=https://natenom.de/2018/11/wir-haben-meine-sogenannte-startseite-www-natenom-com-etwas-ueberarbeitet/>Wir haben meine sogenannte „Startseite“ – www.natenom.com – etwas überarbeitet</a></li></ul></div></section><div class="card component row post-comments" id=post-comments><div class=card-header><h2 class="card-title my-2 fs-4 text-surface">Kommentare</h2></div><div class=card-body><p>Bisher gibt es hier keine Kommentare.</p><p><details class="mastodon-comments email"><summary class="mastodon-comments email-summary">Kommentar oder Anmerkung für diesen Blogbeitrag</summary><div class="mastodon-comments emailcontent"><p>Öffentlicher Kommentar per E-Mail: <a href='mailto:natenom@posteo.de?subject=Kommentar zum Blogbeitrag: Umzug%20von%20DokuWiki%20nach%20Hugo%20%e2%80%93%20Teil%203%20%e2%80%93%20Einrichtung%20des%20neuen%20Wikis&body=Hallo Natenom, %0D%0A%0D%0Azu diesem Blogbeitrag habe ich einen Kommentar:%0D%0A%0D%0AMein Name (optional):%0D%0AMeine Website (optional):%0D%0AIch beziehe mich speziell auf den Kommentar mit der ID:%0D%0A%0D%0AURL zum Blogbeitrag: https%3a%2f%2fnatenom.de%2f2022%2f03%2fumzug-dokuwiki-hugo-3-einrichtung%2f'>Hier klicken</a></p><p>Nicht öffentliche Anmerkung per E-Mail: <a href='mailto:natenom@posteo.de?subject=Persönliche Anmerkung zum Blogbeitrag: Umzug%20von%20DokuWiki%20nach%20Hugo%20%e2%80%93%20Teil%203%20%e2%80%93%20Einrichtung%20des%20neuen%20Wikis&body=Hallo Natenom,%0D%0A%0D%0Azu diesem Blogbeitrag habe ich eine persönliche, nicht zu veröffentlichende Anmerkung:%0D%0A%0D%0AURL zum Blogbeitrag: https%3a%2f%2fnatenom.de%2f2022%2f03%2fumzug-dokuwiki-hugo-3-einrichtung%2f'>Hier klicken</a></p></p><p>Sonstige Kontaktaufnahme: <a href=/natenom/>Kontakt</a></p></div></details></p></div></div></div></div><aside class="col-xxl-4 sidebar d-flex"><div class="container d-flex flex-column"><div class="accordion profile"><div class="accordion-item card row text-center component"><div class="accordion-header card-header border-0" id=profile-header><a class="accordion-button d-lg-none mb-2 shadow-none p-0 bg-transparent text-surface collapsed" role=button data-bs-toggle=collapse href=#profile aria-expanded=false aria-controls=profile>Profil</a></div><div class="card-body collapse accordion-collapse accordion-body d-lg-block" id=profile aria-labelledby=profile-header><div class="col-12 d-flex align-items-center justify-content-center"><picture><img class="profile-avatar rounded-circle" alt=Natenom src=https://natenom.de/images/logo-natenom-circle-150x150.png loading=lazy data-viewer-invisi
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">450</span>
|
|||
|
|
</a><a href=/categories/fotografie/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Fotografie>Fotografie
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">328</span>
|
|||
|
|
</a><a href=/categories/diverses/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Diverses>Diverses
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">242</span>
|
|||
|
|
</a><a href=/categories/web/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Web>Web
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">200</span>
|
|||
|
|
</a><a href=/categories/linux/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Linux>Linux
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">135</span>
|
|||
|
|
</a><a href=/categories/android/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Android>Android
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">68</span>
|
|||
|
|
</a><a href=/categories/linkdump/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Linkdump>Linkdump
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">42</span>
|
|||
|
|
</a><a href=/categories/mumble/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Mumble>Mumble
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">16</span>
|
|||
|
|
</a><a href=/categories/navesima/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=NavesiMa>NavesiMa
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">9</span>
|
|||
|
|
</a><a href=/categories/links/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-category me-2 mb-2" title=Links>Links
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">2</span></a></div></div></section></div><div class="accordion tags-taxonomies"><section class="row card component"><div class=card-header><h2 class="card-title my-2 fs-4 text-surface d-none d-lg-block"><a href=https://natenom.de/tags>Tags</a></h2><a class="accordion-button d-lg-none mb-1 shadow-none p-0 bg-transparent text-surface collapsed" role=button data-bs-toggle=collapse href=#taxonomy-tags aria-expanded=false aria-controls=taxonomy-tags>Tags</a></div><div class="card-body collapse accordion-collapse accordion-body d-lg-block" id=taxonomy-tags><div class=py-2><a href=/tags/fahrrad/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Fahrrad>Fahrrad
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">557</span>
|
|||
|
|
</a><a href=/tags/fotos/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Fotos>Fotos
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">410</span>
|
|||
|
|
</a><a href=/tags/mobilit%C3%A4t/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Mobilität>Mobilität
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">380</span>
|
|||
|
|
</a><a href=/tags/pforzheim/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Pforzheim>Pforzheim
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">263</span>
|
|||
|
|
</a><a href=/tags/open-source/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title="Open Source">Open Source
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">237</span>
|
|||
|
|
</a><a href=/tags/natur/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Natur>Natur
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">208</span>
|
|||
|
|
</a><a href=/tags/linux/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Linux>Linux
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">161</span>
|
|||
|
|
</a><a href=/tags/autos/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Autos>Autos
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">131</span>
|
|||
|
|
</a><a href=/tags/enzkreis/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Enzkreis>Enzkreis
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">115</span>
|
|||
|
|
</a><a href=/tags/statistiken/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Statistiken>Statistiken
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">110</span>
|
|||
|
|
</a><a href=/tags/hardware/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Hardware>Hardware
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">107</span>
|
|||
|
|
</a><a href=/tags/web/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Web>Web
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">107</span>
|
|||
|
|
</a><a href=/tags/android/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Android>Android
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">98</span>
|
|||
|
|
</a><a href=/tags/hugo/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Hugo>Hugo
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">89</span>
|
|||
|
|
</a><a href=/tags/m%C3%BCll/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Müll>Müll
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">89</span>
|
|||
|
|
</a><a href=/tags/sicherheit/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Sicherheit>Sicherheit
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">88</span>
|
|||
|
|
</a><a href=/tags/blog/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Blog>Blog
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">87</span>
|
|||
|
|
</a><a href=/tags/m%C3%BCllsammeln/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Müllsammeln>Müllsammeln
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">86</span>
|
|||
|
|
</a><a href=/tags/politik/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Politik>Politik
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">86</span>
|
|||
|
|
</a><a href=/tags/polizei/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Polizei>Polizei
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">76</span>
|
|||
|
|
</a><a href=/tags/strecke/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Strecke>Strecke
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">75</span>
|
|||
|
|
</a><a href=/tags/abstand/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Abstand>Abstand
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">74</span>
|
|||
|
|
</a><a href=/tags/landschaften/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Landschaften>Landschaften
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">74</span>
|
|||
|
|
</a><a href=/tags/w%C3%A4lder/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Wälder>Wälder
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">68</span>
|
|||
|
|
</a><a href=/tags/wordpress/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=WordPress>WordPress
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">64</span>
|
|||
|
|
</a><a href=/tags/neuhausen/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Neuhausen>Neuhausen
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">60</span>
|
|||
|
|
</a><a href=/tags/apps/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Apps>Apps
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">59</span>
|
|||
|
|
</a><a href=/tags/videos/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Videos>Videos
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">59</span>
|
|||
|
|
</a><a href=/tags/landstra%C3%9Fen/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Landstraßen>Landstraßen
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">54</span>
|
|||
|
|
</a><a href=/tags/makrofotos/ class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=Makrofotos>Makrofotos
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">54</span>
|
|||
|
|
</a><a href=https://natenom.de/tags class="btn btn-sm btn-secondary post-taxonomy ps-3 post-tag me-2 mb-2" title=ALLE>ALLE
|
|||
|
|
<span class="badge badge-sm text-secondary bg-white ms-1">816</span></a></div></div></section></div><div class="accordion archives"><section class="row card component"><div class=card-header><h2 class="card-title my-2 fs-4 text-surface d-none d-lg-block"><a href=/archiv/>Archiv</a></h2><a class="accordion-button d-lg-none mb-1 shadow-none p-0 bg-transparent collapsed" role=button data-bs-toggle=collapse href=#archives aria-expanded=false aria-controls=archives>Archiv</a></div><div class="card-body collapse accordion-collapse accordion-body d-lg-block" id=archives><a href=/archiv/2024/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2024>2024 <span class="badge badge-sm text-secondary bg-white ms-1">23</span>
|
|||
|
|
</a><a href=/archiv/2023/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2023>2023 <span class="badge badge-sm text-secondary bg-white ms-1">147</span>
|
|||
|
|
</a><a href=/archiv/2022/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2022>2022 <span class="badge badge-sm text-secondary bg-white ms-1">188</span>
|
|||
|
|
</a><a href=/archiv/2021/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2021>2021 <span class="badge badge-sm text-secondary bg-white ms-1">111</span>
|
|||
|
|
</a><a href=/archiv/2020/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2020>2020 <span class="badge badge-sm text-secondary bg-white ms-1">193</span>
|
|||
|
|
</a><a href=/archiv/2019/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2019>2019 <span class="badge badge-sm text-secondary bg-white ms-1">118</span>
|
|||
|
|
</a><a href=/archiv/2018/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2018>2018 <span class="badge badge-sm text-secondary bg-white ms-1">143</span>
|
|||
|
|
</a><a href=/archiv/2017/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2017>2017 <span class="badge badge-sm text-secondary bg-white ms-1">163</span>
|
|||
|
|
</a><a href=/archiv/2016/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2016>2016 <span class="badge badge-sm text-secondary bg-white ms-1">108</span>
|
|||
|
|
</a><a href=/archiv/2015/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2015>2015 <span class="badge badge-sm text-secondary bg-white ms-1">85</span>
|
|||
|
|
</a><a href=/archiv/2014/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2014>2014 <span class="badge badge-sm text-secondary bg-white ms-1">85</span>
|
|||
|
|
</a><a href=/archiv/2013/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2013>2013 <span class="badge badge-sm text-secondary bg-white ms-1">56</span>
|
|||
|
|
</a><a href=/archiv/2012/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2012>2012 <span class="badge badge-sm text-secondary bg-white ms-1">43</span>
|
|||
|
|
</a><a href=/archiv/2011/ class="btn btn-sm btn-secondary post-taxonomy ps-3 me-2 mb-2" title=2011>2011 <span class="badge badge-sm text-secondary bg-white ms-1">36</span></a></div></section></div></div></aside></div></main><footer class="footer mt-auto py-3 text-center container"><div class="row text-center"><div class="col-12 mt-2"><p class=mb-2>Natenoms Blog</p><p class="text-secondary mb-2"><small>Mein Blog über verschiedene Themen, die mich über die Zeit beschäftigen. Derzeit sind dies: Verkehrswende, Mobilität, Fahrrad, Minimalismus, Fotografie, Malen, Zeichnen …</small></p><div class="copyright mb-2 text-secondary"><small></small></div><div class="powered-by mb-2 text-secondary"><small>Build with ❤️ from the <a class=text-primary href=https://gohugo.io target=_blank rel="noopener noreferrer">Hugo</a> and the <a class=text-primary href=https://github.com/razonyang/hugo-theme-bootstrap target=_blank rel="noopener noreferrer">HBS</a> theme.</small></div><nav class="social-links nav justify-content-center mb-2 mt-3"><a class="nav-link social-link p-0 me-1 mb-2" target=_blank href=/index.xml title=RSS rel=me><i class="fas fa-fw fa-2x fa-rss" style=color:#ea6221></i></a></nav></div><div class="col-12 col-lg-8 offset-0 offset-lg-1"></div></div><div class=natenom-footer><a href=/ueber/impressum/>Impressum</a> <a href=/ueber/datenschutz/>Datenschutz</a></div></footer><script data-precache src=/assets/main/bundle.min.b0a436c85b86c431bb1c0fdb2ade0445de95435dc453dc7f4f30acad2153b535.js integrity="sha256-sKQ2yFuGxDG7HA/bKt4ERd6VQ13EU9x/TzCsrSFTtTU=" crossorigin=anonymous async></script><script data-precache src=/assets/icons/bundle.min.691458a56c2eef480bec8d31c967801a416b6445459ae901fe213e7870a0dd83.js integrity="sha256-aRRYpWwu70gL7I0xyWeAGkFrZEVFmukB/iE+eHCg3YM=" crossorigin=anonymous defer></script></body></html>
|