...
Table of Content Zone | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Jak zmienić logo biblioteki?Patrz 04. Dostosowywanie wyglądu aplikacji czytelnika Jak zmienić tekst wyświetlany na stronach?Dowolną etykietę tekstową używaną w szablonie komponentu można "przykryć" podając nową wartość w plikch: dlibra-webapp/WEB-INF/components/resources/WEBAPP_xx.xml zostanie ona natychmiast uwzględniona. Przykładowo w komponencie odpowiedzialnym za sekcję "Dodatki" (AddonsComponent) jest wykorzystywana etykieta "AddonsComponent.OAIHosts" jej wartość to : "Biblioteki cyfrowe dLibra". Chcąc zmienić tę wartość dla języka polskiego dodajemy klucz AddonsComponent.OAIHosts do pliku Jak dodać link w sekcji "Informacje" na stronie głównej?W "Informacjach" mogą się znaleźć 3 rodzaje linków:
Należy postępować w następujący sposób:
Czy roboty są uwzględnienie przy zliczaniu statystyk?To jakie programy (przeglądarki) nie są uwzględniane przy zliczaniu statystyk zależy od zawartości pliku ignored_agents.txt. Każdy wpis jest traktowany jako wyrażenie regularne (w pliku znajduję się przykładowy wpis dla GoogleBot'a). Należy umieścić w nim łańcuchy znakowe odpowiadające polu User Agent (nagłówek HTTP) programów które nie powinny być zliczane (przykład dla googlebot'a w pliku). Nazwy user agentów można znaleźć w sieci np. tu http://en.wikipedia.org/wiki/User_agent. Po wprowadzeniu zmian w plikach należy zrestartować Tomcat'a żeby nowe wartości byly brane pod uwagę. Gdzie można zmienić informację o adresie i informacjach dotyczących instytucji tworzących bibliotekę?Informacje standardowo wyświetlane w stopce aplikacji czytelnika można edytować w panelu administracyjnym. Domyślnie dane te znajdują się na stronach pomocy o identyfikatorach "address" i "participants". Gdzie umieścic kod Google Analytics?Kawałek kodu dla Google Analitycs, można wstawić w pliku: dlibra-webapp/WEB-INF/layout/parts/header.vm. Plik header.vm jest używany przez większość szablonów rozmieszczeń w aplikacji czytelnika Jak dodać nową stronę pomocy?Strony pomocy przechowywane są w bazie danych aplikacji czytelnika. Aby dodać nową stronę należy zalogować się do panelu administracyjnego Procedura dodawania takiej strony jest następująca: (operuje polskimi nazwami)
Jak podmienić plik graficzny wyświetlany na stronach aplikacji czytelnika?Ścieżki do plików graficznych można "wyśledzić" w przeglądarce: klikając prawym przyciskiem na obrazek : wybrać Właściwości (Properties) tam powinien być wyświetlony adres do obrazka np. http://www.wbc.poznan.pl/style/dlibra/theme1/logo.gif Plik logo.gif należy szukać w katalogu : dlibra-webapp-5.0/style/dlibra/theme1/logo.gif Wystarczy więc podmienić ten plik. Jak zmienić tytuł strony wyświetlanej przez aplikacje Czytelnika?Tytuły stron Aplikacji Czytelnika są zdefiniowane w pliku dlibra-webapp-5.0/WEB-INF/pages-titles.xml. Poniżej zaprezentowano przykładowy wpis dla strony głównej.
Zarówno tytuł strony jak i jej podtytuł są wyrażeniami języka VTL (Velocity Template Language) - w przytoczonym przykładzie jako tytuł strony zostanie wstawiona wartość etykiety tekstowej o kluczu base.Homepage. Na poziomie szablonów aplikacji czytelnika wartości wyrażeń zawawrtych w znacznikach title i subtitle dostępne są poprzez zmienne pageTitle i pageSubtitle. Aby zrozumieć jak tworzony jest tytuł strony w aplikacji Czytelnika, poniżej przytoczono fragment pliku dlibra-webapp/WEB-INF/layout/templates/parts/header.vm.
Tytuł strony tworzony jest poprzez złączenie dwóch łańcuchów znakowych:
Jak zmienić zawartość znaczników meta w nagłówkach stron WWW aplikacji czytelnika?Należy najpierw ustalić identyfikator etykiety tekstowej w której znajduje się zawartość danego meta znacznika. Aby tego dokonać należy otworzyć plik dlibra-webapp/WEB-INF/layout/templates/parts/header.vm odnaleźć w nim odpowiedni znacznik. Poniżej fragment pliku header.vm:
Szukana etykieta ma identyfikator main.meta.description należy teraz zdefiniować dla niej nową wartość. Sposób postępowania został opisany w rozdziale "Jak zmienić tekst wyświetlany na stronach?". Jak uzależnić logo biblioteki od języka interfejsu który wybrał użytkownik?W sytuacji gdy logo biblioteki ma dwie (lub więcej) różnych wersji językowych i chcielibyśmy uzależnić to które jest wyświetlane od wybranego przez użytkownika języka interfejsu, konieczne jest dokonanie pewnych modyfikacji w kodzie szablonu strony. Fragment kodu VTL odpowiadający za wyświetlanie logo biblioteki znajduję się na początku pliku dlibra-webapp/WEB-INF/layout/templates/parts/simple-inv.vm.
To jaki języka wybrał użytkownik jest dostępne poprzez zmienną ${userLanguage}, zmienna ta przyjmuje wartość "pl" gdy uzytkownik korzysta z polskiego interfejsu, wartość "en" gdy korzysta z angielskiego. Mamy dwa pliki z logo biblioteki: dlibra-webapp-5.0/style/dlibra/theme1/logo_pl.gif i dlibra-webapp-5.0/style/dlibra/theme1/logo_en.gif. Przykładowe ścieżki bazują na założeniu, że w modyfikowanej Aplikacji Czytelnika znajduję się tylko jeden temat kolorystczny : theme1. Istniejący kod należy zmienić w następujący sposób:
Zmiany powinny być widoczne od razu - bez konieczności restartu Aplikacji Czytelnika. Gdzie w aplikacji czytelnika dlibra 5.0 znajduję się główny plik z makrami VTL?W wersji 4.0 większość makr VTL została przeniesiona do archiwum dlibra-web-components-x.x.x.jar (plik components_library.vm) oraz dlibra-web-framework-x.x.x.jar (plik basic-library.vm). Zawartość archiwów powinna pozostać niezmieniona. Wszelkie modyfikacje makr należy umieszczać w plikach dlibra-webapp-5.0/layout/templates/layout_library.vm oraz dlibra-webapp-5.0/layout/templates/custom_library.vm W przypadku gdy pojawią się wątpliwości związane z rolą/istnieniem danego marka w dlibra 5.0 proszę skontaktować się z nami, bądź wystosować zapytanie na forum. Jak w prosty sposób stworzyć swój własny temat kolorystyczny ?Wszystkie pliki pliki graficzne i css związane z kolorystyką strony znajdują się w katalogu tematu kolorystycznego, domyślnie style/dlibra/theme1. Można wprowadzać zmiany bezpośrednio w tym katalogu, lub skopiować go, np. do katalogu style/dlibra/theme2, aby utworzyć nowy temat. Aplikacja czytelnika pozwala przełączyć się użytkownikowi na inny temat kolorystyczny bez zmiany globalnych ustawień (zmiana dotyczy tylko aktualnej sesji użytkownika). Pozwala to na wygodną pracę nad nowym tematem, podczas gdy użytkownicy nadal korzystają ze starego tematu. Aby to zrobić, należy w przeglądarce otworzyć adres typu http://strona-biblioteki/dlibra?action=ChangeStyleAction&style=dlibra:theme2, a następnie przeładować stronę. Po zakończeniu prac nad nowym tematem można ustawić go jako domyślny dla wszystkich użytkowników w pliku WEB-INF/web.xml: context-param o nazwie view.style. Zmiana wymaga restartu aplikacji czytelnika (Tomcata). Pomocne mogą okazać się następujące narzędzia:
Co zrobić gdy aplikacja czytelnika działa bardzo wolno ?W domyślnie zainstalowanej dLibrze pamięć podręczna (cache) aplikacji czytelnika jest wyłączony. Jeżeli aplikacja czytelnika zaczyna działać wolno warto włączyć pamięć podręczną. Aby tego dokonać należy w pliku dlibra-webapp/WEB-INF/conf/cache.properties zmienić wartość flagi use.cache na true. Następnie należy zrestartować tomcata. W czasie uruchamiania aplikacji czytelnika z serwera pobrane zostaną niezbędne dane. W związku z tym uruchomienie aplikacji czytelnika może trwać dłużej niż przed włączeniem pamięci cache. Gdy wszystkie informacje zostaną pobrane i aplikacja poprawnie wystartuje, przyspieszenie działania powinno być wyraźnie odczuwalne. java.lang.OutOfMemoryError: Java heap spaceW wersji 4.0.14 wprowadzony został nowy mechanizm podpowiedzi w formularzu wyszukiwania prostego i zaawansowanego. Zaimplementowany mechanizm zwiększył wymagania pamięciowe aplikacji czytelnika dLibry. Struktury na podstawie których tworzone są podpowiedzi są uaktualniane raz na tydzień, domyślnie odbywa się to o 22:00 w każdą sobotę. Jeżeli Apache Tomcat działa w domyślnej konfiguracji mogą pojawić się problemy z brakiem wolnej pamięci. Przykładowy komunikat o błędzie sugerujący, że mamy do czynienia z brakiem wolnej pamięci może wyglądać tak:
Aby zapobiec tego typu problemom należy zwiększyć wielkość pamięci przydzielonej Tomcatowi. Jeżeli uruchamiamy Tomcata poprzez skrypty, to na początku skryptu startującego - (w zależności od instalacji skrypt może się różnie nazywać: catalina.sh, catalina.bat, tomcat6.sh) należy dodać następującą linię : JAVA_OPTS ='-Xms1280m -Xmx1280m'. Jeżeli natomiast posiadamy instalację Tomcata na systemie Windows jako usługę, należy uruchomić tomcat6w.exe i w zakładce Java podać w polu "Initial memory pool" wartość 1280, a w "Maximum memory pool" 1280. Pierwszy z parametrów określa początkową wielkość pamięci przydzielonej Tomcatowi, drugi maksymalny przydział. Wielkość przydzielonej pamięci należy dobrać biorąc pod uwagę wielkość biblioteki cyfrowej. Problemy z certyfikatem przy dostępie do strony kontaktPo kliknięciu w "Kontakt" przeglądarka wyświetla błąd informujący o tym, że "Certyfikat nie jest zaufany, ponieważ jest on samopodpisany." lub "Ten certyfikat utracił ważność: (tutaj data). (Kod błędu: sec_error_expired_issuer_certificate)". Instrukcja pozwalająca na wygenerowanie nowego certyfikatu dla tomcata jest bardzo prosta. Sprowadza się do wydania komendy :
i wpisaniu wszystkich danych instytucji. Polecenie powinno zostać wywołane przez użytkownika który uruchamia tomcata. Aby zmiany zostały uwzględnione konieczny jest restart tomcata. Wygenerowanie nowego certyfikatu rozwiąże problem związany z przekroczeniem terminu przydatności, nowoczesne przeglądarki i tak będą ostrzegać przed takim certyfikatem ponieważ nie został on wystawiony przez uprawnioną instytucję certyfikującą. Aby temu zaradzić należy zwrócić się z prośbą o wygenerowanie certyfikatu do takiej właśnie instytucji.
Do czego konkretnie używane są cookies w dLibrze? Co w związku z tym jako administrator muszę zrobić aby pozostać w zgodzie z art. 173 ustawy "Prawo telekomunikacyjne"?Od 22 marca 2013 r. obowiązuje w Polsce znowelizowane Prawo telekomunikacyjne (http://www.dziennikustaw.gov.pl/DU/2012/1445). Artykuł 173 tej ustawy brzmi:
Stosowane w Aplikacji Czytelnika systemu dLibra pliki cookie związane są z dwoma podstawowymi aspektami funkjonowania tego systemu:
Obydwa te aspekty podpadają pod ustęp 3 art. 173 Prawa telekomunikacyjnego, gdyż są niezbędne do zapewnienia funkcjonalności aplikacji, z której chce skorzystać użytkownik. Oznacza to, że w podstawowej konfiguracji systemu dLibra nie jest konieczne wyświetlanie użytkownikowi specjalnych komunikatów dotyczących cookie i ich akceptacji. UWAGA: W momencie kiedy Aplikacja Czytelnika zostanie na potrzeby danej biblioteki cyfrowej rozszerzona o dodatkowe komponenty takie jak banery automatycznych systemów reklamowych czy monitorowanie ruchu przy pomocy Google Analytics, konieczne będzie wprowadzenie dodatkowego komunikatu lub komponentu informacyjnego na strony objęte taką dodatkową funkcjonalnością. W takiej sytuacji zalecamy zapoznanie się z polityką prywatności poszczególnych dostawców dodatkowych usług (np. dla Google Analytics: http://www.google.com/intl/pl/analytics/privacyoverview.html). Jak uruchomić kilka aplikacji czytelnika z jednym serwerem dLibra?
|
...