Merge pull request #6 from cupcakearmy/dependabot/npm_and_yarn/next-14.2.32

Bump next from 14.2.30 to 14.2.32

.github/actions/build/action.yaml

@@ -1,19 +0,0 @@
-name: "Build"
-description: "Install deps and build docs"
-
-runs:
-  using: "composite"
-  steps:
-    - uses: pnpm/action-setup@v2
-      with:
-        version: 7
-    - uses: actions/setup-node@v3
-      with:
-        node-version: 18
-        cache: "pnpm"
-    - name: Install dependencies
-      run: pnpm install --frozen-lockfile
-      shell: bash
-    - name: Build
-      run: pnpm build
-      shell: bash

.github/workflows/preview.yaml

@@ -1,35 +0,0 @@
-name: Docs
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: true
-
-jobs:
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - uses: ./.github/actions/build
-
-      - uses: actions/configure-pages@v3
-      - uses: actions/upload-pages-artifact@v1
-        with:
-          path: "./out"
-      - id: deployment
-        uses: actions/deploy-pages@v1

.nvmrc

@@ -0,0 +1 @@
+v22.13.0

next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/pages/building-your-application/configuring/typescript for more information.

next.config.js

@@ -1,11 +1,13 @@
-const withNextra = require('nextra')({
+import nextra from 'nextra'
+
+const withNextra = nextra({
   theme: 'nextra-theme-docs',
   themeConfig: './theme.config.jsx',
 })
 
-module.exports = {
+export default withNextra({
-  ...withNextra(),
+  output: 'export',
   images: {
     unoptimized: true,
   },
-}
+})

package.json

@@ -1,15 +1,21 @@
 {
   "private": true,
   "license": "MIT",
+  "type": "module",
   "scripts": {
-    "dev": "next dev",
+    "build": "NEXT_TELEMETRY_DISABLED=1 next build",
-    "build": "next build && next export"
+    "dev": "NEXT_TELEMETRY_DISABLED=1 next dev",
+    "start": "pnpm dlx serve out"
   },
   "dependencies": {
-    "next": "^13.2.3",
+    "next": "^14.2.32",
-    "nextra": "^2.2.18",
+    "nextra": "^3.0.15",
-    "nextra-theme-docs": "^2.2.18",
+    "nextra-theme-docs": "^3.0.15",
-    "react": "^18.2.0",
+    "react": "^18.3.1",
-    "react-dom": "^18.2.0"
+    "react-dom": "^18.3.1"
-  }
+  },
+  "devDependencies": {
+    "@types/node": "22.7.7"
+  },
+  "packageManager": "pnpm@9.12.2"
 }

pages/_app.mdx

@@ -1,3 +0,0 @@
-export default function App({ Component, pageProps }) {
-  return <Component {...pageProps} />
-}

pages/_meta.json

@@ -1,5 +0,0 @@
-{
-  "index": "Intro",
-  "cli": "CLI",
-  "dev_ops": "Dev Ops"
-}

pages/_meta.ts

@@ -0,0 +1,8 @@
+export default {
+  index: 'Intro',
+  cli: 'CLI',
+  git: 'Git',
+  dev_ops: 'Dev Ops',
+  latex: 'LaTeX',
+  web_dev: 'Web Development',
+}

pages/admin/windows.md

@@ -0,0 +1,21 @@
+---
+tags:
+  - windows
+  - administration
+---
+
+# Windows
+
+
+## List of tools
+
+- [De-Bloat](https://github.com/Raphire/Win11Debloat)
+- [Microsoft Activation Scripts](https://github.com/massgravel/Microsoft-Activation-Scripts)
+- [Uniget UI](https://github.com/marticliment/UnigetUI)
+
+
+## Utils
+
+### Add local user
+
+`Win + R` then `netplwiz`

pages/cli/delete-empty-directories.md

@@ -0,0 +1,7 @@
+# Delete empty directories
+
+```bash
+find . -type d -empty -delete
+```
+
+This recursively finds and deletes empty directory.

pages/cli/format-drive.md

@@ -0,0 +1,23 @@
+---
+tags:
+  - cli
+  - macos
+  - format
+---
+
+# Format a Drive
+
+## macOS
+
+Some times Disk Utility cannot format a whole drive for some reason.
+
+```
+# Check devices
+diskutil list
+
+# To exfat
+diskutil eraseDisk EXFAT "NAME" GPT /dev/diskN
+
+# To fat32, with mbr
+ diskutil eraseDisk FAT32 "NAME" MBR /dev/diskN
+```

pages/dev_ops/_meta.json

@@ -1,4 +0,0 @@
-{
-  "github-actions": "Github Actions",
-  "hosting": "Hosting"
-}

pages/dev_ops/_meta.ts

@@ -0,0 +1,4 @@
+export default {
+  'github-actions': 'Github Actions',
+  hosting: 'Hosting',
+}

pages/dev_ops/github-actions/publish-docker-images.md

@@ -22,15 +22,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@v2
+        uses: docker/setup-qemu-action@v3
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
         with:
           install: true
 
       - name: Docker Labels
         id: meta
-        uses: docker/metadata-action@v4
+        uses: docker/metadata-action@v5
         with:
           images: |
             foo/bar
@@ -43,19 +43,19 @@ jobs:
             type=semver,pattern={{major}}
 
       - name: Log in to Docker Hub
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_TOKEN }}
       - name: Log in to the Container registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Build and push
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           platforms: linux/amd64,linux/arm64
           push: true

pages/dev_ops/hosting/docker-registry.md

@@ -0,0 +1,14 @@
+---
+tags:
+  - docker registry
+  - hosting
+  - authentication
+---
+
+# Setup you own authenticated Docker Registry
+
+## Resources
+
+- https://earthly.dev/blog/private-docker-registry/
+- https://www.digitalocean.com/community/tutorials/how-to-set-up-a-private-docker-registry-on-ubuntu-20-04
+- https://github.com/docker/get-involved/blob/90c9470fd66c9318fec9c6f0914cb70fa87b9bf9/content/en/docs/CommunityLeaders/EventHandbooks/Docker101/registry/_index.md?plain=1#L203

pages/dev_ops/hosting/imgproxy.md

@@ -0,0 +1,61 @@
+# Imgproxy with caching
+
+A simple docker compose file that enables caching of the transformed [imgproxy](https://github.com/imgproxy/imgproxy) responses powered by nginx.
+
+```yaml
+version: '3.8'
+
+volumes:
+  cache:
+
+services:
+  img:
+    image: darthsim/imgproxy
+    environment:
+      # Required for nginx
+      IMGPROXY_BIND: 0.0.0.0:80
+
+      # Security
+      IMGPROXY_MAX_SRC_RESOLUTION: 100
+      IMGPROXY_ALLOWED_SOURCES: https://images.unsplash.com/,https://images.pexels.com/
+
+      # Transforms
+      IMGPROXY_ENFORCE_WEBP: true
+      IMGPROXY_ENFORCE_AVIF: true
+      IMGPROXY_ONLY_PRESETS: true
+      IMGPROXY_PRESETS: default=resizing_type:fit,250=size:250:250,500=size:500:500,1000=size:1000:1000,1500=size:1500:1500,2000=size:2000:2000
+
+  proxy:
+    image: nginx
+    ports:
+      - 80:80
+    volumes:
+      - ./proxy.conf:/etc/nginx/conf.d/default.conf:ro
+      - cache:/tmp
+```
+
+```
+# proxy.conf
+# Set cache to 30 days, 1GB.
+# Only use the uri as the cache key, as it's the only input for imageproxy.
+proxy_cache_path /tmp levels=1:2 keys_zone=backcache:8m max_size=1g inactive=30d;
+proxy_cache_key "$uri";
+proxy_cache_valid 200 302 30d;
+
+server
+{
+	listen 80;
+	server_name _;
+
+	location /
+	{
+		proxy_pass_request_headers off;
+		proxy_set_header HOST $host;
+		proxy_set_header Accept $http_accept;
+
+		proxy_pass http://img;
+
+		proxy_cache backcache;
+	}
+}
+```

pages/dev_ops/hosting/vpn-transmission.md

@@ -0,0 +1,50 @@
+---
+tags:
+  - docker
+  - vpn
+  - transmission
+  - torrent
+---
+
+# Dockerised Transmission over VPN
+
+This setup allows to have a VPN server running, for downloading all your Linux ISOs over a VPN.
+
+This works by using the amazing gluetun container and giving it a name `container_name:vpn` and referencing that name in all the containers where we want to go through a VPN by setting `network_mode: "container:vpn"`.
+The two containers don't have to be in the same docker-compose file.
+
+All the traffic is then routed thought the VPN container, where also the ports then are set.
+
+Many vpn providers are supported, just look at the gluetun docs.
+
+```yaml
+version: '3.8'
+
+services:
+  vpn:
+    image: qmcgaw/gluetun
+    container_name: vpn
+    restart: unless-stopped
+    cap_add:
+      - NET_ADMIN
+    ports:
+      - 9091:9091
+    environment:
+      - VPN_SERVICE_PROVIDER=nordvpn
+      - SERVER_REGIONS=Switzerland
+      - OPENVPN_USER=
+      - OPENVPN_PASSWORD=
+
+  transmission:
+    image: lscr.io/linuxserver/transmission:latest
+    restart: unless-stopped
+    network_mode: 'container:vpn'
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=Europe/London
+    volumes:
+      - ./data/config:/config
+      - ./data/source:/watch
+      - /media/storage/dl:/downloads
+```

pages/git/clean.md

@@ -0,0 +1,17 @@
+---
+tags:
+  - git
+  - clean
+  - gitignore
+  - delete
+---
+
+# Delete all files mentioned by `.gitignore`
+
+This command is useful if you want to reset a repository to it's checked out state.
+
+```bash
+git clean -Xdf
+```
+
+[Original SO Link](https://unix.stackexchange.com/a/542735)

pages/git/clear-history.md

@@ -0,0 +1,28 @@
+# Clear history
+
+This removes all commits from the past.
+
+```bash
+# Checkout
+git checkout --orphan latest_branch
+
+# Add all the files
+git add -A
+
+# Commit the changes
+git commit -am "commit message"
+
+# Delete the branch
+git branch -D main
+
+# Rename the current branch to main
+git branch -m main
+
+# Finally, force update your repository
+git push -f origin main
+
+# Optionally clear local caches
+git gc --aggressive --prune=all
+```
+
+https://stackoverflow.com/a/26000395

pages/git/remove-from-remote.md

@@ -0,0 +1,11 @@
+# Remove files from repository
+
+How to remove files from the repository, without deleting them locally. [Original SO](https://stackoverflow.com/a/1143800)
+
+```bash
+# File
+git rm --cached file_to_remove.txt
+
+# Dir
+git rm --cached -r directory_to_remove
+```

pages/git/remove-merged-branch.md

@@ -0,0 +1,20 @@
+---
+tags:
+  - git
+  - branch
+  - clean
+  - delete
+---
+
+# Delete all local branches that are already merged.
+
+This command is useful if you have a buch of local branches that you don't need anymore.
+
+```bash
+git branch --merged | grep -v \* | xargs git branch -D
+```
+
+[Original SO Link](https://stackoverflow.com/a/10610669)
+
+
+ 

pages/git/remove-secrets.md

@@ -0,0 +1,9 @@
+# Remove secrets after being pushed
+
+If you accidentally pushed a secret or some file that should not be publicly available in your git repo, there are a few ways. My personal fav is [BFG](https://rtyley.github.io/bfg-repo-cleaner/).
+
+> `--no-blob-protection` also modifies you latest commit, by default that is turned off.
+
+```bash
+bfg -D "*.txt" --no-blob-protection
+```

pages/git/reset-files.md

@@ -0,0 +1,11 @@
+# Reset Files
+
+How to reset files from another branch.
+
+```sh
+# New way
+git restore my/file.md
+
+# Old way
+git checkout origin/HEAD -- my/file.md
+```

pages/git/revert-commit.md

@@ -0,0 +1,16 @@
+# Revert branch to commit
+
+Revert a branch to a certain commit, discarding newer ones.
+
+```bash
+# Specific commit
+git reset --hard a1d6424
+
+# Commits back
+git reset --hard HEAD@{3}
+```
+
+```bash
+# Push
+git push -f
+```

pages/latex.md

@@ -0,0 +1,12 @@
+# LaTeX
+
+This is a collection of different LaTeX snippets for different use-cases.
+
+## Building
+
+I exclusively [Tectonic](https://tectonic-typesetting.github.io/en-US/) as build engine, as it is a modern alternative to the "OGs".
+Most importantly, it supports lazy loading of dependencies, so the install size is tiny (in comparison).
+
+## Pipeline
+
+To build Latex in a GitHub Action, see [here](dev_ops/github-actions/latex)

pages/latex/acronyms.md

@@ -0,0 +1,14 @@
+# Acronyms
+
+```latex
+\usepackage{acro}
+
+\DeclareAcronym{dtn}{
+  short            = DTN ,
+  long             = Delay / Disruption Tollerant Networking ,
+}
+
+\ac{tcp}
+
+\printacronyms
+```

pages/latex/bibliography.md

@@ -0,0 +1,34 @@
+# Bibliography
+
+```latex
+\usepackage[backend=bibtex8, style=ieee]{biblatex}
+\addbibresource{db.bib}
+
+\cite{jedari2018survey}
+
+\medskip
+\printbibliography
+```
+
+```latex
+@article{jedari2018survey,
+  title     = {A survey on human-centric communications in non-cooperative wireless relay networks},
+  author    = {Jedari, Behrouz and Xia, Feng and Ning, Zhaolong},
+  journal   = {IEEE Communications Surveys \& Tutorials},
+  volume    = {20},
+  number    = {2},
+  pages     = {914--944},
+  year      = {2018},
+  publisher = {IEEE}
+}
+```
+
+For the backend `biber` should be the one used if versions compatiblity is not an issue
+
+- [Styles](https://www.overleaf.com/learn/latex/Biblatex_citation_styles#Citation_styles)
+- [Intro](https://www.overleaf.com/learn/latex/Bibliography_management_with_biblatex#Introduction)
+
+### RFC
+
+- [https://datatracker.ietf.org/doc/html/draft-carpenter-rfc-citation-recs-01#section-5.2](https://datatracker.ietf.org/doc/html/draft-carpenter-rfc-citation-recs-01#section-5.2)
+- [https://notesofaprogrammer.blogspot.com/2014/11/bibtex-entries-for-ietf-rfcs-and.html](https://notesofaprogrammer.blogspot.com/2014/11/bibtex-entries-for-ietf-rfcs-and.html)

pages/latex/code.md

@@ -0,0 +1,13 @@
+# Code
+
+```latex
+% Inline
+Version: \verb|1.2.3|
+
+% Block
+\begin{verbatim*}
+Text enclosed inside \texttt{verbatim} environment 
+is printed directly 
+and all \LaTeX{} commands are ignored.
+\end{verbatim*}
+```

pages/latex/footnotes.md

@@ -0,0 +1,11 @@
+# Footnotes
+
+```latex
+% Simple
+Something\footnote{This is a footnote}
+
+% With link
+Kubernetes\footnote{\url{https://kubernetes.io/}}
+```
+
+[https://www.overleaf.com/learn/latex/Footnotes](https://www.overleaf.com/learn/latex/Footnotes#Introduction_to_LaTeX.27s_main_footnote_commands)

pages/latex/images.md

@@ -0,0 +1,19 @@
+# Images
+
+```latex
+\usepackage{graphicx}
+
+% Relative to .tex file
+\graphicspath{ {../images/} }
+
+\begin{figure}[h]
+  \label{fig:cat}
+  \caption{Miaaauu}
+  \centering
+  \includegraphics[width=0.6\textwidth]{cat.png}
+\end{figure}
+
+Some cat here! \ref{fig:cat}
+```
+
+[https://www.overleaf.com/learn/latex/Inserting_Images](https://www.overleaf.com/learn/latex/Inserting_Images)

pages/latex/links.md

@@ -0,0 +1,13 @@
+# Links
+
+```latex
+\usepackage{hyperref}
+
+\href{http://www.overleaf.com}{Something Linky}
+
+\url{http://www.overleaf.com}
+```
+
+Also required for linked TOC.
+
+[https://www.overleaf.com/learn/latex/Hyperlinks#Linking_web_addresses](https://www.overleaf.com/learn/latex/Hyperlinks#Linking_web_addresses)

pages/latex/lists.md

@@ -0,0 +1,17 @@
+# Lists
+
+```latex
+% Items
+\begin{itemize}
+  \item a
+  \item b
+\end{itemize}
+
+% Numbered
+\begin{enumerate}
+  \item One
+  \item Two
+\end{enumerate}
+```
+
+[https://www.overleaf.com/learn/latex/Lists](https://www.overleaf.com/learn/latex/Lists)

pages/latex/tables.md

@@ -0,0 +1,35 @@
+# Tables
+
+```latex
+\begin{tabular}{ l|r }
+  \label{item:dtn-simulators-chosen}
+  Name                       & Language      \\
+  \hline
+  The One \cite{sim-theone}  & \verb|Java|   \\
+  OPS \cite{sim-ops}         & \verb|C++|    \\
+  ns3-dtn-bit \cite{sim-ns3} & \verb|C++|    \\
+  dtnsim \cite{sim-dtnsim}   & \verb|Python| \\
+  DTN \cite{sim-dtn}         & \verb|C#|     \\
+\end{tabular}
+```
+
+```latex
+begin{table}[h!]
+  \centering
+  \begin{tabular}{|c c c c|}
+    \hline
+    Col1 & Col2 & Col2  & Col3 \\
+    \hline\hline
+    1    & 6    & 87837 & 787  \\
+    2    & 7    & 78    & 5415 \\
+    3    & 545  & 778   & 7507 \\
+    4    & 545  & 18744 & 7560 \\
+    5    & 88   & 788   & 6344 \\
+    \hline
+  \end{tabular}
+  \caption{Table to test captions and labels.}
+  \label{table:1}
+\end{table}
+```
+
+[https://www.overleaf.com/learn/latex/Tables#Tables_with_fixed_length](https://www.overleaf.com/learn/latex/Tables#Tables_with_fixed_length)

pages/latex/tu-dresden.md

@@ -0,0 +1,33 @@
+# TU Dresden
+
+```latex
+\documentclass{tudscrartcl}
+
+\iftutex
+  \usepackage{fontspec}
+\else
+  \usepackage[T1]{fontenc}
+\fi
+
+\begin{document}
+
+% Title
+\faculty{Faculty of Computer Science}
+\institute{Institute of Systems Architecture}
+\chair{Chair of Computer Networks}
+\extraheadline{Source: \href{https://github.com/cupcakearmy/master-thesis/}{github.com/cupcakearmy/master-thesis/}}
+\author{Niccolo Borgioli}
+\date{\today}
+\title{Comparison of DTN simulators}
+\maketitle
+
+\tableofcontents
+
+\section{Introduction}
+
+Foo bar
+
+\end{document}
+```
+
+[Docs](https://mirror.foobar.to/CTAN/macros/latex/contrib/tudscr/doc/tudscr.pdf)

pages/web_dev/tailwind_theme.md

@@ -0,0 +1,82 @@
+---
+tags:
+  - tailwind
+  - theme
+  - css variables
+  - dark mode
+---
+
+# Tailwind themes with CSS Variables
+
+There are many tailwind theme plugins, tried few and landed on`tailwindcss-themer`.
+
+## Setup
+
+Two files are required:
+
+1. `pnpm i -D tailwindcss-themer`
+1. `tailwind.config.js`
+1. `app.postcss`
+
+> Technically, we don't need to use CSS variables, but I like to, as I can export them automatically from Figma, or whatever design tool. Without CSS Variables, you could just define the colors in `tailwind.config.js` without touching css files.
+
+```js
+// tailwind.config.js
+
+const themer = require('tailwindcss-themer')
+
+/** @type {import('tailwindcss').Config}*/
+const config = {
+  theme: {
+    // ...
+  },
+
+  plugins: [
+    themer({
+      defaultTheme: {
+        extend: {
+          colors: {
+            primary: 'var(--colors-cyan-500)',
+            secondary: 'var(--colors-yellow-500)',
+            surface: 'var(--colors-gray-100)',
+            text: 'var(--colors-gray-900)',
+          },
+        },
+      },
+      themes: [
+        {
+          name: 'darker',
+          mediaQuery: '@media (prefers-color-scheme: dark)',
+          extend: {
+            colors: {
+              primary: 'var(--colors-cyan-700)',
+              secondary: 'var(--colors-yellow-500)',
+              surface: 'var(--colors-gray-900)',
+              text: 'var(--colors-gray-100)',
+            },
+          },
+        },
+      ],
+    }),
+  ],
+}
+
+module.exports = config
+```
+
+```css
+/* app.postcss */
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+:root {
+  /* colors */
+  --colors-cyan-500: rgb(164, 189, 245);
+  --colors-cyan-700: #0d398c;
+  --colors-gray-100: rgb(255, 255, 255);
+  --colors-gray-900: rgb(1, 1, 1);
+  --colors-yellow-500: rgb(233, 246, 82);
+}
+```

theme.config.jsx

@@ -10,6 +10,9 @@ export default {
   feedback: {
     content: 'Question? An error? Give feedback →',
   },
+  head: (
+    <script defer src="https://spectare.nicco.io//unicorn.js" data-website-id="4aecaa6f-1e68-4a21-960a-8ff5aaa6599a"></script>
+  ),
   footer: {
     text: (
       <span>

tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "noEmit": true,
+    "incremental": true,
+    "module": "esnext",
+    "esModuleInterop": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve"
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}