Merge Konflict
Ist jetzt auf stand von main
This commit is contained in:
commit
f026db0b68
21 files changed
+1044
-5601
No files matched your search
@@ -20,43 +20,6 @@ jobs:
|
|||||||
mv PsalmTafel/* . 2>/dev/null || mv psalmtafel/* . 2>/dev/null || mv */* . 2>/dev/null
|
mv PsalmTafel/* . 2>/dev/null || mv psalmtafel/* . 2>/dev/null || mv */* . 2>/dev/null
|
||||||
rm repo.zip
|
rm repo.zip
|
||||||
|
|
||||||
- name: Create tag in Gitea (based on package.json version)
|
|
||||||
run: |
|
|
||||||
apk add --no-cache jq curl
|
|
||||||
|
|
||||||
VERSION=$(jq -r '.version' package.json)
|
|
||||||
TAG="v${VERSION}"
|
|
||||||
echo "Tag: $TAG"
|
|
||||||
|
|
||||||
# Hole commit SHA von main (damit Tag korrekt gesetzt wird)
|
|
||||||
SHA=$(curl -s \
|
|
||||||
-H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
|
|
||||||
"http://172.17.0.1:3000/api/v1/repos/${{ github.repository }}/branches/main" \
|
|
||||||
| jq -r '.commit.id')
|
|
||||||
|
|
||||||
echo "main commit SHA: $SHA"
|
|
||||||
|
|
||||||
# Prüfen, ob Tag existiert
|
|
||||||
HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
|
|
||||||
-H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
|
|
||||||
"http://172.17.0.1:3000/api/v1/repos/${{ github.repository }}/repository/tags/${TAG}")
|
|
||||||
|
|
||||||
if [ "$HTTP_STATUS" -eq 404 ]; then
|
|
||||||
echo "Tag $TAG existiert nicht. Erstelle ihn..."
|
|
||||||
# Gitea: Tag erstellen via /git/refs
|
|
||||||
curl -X POST \
|
|
||||||
-H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d "{
|
|
||||||
\"ref\": \"refs/tags/${TAG}\",
|
|
||||||
\"sha\": \"${SHA}\"
|
|
||||||
}" \
|
|
||||||
"http://172.17.0.1:3000/api/v1/repos/${{ github.repository }}/git/refs"
|
|
||||||
else
|
|
||||||
echo "Tag $TAG existiert bereits. Überspringe Erstellung."
|
|
||||||
fi
|
|
||||||
|
|
||||||
|
|
||||||
- name: Update Docker container
|
- name: Update Docker container
|
||||||
run: |
|
run: |
|
||||||
echo "Building new Next.js Docker image..."
|
echo "Building new Next.js Docker image..."
|
||||||
@@ -79,20 +42,26 @@ jobs:
|
|||||||
VERSION=$(jq -r '.version' package.json)
|
VERSION=$(jq -r '.version' package.json)
|
||||||
echo "Current version: v$VERSION"
|
echo "Current version: v$VERSION"
|
||||||
|
|
||||||
if [[ "$VERSION" == 0.* ]]; then
|
# Shell-kompatible Prüfung (funktioniert zuverlässig in Alpine/sh)
|
||||||
IS_PRERELEASE=true
|
case "$VERSION" in
|
||||||
echo "Version startet mit 0. -> Markiere als Prerelease."
|
0.*)
|
||||||
else
|
IS_PRERELEASE="true"
|
||||||
IS_PRERELEASE=false
|
echo "Version starts with 0. Setting prerelease to true."
|
||||||
echo "Version startet nicht mit 0. -> Normales Release."
|
;;
|
||||||
fi
|
*)
|
||||||
|
IS_PRERELEASE="false"
|
||||||
|
echo "Setting prerelease to false."
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# Prüfen, ob das Release bereits existiert
|
||||||
HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
|
HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
|
||||||
-H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
|
-H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
|
||||||
"http://172.17.0.1:3000/api/v1/repos/${{ github.repository }}/releases/tags/v$VERSION")
|
"http://172.17.0.1:3000/api/v1/repos/${{ github.repository }}/releases/tags/v$VERSION")
|
||||||
|
|
||||||
if [ "$HTTP_STATUS" -eq 404 ]; then
|
if [ "$HTTP_STATUS" -eq 404 ]; then
|
||||||
echo "Creating new release v$VERSION..."
|
echo "Creating new release v$VERSION..."
|
||||||
|
# Gitea erstellt bei diesem Call automatisch auch den Tag v$VERSION auf 'main'
|
||||||
curl -X POST \
|
curl -X POST \
|
||||||
-H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
|
-H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
|
||||||
-H "Content-Type: application/json" \
|
-H "Content-Type: application/json" \
|
||||||
|
|||||||
@@ -24,7 +24,7 @@ PsalmTafel is a real-time display system designed for choirs. It enables the cho
|
|||||||
|
|
||||||
For detailed installation guides and deployment instructions, please visit our Wiki:
|
For detailed installation guides and deployment instructions, please visit our Wiki:
|
||||||
|
|
||||||
* [PsalmTafel Wiki – Installation Guide](https://git.schamagusa.de/Schanbro/PsalmTafel/wiki/Installation)
|
* [PsalmTafel Wiki – Installation Guide](https://psalmtafel.gem.schamagusa.de/wiki/installation)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,3 +1,5 @@
|
|||||||
|
// @wikiCategory: Liederbücher
|
||||||
|
|
||||||
import { NextResponse } from "next/server";
|
import { NextResponse } from "next/server";
|
||||||
import { getSongBooks, searchSongBooksByTitle, createSongBook } from "@/lib/db/songbook";
|
import { getSongBooks, searchSongBooksByTitle, createSongBook } from "@/lib/db/songbook";
|
||||||
|
|
||||||
@@ -13,6 +15,8 @@ import { getSongBooks, searchSongBooksByTitle, createSongBook } from "@/lib/db/s
|
|||||||
* description: List of songbooks
|
* description: List of songbooks
|
||||||
* 500:
|
* 500:
|
||||||
* description: Internal Server Error
|
* description: Internal Server Error
|
||||||
|
*
|
||||||
|
* @wikiDescription: Liste aller Liederbücher abrufen
|
||||||
*/
|
*/
|
||||||
export async function GET(request: Request) {
|
export async function GET(request: Request) {
|
||||||
try {
|
try {
|
||||||
@@ -100,6 +104,8 @@ export async function GET(request: Request) {
|
|||||||
* description: Conflict (title already exists)
|
* description: Conflict (title already exists)
|
||||||
* 500:
|
* 500:
|
||||||
* description: Internal Server Error
|
* description: Internal Server Error
|
||||||
|
*
|
||||||
|
* @wikiDescription: Neues Liederbuch erstellen
|
||||||
*/
|
*/
|
||||||
export async function POST(request: Request) {
|
export async function POST(request: Request) {
|
||||||
try {
|
try {
|
||||||
|
|||||||
@@ -1,7 +1,10 @@
|
|||||||
|
// @wikiCategory: Lieder
|
||||||
|
|
||||||
import { NextResponse } from "next/server";
|
import { NextResponse } from "next/server";
|
||||||
import { getSongs, searchSongsByTitle, createSong, } from "@/lib/db/song";
|
import { getSongs, searchSongsByTitle, createSong, } from "@/lib/db/song";
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @openapi
|
* @openapi
|
||||||
* /api/songs:
|
* /api/songs:
|
||||||
|
|||||||
@@ -1,3 +1,5 @@
|
|||||||
|
// @wikiCategory: Stream
|
||||||
|
|
||||||
import { NextResponse } from "next/server";
|
import { NextResponse } from "next/server";
|
||||||
import { getSong } from "@/lib/db/managing";
|
import { getSong } from "@/lib/db/managing";
|
||||||
|
|
||||||
@@ -8,10 +10,12 @@ let currentSong = {
|
|||||||
title: ""
|
title: ""
|
||||||
};
|
};
|
||||||
|
|
||||||
|
// @wikiDescription: Akutell gestreamtes Lied abrufen
|
||||||
export async function GET() {
|
export async function GET() {
|
||||||
return NextResponse.json(currentSong)
|
return NextResponse.json(currentSong)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// @wikiDescription: Lied zum Streamen festlegen
|
||||||
export async function POST(request: Request) {
|
export async function POST(request: Request) {
|
||||||
try {
|
try {
|
||||||
const data = await request.json();
|
const data = await request.json();
|
||||||
|
|||||||
+127
@@ -29,3 +29,130 @@ section {
|
|||||||
margin-bottom: 50px;
|
margin-bottom: 50px;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
h1 {
|
||||||
|
font-size: 2rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Shiki Code-Blöcke stylen */
|
||||||
|
pre {
|
||||||
|
padding: 1rem;
|
||||||
|
border-radius: 0.75rem;
|
||||||
|
border: 1px solid #27272a; /* Tailwind zinc-800 */
|
||||||
|
overflow-x: auto;
|
||||||
|
font-size: 0.875rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
pre code {
|
||||||
|
background-color: transparent !important;
|
||||||
|
padding: 0 !important;
|
||||||
|
border: none !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Shiki / Rehype Pretty Code Block Container */
|
||||||
|
figure[data-rehype-pretty-code-figure] {
|
||||||
|
margin-top: 1.5rem;
|
||||||
|
margin-bottom: 1.5rem;
|
||||||
|
border-radius: 0.75rem;
|
||||||
|
overflow: hidden;
|
||||||
|
border: 1px solid #27272a; /* Tailwind zinc-800 */
|
||||||
|
background-color: #0d1117; /* Dunkler VS-Code Hintergrund */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Der Titel/Dateiname (falls im MDX angegeben) */
|
||||||
|
div[data-rehype-pretty-code-title] {
|
||||||
|
background-color: #161b22;
|
||||||
|
border-bottom: 1px solid #27272a;
|
||||||
|
padding: 0.5rem 1rem;
|
||||||
|
font-family: monospace;
|
||||||
|
font-size: 0.75rem;
|
||||||
|
color: #8b949e;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Der eigentliche Code-Bereich */
|
||||||
|
figure[data-rehype-pretty-code-figure] pre {
|
||||||
|
margin: 0 !important;
|
||||||
|
padding: 1rem !important;
|
||||||
|
background-color: transparent !important;
|
||||||
|
overflow-x: auto;
|
||||||
|
font-size: 0.875rem;
|
||||||
|
line-height: 1.7;
|
||||||
|
}
|
||||||
|
|
||||||
|
figure[data-rehype-pretty-code-figure] code {
|
||||||
|
font-family: var(--font-mono, monospace);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Container für den Code-Block */
|
||||||
|
/* Container für den Code-Block */
|
||||||
|
figure[data-rehype-pretty-code-figure] {
|
||||||
|
position: relative;
|
||||||
|
margin-top: 1.5rem;
|
||||||
|
margin-bottom: 1.5rem;
|
||||||
|
border-radius: 0.75rem;
|
||||||
|
overflow: hidden;
|
||||||
|
border: 1px solid #27272a;
|
||||||
|
background-color: #0d1117;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Leeres Pseudo-Element der Figure deaktivieren */
|
||||||
|
figure[data-rehype-pretty-code-figure]::before {
|
||||||
|
display: none !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Sprach-Badge links oben */
|
||||||
|
figure[data-rehype-pretty-code-figure] pre[data-language]::before {
|
||||||
|
content: attr(data-language);
|
||||||
|
display: block !important;
|
||||||
|
position: absolute;
|
||||||
|
top: 0.6rem;
|
||||||
|
left: 0.5rem;
|
||||||
|
font-family: var(--font-mono, ui-monospace, monospace);
|
||||||
|
font-size: 0.68rem;
|
||||||
|
font-weight: 600;
|
||||||
|
text-transform: uppercase;
|
||||||
|
letter-spacing: 0.05em;
|
||||||
|
color: #a1a1aa;
|
||||||
|
background-color: #18181b;
|
||||||
|
border: 1px solid #27272a;
|
||||||
|
padding: 0.15rem 0.5rem;
|
||||||
|
border-radius: 0.375rem;
|
||||||
|
pointer-events: none;
|
||||||
|
z-index: 10;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Platz oben im Code-Block */
|
||||||
|
figure[data-rehype-pretty-code-figure] pre {
|
||||||
|
margin: 0 !important;
|
||||||
|
padding: 1rem !important;
|
||||||
|
padding-top: 2.6rem !important; /* Platz für Badge & Button */
|
||||||
|
background-color: transparent !important;
|
||||||
|
overflow-x: auto;
|
||||||
|
font-size: 0.875rem;
|
||||||
|
line-height: 1.7;
|
||||||
|
}
|
||||||
|
|
||||||
|
h1, h2, h3, h4, h5, h6 {
|
||||||
|
scroll-margin-top: 5rem; /* <-- Höhe deines Headers + etwas Abstand */
|
||||||
|
}
|
||||||
|
|
||||||
|
html {
|
||||||
|
scroll-behavior: smooth;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Anchor-Link Styling */
|
||||||
|
.heading-anchor {
|
||||||
|
opacity: 0;
|
||||||
|
margin-right: 1em; /* Abstand zum nachfolgenden Text */
|
||||||
|
color: #3b82f6; /* Tailwind blue-500 */
|
||||||
|
text-decoration: none;
|
||||||
|
font-weight: 800;
|
||||||
|
transition: opacity 0.15s ease-in-out;
|
||||||
|
}
|
||||||
|
|
||||||
|
h1:hover .heading-anchor,
|
||||||
|
h2:hover .heading-anchor,
|
||||||
|
h3:hover .heading-anchor,
|
||||||
|
h4:hover .heading-anchor,
|
||||||
|
.heading-anchor:focus {
|
||||||
|
opacity: 1;
|
||||||
|
}
|
||||||
+111
-16
@@ -3,11 +3,65 @@
|
|||||||
import { useState, useEffect } from "react";
|
import { useState, useEffect } from "react";
|
||||||
|
|
||||||
export default function SenderPage() {
|
export default function SenderPage() {
|
||||||
|
const [isFullscreen, setIsFullscreen] = useState(false);
|
||||||
|
|
||||||
const [songID, setSongID] = useState("");
|
const [songID, setSongID] = useState("");
|
||||||
const [songbook, setSongbook] = useState("");
|
const [songbook, setSongbook] = useState("");
|
||||||
const [number, setNumber] = useState("");
|
const [number, setNumber] = useState("");
|
||||||
const [title, setTitle] = useState("");
|
const [title, setTitle] = useState("");
|
||||||
|
|
||||||
|
// --- Screen Wake Lock API Integration ---
|
||||||
|
useEffect(() => {
|
||||||
|
let wakeLock: WakeLockSentinel | null = null;
|
||||||
|
|
||||||
|
const requestWakeLock = async () => {
|
||||||
|
try {
|
||||||
|
if ("wakeLock" in navigator) {
|
||||||
|
wakeLock = await navigator.wakeLock.request("screen");
|
||||||
|
}
|
||||||
|
} catch (err) {
|
||||||
|
console.error("Wake Lock Fehler:", err);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
requestWakeLock();
|
||||||
|
|
||||||
|
// Erneutes Anfordern, falls der Tab/die App gewechselt wurde
|
||||||
|
const handleVisibilityChange = () => {
|
||||||
|
if (document.visibilityState === "visible") {
|
||||||
|
requestWakeLock();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
document.addEventListener("visibilitychange", handleVisibilityChange);
|
||||||
|
|
||||||
|
return () => {
|
||||||
|
document.removeEventListener("visibilitychange", handleVisibilityChange);
|
||||||
|
if (wakeLock) {
|
||||||
|
wakeLock.release();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}, []);
|
||||||
|
|
||||||
|
// --- Fullscreen Steuerung ---
|
||||||
|
const toggleFullscreen = () => {
|
||||||
|
if (!document.fullscreenElement) {
|
||||||
|
document.documentElement
|
||||||
|
.requestFullscreen()
|
||||||
|
.then(() => {
|
||||||
|
setIsFullscreen(true);
|
||||||
|
})
|
||||||
|
.catch((err) => {
|
||||||
|
console.error("Vollbild fehlgeschlagen:", err);
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
document.exitFullscreen().then(() => {
|
||||||
|
setIsFullscreen(false);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// --- Daten abrufen ---
|
||||||
const getID = async () => {
|
const getID = async () => {
|
||||||
try {
|
try {
|
||||||
const res = await fetch("/api/stream/currentID");
|
const res = await fetch("/api/stream/currentID");
|
||||||
@@ -28,22 +82,63 @@ export default function SenderPage() {
|
|||||||
}, []);
|
}, []);
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div className="flex h-screen w-screen flex-col items-center justify-between bg-black text-white font-sans select-none overflow-hidden">
|
<div
|
||||||
<div className="w-full text-center py-2">
|
className={`absolute top-0 left-0 z-50 flex h-screen w-screen flex-col items-center justify-between bg-black text-white select-none overflow-hidden p-2`}
|
||||||
<span className="text-[7rem] md:text-[11rem] font-black uppercase block leading-none">
|
>
|
||||||
{songbook}
|
{/* 1. Liederbuch */}
|
||||||
</span>
|
<header className="w-full flex-[1.5] flex items-center justify-center overflow-hidden py-1">
|
||||||
</div>
|
<svg viewBox="0 0 1000 200" className="w-full h-full max-h-full">
|
||||||
<div className="flex-1 flex items-center justify-center w-full">
|
<text
|
||||||
<h1 className="text-[14rem] md:text-[20rem] font-black leading-none tracking-tighter text-white">
|
x="50%"
|
||||||
{number}
|
y="50%"
|
||||||
</h1>
|
dominantBaseline="central"
|
||||||
</div>
|
textAnchor="middle"
|
||||||
<div className="w-full text-center pb-2 px-4">
|
className="fill-amber-300 font-black uppercase"
|
||||||
<p className="text-3xl md:text-6xl font-medium text-neutral-400 truncate">
|
fontSize="220"
|
||||||
{title}
|
>
|
||||||
</p>
|
{songbook}
|
||||||
</div>
|
</text>
|
||||||
|
</svg>
|
||||||
|
</header>
|
||||||
|
|
||||||
|
{/* 2. Nummer */}
|
||||||
|
<main className="w-full flex-[5] flex items-center justify-center overflow-hidden py-1">
|
||||||
|
<svg viewBox="0 0 1000 500" className="w-full h-full max-h-full">
|
||||||
|
<text
|
||||||
|
x="50%"
|
||||||
|
y="50%"
|
||||||
|
dominantBaseline="central"
|
||||||
|
textAnchor="middle"
|
||||||
|
className="fill-white font-black"
|
||||||
|
fontSize="520"
|
||||||
|
>
|
||||||
|
{number}
|
||||||
|
</text>
|
||||||
|
</svg>
|
||||||
|
</main>
|
||||||
|
|
||||||
|
{/* 3. Titel */}
|
||||||
|
<footer className="w-full flex-[1] flex items-center justify-center overflow-hidden py-1">
|
||||||
|
<svg viewBox="0 0 1000 120" className="w-full h-full max-h-full">
|
||||||
|
<text
|
||||||
|
x="50%"
|
||||||
|
y="50%"
|
||||||
|
dominantBaseline="central"
|
||||||
|
textAnchor="middle"
|
||||||
|
className="fill-zinc-200 font-semibold"
|
||||||
|
fontSize="90"
|
||||||
|
>
|
||||||
|
{title}
|
||||||
|
</text>
|
||||||
|
</svg>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
<button
|
||||||
|
onClick={toggleFullscreen}
|
||||||
|
className="fixed top-4 right-4 z-50 bg-neutral-800 hover:bg-neutral-700 text-white px-4 py-2 rounded-lg opacity-40 hover:opacity-100 transition-opacity"
|
||||||
|
>
|
||||||
|
{isFullscreen ? "Vollbild beenden" : "Vollbild starten"}
|
||||||
|
</button>
|
||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,93 @@
|
|||||||
|
import { getWikiPageBySlug } from '@/lib/wiki';
|
||||||
|
import { notFound } from 'next/navigation';
|
||||||
|
import { MDXRemote } from 'next-mdx-remote/rsc';
|
||||||
|
import rehypePrettyCode from 'rehype-pretty-code';
|
||||||
|
import rehypeSlug from 'rehype-slug';
|
||||||
|
import rehypeAutolinkHeadings from 'rehype-autolink-headings';
|
||||||
|
import { Callout, Grid, Card, Steps, Step, InlineCode, CodeBlockContainer, API } from '@/components/mdx-components';
|
||||||
|
import Article from '@/components/wiki/Article';
|
||||||
|
|
||||||
|
const mdxOptions = {
|
||||||
|
mdxOptions: {
|
||||||
|
rehypePlugins: [
|
||||||
|
rehypeSlug, // creates heading-ids automaticly
|
||||||
|
[
|
||||||
|
rehypeAutolinkHeadings,
|
||||||
|
{
|
||||||
|
behavior: 'prepend', // symbol is PRE header
|
||||||
|
properties: {
|
||||||
|
className: ['heading-anchor'],
|
||||||
|
ariaHidden: 'true',
|
||||||
|
tabIndex: -1,
|
||||||
|
},
|
||||||
|
content: {
|
||||||
|
type: 'text',
|
||||||
|
value: ' #', // symbol
|
||||||
|
},
|
||||||
|
},
|
||||||
|
],
|
||||||
|
[
|
||||||
|
rehypePrettyCode,
|
||||||
|
{
|
||||||
|
theme: 'github-dark',
|
||||||
|
keepBackground: true,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
],
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
const mdxComponents = {
|
||||||
|
// Eigene UI-Komponenten
|
||||||
|
Callout,
|
||||||
|
Grid,
|
||||||
|
Card,
|
||||||
|
Steps,
|
||||||
|
Step,
|
||||||
|
API,
|
||||||
|
// Custom Typography Überschreibungen
|
||||||
|
code: InlineCode,
|
||||||
|
pre: CodeBlockContainer,
|
||||||
|
h1: (props: any) => <h1 className="text-3xl font-bold text-white mt-8 mb-4 border-b border-zinc-800 pb-3" {...props} />,
|
||||||
|
h2: (props: any) => <h2 className="text-2xl font-bold text-white mt-10 mb-4" {...props} />,
|
||||||
|
h3: (props: any) => <h3 className="text-xl font-semibold text-white mt-6 mb-3" {...props} />,
|
||||||
|
};
|
||||||
|
|
||||||
|
type PageProps = {
|
||||||
|
params: Promise<{
|
||||||
|
slug: string;
|
||||||
|
}>;
|
||||||
|
};
|
||||||
|
|
||||||
|
export default async function Page({ params }: PageProps) {
|
||||||
|
const { slug } = await params;
|
||||||
|
const article = await getWikiPageBySlug(slug);
|
||||||
|
|
||||||
|
if (!article) {
|
||||||
|
notFound();
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
// <article className="prose prose-invert prose-blue max-w-4xl mx-auto p-6 md:p-12 min-h-screen">
|
||||||
|
// <header className="mb-8 border-b border-zinc-800 pb-6">
|
||||||
|
// <h1 className="text-4xl font-extrabold text-white mb-2 m-0">{article.title}</h1>
|
||||||
|
// {article.updatedAt && (
|
||||||
|
// <p className="text-zinc-500 text-sm m-0">Zuletzt aktualisiert: {article.updatedAt}</p>
|
||||||
|
// )}
|
||||||
|
// </header>
|
||||||
|
|
||||||
|
// <MDXRemote
|
||||||
|
// source={article.rawContent}
|
||||||
|
// components={mdxComponents}
|
||||||
|
// options={mdxOptions as any}
|
||||||
|
// />
|
||||||
|
// </article>
|
||||||
|
<Article title={article.title} updatedAt={article.updatedAt}>
|
||||||
|
<MDXRemote
|
||||||
|
source={article.rawContent}
|
||||||
|
components={mdxComponents}
|
||||||
|
options={mdxOptions as any}
|
||||||
|
/>
|
||||||
|
</Article>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
import { getAllApis } from "@/lib/wiki";
|
||||||
|
import Article from '@/components/wiki/Article';
|
||||||
|
import { API } from '@/components/mdx-components';
|
||||||
|
|
||||||
|
export default async function Page() {
|
||||||
|
const allApis = await getAllApis();
|
||||||
|
|
||||||
|
// Gruppiert die APIs nach ihrer Kategorie
|
||||||
|
const groupedApis = Object.groupBy(allApis, (api) => api.category);
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Article title="API-Endpunkte">
|
||||||
|
{Object.entries(groupedApis).map(([category, apis]) => (
|
||||||
|
<div key={category} className="mb-10">
|
||||||
|
{/* Kategorie-Überschrift wird nur EINMAL pro Kategorie gerendert */}
|
||||||
|
<h2 className="text-2xl font-bold text-white mt-10 mb-4 border-b border-zinc-800 pb-2">
|
||||||
|
{category}
|
||||||
|
</h2>
|
||||||
|
|
||||||
|
{/* Routen innerhalb dieser Kategorie durchgehen */}
|
||||||
|
{apis?.map((api, index) => (
|
||||||
|
<div key={index} className="my-4">
|
||||||
|
{api.methods.map((method, mIndex) => (
|
||||||
|
<API route={api.route} method={method.method} key={mIndex}>
|
||||||
|
{method.description}
|
||||||
|
</API>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</Article>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
import Article from "@/components/wiki/Article";
|
||||||
|
import { getAllWikiPages } from "@/lib/wiki";
|
||||||
|
|
||||||
|
export default async function WikiIndexPage() {
|
||||||
|
const allPages = await getAllWikiPages();
|
||||||
|
return (
|
||||||
|
<Article title="Wiki">
|
||||||
|
<div className="flex flex-col gap-2">
|
||||||
|
{allPages.map(({ title, path }) => (
|
||||||
|
<a key={path} href={`/wiki/${path}`} className="hover:underline">
|
||||||
|
{title}
|
||||||
|
</a>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
</Article>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
'use client';
|
||||||
|
|
||||||
|
import { useState } from 'react';
|
||||||
|
|
||||||
|
export function CopyButton({ code }: { code?: string }) {
|
||||||
|
const [copied, setCopied] = useState(false);
|
||||||
|
|
||||||
|
const handleCopy = async (e: React.MouseEvent<HTMLButtonElement>) => {
|
||||||
|
e.preventDefault();
|
||||||
|
|
||||||
|
// Falls kein expliziter Code übergeben wird, suchen wir den Text im Elternelement (Codeblock)
|
||||||
|
let textToCopy = code;
|
||||||
|
if (!textToCopy) {
|
||||||
|
const parent = e.currentTarget.closest('figure');
|
||||||
|
const codeElement = parent?.querySelector('code');
|
||||||
|
textToCopy = codeElement?.textContent || '';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (textToCopy) {
|
||||||
|
await navigator.clipboard.writeText(textToCopy);
|
||||||
|
setCopied(true);
|
||||||
|
setTimeout(() => setCopied(false), 2000);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<button
|
||||||
|
onClick={handleCopy}
|
||||||
|
className="absolute top-2.5 right-3 p-1.5 rounded-md bg-zinc-900 border border-zinc-800 text-zinc-400 hover:text-white hover:bg-zinc-800 transition-colors z-20"
|
||||||
|
aria-label="Code kopieren"
|
||||||
|
>
|
||||||
|
{copied ? (
|
||||||
|
// Check Icon (Erfolg)
|
||||||
|
<svg className="w-4 h-4 text-emerald-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||||
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
|
||||||
|
</svg>
|
||||||
|
) : (
|
||||||
|
// Clipboard Icon
|
||||||
|
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||||
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
|
||||||
|
</svg>
|
||||||
|
)}
|
||||||
|
</button>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,166 @@
|
|||||||
|
import React from 'react';
|
||||||
|
import { CopyButton } from './CopyButton';
|
||||||
|
|
||||||
|
// 1. Callouts (Info, Warning, Error, Success)
|
||||||
|
export function Callout({
|
||||||
|
children,
|
||||||
|
type = 'info'
|
||||||
|
}: {
|
||||||
|
children: React.ReactNode;
|
||||||
|
type?: 'info' | 'warning' | 'error' | 'success'
|
||||||
|
}) {
|
||||||
|
// Farben für Hintergrund, Text und den linken Akzentstreifen (after)
|
||||||
|
const variants = {
|
||||||
|
info: "bg-blue-500/10 text-blue-200 after:bg-blue-500",
|
||||||
|
warning: "bg-amber-500/10 text-amber-200 after:bg-amber-500",
|
||||||
|
error: "bg-red-500/10 text-red-200 after:bg-red-500",
|
||||||
|
success: "bg-emerald-500/10 text-emerald-200 after:bg-emerald-500",
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div
|
||||||
|
className={`relative overflow-hidden p-4 my-6 rounded-md
|
||||||
|
after:content-[''] after:absolute after:top-1 after:left-1 after:bottom-1 after:w-1 after:rounded
|
||||||
|
${variants[type]}`}
|
||||||
|
>
|
||||||
|
<div className="flex gap-3 items-center">
|
||||||
|
<div className="shrink-0">
|
||||||
|
{type === 'info' && <svg className="w-6 h-6 text-blue-400" fill="none" viewBox="0 0 24 24" stroke="currentColor"><path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg>}
|
||||||
|
{type === 'warning' && <svg className="w-6 h-6 text-amber-400" fill="none" viewBox="0 0 24 24" stroke="currentColor"><path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" /></svg>}
|
||||||
|
{type === 'error' && <svg className="w-6 h-6 text-red-400" fill="none" viewBox="0 0 24 24" stroke="currentColor"><path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg>}
|
||||||
|
{type === 'success' && <svg className="w-6 h-6 text-emerald-400" fill="none" viewBox="0 0 24 24" stroke="currentColor"><path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" /></svg>}
|
||||||
|
</div>
|
||||||
|
<div className="text-sm leading-relaxed [&>p]:m-0">{children}</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2. Grid & Cards
|
||||||
|
export function Grid({ children }: { children: React.ReactNode }) {
|
||||||
|
return <div className="grid grid-cols-1 md:grid-cols-2 gap-4 my-8">{children}</div>;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function Card({ title, href, children }: { title: string; href: string; children: React.ReactNode }) {
|
||||||
|
return (
|
||||||
|
<a href={href} className="block p-6 bg-zinc-900 border border-zinc-800 rounded-xl hover:border-blue-500 transition-colors group no-underline">
|
||||||
|
<h3 className="text-lg font-bold text-white group-hover:text-blue-400 m-0 mb-2">{title}</h3>
|
||||||
|
<div className="text-zinc-400 text-sm m-0 leading-relaxed [&>p]:m-0">
|
||||||
|
{children}
|
||||||
|
</div>
|
||||||
|
</a>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 3. Steps
|
||||||
|
export function Steps({ children }: { children: React.ReactNode }) {
|
||||||
|
// Wir gehen durch alle Kinder und fügen automatisch die 'stepNumber' als Prop hinzu
|
||||||
|
const steps = React.Children.map(children, (child, index) => {
|
||||||
|
if (React.isValidElement(child)) {
|
||||||
|
return React.cloneElement(child as React.ReactElement<any>, {
|
||||||
|
stepNumber: index + 1,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return child;
|
||||||
|
});
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="ml-4 border-l border-zinc-800 pl-8 my-8 space-y-8">
|
||||||
|
{steps}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function Step({
|
||||||
|
title,
|
||||||
|
children,
|
||||||
|
stepNumber
|
||||||
|
}: {
|
||||||
|
title: string;
|
||||||
|
children: React.ReactNode;
|
||||||
|
stepNumber?: number;
|
||||||
|
}) {
|
||||||
|
return (
|
||||||
|
<div className="relative">
|
||||||
|
{/* Die Nummer wird direkt als Text aus React gerendert */}
|
||||||
|
<div className="absolute -left-[41px] flex h-5 w-5 items-center justify-center rounded-full bg-zinc-900 border border-zinc-800 text-[10px] font-bold text-white">
|
||||||
|
{stepNumber}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<h3 className="text-white font-bold mb-2 mt-0 text-base">{title}</h3>
|
||||||
|
<div className="text-zinc-400 text-sm [&>p]:m-0">{children}</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Custom Inline Code (verhindert das Erben auf große Codeblöcke)
|
||||||
|
export function InlineCode({ children, className, ...props }: React.HTMLAttributes<HTMLElement>) {
|
||||||
|
// Wenn 'data-theme' oder 'data-language' existiert, kommt das Element aus rehype-pretty-code (Code-Block)
|
||||||
|
const isCodeBlock = props && ('data-theme' in props || 'data-language' in props);
|
||||||
|
|
||||||
|
// Falls es Teil eines großen Codeblocks ist -> normales <code> ohne Inline-Styling rendern
|
||||||
|
if (isCodeBlock || className?.includes('language-')) {
|
||||||
|
return <code className={className} {...props}>{children}</code>;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Ansonsten: Unser schickes Inline-Code-Design anwenden
|
||||||
|
return (
|
||||||
|
<code
|
||||||
|
className="px-1.5 py-0.5 rounded-md bg-zinc-800 text-pink-400 font-mono text-sm border border-zinc-700/50 before:content-none after:content-none"
|
||||||
|
{...props}
|
||||||
|
>
|
||||||
|
{children}
|
||||||
|
</code>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function CodeBlockContainer({ children, ...props }: React.HTMLAttributes<HTMLPreElement>) {
|
||||||
|
return (
|
||||||
|
<div className="relative group">
|
||||||
|
<CopyButton />
|
||||||
|
<pre {...props}>{children}</pre>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function API({
|
||||||
|
method = 'GET',
|
||||||
|
route,
|
||||||
|
children
|
||||||
|
}: {
|
||||||
|
method?: string;
|
||||||
|
route: string;
|
||||||
|
children?: React.ReactNode;
|
||||||
|
}) {
|
||||||
|
const methodUpper = method.toUpperCase();
|
||||||
|
|
||||||
|
// Farben für die verschiedenen HTTP-Methoden
|
||||||
|
const methodStyles: Record<string, string> = {
|
||||||
|
GET: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30',
|
||||||
|
POST: 'bg-blue-500/10 text-blue-400 border-blue-500/30',
|
||||||
|
PUT: 'bg-amber-500/10 text-amber-400 border-amber-500/30',
|
||||||
|
PATCH: 'bg-orange-500/10 text-orange-400 border-orange-500/30',
|
||||||
|
DELETE: 'bg-rose-500/10 text-rose-400 border-rose-500/30',
|
||||||
|
};
|
||||||
|
|
||||||
|
const badgeStyle = methodStyles[methodUpper] || 'bg-zinc-800 text-zinc-300 border-zinc-700';
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="my-6 rounded-xl border border-zinc-800 bg-zinc-900/50 overflow-hidden">
|
||||||
|
{/* Route & Methoden-Header */}
|
||||||
|
<div className="flex items-center gap-3 p-4 bg-zinc-900 border-b border-zinc-800 font-mono text-sm">
|
||||||
|
<span className={`px-2.5 py-1 rounded-md text-xs font-bold border ${badgeStyle}`}>
|
||||||
|
{methodUpper}
|
||||||
|
</span>
|
||||||
|
<span className="text-zinc-200 font-semibold">/api/{route}</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Beschreibung / Inhalt */}
|
||||||
|
{children && (
|
||||||
|
<div className="p-4 text-sm text-zinc-400 leading-relaxed [&>p]:m-0">
|
||||||
|
{children}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
import { ReactNode } from "react";
|
||||||
|
|
||||||
|
interface ArticleProps {
|
||||||
|
title: string;
|
||||||
|
updatedAt?: string;
|
||||||
|
children: ReactNode
|
||||||
|
}
|
||||||
|
|
||||||
|
export default function Article({ title, updatedAt, children }: ArticleProps) {
|
||||||
|
return (
|
||||||
|
<article className="prose prose-invert prose-blue max-w-4xl mx-auto p-6 md:p-12 min-h-screen">
|
||||||
|
<header className="mb-8 border-b border-zinc-800 pb-6">
|
||||||
|
<h1 className="text-4xl font-extrabold text-white mb-2 m-0">{title}</h1>
|
||||||
|
{updatedAt && (
|
||||||
|
<p className="text-zinc-500 text-sm m-0">Zuletzt aktualisiert: {updatedAt}</p>
|
||||||
|
)}
|
||||||
|
</header>
|
||||||
|
|
||||||
|
{children}
|
||||||
|
</article>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
---
|
||||||
|
title: Lied erstellen
|
||||||
|
updatedAt: "2026-08-05"
|
||||||
|
---
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
<Step title="Verwaltungsseite aufrufen">
|
||||||
|
Navigiere im Browser auf `http://<ip>:3000/admin` (oder falls lokal gehostet: `http://localhost:3000/admin`).
|
||||||
|
</Step>
|
||||||
|
<Step title="Liederbuch auswählen">
|
||||||
|
Wähle in der Karte "Lied hinzufügen" oder "CSV-Massenimport" ein Liederbuch aus.
|
||||||
|
</Step>
|
||||||
|
<Step title="Lied hinzufügen">
|
||||||
|
Gib in der Karte "Lied hinzufügen" die Nummer und den Namen des Liedes ein. Bestätige mit "Lied speichern".
|
||||||
|
<img src="https://git.schamagusa.de/Schanbro/PsalmTafel/raw/branch/main/wiki/new_song.png" alt="Neues Lied hinzufügen" />
|
||||||
|
|
||||||
|
Alternativ in der Karte "CSV-Massenimport" eine CSV-Datei hochladen und mit "Hochladen & Verarbeiten" bestäigen.
|
||||||
|
<img src="https://git.schamagusa.de/Schanbro/PsalmTafel/raw/branch/main/wiki/csv_import.png" alt="CSV-Massenimport" />
|
||||||
|
<Callout type="important">
|
||||||
|
Das Format der CSV-Datei muss wie folgt aufgebaut sein:
|
||||||
|
```csv
|
||||||
|
nummer;title
|
||||||
|
[Lied-Nummer];[Lied-Titel]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Beispiel:**
|
||||||
|
```csv
|
||||||
|
nummer;title
|
||||||
|
24;Die Schwalbe lieb und klein
|
||||||
|
596;Von guten Mächten wunderbar geborgen
|
||||||
|
```
|
||||||
|
</Callout>
|
||||||
|
</Step>
|
||||||
|
</Steps>
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
---
|
||||||
|
title: Liederbuch erstellen
|
||||||
|
updatedAt: "2026-08-05"
|
||||||
|
---
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
<Step title="Verwaltungsseite aufrufen">
|
||||||
|
Navigiere im Browser auf `http://<ip>:3000/admin` (oder falls lokal gehostet: `http://localhost:3000/admin`).
|
||||||
|
</Step>
|
||||||
|
<Step title="Liederbuch hinzufügen">
|
||||||
|
Gib in der Karte "Neues Liederbuch" die Namen und optional die Sprache des Liederbuchs ein. Bestätige mit "Liederbuch erstellen".
|
||||||
|
<img src="https://git.schamagusa.de/Schanbro/PsalmTafel/raw/branch/main/wiki/new_songbook.png" alt="Neues Liederbuch hinzufügen" />
|
||||||
|
</Step>
|
||||||
|
</Steps>
|
||||||
@@ -0,0 +1,49 @@
|
|||||||
|
---
|
||||||
|
title: Installation & Setup
|
||||||
|
updatedAt: "2026-08-05"
|
||||||
|
----
|
||||||
|
|
||||||
|
<Callout type="warning">
|
||||||
|
Dieses Projekt befindet sich noch in der **aktiven Entwicklungsphase**. Bitte verwende es noch nicht für den produktiven Einsatz.
|
||||||
|
</Callout>
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
<Step title="Repository klonen">
|
||||||
|
Nutze Git, um den Code zu holen:
|
||||||
|
```bash
|
||||||
|
git clone https://git.schamagusa.de/Schanbro/PsalmTafel.git
|
||||||
|
```
|
||||||
|
</Step>
|
||||||
|
<Step title="Navigiere in den erzeugten Ordner">
|
||||||
|
Nutze cd, um in den Ordner zu navigieren:
|
||||||
|
```bash
|
||||||
|
cd PsalmTafel
|
||||||
|
```
|
||||||
|
</Step>
|
||||||
|
<Step title="Abhängigkeiten installieren">
|
||||||
|
Führe den Installer aus:
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
</Step>
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
## Setup
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
<Step title="Datenbank einrichten lassen">
|
||||||
|
Führe die Einrichtung der Datenbank aus:
|
||||||
|
```bash
|
||||||
|
prisma generate
|
||||||
|
npx prisma migrate dev
|
||||||
|
```
|
||||||
|
</Step>
|
||||||
|
<Step title="Server starten">
|
||||||
|
Führe den Installer aus:
|
||||||
|
```bash
|
||||||
|
pnpm dev
|
||||||
|
```
|
||||||
|
</Step>
|
||||||
|
</Steps>
|
||||||
@@ -0,0 +1,50 @@
|
|||||||
|
---
|
||||||
|
title: Test Page
|
||||||
|
updatedAt: "2026-08-04"
|
||||||
|
---
|
||||||
|
|
||||||
|
Willkommen im offiziellen Wiki! Hier findest du alle Informationen zum Projekt.
|
||||||
|
|
||||||
|
<Grid>
|
||||||
|
<Card title="Installation" href="/wiki/installation">
|
||||||
|
Erfahre, wie du das Projekt lokal aufsetzt.
|
||||||
|
</Card>
|
||||||
|
<Card title="Deployment" href="/wiki/deployment">
|
||||||
|
So bringst du deinen Code live auf den Server.
|
||||||
|
</Card>
|
||||||
|
</Grid>
|
||||||
|
|
||||||
|
## Schnellstart
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
<Step title="Repository klonen">
|
||||||
|
Nutze Git, um den Code zu holen:
|
||||||
|
`git clone ...`
|
||||||
|
</Step>
|
||||||
|
<Step title="Abhängigkeiten installieren">
|
||||||
|
Führe den Installer aus:
|
||||||
|
`pnpm install`
|
||||||
|
</Step>
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
<Callout type="warning">
|
||||||
|
Vergiss nicht, die `.env` Datei anzulegen, sonst startet die App nicht!
|
||||||
|
</Callout>
|
||||||
|
|
||||||
|
<Callout type="success">
|
||||||
|
Du bist jetzt bereit zum Entwickeln!
|
||||||
|
</Callout>
|
||||||
|
|
||||||
|
<Callout type="info">
|
||||||
|
Du bist jetzt bereit zum Entwickeln!
|
||||||
|
</Callout>
|
||||||
|
|
||||||
|
<Callout type="error">
|
||||||
|
Du bist jetzt bereit zum Entwickeln!
|
||||||
|
</Callout>
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
function sayHello(name: string): string {
|
||||||
|
return `Hallo, ${name}!`;
|
||||||
|
}
|
||||||
|
```
|
||||||
+228
@@ -0,0 +1,228 @@
|
|||||||
|
import fs from 'fs';
|
||||||
|
import path from 'path';
|
||||||
|
import matter from 'gray-matter';
|
||||||
|
import ts from 'typescript';
|
||||||
|
import { ApiRoute, ApiMethod } from '@/types/api';
|
||||||
|
|
||||||
|
export type WikiArticle = {
|
||||||
|
slug: string;
|
||||||
|
title: string;
|
||||||
|
rawContent: string;
|
||||||
|
updatedAt?: string;
|
||||||
|
};
|
||||||
|
|
||||||
|
export type WikiPage = {
|
||||||
|
title: string;
|
||||||
|
path: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const wikiDirectory = path.join(process.cwd(), "data/wiki/pages");
|
||||||
|
|
||||||
|
export async function getWikiPageBySlug(slug: string): Promise<WikiArticle | null> {
|
||||||
|
try {
|
||||||
|
const fullPath = path.join(wikiDirectory, `${slug}.mdx`);
|
||||||
|
const fileContents = fs.readFileSync(fullPath, "utf-8");
|
||||||
|
|
||||||
|
const { data, content } = matter(fileContents);
|
||||||
|
|
||||||
|
return {
|
||||||
|
slug,
|
||||||
|
rawContent: content,
|
||||||
|
title: data.title || 'Unbenannt',
|
||||||
|
updatedAt: data.updatedAt || null,
|
||||||
|
...data,
|
||||||
|
} as WikiArticle;
|
||||||
|
} catch (error) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Liest rekursiv alle Dateien aus einem Verzeichnis aus.
|
||||||
|
* @param dirPath - Der Startordner
|
||||||
|
* @param extension - Optionale Dateiendung zur Filterung (z. B. ".ts" oder "ts")
|
||||||
|
* @returns Array mit den Dateipfaden
|
||||||
|
*/
|
||||||
|
export function getAllFiles(dirPath: string, extension?: string): string[] {
|
||||||
|
if (!fs.existsSync(dirPath)) return [];
|
||||||
|
|
||||||
|
let results: string[] = [];
|
||||||
|
|
||||||
|
// optionales führendes Dot sicherstellen (z. B. aus "ts" wird ".ts")
|
||||||
|
const targetExt = extension && !extension.startsWith('.')
|
||||||
|
? `.${extension}`
|
||||||
|
: extension;
|
||||||
|
|
||||||
|
// withFileTypes: true spart zusätzliche fs.statSync Aufrufe
|
||||||
|
const entries = fs.readdirSync(dirPath, { withFileTypes: true });
|
||||||
|
|
||||||
|
for (const entry of entries) {
|
||||||
|
const fullPath = path.join(dirPath, entry.name);
|
||||||
|
|
||||||
|
if (entry.isDirectory()) {
|
||||||
|
results = results.concat(getAllFiles(fullPath, targetExt));
|
||||||
|
} else if (!targetExt || entry.name.endsWith(targetExt)) {
|
||||||
|
results.push(fullPath);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return results;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Liest die Kategorie aus der Datei aus (@wikiCategory) oder ermittelt sie aus dem Ordnernamen.
|
||||||
|
*/
|
||||||
|
export function filterCategory(
|
||||||
|
content: string,
|
||||||
|
filePath: string,
|
||||||
|
prefix: string = '@wikiCategory'
|
||||||
|
): string {
|
||||||
|
// 1. In Kommentaren nach @wikiCategory suchen
|
||||||
|
const lines = content.split('\n');
|
||||||
|
for (const line of lines) {
|
||||||
|
const cleaned = line.replace(/^\/\/\s*/, '').replace(/^\/\*\*?\s*/, '').replace(/\*\/$/, '').trim();
|
||||||
|
if (cleaned.startsWith(prefix)) {
|
||||||
|
let category = cleaned.slice(prefix.length).trim().replace(/^:\s*/, '');
|
||||||
|
if (category) return category;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2. Fallback: Ersten Ordnernamen unter app/api/ als Kategorie nutzen
|
||||||
|
const normalizedPath = filePath.replace(/\\/g, '/');
|
||||||
|
const apiMatch = normalizedPath.match(/app\/api\/([^/]+)/);
|
||||||
|
if (apiMatch && apiMatch[1]) {
|
||||||
|
const folderName = apiMatch[1];
|
||||||
|
// Ersten Buchstaben großschreiben (z. B. "stream" -> "Stream")
|
||||||
|
return folderName.charAt(0).toUpperCase() + folderName.slice(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
return 'Allgemein';
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parst TypeScript-Code via AST und extrahiert HTTP-Methoden sowie deren Kommentare.
|
||||||
|
*/
|
||||||
|
export function filterMethods(
|
||||||
|
content: string,
|
||||||
|
prefix: string = '@wikiDescription'
|
||||||
|
): ApiMethod[] {
|
||||||
|
const sourceFile = ts.createSourceFile(
|
||||||
|
'temp.ts',
|
||||||
|
content,
|
||||||
|
ts.ScriptTarget.Latest,
|
||||||
|
/* setParentNodes */ true
|
||||||
|
);
|
||||||
|
|
||||||
|
const methods: ApiMethod[] = [];
|
||||||
|
const validMethods = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
|
||||||
|
|
||||||
|
ts.forEachChild(sourceFile, (node) => {
|
||||||
|
if (ts.isFunctionDeclaration(node) && node.name) {
|
||||||
|
const functionName = node.name.text;
|
||||||
|
|
||||||
|
if (validMethods.has(functionName)) {
|
||||||
|
let description = '';
|
||||||
|
|
||||||
|
const commentRanges = ts.getLeadingCommentRanges(content, node.pos);
|
||||||
|
|
||||||
|
if (commentRanges && commentRanges.length > 0) {
|
||||||
|
const lastCommentRange = commentRanges[commentRanges.length - 1];
|
||||||
|
const rawComment = content.substring(
|
||||||
|
lastCommentRange.pos,
|
||||||
|
lastCommentRange.end
|
||||||
|
);
|
||||||
|
|
||||||
|
const cleanedComment = rawComment
|
||||||
|
.replace(/^\/\/\s*/, '')
|
||||||
|
.replace(/^\/\*\*?\s*/, '')
|
||||||
|
.replace(/\*\/$/, '')
|
||||||
|
.split('\n')
|
||||||
|
.map((line) => line.replace(/^\s*\*\s?/, '').trim())
|
||||||
|
.join(' ')
|
||||||
|
.trim();
|
||||||
|
|
||||||
|
if (cleanedComment.startsWith(prefix)) {
|
||||||
|
let textAfterPrefix = cleanedComment.slice(prefix.length).trim();
|
||||||
|
textAfterPrefix = textAfterPrefix.replace(/^:\s*/, '');
|
||||||
|
description = textAfterPrefix;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
methods.push({
|
||||||
|
method: functionName,
|
||||||
|
description: description || 'Keine Beschreibung vorhanden.',
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
return methods;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Liest alle API-Dateien dynamisch aus und wandelt sie in ApiRoute-Objekte um.
|
||||||
|
*/
|
||||||
|
export async function getAllApis(): Promise<ApiRoute[]> {
|
||||||
|
try {
|
||||||
|
const apiBasePath = path.join(process.cwd(), "app/api");
|
||||||
|
const allTsFiles = getAllFiles(apiBasePath, ".ts");
|
||||||
|
const routes: ApiRoute[] = [];
|
||||||
|
|
||||||
|
allTsFiles.forEach((filePath) => {
|
||||||
|
const fileContents = fs.readFileSync(filePath, "utf-8");
|
||||||
|
|
||||||
|
// 1. Methoden extrahieren
|
||||||
|
const methods = filterMethods(fileContents, "@wikiDescription");
|
||||||
|
|
||||||
|
// Nur Routen hinzufügen, die auch API-Methoden exportieren
|
||||||
|
if (methods.length > 0) {
|
||||||
|
// 2. Kategorie ermitteln
|
||||||
|
const category = filterCategory(fileContents, filePath, "@wikiCategory");
|
||||||
|
|
||||||
|
// 3. Route-Pfad automatisch aus dem Dateipfad generieren (app/api/stream/currentID/route.ts -> stream/currentID)
|
||||||
|
const relativePath = path.relative(apiBasePath, filePath).replace(/\\/g, '/');
|
||||||
|
const routePath = relativePath
|
||||||
|
.replace(/\/route\.ts$/, '')
|
||||||
|
.replace(/\.ts$/, '');
|
||||||
|
|
||||||
|
routes.push({
|
||||||
|
route: routePath,
|
||||||
|
category,
|
||||||
|
methods,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
return routes;
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Fehler beim Auslesen der API-Dateien:", error);
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function getAllWikiPages(): Promise<WikiPage[]> {
|
||||||
|
try {
|
||||||
|
const pagesBasePath = path.join(process.cwd(), "data/wiki/pages");
|
||||||
|
const allPaths = getAllFiles(pagesBasePath, ".mdx");
|
||||||
|
const allPages: WikiPage[] = [];
|
||||||
|
|
||||||
|
for (const filePath of allPaths) {
|
||||||
|
// extract filename of the path (e. g. "test" at "data/wiki/pages/test.mdx")
|
||||||
|
const slug = path.parse(filePath).name;
|
||||||
|
|
||||||
|
const wikiPage = await getWikiPageBySlug(slug);
|
||||||
|
|
||||||
|
if (wikiPage) {
|
||||||
|
allPages.push({
|
||||||
|
path: slug,
|
||||||
|
title: wikiPage.title,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
console.log(allPages);
|
||||||
|
return allPages;
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Fehler beim Auslesen der Wiki-Seiten:", error);
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
+17
-4
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "psalm-talel",
|
"name": "psalm-tafel",
|
||||||
"version": "0.0.5",
|
"version": "0.0.5.1",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "next dev",
|
"dev": "next dev",
|
||||||
@@ -15,14 +15,27 @@
|
|||||||
"argon2": "^0.45.1",
|
"argon2": "^0.45.1",
|
||||||
"better-sqlite3": "^13.0.2",
|
"better-sqlite3": "^13.0.2",
|
||||||
"dotenv": "^17.4.2",
|
"dotenv": "^17.4.2",
|
||||||
|
"gray-matter": "^4.0.3",
|
||||||
"next": "16.2.9",
|
"next": "16.2.9",
|
||||||
|
"next-mdx-remote": "^6.0.0",
|
||||||
"papaparse": "^5.5.4",
|
"papaparse": "^5.5.4",
|
||||||
"prisma": "^7.9.1",
|
"prisma": "^7.9.1",
|
||||||
"react": "19.2.4",
|
"react": "19.2.4",
|
||||||
"react-dom": "19.2.4"
|
"react-dom": "19.2.4",
|
||||||
|
"rehype-autolink-headings": "^7.1.0",
|
||||||
|
"rehype-highlight": "^7.0.2",
|
||||||
|
"rehype-pretty-code": "^0.14.5",
|
||||||
|
"rehype-slug": "^6.0.0",
|
||||||
|
"rehype-stringify": "^10.0.1",
|
||||||
|
"remark": "^15.0.1",
|
||||||
|
"remark-html": "^16.0.1",
|
||||||
|
"remark-parse": "^11.0.0",
|
||||||
|
"remark-rehype": "^11.1.2",
|
||||||
|
"shiki": "^4.4.1"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@tailwindcss/postcss": "^4",
|
"@tailwindcss/postcss": "^4",
|
||||||
|
"@tailwindcss/typography": "^0.5.20",
|
||||||
"@types/better-sqlite3": "^7.6.13",
|
"@types/better-sqlite3": "^7.6.13",
|
||||||
"@types/node": "^20",
|
"@types/node": "^20",
|
||||||
"@types/react": "^19",
|
"@types/react": "^19",
|
||||||
@@ -30,7 +43,7 @@
|
|||||||
"eslint": "^9",
|
"eslint": "^9",
|
||||||
"eslint-config-next": "16.2.9",
|
"eslint-config-next": "16.2.9",
|
||||||
"tailwindcss": "^4",
|
"tailwindcss": "^4",
|
||||||
"typescript": "^5"
|
"typescript": "^5.9.3"
|
||||||
},
|
},
|
||||||
"pnpm": {
|
"pnpm": {
|
||||||
"onlyBuiltDependencies": [
|
"onlyBuiltDependencies": [
|
||||||
|
|||||||
Generated
-5536
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,10 @@
|
|||||||
|
export interface ApiMethod {
|
||||||
|
method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
|
||||||
|
description: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ApiRoute {
|
||||||
|
category: string;
|
||||||
|
route: string;
|
||||||
|
methods: ApiMethod[];
|
||||||
|
}
|
||||||
Reference in new issue
Block a user