Skip to content
aYOUne
Not in your language

This page is not yet available in en. You're reading the de version.

ay laser-library

ay laser-library (Alias: laser)

Bereitet gekaufte Laser-Vorlagenpakete für die Vorlagen-Bibliothek vor. Aus einem großen, rohen Bestand (Tausende Ordner, gemischte Formate, fehlende Vorschaubilder) entsteht je Design genau eine normierte SVG, ein Vorschaubild und vermessene Metadaten. Die Originale bleiben unverändert an ihrem Ort.

Der Befehl läuft lokal und braucht keine Anmeldung: er liest die Quellordner, schreibt nur in den Ausgabeordner und lädt nichts hoch. Das Einspielen in die Bibliothek ist ein späterer Schritt, der die hier erzeugten Manifeste liest.

Syntax

ay laser-library prepare <ordner...> [flags]

Was je Design passiert

  1. Design erkennen — ein Ordner mit Schneiddateien ist ein Design. Format-Unterordner (svg/, png/, CDR.EPS.AI.PDF.DXF/) gehören zum Design darüber. Nummerierte Teile mit gleichem Namen (1-01, 1-02 …) sind ein Design mit mehreren Lagen; verschieden benannte Dateien in einem Ordner sind getrennte Designs.
  2. Beste Schneiddatei wählen — SVG vor DXF vor PDF vor AI vor EPS vor CDR. DWG/CAD-Dateien sind keine Schneiddateien.
  3. Normieren — über Inkscape als schlichte SVG, zugeschnitten auf die Zeichnung (nicht auf die Seite) und mit Text in Pfade umgewandelt. So misst ein CorelDRAW-Motiv auf einer A4-Seite seine echte Größe.
  4. Vermessen — Breite und Höhe in mm, Schnittlänge, Fläche, Lagenzahl.
  5. Vorschaubild — ein mitgeliefertes Bild wird übernommen (Montageanleitungen und Hinweisbilder nie), sonst wird eines aus der SVG erzeugt.
  6. Anlass erkennen — Halloween, Nikolaus, Advent, Weihnachten, Valentinstag, Hochzeit, Ostern und weitere, aus Ordner- und Dateinamen (deutsch, englisch, spanisch).
  7. Dubletten zusammenführen — gleicher Inhalt in zwei Paketen ergibt einen Eintrag mit zwei Quellen.

Flags

Flag Zweck
--root <ordner> Wurzel der Sammlung. Kategorie und Paket sind die ersten zwei Ordnerebenen darunter. Vorgabe: der erste angegebene Ordner
--out <ordner> Ausgabeordner (Vorgabe laser-library)
--exclude <muster> Ordner ausschließen (Name oder Pfad unter der Wurzel), mehrfach angebbar
--no-default-exclude 07 Modellbau nicht automatisch ausschließen
--bed <BxH> Arbeitsfläche eines Lasers in mm, z. B. 600x400 oder "Laser A=600x400", mehrfach angebbar. Schaltet die Liste „passt auf keinen Laser" ein
--inkscape <pfad> Pfad zu Inkscape (sonst AY_INKSCAPE, dann Suchpfad, dann die üblichen Installationsorte)
--concurrency <n> Parallele Inkscape-Prozesse (Vorgabe 4)
--limit <n> Nur die ersten n Designs — für einen Probelauf
--retry-failed Teile, deren Umwandlung früher scheiterte, erneut versuchen
--preview-width <px> Breite erzeugter Vorschaubilder (Vorgabe 800)

Beispiele

# Probelauf über zwei Anlass-Ordner
ay laser-library prepare "\\NAS\Laser\Vorlagen\08 Anlässe\Halloween" "\\NAS\Laser\Vorlagen\08 Anlässe\Weihnachten" \
  --root "\\NAS\Laser\Vorlagen" --limit 20

# Ganze Sammlung, Passung auf zwei Laser prüfen
ay laser-library prepare ./Vorlagen --out ./bibliothek --bed "Laser A=600x400" --bed "Laser B=1300x900" --concurrency 6

Ergebnis

<out>/<kategorie>/<paket>/manifest.json          ein Eintrag je Design
<out>/<kategorie>/<paket>/<design>/design.svg    normierte SVG (part-01.svg … bei mehreren Lagen)
<out>/<kategorie>/<paket>/<design>/preview.*     übernommenes oder erzeugtes Vorschaubild
<out>/bericht.md, bericht.json                   Arbeitsliste

Der Bericht führt vier Listen: prüfen, passt auf keinen Laser, Dublette und Umwandlung fehlgeschlagen, dazu die Umwandlungsquote je Quellformat.

Wiederaufnehmbar

Ein zweiter Lauf übernimmt jede unveränderte Datei aus <out>/.cache und ist deshalb schnell. Ein abgebrochener Lauf verliert höchstens die letzten Dateien.

Dubletten nur innerhalb eines Laufs

Doppelte Designs werden über alle Ordner eines Aufrufs erkannt. Wer mehrere Pakete prüft, gibt sie im selben Aufruf an.

Voraussetzung

Inkscape 1.0 oder neuer für die Umwandlung von DXF, PDF, AI, EPS und CDR sowie für erzeugte Vorschaubilder. Ohne Inkscape werden nur SVG-Quellen vermessen; alle anderen Formate erscheinen benannt unter „Umwandlung fehlgeschlagen".

Mehrseitige Quellen

Bei PDF- und AI-Dateien mit mehreren Seiten wird nur Seite 1 übernommen. Solche Designs stehen in der Liste „prüfen".

Work with this page

Ready-made instructions for your AI tool. Copy, paste, go — the AI fetches the content itself via the address in the text.

Summarise the steps for me The essentials, in the right order.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/cli/laser-library.md
The complete collection: https://ayoune.com/en/docs/cli.md

Summarise the content for me.

- First, in two sentences: what is this about?
- Then the steps in the order I need to take them.
- One line per step, in plain language.
- At the end: what I should have ready beforehand.

Leave out nothing I need in order to actually finish.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Help me set this up Step by step, asking me as you go.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/cli/laser-library.md
The complete collection: https://ayoune.com/en/docs/cli.md

Walk me through the setup step by step.

- First tell me what I need to have ready (access, data, time).
- Then take me through ONE step at a time. Wait for my "next".
- For each step, say how I can tell that it worked.
- If something goes wrong, ask me for the exact message instead of guessing.

If the instructions leave a point open, tell me so rather than inventing it.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Help me with a problem Narrow down the cause instead of guessing.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/cli/laser-library.md
The complete collection: https://ayoune.com/en/docs/cli.md

Help me narrow down a problem.

- First ask me what I observe and what I expected instead.
- From that, derive the most likely causes consistent with this source.
- For each cause, give me ONE test that confirms or rules it out.
- Order them so the cheapest test comes first.

Do not guess. If the source does not cover the problem, tell me where I should
look next.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Explain it in plain words No jargon, from the ground up.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/cli/laser-library.md
The complete collection: https://ayoune.com/en/docs/cli.md

Explain the content so that someone without prior knowledge understands it.

- Start with the purpose: why does this exist at all?
- Explain technical terms in half a sentence on first use.
- One everyday comparison where it genuinely holds — none where it limps.
- At the end: the three things worth remembering.

Do not shorten by dropping conditions. A simplification that hides a
prerequisite is a false statement.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
A checklist to tick off To follow along while you do it.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/cli/laser-library.md
The complete collection: https://ayoune.com/en/docs/cli.md

Turn this into a **tick-off checklist** for practical use.

- Exactly one action per item, in the imperative.
- Order it so that no item depends on a later prerequisite.
- Prerequisites and pitfalls as indented sub-items.
- End with an acceptance step: how do I know everything is right?
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Build it into my project Concrete code for my use case.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/cli/laser-library.md
The complete collection: https://ayoune.com/en/docs/cli.md

Help me build this into my project.

- First ask me about language, environment and what I am trying to achieve.
- Then give a minimal, runnable example — no ellipses standing in for code.
- Name the error cases I must handle and how they surface.
- State the limits: timeouts, quotas, permissions.

Use only what the source actually describes. Do not invent fields, parameters
or endpoints — an invented call costs me more time than it saves.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Was this article helpful?

👎 No (0)
Leave a comment