Sie wurden soeben entmündigt

Bevor Sie sich jetzt wundern: 'deconfluencing' ist kein Wort, das Sie im Merriam Webster nachschlagen können. Vielleicht sollte es das sein. Auf jeden Fall ist es etwas, das ich brauchte und schließlich selbst kreiert habe.

Was sagen Sie? Waren Sie schon einmal in einer Situation, in der Sie viele nützliche Inhalte in Confluence hatten, aber nicht unbedingt wollten, dass diese als Confluence-Website veröffentlicht werden, mit all dem Schnickschnack, den diese bietet. In diesem Fall könnte der Deconfluencer genau das Richtige für Sie sein. Der Deconfluencer tut genau das, was sein Name vermuten lässt. Er nimmt einen Confluence-Bereich und veröffentlicht ihn neu, wobei er alles entfernt, was Sie nicht wollen, und die Teile neu schreibt, die Sie neu geschrieben haben wollen.Lassen Sie uns ein Beispiel betrachten. Nehmen wir an, dies ist Ihre Confluence-Seite:

Dann könnte der Deconfluencer es in etwas wie dieses verwandeln:

Gleicher Inhalt, nur anders gerendert. Wie funktioniert das? Der Deconfluencer ist einfach ein Reverse Proxy mit einer eingebauten Transformationslogik. (Und einigen anderen Funktionen, die bei der Wiederveröffentlichung von Confluence-Inhalten nützlich sind.) Es ist kein Krieg. Es handelt sich lediglich um ein Kommandozeilen-Tool, das - einmal gestartet - auf einem bestimmten Port lauscht, eingehende Anfragen an Confluence weiterleitet und die Ergebnisse umwandelt, bevor es sie an den Browser zurücksendet. Mir gefällt Ihr Erscheinungsbild nicht Nun, das ist richtig. Das Gute daran ist, dass Sie die Confluence-Seite nach Belieben umgestalten können. Wenn Sie eine Deconfluencer-Distribution entpacken, finden Sie ein conf-Verzeichnis mit einer filter.xsl-Datei und ein resources-Verzeichnis mit statischen Ressourcen wie CSS und Bildmaterial. Um mit letzterem zu beginnen: Wenn Sie nur das CSS ändern wollen, dann ändern Sie einfach die Datei style.css, und schon sind Sie fertig. Wenn Sie jedoch etwas kompliziertere Änderungen vornehmen möchten, müssen Sie die Datei filter.xsl anpassen. Die XSLT-Vorlage filter.xsl wird verwendet, um die aus Confluence kommende Seite in die resultierende Seite zu verwandeln. Diese Datei erzeugt einen Seitenkopf, der auf die Ressourcen im oben erwähnten Ressourcenverzeichnis verweist. Sie enthält jedoch auch einige grundlegende Vorlagen, um Inhalte herauszufiltern, die Sie wahrscheinlich nicht sehen möchten. Um eine HTML-Seite mit XSLT umwandeln zu können, wandelt der Deconfluencer zunächst das eingehende XML in ein DOM um. Das hört sich nach einer mühsamen Übung an Nun, es mag so klingen, aber das ist es wirklich nicht. Sobald Sie den Deconfluencer gestartet haben, können Sie die Datei filter.xsl einfach im laufenden Betrieb aktualisieren und die Ergebnisse sofort nach dem Klick auf die Schaltfläche Aktualisieren überprüfen. Seien Sie versichert, dass der Deconfluencer die Vorlage nicht bei jeder Anfrage aus dem Dateisystem lädt. Stattdessen überwacht er das Verzeichnis conf und lädt die Datei filter.xsl nur dann neu, wenn die Datei geändert wurde. Vorhandene Dateien überschreiben? Das möchte ich nicht tun! Dann tun Sie es nicht. Das müssen Sie auch nicht. Sie können den deconfluencer auch starten und ihn auf alternative Orte verweisen. Starten Sie den Deconfluencer einfach ohne Optionen, und er wird Ihnen sagen, welche Optionen Sie verwenden müssen. Nur der Einfachheit halber: Dies sind die Befehlszeilenparameter, die er derzeit unterstützt:

  -b BASE URL : Die Basis-URL des URL-Bereichs, den wir dekonfigurieren möchten.
  -f FILTER : Der Ort, an dem der XSLT-Filter angewendet werden soll. (Der Standardwert ist con 
  f/filter.xsl.)
  -n PORTNUMMER : Die Portnummer, auf der der Reverse-Proxy ausgeführt wird (8082)
  -o NAME=VALUE : Parameter, die an die Transformation übergeben werden
  -p PASSWORT : Das Passwort, mit dem Sie sich bei Confluence authentifizieren.
  -s PATH : Ort, der für die Bereitstellung statischer Ressourcen verwendet werden soll. (Standardmäßig auf 
  Ressourcen/.)
  -u USERNAME : Der Benutzername, mit dem Sie sich bei Confluence authentifizieren.
  -v : Ausführlicher Modus. Protokollierung der Daten in std err. 

Genug davon; wo kann ich es finden? Das Deconfluencer-Projekt wird auf Github gehostet (github.com/xebia/deconfluencer). Sie können die Quellen herunterladen und das Projekt von Grund auf neu erstellen. Allerdings muss ich Sie warnen, dass JNotify nicht in einem der zentralen Maven-Repositories aufgeführt ist, so dass Sie es wahrscheinlich selbst installieren müssen. Alternativ können Sie eine Distribution direkt von Github herunterladen, indem Sie Ihren Browser hierher leiten: github.com/downloads/xebia/deconfluencer/deconfluencer-1.0-SNAPSHOT-dist.tar.gz. Was fehlt noch? Es gibt sicherlich einige Dinge, die verbessert werden könnten. Zum Beispiel geht es derzeit nicht sinnvoll mit Anhängen um. Das hat zur Folge, dass Bilder, die Sie auf Ihrer Confluence-Seite haben, höchstwahrscheinlich nicht korrekt angezeigt werden. Es ist keine große Überarbeitung erforderlich, aber es ist sicherlich etwas, das man gerne hätte. Was halten Sie nun von all dem? Klingt das sinnvoll? Sehen Sie andere Verwendungszwecke dafür? Schreiben Sie einen Kommentar oder - noch besser - forken Sie das Projekt einfach selbst.