Zum Inhalt

Notizen

Recherche - Hinweise - Ideen

wird noch ergänzt…

Notizen

Navigation unterteilt in:

Funktion

Einrichtung

Bedienung

POISuite / Module?

index.md oder nicht? (Wissen, Team)

FAQ Seiten manuell einbinden?

Navigation - Plugin

https://pypi.org/project/mkdocs-awesome-pages-plugin/

https://lukasgeiter.github.io/mkdocs-awesome-nav/

TESTEN:

navigation automatic previews

markdown_extensions:
  - material.extensions.preview:
      configurations:
        - targets:
            include:
              - changelog/index.md
              - customization.md
              - insiders/changelog/*
              - setup/extensions/*

privacy plugin aktivieren

Cookie Consent

Im Copyright Button einbinden

Video Hinweis in css und als div

footer - navigation aktivieren

footer - social media links

Videos

Videos einbinden (iframe 560px)

iframe responsive einbinden - Container?

GDPR mit java script?

iframe - Poster zu groß bei mobil?

youtube shorts einbinden:
im link ändern: shorts zu embed ändern

Vimeo - Screen-Videos ohne Ton ausliefern!!!

Recherche - Test

Link auf Note möglich? NEIN

permalinks aktivieren

Wissen / sortieren? (evtl. Tags nutzen)

Tags in mkdocs? (plugin aktivieren)

Suche testen? https://docs.thermaldrones.de/?q=„Suchwort“

Vermerk: “Änderungen erforderlich” ==[XXXX]== → [XXXX]

mit Suche dazu: https://docs.thermaldrones.de/?q=%5Btext%5D

draft_docs

draft_docs getestet

New in version 1.6

This config defines patterns of files (under docs_dir) to be treated as a draft. Draft files are available during mkdocs serve and include a “DRAFT” mark but will not be included in the build. To prevent this effect and make “serve” behave the same as “build”, you can run mkdocs serve –clean.

Build ohne draft

Example:

mkdocs.yml
draft_docs: |
  drafts/               # A "drafts" directory anywhere.
  _unpublished.md       # A md file ending in _unpublished.md
  !/foo_unpublished.md  # But keep this particular file.

ACHTUNG: draft_docs Beispiel falsch in der Doku - der Kommentar muss auf eine separate Zeile!!!

mkdocs.yml
draft_docs: |
  # A "drafts" directory anywhere.
  drafts/     
  # A md file ending in _unpublished.md         
  _unpublished.md
  # But keep this particular file.       
  !/foo_unpublished.md  # But keep this particular file.

so funktioniert es - Navigation muss aber auch angepasst werden…

mkdocs.yml
draft_docs: |
  # A "team" directory anywhere.
  team/

ToDo Liste:

:material-check-all: icon nutzen bei mehreren Punkten

smile = :wink: → 😉

PDF Dateinamen in kleinbuchstaben ändern

VS Code umbenennen testen!

Hex Colors:

https://gist.github.com/lopspower/03fb1cc0ac9f32ef38f4

social cards tutorial

https://youtu.be/4OjnOc6ftJ8?is=S8cyw_LDQvVuKqCA

FAQ Bereich

html / block???

evtl. nochmal accordion testen - markdown header?

CSS für Accordion testen

CSS für grid cards testen

FAQ in mkdocs - mit ChatGPT

faq-generator erstellen und testen

Muster für gute FAQ:
https://service.luckymoose.de/de/

Plugins

mkdocs-awesome-pages - Plugin

https://pypi.org/project/mkdocs-awesome-pages-plugin/

jetzt Awesome Nav for MkDocs - Plugin

https://lukasgeiter.github.io/mkdocs-awesome-nav/

Mkdocs-Macros - Plugin

https://mkdocs-macros-plugin.readthedocs.io/en/latest/why/

MkDocs GLightbox -Plugin

https://blueswen.github.io/mkdocs-glightbox/

Tag Plugin

https://squidfunk.github.io/mkdocs-material/plugins/tags/

https://squidfunk.github.io/mkdocs-material/setup/setting-up-tags/#setting-up-tags

tags plugin aktivieren

tags testen (todo)

Liste mit tags bei Team als ToDo-Liste einbinden

.htaccess

Passwort Schutz für Teambereich?

.htaccess in /team wird sie beim Build mit erstellt? NEIN

relative Links in mkdoc - Erklärung

https://mkdocs-macros-plugin.readthedocs.io/en/latest/tips/#how-do-i-deal-with-relative-links-to-documentsimages

extra.css

Header etc. auskommentiert - waren im dark modus nicht mehr sichtbar…

muss noch angepasst werden

Logo - Version für Dark Modus???

Infobox ohne Titel als Frage? icon möglich?

evtl. css anpassen - custom box

https://squidfunk.github.io/mkdocs-material/reference/admonitions/

https://github.com/facelessuser/pymdown-extensions/blob/main/docs/src/scss/extensions/_admonition.scss

Icon mit custom color:

https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/#with-colors

(z.B. für POI Icon in orange…) ()

in extra.css 

.youtube {

  color: #EE0F0F; /*(richtige Farbe einsetzen)*/

}


:fontawesome-brands-youtube:{ .youtube }

https://mkdocs-magicspace.alnoda.org/tutorials/markdown/hack-markdown/#

https://github.com/squidfunk/mkdocs-material/discussions/3535

https://github.com/squidfunk/mkdocs-material/discussions/2135

Overriding h1 style on custom light theme #3151

Support for different custom logo for each palette scheme · Issue #6176 · squidfunk/mkdocs-material

Different Logo-Icon for Dark Mode and Light Mode · squidfunk/mkdocs-material · Discussion #2729

Is there a way to support image size adjustment? #1678

You can use the attr_list extension to achieve this.

Syntax:
![](https://example.com/qqq.img){: style="height:150px;width:150px"}

markdown_extensions:
  - attr_list

Bilder noch anpassen

Bilder unterschiedlich groß - Ränder nicht gleichmässig - lassen sich dadurch schlecht ausrichten.

Bilder für POIApp, POICloud, POIConnect und POIStudio anpassen!!!

Schema Grafik - weniger Rand - evtl. Version mit 50% Deckkraft (jetzt mit opacity umgesetzt)

<div style="opacity: 0.5;" markdown="block">
<img src="../assets/images/Entwurf-Schema-POISuite-100.svg#only-light">
</div>

Yes, I believe there are two ways you could go about this:

Use the attr_list extension and add something like {target=”_blank”} to your links (e.g., link text).

Use the privacy plugin’s external link functionality (requires insiders)

convert to webp

alle bilder im ordner zu webp konvertieren:

find . -type f \( -iname '*.png' -o -iname '*.jpg' -o -iname '*.jpeg' \) -exec sh -c 'cwebp -quiet "$1" -o "${1%.*}.webp"' _ {} \;

vorher webp Paket mit homebrew installiert:

brew install webp

script anlegen

script ausführbar machen

#!/bin/sh
find . -type f \( -iname '*.png' -o -iname '*.jpg' -o -iname '*.jpeg' \) -exec sh -c 'cwebp -quiet "$1" -o "${1%.*}.webp"' _ {} \;

Automator

Automator Schnellaktion und Ordneraktion

Ordneraktion für screenshot on desktop angelegt

(screenshot to webp und convert to webpangelegt)

Aktion teilen

in Automator:

Schnellaktion - Bilder in Finder laden - shell script ausführen:

for f in "$@"
do
    filename="${f%.*}"
    /opt/homebrew/bin/cwebp -q 85 "$f" -o "${filename}.webp"
done