Texteditor #

Der Texteditor öffnet Textdateien direkt im Browser und speichert Änderungen in die Datei zurück. Neue Textdateien legen Anwender über das Menü + der Dateiliste an. Grundlage ist der Editor Ace mit Syntaxhervorhebung.

Voraussetzungen #

Weitere Dienste braucht die App nicht.

Installation #

Im App-Menü Markt öffnen, Text Editor suchen und Installieren wählen. Auf der Kommandozeile:

# App aus dem Marktplatz installieren, dabei wird sie eingeschaltet
sudo -u www-data php8.4 occ market:install files_texteditor

# nur nötig, wenn die App schon vorhanden, aber ausgeschaltet ist
sudo -u www-data php8.4 occ app:enable files_texteditor

Einrichtung #

Die App hat keine Einstellungsseite, keine Konfigurationsschlüssel und keine eigenen occ-Befehle. Fest im Code stehen:

Wer eine Datei bearbeiten darf, ergibt sich aus den normalen Rechten. Ohne Schreibrecht, etwa bei einer Freigabe ohne Bearbeitungsrecht, öffnet der Editor die Datei nur lesend.

Nutzung #

• Öffnen: Ein Klick auf eine Textdatei öffnet den Editor. Im Menü … der Datei heißt der Eintrag In Texteditor öffnen.
• Neue Datei: + und dann Textdatei. Die Datei heißt zunächst Neue Textdatei.txt und öffnet sich sofort im Editor. Der Eintrag fehlt in der Ansicht öffentlicher Links.
• Speichern: automatisch drei Sekunden nach der letzten Änderung, sofort mit Strg+S oder Cmd+S. Ein Sternchen neben dem Dateinamen zeigt ungespeicherte Änderungen.
• Schließen: über das Kreuz rechts in der Leiste über dem Editor. Erst dabei gibt der Editor die Sperre auf der Datei frei.
• Öffentliche Links: Der Editor arbeitet auch dort, wenn der Link Schreibrechte hat. Bei Links mit Passwort muss das Passwort in derselben Sitzung schon eingegeben worden sein.

Textdateien wie .txt und .md öffnen und bearbeiten Sie direkt im Browser.

Welche Dateien sich öffnen lassen #

Maßgeblich ist der MIME-Typ, den owncloud.online der Datei zuordnet. Der Editor öffnet alle Typen, die mit text/ beginnen, dazu JSON, XML, YAML, JavaScript, PHP und leere Dateien. Die Syntaxhervorhebung richtet sich nach der Dateiendung, zum Beispiel md, json, xml, html, css, js, php, py, sh oder sql. Für andere Endungen öffnet der Editor die Datei ohne Hervorhebung.

Gleichzeitiges Bearbeiten #

Der Texteditor ist kein Mehrbenutzer-Editor. Zwei Personen bearbeiten eine Datei nacheinander, nicht gemeinsam:

1. Sperre beim Öffnen: Wer eine Datei öffnet, sperrt sie, sofern der Speicher dauerhafte Sperren unterstützt. Andere bekommen sie nur lesend, mit dem Hinweis „Datei ist schreibgeschützt, blockiert von …“ und dem Namen der sperrenden Person.
2. Prüfung beim Speichern: Hat sich die Datei seit dem Öffnen geändert, speichert der Editor nicht und meldet „Die Datei konnte nicht gespeichert werden, weil sie seit dem Öffnen verändert worden ist“. Fremde Änderungen werden so nicht überschrieben.

Grenzen und Hinweise #

• Dateien über 4 MiB weist der Server ab: „Diese Datei ist zu groß. Bitte lade die Datei stattdessen herunter.“ Die Grenze lässt sich nicht ändern.
• Dateien in anderen Kodierungen, etwa Windows-1252 oder ISO-8859-1, zeigt der Editor nach UTF-8 umgerechnet an, öffnet sie aber nur lesend. So verändert die Umrechnung die Datei nicht.
• Schließt jemand den Browser-Tab statt des Editors, warnt der Browser vorher. Wird die Warnung übergangen, bleibt die Sperre bestehen, bis sie abläuft.

Fehlersuche #

Fehler auf dem Server protokolliert die App unter dem Namen files_texteditor, siehe Serverprotokoll und Fehlermeldungen.