Zitate automatisch verlinken

Was macht die Vernetzung?

Sie schreiben Ihre Beiträge wie bisher. Die Vernetzung erkennt Zitate von Bundesrecht und Gerichtsentscheidungen im Text und verlinkt sie mit der passenden Norm oder Entscheidung auf gesetze.nulegal.eu — 6.151 geltende Gesetze und Verordnungen mit historischen Fassungen und 503.157 Entscheidungen, auch vieler Instanzgerichte.

Drei Regeln gelten für jeden eingefügten Link:

• Nur sichere Treffer. Normen werden nur verlinkt, wenn das Gesetz im Zitat genannt ist und die Norm im Bestand existiert. Aktenzeichen nur, wenn sie genau eine Entscheidung bezeichnen. Ein Link von Ihrer Seite führt nie ins Leere.
• Ihr HTML bleibt unangetastet. Es werden ausschließlich Links in Textknoten eingefügt. Bestehende Links, Code-Blöcke, Formulare und Attribute werden nie verändert. Mit data-no-vernetzung nehmen Sie beliebige Bereiche aus.
• Keine Daten über Ihre Leser. Details unter Datenschutz.

Alle Links tragen die Klasse nulegal-cite und lassen sich per CSS an Ihr Design anpassen.

Variante 1: Server-API (empfohlen)

Ihr System sendet den Inhalt eines Beitrags an die API und speichert das Ergebnis. Die Links stehen dann direkt in Ihren ausgelieferten Seiten — das ist die Variante mit dem vollen Nutzen für Ihre Sichtbarkeit in Suchmaschinen.

POST https://gesetze.nulegal.eu/v1/vernetzung
Content-Type: application/json

{"html": "<p>Nach § 823 Abs. 1 BGB haftet, wer …</p>"}

Antwort:

{"html": "<p>Nach <a class=\"nulegal-cite\"
  href=\"https://gesetze.nulegal.eu/gesetze/BGB/823\"
  rel=\"noopener\">§ 823 Abs. 1 BGB</a> haftet, wer …</p>",
 "links": 1, "version": "1.0"}

Für reinen Text ohne HTML senden Sie stattdessen das Feld text; die Antwort ist dann sicher kodiertes HTML.

Zwischenspeichern

Speichern Sie das Ergebnis bei sich (zum Beispiel je Beitrag, mit dem Hash des Inhalts als Schlüssel) und rufen Sie die API nur auf, wenn sich der Inhalt ändert. Das Ergebnis ist deterministisch; eine Woche Speicherdauer ist ein guter Standard. Die API erlaubt 60 Anfragen pro Minute und Absender; darüber antwortet sie mit Status 429. Eingaben sind auf etwa 300.000 Zeichen begrenzt (Status 413) — senden Sie Beiträge einzeln statt ganzer Seitenbäume.

Variante 2: WordPress-Plugin

Für WordPress übernimmt unser Plugin genau diesen Ablauf automatisch: Es verlinkt Beiträge und Seiten bei der Auslieferung über die Server-API und speichert das Ergebnis sieben Tage im WordPress-eigenen Cache. Keine Konfiguration nötig; ist die API einmal nicht erreichbar, erscheint der Beitrag unverändert.

Wenn Sie das Plugin einsetzen möchten, schreiben Sie an hello@nulegal.de — wir schicken es Ihnen.

Variante 3: Einbindungs-Skript

Eine Zeile im Template genügt:

<script src="https://gesetze.nulegal.eu/static/linkify.js" defer></script>

Das Skript (unter 7 kB, keine Abhängigkeiten) verlinkt die Zitate nach dem Laden der Seite direkt im Browser. Es sendet nichts an uns und lädt nichts nach. Mit data-selector=".entry-content" am Script-Tag beschränken Sie es auf einen Seitenbereich; für nachgeladene Inhalte gibt es nulegalVernetzung.run(element).

Zu beachten: Browser-seitig eingefügte Links sind für Suchmaschinen weniger wert als Links, die bereits im ausgelieferten HTML stehen, und das Skript kann nicht gegen den Bestand prüfen — es verlinkt nur eindeutig benannte Bundesgesetze und gerichts-qualifizierte Aktenzeichen über unsere Weiterleitungsseite. Wenn Sie können, nehmen Sie die Server-API oder das Plugin.

Datenschutz

Die Vernetzung braucht keine Daten über Ihre Leser, und wir erheben auch keine. Server-API und Plugin verarbeiten ausschließlich den Beitragstext, im Arbeitsspeicher, ohne Speicherung; es werden keine Cookies gesetzt und keine Kennungen vergeben. Das Einbindungs-Skript arbeitet vollständig im Browser und sendet nichts an uns. Erst wenn jemand einen Link anklickt, entsteht ein normaler Seitenaufruf bei uns wie bei jedem anderen Link auch. Durch die Einbindung selbst fließen also keine personenbezogenen Daten an uns.

Fragen

Antworten zur Datenbank selbst stehen unter Über diese Datenbank, die vollständige API-Dokumentation unter Entwickler. Für alles andere: hello@nulegal.de.