Markdown zu LinuxUser Format Converter

Ein Python-Tool zur Konvertierung von Markdown-Dokumenten in das spezielle Textformat des LinuxUser-Magazins.

Features

• ✅ Vollständige Konvertierung von Markdown zu LinuxUser-Format
• ✅ Grafische Benutzeroberfläche mit Live-Vorschau
• ✅ Kommandozeilen-Interface für Automatisierung
• ✅ Unterstützung aller wichtigen LinuxUser-Tags
• ✅ Erhaltung der Textformatierung
• ✅ Automatische Typografie-Verbesserungen

Installation

Voraussetzungen

• Python 3.6 oder höher
• tkinter (für die GUI-Version)

# Debian/Ubuntu
sudo apt install python3 python3-tk

# Fedora
sudo dnf install python3 python3-tkinter

# Arch
sudo pacman -S python tk

Verwendung

GUI-Version

Starten Sie die grafische Oberfläche:

python3 converter_gui.py

Features der GUI:

• Drag & Drop von Markdown-Dateien
• Live-Vorschau während der Eingabe
• Referenz-Tab mit allen LinuxUser-Konventionen
• Export in Zwischenablage
• Syntax-Highlighting (optional)

Kommandozeilen-Version

Für die Batch-Verarbeitung oder Integration in Workflows:

# Einfache Konvertierung
python3 markdown_to_linuxuser.py artikel.md

# Mit Ausgabedatei
python3 markdown_to_linuxuser.py artikel.md -o ausgabe.txt

# Mit Vorschau
python3 markdown_to_linuxuser.py artikel.md -p

# Verbose-Modus
python3 markdown_to_linuxuser.py artikel.md -v

Kommandozeilen-Optionen

• input_file: Pfad zur Markdown-Eingabedatei (erforderlich)
• -o, --output: Ausgabedatei (Standard: input_file_linuxuser.txt)
• -p, --preview: Zeigt Vorschau vor dem Speichern
• -v, --verbose: Detaillierte Ausgabe mit Statistiken

LinuxUser Format-Referenz

Hauptelemente

Tag	Beschreibung	Markdown-Äquivalent
@V:	Vorspann/Teaser	# Hauptüberschrift
@L:	Absatz	Normaler Text
@ZT:	Zwischentitel	## Überschrift
@KT:	Kastentext	#### Überschrift oder > Blockquote
@BI:	Bildunterschrift	
@LI:	Listing	```code```
@IT:	Infotabelle	Markdown-Tabellen

Inline-Formatierung

Format	LinuxUser	Markdown
Code	<C>code</C>	`code`
Kursiv	<I>text</I>	*text* oder _text_
Tasten	[Strg]+[C]	Automatisch erkannt

Sonderzeichen

Der Converter wandelt automatisch um:

• Bindestriche zu Gedankenstrichen (—)
• Einfache zu deutschen Anführungszeichen („")
• Fügt geschützte Leerzeichen ein (**)
• Tausendertrennzeichen (:*)

Beispiele

Eingabe (Markdown)

# Mein Linux-Artikel

Dies ist die Einleitung mit `inline code` und *kursivem Text*.

## Installation

Führen Sie folgenden Befehl aus:

```bash
sudo apt install programm

Wichtiger Hinweis: Sichern Sie Ihre Daten!

### Ausgabe (LinuxUser-Format)

@@ LinuxUser-Artikel @@ Konvertiert am: 2024-11-08 12:00 @@ Encoding: UTF-8

@V:Mein Linux-Artikel

@L:Dies ist die Einleitung mit inline code und kursivem Text.

@ZT:Installation

@L:Führen Sie folgenden Befehl aus:

@LI:Listing 1 (bash) @LI: sudo apt install programm @LI:

@KT:Wichtiger Hinweis: Sichern Sie Ihre Daten!

@BI:Abbildung 1: Screenshot

@KT:Der Autor @L:[Hier Autoreninformationen einfügen]

@@ Ende des Artikels

## Test-Beispiel

Eine Beispiel-Markdown-Datei `beispiel_artikel.md` ist enthalten, um die Funktionalität zu testen:

```bash
# Testen mit Beispieldatei
python3 markdown_to_linuxuser.py beispiel_artikel.md -p

Erweiterte Nutzung

Als Python-Modul

Sie können den Converter auch in eigenen Python-Skripten verwenden:

from markdown_to_linuxuser import MarkdownToLinuxUserConverter

converter = MarkdownToLinuxUserConverter()

markdown_text = "# Mein Artikel\n\nInhalt..."
linuxuser_text = converter.convert(markdown_text)

print(linuxuser_text)

Batch-Verarbeitung

#!/bin/bash
# Alle .md-Dateien im Ordner konvertieren

for file in *.md; do
    echo "Konvertiere $file..."
    python3 markdown_to_linuxuser.py "$file"
done

Bekannte Einschränkungen

• Verschachtelte Listen werden vereinfacht
• Komplexe Tabellen können manuell nachbearbeitet werden müssen
• Fußnoten werden nicht unterstützt
• HTML-Inhalte in Markdown werden entfernt

Tipps für beste Ergebnisse

1. Strukturierung: Verwenden Sie klare Überschriftenhierarchien
2. Code-Blöcke: Geben Sie immer die Sprache an (python, bash, etc.)
3. Bilder: Verwenden Sie aussagekräftige Alt-Texte
4. Tabellen: Halten Sie Tabellen einfach und übersichtlich
5. Nachbearbeitung: Prüfen Sie Autorenbox und Meta-Informationen

Fehlerbehebung

"tkinter nicht gefunden"

Installieren Sie tkinter:

sudo apt install python3-tk

Encoding-Probleme

Stellen Sie sicher, dass Ihre Markdown-Datei UTF-8 kodiert ist:

file -bi artikel.md
iconv -f ISO-8859-1 -t UTF-8 artikel.md > artikel_utf8.md

Lizenz

Dieses Tool steht unter der MIT-Lizenz zur freien Verfügung.

Support

Bei Fragen oder Problemen erstellen Sie gerne ein Issue oder kontaktieren Sie den Autor.

---

Hinweis: Dieses Tool wurde speziell für die Konventionen des LinuxUser-Magazins entwickelt. Die genauen Formatierungsrichtlinien können sich ändern. Prüfen Sie die Ausgabe vor der Einreichung beim Verlag.