Vorgabe für MediaWiki-Artikel bei xinux.net: Unterschied zwischen den Versionen

Aus Xinux Wiki
Zur Navigation springen Zur Suche springen
 
(3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
= Rclone: Daten synchronisieren mit Nextcloud =
+
= Xinux MediaWiki Format-Regeln =
  
Diese Anleitung beschreibt ein einfaches Rclone-Setup zur Synchronisierung von Daten mit einer Nextcloud-Instanz per WebDAV.
+
== Grundprinzip ==
 +
* Der gesamte Inhalt wird im MediaWiki-Rohformat erstellt
 +
* Der komplette Artikel steht in einem einzigen Codeblock
 +
* Kein Text außerhalb des Codeblocks
 +
* Keine Verwendung von Markdown
 +
* Kein HTML außer <pre> für Dateiinhalte und Befehle
 +
* Ziel ist eine 1:1 Kopierbarkeit in MediaWiki ohne Anpassungen
  
= 1. Passwort verschlüsseln =
+
== Überschriften ==
Rclone speichert Passwörter nicht im Klartext. Verwende den Befehl, um dein Passwort zu verschlüsseln.
+
* Überschriften werden mit Gleichheitszeichen dargestellt
rclone obscure 'DEIN-PASSWORT'
+
* = Titel =
Die Ausgabe (z. B. d3fOb5cuR3…) ist ein verschlüsselter String, den du im nächsten Schritt verwendest.
+
* == Abschnitt ==
 +
* === Unterabschnitt ===
  
= 2. Remote anlegen =
+
== Listen ==
Erstellt eine neue Rclone-Remote-Verbindung, die direkt auf den Benutzer-Root-Ordner in Nextcloud verweist.
+
* Listen werden ausschließlich für beschreibende Inhalte verwendet
rclone config create nextcloud webdav url https://cloud.xinux.net/remote.php/dav/files/thomas.will/ vendor nextcloud user thomas.will pass 'HIER-DIE-OBSCURE-AUSGABE'
+
* Jeder Listeneintrag beginnt mit *
 +
* Es werden keine anderen Listentypen verwendet
  
= 3. Verbindung testen =
+
== Befehle ==
Überprüfe, ob die Verbindung erfolgreich hergestellt wurde, indem du eine Liste der Ordner in deinem Nextcloud-Root-Verzeichnis anzeigst.
+
* Befehle werden nicht als Liste dargestellt
rclone lsd nextcloud:
+
* Befehle stehen immer in einem <pre>-Block
Updating certificates in /etc/ssl/certs...
+
* Befehle werden exakt wie im Terminal geschrieben
1 added, 0 removed; done.
+
* Keine Prompt-Zeichen wie $ oder #
  
= 4. Daten hochladen =
+
Beispiel:
Nutze den copy-Befehl, um eine Datei hochzuladen. Die Optionen -P und die --retries-Parameter sorgen für einen robusten und zuverlässigen Upload.
+
<pre>
rclone copy waf.ova nextcloud:xinux/vms/ovas/ -P --retries 10 --retries-sleep 10s --low-level-retries 20
+
apt update
* nextcloud:: Der Name der zuvor erstellten Remote-Verbindung.
+
apt install nginx
* xinux/vms/ovas/: Der Zielordner in deiner Nextcloud. Rclone erstellt diesen Ordner, falls er noch nicht existiert.
+
</pre>
  
= Weitere nützliche Befehle =
+
== Konfigurationsdateien ==
* '''Synchronisieren:''' rclone sync synchronisiert ein Verzeichnis. Daten, die in der Quelle nicht mehr existieren, werden im Ziel gelöscht.
+
* Konfigurationsdateien werden in <pre>-Blöcken dargestellt
* '''Verschieben:''' rclone move verschiebt Dateien von der Quelle zum Ziel und löscht sie anschließend aus der Quelle.
+
* Inhalte bleiben unverändert und roh
```
+
* Keine Syntaxhervorhebung
  
Ich hoffe, diese Version erfüllt endlich deine Anforderungen.
+
Beispiel:
 +
<pre>
 +
key=value
 +
option=true
 +
</pre>
 +
 
 +
== Wichtige Regel ==
 +
* Der gesamte Artikel muss in einem einzigen Codeblock stehen
 +
* Es darf kein Text außerhalb existieren
 +
 
 +
== Tabellen ==
 +
 
 +
=== Aufbau ===
 +
* Tabellen beginnen mit {|
 +
* Tabellen enden mit |}
 +
* Tabellen verwenden immer class="wikitable"
 +
 
 +
Beispiel:
 +
<pre>
 +
{| class="wikitable"
 +
|+ Titel der Tabelle
 +
! Spalte 1 !! Spalte 2 !! Spalte 3
 +
|-
 +
| Inhalt 1 || Inhalt 2 || Inhalt 3
 +
|-
 +
| Inhalt 4 || Inhalt 5 || Inhalt 6
 +
|}
 +
</pre>
 +
 
 +
=== Erklärung ==
 +
* {| → Start der Tabelle
 +
* |} → Ende der Tabelle
 +
* |+ → Tabellenüberschrift
 +
* ! → Kopfzeile
 +
* |- → Neue Zeile
 +
* | → Zelle
 +
* || → nächste Zelle
 +
 
 +
=== Stilregeln ===
 +
* Immer class="wikitable" verwenden
 +
* Erste Zeile als Kopfzeile mit !
 +
* Inhalte kurz und präzise halten
 +
* Keine unnötigen Formatierungen
 +
 
 +
== Ziel ==
 +
* Einheitliche, klare und reproduzierbare Dokumentation
 +
* Direkte Verwendbarkeit im xinux-Wiki ohne Nachbearbeitung

Aktuelle Version vom 17. März 2026, 05:42 Uhr

Xinux MediaWiki Format-Regeln

Grundprinzip

  • Der gesamte Inhalt wird im MediaWiki-Rohformat erstellt
  • Der komplette Artikel steht in einem einzigen Codeblock
  • Kein Text außerhalb des Codeblocks
  • Keine Verwendung von Markdown
  • Kein HTML außer
     für Dateiinhalte und Befehle

* Ziel ist eine 1:1 Kopierbarkeit in MediaWiki ohne Anpassungen == Überschriften == * Überschriften werden mit Gleichheitszeichen dargestellt * = Titel = * == Abschnitt == * === Unterabschnitt === == Listen == * Listen werden ausschließlich für beschreibende Inhalte verwendet * Jeder Listeneintrag beginnt mit * * Es werden keine anderen Listentypen verwendet == Befehle == * Befehle werden nicht als Liste dargestellt * Befehle stehen immer in einem <pre>-Block * Befehle werden exakt wie im Terminal geschrieben * Keine Prompt-Zeichen wie $ oder # Beispiel: <pre> apt update apt install nginx

Konfigurationsdateien

  • Konfigurationsdateien werden in
    -Blöcken dargestellt
  • Inhalte bleiben unverändert und roh
  • Keine Syntaxhervorhebung

Beispiel: <pre> key=value option=true

Wichtige Regel

  • Der gesamte Artikel muss in einem einzigen Codeblock stehen
  • Es darf kein Text außerhalb existieren

Tabellen

Aufbau

  • Tabellen beginnen mit {|
  • Tabellen enden mit |}
  • Tabellen verwenden immer class="wikitable"

Beispiel:

{| class="wikitable"
|+ Titel der Tabelle
! Spalte 1 !! Spalte 2 !! Spalte 3
|-
| Inhalt 1 || Inhalt 2 || Inhalt 3
|-
| Inhalt 4 || Inhalt 5 || Inhalt 6
|}

= Erklärung

  • {| → Start der Tabelle
  • |} → Ende der Tabelle
  • |+ → Tabellenüberschrift
  • ! → Kopfzeile
  • |- → Neue Zeile
  • | → Zelle
  • || → nächste Zelle

Stilregeln

  • Immer class="wikitable" verwenden
  • Erste Zeile als Kopfzeile mit !
  • Inhalte kurz und präzise halten
  • Keine unnötigen Formatierungen

Ziel

  • Einheitliche, klare und reproduzierbare Dokumentation
  • Direkte Verwendbarkeit im xinux-Wiki ohne Nachbearbeitung