Commit eb2b2829 authored by Tobias Zeumer's avatar Tobias Zeumer

Weekend changes to CHANGELOG.md and update README.md

parent a3553cf4
# Kurzinfo # Kurzinfo
Ein Lageplan für die TUB als reines HTML (5), Javascript und SVG und überall lauffähig. Eine Verwendung als Standortanzeige (über die Signatur) in Katalog oder Discovery ist auch möglich. Ein Lageplan für die TUB als prinzipiell reines HTML (5), Javascript und SVG und überall lauffähig. Eine Verwendung als Standortanzeige (über die Signatur) in Katalog oder Discovery ist auch möglich.
Am 2018-07-04 doch - zmdst. temporär - ab [diesem Commit](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/commit/de73e9a1cb1351264ef7768e1c90e3ca1e8b46b8) auf PHP gewechselt um die SVG zu laden).
Größtes Manko bis heute: es sieht irgendwie zu langweilig aus.
## Grundgedanken ## Grundgedanken
Grundsätzlich sollte der Plan gleichermaßen auf Handys/Tablets als auch auf großen PC-Bildschirmen oder Infoscreens mit Maus oder Touch funktionieren. Eine sehr schönes (freies) Beispiel ist [Interactive 3D Mall Map](https://tympanus.net/codrops/2016/04/13/interactive-3d-mall-map/) von Mary Lou bei Codrops. Grundsätzlich sollte der Plan gleichermaßen auf Handys/Tablets als auch auf großen PC-Bildschirmen oder Infoscreens mit Maus oder Touch funktionieren. Eine sehr schönes (freies) Beispiel ist [Interactive 3D Mall Map](https://tympanus.net/codrops/2016/04/13/interactive-3d-mall-map/) von Mary Lou bei Codrops.
Insbesondere für einen Infoscreen ist Serendipity ein wesentlicher Aspekt. Das heißt, es geht mehr darum, zufällig/schnell/ansprechend Bibliotheksangebote zu entdecken, weniger aber um eine gezielte Suche (also das jmd. aktiv den Plan aufruft um einen genauen Punkt anzusteuern). In gewisser Weise kann der Plan auch als alternativer Zugang zu den allermeisten (verschachtelteren) Infos auf der [TUB-Homepage](https://www.tub.tuhh.de/) betrachtet werden. Insbesondere für einen Infoscreen ist Serendipity ein wesentlicher Aspekt. Das heißt, es geht mehr darum, zufällig/schnell/ansprechend Bibliotheksangebote zu entdecken, weniger aber um eine gezielte Suche (also das jmd. aktiv den Plan aufruft um einen genauen Punkt anzusteuern). In gewisser Weise kann der Plan auch als alternativer Zugang zu den allermeisten (verschachtelteren) Infos auf der [TUB-Homepage](https://www.tub.tuhh.de/) betrachtet werden.
# Features
Stand v0.7.5. Änderungen sind im [Changelog](docs/CHANGELOG.md) oder bei den [Releases](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/tags) zu finden.
## Angebote, Einrichtung, Sonderregale ("Serendipity")
* Infos zu einzelnen Angeboten werden angezeigt via
* Mapmarkern (klickbar)
* Thematischem Seitenmenü
* Suchfeld (mit Vorschlagfunktion)
* Die Legend verlinkt ggf. auf weiterführende Infos, Formulare (Anmeldung, Fernleihe etc.) oder ggf. zu TUB-News aus dem entsprechenden Bereich. Üblicherweise in einem neuen Fenster, gelegentlich auch in einem Modal ("Popup"), wie z.B. bei den [Semsterapparaten](https://www.tub.tuhh.de/ext/tubmap/index.php?search=sem).
* Prinzipiell kann alles von extern verlinkt werden á la https://www.tub.tuhh.de/ext/tubmap/index.php?search=sem
* In der "IconBar" (oberer Bereich im Navigationsmenü) wird auf @tubhh-Tweets und JournalTouch verlinkt.
## Bestand
* Der gesamt Bestand ist für jedes Regal erfasst (Signaturen, Systematik)
* Auf eine Signatur kann direkt verlinkt werden á la https://www.tub.tuhh.de/ext/tubmap/index.php?signature=ch:che-123
* "Regalbrowsing": Bei Klick auf ein Regal, wird der Bestand angezeigt und entweder zum Discovery oder zum Opac verlinkt (Auswahl nach Beschränkung des jeweiligen Systems). Alternativ können Medien zu den einzelnen Themen (Discovery) angezeigt werden; damit werden auch Ebooks sichtbar.
## Darstellung (allgemein und Mobil/Desktop)
* Von Handy bis Riesenbildschirm wird alles in den gängigen Browsern (Chrome, Firefox, Edge, Safari, Opera) ordentlich angezeigt.
* Bei beiden Geräteklassen kann mit Zoom-Buttons gezoomed werden
* "Mausschubser" können mit dem Mausrad zoomen
* Touchgeräte können mit Pinch-Geste zoomen
* Panning ("Verschieben") geht gleichermaßen auf beiden Geräteklassen
* Details (Mapmarker, Systematik, Raumnummern, Detaillevel) können über das Settings-Menü eingestellt werden. Das Detaillevel kann auch beim Verlinken gewählt werden á la https://www.tub.tuhh.de/ext/tubmap/index.php?mapDetails=5
* Alle Elemente sind sehr, sehr nah an den tatsächlichen Maßstäben (siehe auch [Datenquelle(n)](docs/data_sources.md)).
* "Gefundene" Elemente werden rot markiert und "fliegen ein"
## Druck / Export
* Der Plan wird akzeptabel mit den aktuellen Ansichtsoptionen gedruckt
* Über das Settings-Menü (Zahnrad) können beide Lesesäle als PNG-Datei exportiert werden (mit aktuellen Ansichtsoptionen)
## Ladegeschwindigkeit
Die Seite lädt (beim ersten Seitenaufruf) im (W)LAN in knapp einer Sekunde und ist insgesamt ca. 180 KB groß (Stand 2018-07-08). Mobil und ca ~4G braucht sie leider noch ca. 7 Sekunden (Chrome-Performance-Messung).
* Bilder in Legendetexten werden erst geladen, wenn diese angezeigt werden
* Tweets werden erst bei Aufruf geladen
* ETags und Caching-Informationen sind gesetzt (zweites Laden performanter)
## Logging (Qualitätscheck)
* Ist eine Suche erfolglos, wird der Suchbegriff geloggt, so dass später ggf. darauf reagiert werden kann
* Wird der Screensaver deaktiviert, wird das geloggt. So lässt sich sehen, ob das Angebot überhaupt genutzt wird.
## Mehrsprachigkeit
* Praktische alle Informationen können auf Deutsch oder Englisch angezeigt werden
* (Englisch derzeit allerdings erst nach dem Laden wählbar, d.h. nicht direkt zu verlinken).
## Suche
Neben der unter "Bestand" erwähnten Signatursuche, kann auch via Suchfeld gesucht werden
* Search Suggestions werden entsprechend den Navigationsmenüeinträgen gegeben (farblich unterschieden nach allgemeiner Information und Systematik)
* Es kann auch nach Siganturen gesucht werden. Derzeit allerdings nicht im "richtigen" Format (TI:TIA-123 oder LBS:TIA-123), sondern nur á la "tia".
* Wird weder ein Suchstichwort noch eine Signatur gefunden, wird das Discovery in einem Modal mit den eingegeben Begriffen geöffnet
## Weiteres
* Ein minimalistischer Screensaver öffnet sich nach fünf Minuten. Vor allem setzt er die Ansicht wieder zurück.
# Installation # Technische Details
Einfach [herunterladen](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/-/archive/master/tub-floorplan-master.zip), im entpacken Ordner '''npm install''' ausführen und die Seite z.B. mit Signatur-Suche aufrufen: http://localhost/tub-floorplan/index.html?level=EG&mapDetails=5&signature=ti:tie-123 ## Installation
Einfach [herunterladen](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/-/archive/master/tub-floorplan-master.zip), im entpacken Ordner '''npm install''' ausführen und die Seite z.B. mit Signatur-Suche aufrufen: http://localhost/tub-floorplan/index.php?level=EG&mapDetails=5&signature=ti:tie-123
# Weitere Dokumentation ## Weitere Dokumentation
- [Changelog](docs/CHANGELOG.md) - [Changelog](docs/CHANGELOG.md)
- [Gitlab-Tickets](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/issues) - [Gitlab-Tickets](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/issues)
- [Datenquelle(n)](docs/data_sources.md) (Gebäudeplan, Maßstäbe etc.) - [Datenquelle(n)](docs/data_sources.md) (Gebäudeplan, Maßstäbe etc.)
......
# 2018-07-09 Kleiner Anpassungen V
* Fix: Bei Touch-Geräten wurden Sachen versehentlich ausgeblendet. Siehe [#30 Mobile/Desktop und click/touchstart](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/issues/30)
* Zoomen
* Fix (teilweise): Das Pinchen klappte bei Mobilgeräten nicht. Siehe [#31 Zooming (SVG, jquery.panzoom)](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/issues/31)
* Die Zoom-Buttons sind jetzt etwas hübscher. Außerdem ist der Zoom-Slider weggefallen.
* Ladgeschwindigkeit:
* Kein unnötiges und doppeltes Laden von Icons mehr. Siehe [#29 SVG-Symbole (zu viele Dateien)](https://collaborating.tuhh.de/tobias.zeumer/tub-floorplan/issues/29)
* Die Karte wird nicht mehr mit JavaScript, sondern direkt im HTML geladen (auf PHP gewechselt).
* Besseres Caching für schnelleres zweites Laden (ETags, Dateiversionierung)
* Scripts (Twitter, Mausrad-Erkennung etc.) werden nur bei Bedarf nachgeladen
* Die Mapmarker werden jetzt nur noch beim Screensaver alle 30 Sekunden animiert (stört sonst beim Klicken und bringt Handys ins Schwitzen)
* Insgesamt ist die Karte jetzt nach 1 Sekunde geladen (Desktop)
* Die Popups haben nun einen kleinen Schließen-Button
* Suchfeld (0 Treffer)
* Wenn in der Karte nichts gefunden wird, dann wird nun tub.find mit den eingegebenen Suchbegriff(en) geöffnet
* Außerdem wird notiert, was die Nutzer gesucht haben (nur Zeit und Begriff), so dass man reagieren kann
* Legende ganz leicht optimiert für mobile Ansicht
* Navigationsmenü mit "IconBar"
* Hat jetzt einen Homelink, einen Twitter-Feeds-Link und einen JournalTouch-Link (letzterer auch bei dem Legendentext)
# 2018-07-02 Kleiner Anpassungen IV # 2018-07-02 Kleiner Anpassungen IV
* Fehlendes Semesterapparat-Symbol wieder eingefügt * Fehlendes Semesterapparat-Symbol wieder eingefügt
* Etwas "unsichtbaren" Müll aus Grafik rausgeschmissen (kleiner) * Etwas "unsichtbaren" Müll aus Grafik rausgeschmissen (kleiner)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment