Artikel 1-10, Stilpruefung, Querverweise, Upload-Skript

build/artikel_hochladen.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+"""Laedt alle lokalen artikel/artikel-*.json per Contents-API nach Gitea (neu oder mit sha)."""
+import base64, glob, json, os, sys
+sys.path.insert(0, os.path.dirname(__file__))
+exec(open(os.path.join(os.path.dirname(__file__), 'push_gitea.py'), encoding='utf-8').read().split('def sammle')[0])
+
+for p in sorted(glob.glob('artikel/artikel-*.json')):
+    json.load(open(p, encoding='utf-8'))  # nur gueltiges JSON hochladen
+    inhalt = base64.b64encode(open(p, 'rb').read()).decode()
+    code, d = ruf('GET', f"{REPO}/contents/{p}?ref=main")
+    daten = {'content': inhalt, 'message': f'Artikel {os.path.basename(p)}', 'branch': 'main'}
+    if code == 200:
+        daten['sha'] = d['sha']
+        code, d = ruf('PUT', f"{REPO}/contents/{p}", daten)
+    else:
+        code, d = ruf('POST', f"{REPO}/contents/{p}", daten)
+    print(code, p, '' if code in (200, 201) else str(d)[:200])

build/gen_wf1.py

@@ -211,9 +211,14 @@ FERTIG = iff("Analyse fertig?", [1780, 420],
 link(ABFRAGE, FERTIG, out=0)
 
 ZAEHLEN = code("Versuch zaehlen", [1780, 660], """
+// Zaehler je Query in den Workflow-Daten. $runIndex zaehlt ueber alle Artikel
+// eines Laufs hinweg und taugt deshalb nicht als Zaehler pro Artikel.
 const poll = $('Poll vorbereiten').first().json;
 const antwort = $input.first().json;
-const versuch = (poll.versuch || 0) + $runIndex + 1;
+const sd = $getWorkflowStaticData('global');
+sd.poll = sd.poll || {};
+sd.poll[poll.query] = (sd.poll[poll.query] || 0) + 1;
+const versuch = sd.poll[poll.query];
 return [{ json: { ...poll, versuch, letzter_status: antwort.status || 'unbekannt' } }];
 """)
 link(FERTIG, ZAEHLEN, out=1)
@@ -225,6 +230,7 @@ link(ZAEHLEN, LIMIT)
 
 TIMEOUT = code("Timeout melden", [2220, 780], """
 const a = $input.first().json;
+{ const sd = $getWorkflowStaticData('global'); if (sd.poll) delete sd.poll[a.query]; }
 return [{ json: { slug: a.slug, keyword: a.keyword, query: a.query, ergebnis: 'fehler',
   stufe: 'poll-timeout',
   meldung: 'NeuronWriter-Analyse fuer "' + a.keyword + '" war nach ' + a.versuch
@@ -242,6 +248,7 @@ BRIEF = code("Brief bauen", [2220, 300], r"""
 // Feldnamen stammen aus einer echten /get-query-Antwort, siehe docs/feldnachweis.md
 const a = $('Poll vorbereiten').first().json;
 const n = $input.first().json;
+{ const sd = $getWorkflowStaticData('global'); if (sd.poll) delete sd.poll[a.query]; }
 
 const liste = (arr) => (arr || []).map(x => ({
   begriff: x.t,
@@ -318,6 +325,10 @@ const brief = {
       + 'artikel.cta_ziel mindestens einmal im Fliesstext verlinken, mindestens zwei Business-Links insgesamt. '
       + 'papier-schriftmuster nur ergaenzend. Keine Links auf Privatkunden-Seiten, review, agb, datenschutz, '
       + 'impressum, zahlungsmethoden, lieferung-versand.',
+    querverweise: 'Mindestens zwei, hoechstens vier Querverweise auf verwandte Ratgeberartikel, immer als '
+      + '[ratgeber_link slug="SLUG"]Ankertext[/ratgeber_link], nie als harter Link. Slugs aus artikel-index.json. '
+      + 'Der Shortcode verlinkt erst, wenn der Zielartikel veroeffentlicht ist. Ankertext beschreibt das Ziel, '
+      + 'nie "hier" oder "mehr dazu".',
     bausteine: 'Kein Block "Auch fuer Privatpersonen." und kein Abschnitt "Kostenloses Handschriftmuster '
       + 'anfordern." im Artikeltext, beides liefert das Seitenlayout. Der Artikel endet mit dem letzten '
       + 'inhaltlichen Abschnitt, nie mit einer Zusammenfassung.',

build/pruef_lokal.py

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+"""Lokale Pruefung eines Artikels vor dem Import.
+Aufruf: python3 build/pruef_lokal.py artikel/artikel-SLUG.json [brief.json]"""
+import json, re, subprocess, sys, os
+p = sys.argv[1]
+a = json.load(open(p, encoding='utf-8'))
+idx = json.load(open('artikel-index.json', encoding='utf-8'))
+slugs = {z['slug'] for z in idx}
+bp = sys.argv[2] if len(sys.argv) > 2 else f"build/lokal/briefe/{a['slug']}.json"
+c = a['content_html']
+txt = re.sub(r'\[skrift_preis[^\]]*\]', '3,20 €', c)
+txt = re.sub(r'\[/?ratgeber_link[^\]]*\]', '', txt)
+plain = re.sub(r'\s+', ' ', re.sub(r'<[^>]+>', ' ', txt)).strip()
+w = len(plain.split())
+faqt = ' '.join(f['frage'] + ' ' + f['antwort'] for f in a.get('faq', []))
+voll = (a.get('kurzantwort', '') + ' ' + plain + ' ' + faqt).lower()
+h2 = re.findall(r'<h2>(.*?)</h2>', c); h3 = re.findall(r'<h3>(.*?)</h3>', c)
+print(f"== {a['slug']} | {w} Woerter | H2 {len(h2)} | H3 {len(h3)} | Tabellen {c.count('<table')} | FAQ {len(a.get('faq',[]))}")
+probleme = []
+if not 900 <= w <= 1300: probleme.append(f"Laenge {w}")
+if not 4 <= len(h2) <= 6: probleme.append(f"H2 {len(h2)}")
+if any(x.strip()[-1:] not in '.?' for x in h2 + h3): probleme.append("Ueberschrift ohne Punkt/Fragezeichen")
+if len(a['seo_titel']) > 60: probleme.append(f"SEO-Titel {len(a['seo_titel'])}")
+if len(a['seo_beschreibung']) > 155: probleme.append(f"Meta {len(a['seo_beschreibung'])}")
+if 'Skrift' not in a['kurzantwort']: probleme.append("Skrift fehlt in Kurzantwort")
+if not a.get('faq_ueberschrift'): probleme.append("faq_ueberschrift fehlt")
+if re.search('[–—]', c + a['kurzantwort'] + faqt): probleme.append("Gedankenstrich")
+if re.search(r'\bich\b', plain, re.I): probleme.append("Ich-Form")
+for s in re.findall(r'\[ratgeber_link slug="([^"]+)"', c):
+    if s not in slugs: probleme.append(f"unbekannter Slug {s}")
+if a['slug'] in ('kaltakquise-per-brief',) and 'Keine Rechtsberatung: Dieser Beitrag gibt den Stand unserer Praxiserfahrung wieder' not in plain:
+    probleme.append("Disclaimer fehlt")
+if os.path.exists(bp):
+    b = json.load(open(bp, encoding='utf-8'))
+    fehlt = [f"{x['begriff']}({x['min']})" for x in b['begriffe_pflicht'] if voll.count(x['begriff'].lower()) < (x['min'] or 1)]
+    print(f"   Pflichtbegriffe: {len(b['begriffe_pflicht'])-len(fehlt)}/{len(b['begriffe_pflicht'])}  fehlt: {', '.join(fehlt) or '-'}")
+    print(f"   Zielwortzahl NW {b['wortzahl_ziel']}")
+r = subprocess.run(['node', 'build/stiltest.js', p], capture_output=True, text=True)
+hin = [l for l in r.stdout.splitlines()[1:] if 'Kein Praxiswissen' not in l]
+for l in hin: print('  ', l.strip()[:190])
+for x in probleme: print('   PROBLEM:', x)
+if not hin and not probleme: print('   sauber')

build/push_gitea.py

@@ -10,7 +10,7 @@ import base64, json, os, sys, urllib.request, urllib.error
 
 # Von den Workflows gepflegt, nie von hier ueberschreiben:
 NICHT_UEBERSCHREIBEN = {'artikel-index.json', 'status-importe.json'}
-NICHT_UEBERSCHREIBEN_ORDNER = ('briefe/', 'nachbessern/', 'artikel/')
+NICHT_UEBERSCHREIBEN_ORDNER = ('briefe/', 'nachbessern/', 'artikel/', 'build/lokal/')
 AUS_ORDNER = {'.git', 'node_modules', '__pycache__'}
 AUS_DATEIEN = {'.env'}
 

build/stilpruefung.js

@@ -116,6 +116,14 @@ function stilpruefung(artikel) {
   // Bausteine, die das Seitenlayout bereits liefert
   if (/Auch für Privatpersonen/i.test(html)) add('Baustein doppelt: "Auch für Privatpersonen."', 'Block aus dem Artikeltext entfernen, er steht im Seitenlayout');
   if (/<h[23][^>]*>[^<]*(Muster anfordern|Handschriftmuster)/i.test(html)) add('Baustein doppelt: Muster-CTA', 'Abschnitt "Kostenloses Handschriftmuster anfordern." entfernen, er steht im Seitenlayout');
+  // Querverweise auf andere Ratgeberartikel
+  const quer = [...html.matchAll(/\[ratgeber_link\s+slug="([^"]+)"\]([\s\S]*?)\[\/ratgeber_link\]/g)];
+  if (quer.length < 2) add('Querverweise: zu wenige', `${quer.length} [ratgeber_link], mindestens 2 auf verwandte Ratgeberartikel`);
+  quer.filter(q => q[1] === artikel.slug).forEach(() => add('Querverweis auf sich selbst', artikel.slug));
+  quer.filter(q => !q[2].trim()).forEach(q => add('Querverweis ohne Ankertext', q[1]));
+  (html.match(/href="https?:\/\/(www\.)?skrift\.de\/(?!handgeschriebene-|unterschriftenservice|automatisierte-follow-ups|papier-schriftmuster|kontakt|handschrift-fuer)[a-z0-9-]+\/?"/g) || [])
+    .forEach(h => add('Ratgeber-Link als harter Link', `${h} als [ratgeber_link slug="..."] setzen, sonst droht ein toter Link`));
+
   const unbekannt = [...new Set(slugs.filter(s => s && !BUSINESS.includes(s) && !NEUTRAL.includes(s) && !PRIVAT.includes(s)))];
   unbekannt.forEach(s => add('Links: kein Linkziel fuer Ratgeber', `/${s}/ (z. B. Dankeseite, Rechtstexte)`));
 

wordpress/skrift-ratgeber-felder.php

@@ -2,7 +2,7 @@
 /**
  * Plugin Name: Skrift Ratgeber Felder
  * Description: Meta-Felder fuer Ratgeberartikel (kurzantwort, faq, faq_ueberschrift, cta_ziel, stand_datum) mit Eingabebox im Editor, Shortcodes, Elementor-Widgets fuer FAQ und Kurzantwort sowie Dynamic Tags fuer Lesezeit, FAQ-Ueberschrift und Stand.
- * Version: 1.3.0
+ * Version: 1.4.0
  * Author: Lucas Orth
  *
  * Ablage: wp-content/mu-plugins/skrift-ratgeber-felder.php
@@ -362,6 +362,39 @@ add_shortcode( 'skrift_faq', function ( $atts ) {
 	) );
 } );
 
+/**
+ * Querverweis auf einen anderen Ratgeberartikel.
+ * [ratgeber_link slug="kaltakquise-per-brief"]Ankertext[/ratgeber_link]
+ * Veroeffentlichter Zielbeitrag: normaler Link auf den aktuellen Permalink.
+ * Noch nicht veroeffentlicht: nur der Ankertext, damit kein toter Link entsteht.
+ * Wer den Beitrag bearbeiten darf, sieht in der Vorschau einen gestrichelten
+ * Hinweis auf den noch fehlenden Zielartikel.
+ */
+add_shortcode( 'ratgeber_link', function ( $atts, $inhalt = '' ) {
+	$atts  = shortcode_atts( array( 'slug' => '' ), $atts, 'ratgeber_link' );
+	$slug  = sanitize_title( $atts['slug'] );
+	$text  = '' !== trim( (string) $inhalt ) ? do_shortcode( $inhalt ) : $slug;
+	if ( '' === $slug ) {
+		return $text;
+	}
+	$ziel = get_posts( array(
+		'name'             => $slug,
+		'post_type'        => 'post',
+		'post_status'      => array( 'publish', 'draft', 'pending', 'future', 'private' ),
+		'numberposts'      => 1,
+		'suppress_filters' => true,
+	) );
+	if ( $ziel && 'publish' === $ziel[0]->post_status ) {
+		return '<a href="' . esc_url( get_permalink( $ziel[0] ) ) . '">' . $text . '</a>';
+	}
+	if ( is_user_logged_in() && current_user_can( 'edit_posts' ) ) {
+		$status = $ziel ? $ziel[0]->post_status : 'fehlt';
+		return '<span class="skrift-ratgeber-link--offen" title="Zielartikel ' . esc_attr( $slug )
+			. ' (' . esc_attr( $status ) . ')" style="border-bottom:1px dashed currentColor">' . $text . '</span>';
+	}
+	return $text;
+} );
+
 add_shortcode( 'skrift_kurzantwort', function ( $atts ) {
 	$atts = shortcode_atts( array( 'post_id' => 0 ), $atts, 'skrift_kurzantwort' );
 	return skrift_kurzantwort_html( $atts['post_id'] );