diff --git a/book.toml b/book.toml index b9650b2..1e88e15 100644 --- a/book.toml +++ b/book.toml @@ -20,7 +20,7 @@ level = 0 [output.linkcheck] # Should we check links on the internet? Enabling this option adds a # non-negligible performance impact -follow-web-links = false +follow-web-links = true # Are we allowed to link to files outside of the book's root directory? This # may help prevent linking to sensitive files (e.g. "../../../../etc/shadow") diff --git a/src/Einleitung/WerStehtDahinter.md b/src/Einleitung/WerStehtDahinter.md index 02dd7aa..dc41bb9 100644 --- a/src/Einleitung/WerStehtDahinter.md +++ b/src/Einleitung/WerStehtDahinter.md @@ -1,21 +1,25 @@ Wer dahinter steht ================== -Entscheidungen --------------- - Grundsätzlich sind es die beteiligten Museen und ihre Verbände, die das Geschehen von museum-digital lenken. Jedes Museum ist für seine eigenen Beiträge (und Einträge) verantwortlich. Diese Beiträge gestaltet das Museum mit den entsprechenden Werkzeugen von museum-digital in der -regionalen (oder thematischen) Version, der es zugeordnet ist. Jede -regionale (oder thematische) Version von museum-digital hat andere -Betreuer:innen -- zumeist sind dies die regionalen Museumsverbände oder -Landesstellen für Museumsbetreuung. Die deutschlandweite Version von -museum-digital entsteht aus den regionalen (und thematischen) Versionen -(halb-) automatisch. +regionalen (oder thematischen) Version, der es zugeordnet ist. -![Die AG Digitalisierung trifft sich in Quedlinburg](../assets/chapter_1-2/agdib_quedlinburg_800.jpg) +## Betreuer + +Jede regionale (oder thematische) Version von museum-digital hat andere +Betreuer:innen - zumeist sind dies die regionalen Museumsverbände oder +Landesstellen für Museumsbetreuung. [Eine Liste der für die verschiedenen +deutschen Regionen zuständigen Betreuer](https://nat.museum-digital.de/contact) +kann in der deutschlandweiten Instanz von museum-digital eingesehen werden. + +Als mittlerweile internationales Projekt haben sich in anderen Ländern andere +Organisationsstrukturen herausgebildet. In Ungarn etwa gibt es ein zentrales Team +von Betreuern. + +## Entscheidungen Weitere Entwicklungen bei museum-digital geschehen auf Anregung aus den Museen oder ihren Verbänden. Grundsätzliche Änderungen, d.h. Änderungen, die @@ -26,10 +30,4 @@ zum Tragen kommen und andere Versionen nicht tangieren, werden dann umgesetzt, wenn die entsprechenden Versions-Betreuer es für nötig halten. -Alle konzeptuellen Änderungen (z.B. Aufnahme privater Sammlungen in das -Verzeichnis) werden in der AG Digitalisierung des Museumsverbandes -Sachsen-Anhalt diskutiert und entschieden. - -[**\> Hier geht es zur aktuelle -Kontakteliste.**](https://nat.museum-digital.de/index.php?t=kontakt) - +![Die AG Digitalisierung trifft sich in Quedlinburg](../assets/chapter_1-2/agdib_quedlinburg_800.jpg) diff --git a/src/SUMMARY.md b/src/SUMMARY.md index bfd05cd..d915312 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -43,13 +43,13 @@ # musdb - [musdb](./musdb/README.md) - - [Benutzerkonto]() + - [Benutzerkonto](./musdb/Benutzerkonto/README.md) - [Zugang erhalten](./musdb/Benutzerkonto/Zugang-erhalten.md) - [Nutzerrollen und -Rechte](./musdb/Benutzerkonto/Berechtigungen.md) - [Neue Benutzer hinzufügen](./musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md) - [Einstellungen (Privat)](./musdb/Benutzerkonto/Einstellungen.md) - - [Kontoeinstellungen und Sicherheit]() - - [Benutzerprofil]() + - [Kontoeinstellungen und Sicherheit](./musdb/Benutzerkonto/Kontoeinstellungen-Sicherheit.md) + - [Benutzerprofil](./musdb/Benutzerkonto/Profil.md) - [Benutzeroberfläche]() - [Navigationsleiste](./musdb/UI/Navigationsleiste.md) - [Übersichts-Suche]() diff --git a/src/assets/musdb/login/musdb-Login.jpg b/src/assets/musdb/login/musdb-Login.jpg new file mode 100644 index 0000000..b09d5b6 Binary files /dev/null and b/src/assets/musdb/login/musdb-Login.jpg differ diff --git a/src/musdb/Benutzerkonto/Kontoeinstellungen-Sicherheit.md b/src/musdb/Benutzerkonto/Kontoeinstellungen-Sicherheit.md new file mode 100644 index 0000000..f96eb01 --- /dev/null +++ b/src/musdb/Benutzerkonto/Kontoeinstellungen-Sicherheit.md @@ -0,0 +1 @@ +# Kontoeinstellungen und Sicherheit diff --git a/src/musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md b/src/musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md index 3438a62..2c6dfea 100644 --- a/src/musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md +++ b/src/musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md @@ -12,33 +12,32 @@ Nach dem Anmelden im Eingabe- und Bearbeitungstool von museum-digital erscheint am oberen Rand des Bildschirms eine Symbolleiste. In dieser Symbolleiste findet sich ein Museumssymbol. Wird dieses mit der Maus überfahren öffnet sich ein kleines Menü mit Unterpunkten. Gleich der -erste dieser Menüpunkte heißt \"Benutzer\". Der Bezeichnung des -Menüpunktes folgt ein Stift (das Symbol für \"Benutzer bearbeiten\") und -ein \"+\" als Symbol für \"Benutzer hinzufügen\". Ein Klick auf dieses +erste dieser Menüpunkte heißt "Benutzer". Der Bezeichnung des +Menüpunktes folgt ein Stift (das Symbol für "Benutzer bearbeiten") und +ein "+" als Symbol für "Benutzer hinzufügen". Ein Klick auf dieses Symbol öffnet das Fenster zum Neueintrag eines Nutzers:``  ![](../../assets/musdb/neuer_nutzer.JPG) Dieses Eingabefenster muss vollständig ausgefüllt werden. Unter -\"Anmeldename\" ist jener Name einzutragen, mit dem der zukünftige +"*Anmeldename*" ist jener Name einzutragen, mit dem der zukünftige Nutzer sich später anmelden muss (er kann ihn nach erfolgter Anmeldung -ändern). In das Feld \"Wirklicher Name\" tragen Sie bitte keinen Alias -sondern den tatsächlichen Namen des zukünftigen Benutzers ein. Um -fortgeschrittene Funktionen wie das Benutzerprofil zu benutzen sollte -der hier eingegbene Name darüber hinaus einzigartig sein. In das Feld -\"Email\" ist unbedingt eine funktionierende Email-Adresse einzutragen, -ohne diese kann das Verfahren nicht abgeschlossen werden. Schließlich -ist eine passende Rolle für den neuen Nutzer zu wählen. +ändern). In das Feld "*Wirklicher Name*" tragen Sie bitte keinen Alias +sondern den tatsächlichen Namen des zukünftigen Benutzers ein. Der hier +eingegbene Name sollte darüber hinaus einzigartig sein. In das Feld +"*e-Mail*" ist unbedingt eine funktionierende e-Mail-Adresse einzutragen, +denn ohne diese kann der Benutzer sein Konto nicht aktivieren. Schließlich +ist eine passende [Benutzerrolle](Berechtigungen.html) für den neuen Nutzer zu wählen. -Sobald alle Felder ausgefüllt und \"Abschicken\" geklickt wurde schickt -das System dem zukünftigen Nutzer eine email. Diese email enthält einen +Sobald alle Felder ausgefüllt und "Abschicken" geklickt wurde, schickt +das System dem zukünftigen Nutzer eine e-Mail. Diese e-Mail enthält einen Link, den der neue Benutzer anklicken (oder in die URL-Zeile kopieren) kann. Folgt der Angeschriebene diesem Link gelangt er auf eine Seite, auf welcher - gemäß DSGVO - erklärt wird, welche Angaben bei -museum-digtial von ihm gespeichert werden. Unten auf dieser Seite kann +museum-digital von ihm gespeichert werden. Unten auf dieser Seite kann er sich selbst ein Passwort vergeben. Mit dem Setzen eines Passwortes und Klick auf Abschicken erklärt sich der neue Nutzer mit der -notwendigen Speicherung seiner email-Adresse einverstanden. Danach ist +notwendigen Speicherung seiner e-Mail-Adresse einverstanden. Danach ist das Konto aktiviert und der neue Nutzer kann sich mit dem ihm vom Einrichtenden vergebenen Anmeldenamen sowie dem von ihm selbst gesetzten Passwort in der entsprechenden Instanz von museum-digital anmelden. @@ -49,4 +48,3 @@ von vorne begonnen werden. Wichtig auch: Ein gültiges Passwort muss **mindestens 8 Zeichen** umfassen und dabei wenigstens ein Sonderzeichen enthalten. -  diff --git a/src/musdb/Benutzerkonto/Profil.md b/src/musdb/Benutzerkonto/Profil.md new file mode 100644 index 0000000..16b5526 --- /dev/null +++ b/src/musdb/Benutzerkonto/Profil.md @@ -0,0 +1 @@ +# Benutzerprofil diff --git a/src/musdb/Benutzerkonto/README.md b/src/musdb/Benutzerkonto/README.md index 243924a..3c00827 100644 --- a/src/musdb/Benutzerkonto/README.md +++ b/src/musdb/Benutzerkonto/README.md @@ -1 +1,25 @@ # Benutzerkonto + +Um musdb benutzen zu können, braucht man zuerst einmal ein Benutzerkonto. +Dieses Kapitel beginnt mit einer Erläuterung, [wie man ein Benutzerkonto bekommt](Zugang-erhalten.md), + +Es folgt eine Beschreibung des [zweistufigen Rechtekonzeptes von musdb](Berechtigungen.md). +Jedem Benutzeraccount ist eine Benutzerrolle zugewiesen, die einerseits bestimmt, +ob der Benutzer andere Benutzeraccounts anlegen und verwalten kann. Andererseits +liefert die Benutzerrolle Voreinstellungen für die Berechtigung, um etwa Objekt-Basisdaten +oder Objekt-Abbildungen zu bearbeiten. Diese sehr viel genaueren Berechtigungen können im +Nachhinein und entgegen der Vorgabe durch die Benutzerrolle eingestellt werden. + +Als nächstes wird die Perspektive des ersten Unterkapitels umgedreht: Es wird beschrieben, +[wie man selbst Accounts für Andere anlegen kann](Neues-Kontro-hinzufuegen.md). + +In den Sektionen ["Einstellungen (Privat)"](Einstellungen.md) und +["Kontoeinstellungen und Sicherheit"](Kontoeinstellungen-Sicherheit.md) werden +verschiedene Möglichkeiten, sich die Oberfläche von musdb anzupassen und das eigene Konto +abzusichern erklärt. + +Eine dieser Einstellungen ist die Möglichkeit, grundlegende Informationen - eine +kurze Biographie und vor allem Kontaktinformationen - zu sich selbst für andere +Benutzer freizugeben. Mithilfe des so freigegebenen [Benutzerprofils](Profil.md) können +etwa neue Mitarbeiter in größeren Häusern leichter nachvollziehen, wer das Objekt Jahre +zuvor bearbeitet hat. diff --git a/src/musdb/Benutzerkonto/Zugang-erhalten.md b/src/musdb/Benutzerkonto/Zugang-erhalten.md index bbee314..b277ccd 100644 --- a/src/musdb/Benutzerkonto/Zugang-erhalten.md +++ b/src/musdb/Benutzerkonto/Zugang-erhalten.md @@ -3,7 +3,7 @@ Zugang erhalten museum-digital ist eine Community. Um Zugang zu erhalten, muss man sich an einen schon vorhandenen Benutzer wenden. Im Zweifelsfall heißt das, -dass entweder der Museumsdirektor eines Museums Zugang gibt, oder dass +dass entweder der Museumsdirektor eines Museums Zugang gibt - oder, dass sich Museen, die noch nicht bei museum-digital sind, bei den Administratoren ihrer jeweiligen Instanz melden, um Zugang zu erhalten. @@ -13,6 +13,41 @@ Link. Folgt man diesem Link, kann man die Anmeldung beenden, indem man die Datenschutzvereinbarung zur Benutzung von musdb akzeptiert und sich ein Passwort gibt. -Bei neuen Benutzern sind ihre Rechte standardmäßig entsprechend [ihrer -Benutzerrolle](../Benutzerkonto/Berechtigungen.md) -vergeben. Sie können im Nachhinein angepasst werden. +In der Mail finden sich ebenfalls der Username und ein Link zum Anmeldebildschirm +von musdb, wo der Username und das gerade gesetzte Passwort verwendet werden können. + +![Login-Bildschirm von musdb: Links können die Logindaten eingetragen werden](../../assets/musdb/login/musdb-Login.jpg) + +Loggt man sich zum ersten Mal ein, erscheint zuerst einmal eine kurze Einführung in +die grundlegendsten Konzepte der Benutzung von musdb. Diese Einleitung erscheint auch +nach einer Abwesenheit von mehr als einem halben Jahr. + +## Ablaufen der Einladung + +Der Link zur Aktivierung des Accounts ist nach versenden drei Tage nutzbar - +sind die drei Tage verstrichen, ohne dass der Account vollständig aktiviert +wurde, wird er gesperrt und mittelfristig gelöscht. Aus Sicht des Museumsdirektors +oder Administrators ist es daher ratsam, Accounts gemeinsam mit neuen Nutzern +anzulegen oder neue Accounts lieber Montags als Freitags - vor dem Wochenende +anzulegen. + +## Benutzerrechte + +Beim Anlegen eines neuen Benutzeraccounts muss eine +[Benutzerrolle](../Benutzerkonto/Berechtigungen.md) für den neuen Benutzer +ausgewählt werden. Diese Rolle entscheidet über die grundlegenden Berechtigungen +des Benutzers. Feinere Einstellungen des Berechtigungen (etwa, wenn ein Benutzer +nur eine Sammlung bearbeiten können soll) können eingestellt werden, sobald der +neue Account aktiviert ist. + +## "Ich habe schon ein Konto. Aber wo ist musdb?" + +Die "Ausgabe" von museum-digital ist für die Veröffentlichung optimiert und hat +deshalb keinen (!) Link zum dazugehörigen Login. Deshalb passiert es immer wieder, +dass Benutzer - besonders solche, die nur selten direkt mit der Datenbank arbeiten - +den Loginscreen nach Monaten schlicht nicht wiederfinden. + +Die Einladungsmail beinhaltet wie schon oben besprochen einen Link in zur jeweiligen +Instanz von musdb. Aber es geht auch einfacher: Navigiert man zur jeweiligen regionalen +Instanz der Ausgabe und fügt hinten an die URL "/musdb" an, wird man zur Eingabeoberfläche +geleitet. diff --git a/src/musdb/README.md b/src/musdb/README.md index b9eea84..4d24f6d 100644 --- a/src/musdb/README.md +++ b/src/musdb/README.md @@ -2,10 +2,12 @@ Erfassen und Bearbeiten: musdb ============================== Für die Eingabe und die Bearbeitung von Museums-, Sammlungs- oder -Objektinformationen gibt es ein eigenes Werkzeug bei museum-digital, das -\"Eingabe- und Bearbeitungstool\", **musdb**. Sobald ein Administrator -ein Museum bei museum-digital eingerichtet hat, richtet er auch einen -Zugang für mindestens einen Mitarbeiter in der Rolle \"Museumsdirektor\" +Objektinformationen gibt es ein eigenes Werkzeug bei museum-digital: +*musdb*. Wie alle anderen Tools von museum-digital ist musdb browser-basiert +und wird von Museen einer Region gemeinsam benutzt. + +Sobald ein Administrator ein Museum bei museum-digital eingerichtet hat, +richtet er auch einen Zugang für mindestens einen Mitarbeiter in der Rolle "Museumsdirektor" ein. Mit diesem Zugang können dann weitere Zugänge für das Museum - ganz ohne Zutun des Administrators - angelegt werden. Die Handhabung des Eingabe- und Bearbeitungstools wird in den entsprechenden Unterpunkten @@ -13,17 +15,17 @@ erläutert. Das Werkzeug verfügt über eine eigene, stets erreichbare Navigationsleiste, mit der sich grundsätzliche Einstellungen vornehmen lassen. -Diese Sektion beschreibt in ihren Unterpunkten die Gründzüge des +Diese Sektion beschreibt die Gründzüge des Arbeitens mit musdb. Erfassens oder Bearbeitens von Objektinformationen bei museum-digital. Prinzipiell gibt es für das Erfassen zwei Möglichkeiten: Das Importieren und das händische Eingeben - beides wird näher erläutert. Einige Einstellungen des Programmes erlauben es dem Eingebenden oder Bearbeiter -die Arbeit zu erleichtern indem \"Vorgabewerte\" gesetzt werden (etwa: -\"Wenn-nicht-anders-angegeben-dann-verwende-folgendes\"). Auch diese +die Arbeit zu erleichtern indem "Vorgabewerte" gesetzt werden (etwa: +"Wenn-nicht-anders-angegeben-dann-verwende-folgendes"). Auch diese Einstellungen, die teils für alle Eingebenden oder Bearbeiter eines Museums gelten, teils nur einzelne Bearbeiter betreffen, werden erklärt. +## Weitere Quellen + Eine Playlist mit Screencasts zu musdb ist [hier auf Youtube zu finden](https://www.youtube.com/playlist?list=PLFbmcALPcmvLtbv38OpjEkHFteP-qhmDY). - -