Instrukcja obsługi systemu dLibra 5.0 oraz dMuseion 1.0

Skip to end of metadata
Go to start of metadata

Wstęp

Po wybraniu opcji Konfiguracja z menu Program pojawi się okno konfiguracji programu (rysunek poniżej).

Okno konfiguracji programu

W oknie konfiguracji znajdują się zakładki odpowiadające za konfigurację różnych cech programu. W kolejnych podrozdziałach omówione są wszystkie zakładki. Wartości domyślne poszczególnych parametrów znajdują się w załączniku konfiguracja domyślna.

Ustawienia programu

Pierwsza opcja konfiguracyjna w zakładce Ustawienia programu to pole wyboru Automatycznie dodaj format pliku głównego do zaimportowanych metadanych. Jeżeli pole to jest zaznaczone to po każdym imporcie metadanych zostaną one wzbogacone o wartość formatu pliku głównego publikacji. Jeśli opcja ta nie jest zaznaczona to metadane nie są modyfikowane.

Pozostałe parametry konfiguracyjne mogą być pobierane z pliku konfiguracyjnego. Aby zmienić plik konfiguracyjny aplikacji wybierz przycisk Plik konfiguracyjny... i wskaż w otwartym oknie katalog lub URL pliku konfiguracyjnego. W przypadku podania katalogu, musi się w nim znaleźć plik o nazwie generalConfig.properties. Plik konfiguracyjny aplikacji zawiera zaawansowane parametry konfiguracyjne aplikacji. Jest to plik właściwości, gdzie klucze oddzielone są od wartości znakiem równości. Znajdują się w nim następujące parametry konfiguracyjne:

  • gui.lookandfeel - wartość to nazwa klasy języka programowania Java, która odpowiada za sposób wyświetlania/zachowania elementów interfejsu graficznego użytkownika. Jeśli brak tej wartości przyjmowany jest domyślny wygląd odpowiedni dla systemu operacyjnego na którym uruchomiono aplikację.
  • tags.refresh.period - wartość to czas podawany w milisekundach, który mówi o tym co ile milisekund powinna być odświeżana (aktualizowana z serwera) lista tagów w aplikacji. Domyślna wartość to 600000 czyli 10 minut.
  • tags.message.period - wartość to czas podawany w milisekundach, który mówi o tym co ile milisekund powinien być wyświetlany monit użytkownikowi w przypadku, gdy ma on tagi, które powinny być poddane moderacji. Domyślna wartość to 1800000 czyli 30 minut.
  • messages.refresh.period - wartość to czas podawany w milisekundach, który mówi o tym co ile milisekund powinna być odświeżana (aktualizowana z serwera) lista wiadomości dla redaktora. Domyślna wartość to 600000 czyli 10 minut.
  • messages.message.period - wartość to czas podawany w milisekundach, który mówi o tym co ile milisekund powinien być wyświetlany monit użytkownikowi w przypadku, gdy redaktor ma nieodczytane wiadomości. Domyślna wartość to 1800000 czyli 30 minut.
  • newPublication.title.template - wartość określa szablon tytułu tworzonego elementu (np. publikacji). Szablon ten jest szablonem velocity. W szablonie w miejscu odpowiednio nazwanych zmiennych wprowadzane są wartości atrybutów. Zmienne powinny mieć nazwę odpowiadającą nazwie RDF atrybutu. Domyślna wartość tego parametru to

    Szablon ten powoduje ustawienie jako nazwy wartości atrybutów o nazwach RDF, w kolejności: Creator, Date oraz Title. Wartości te są oddzielane przecinkiem, a jeśli którejś brakuje, jest pomijana.

  • miniature.maxWidth - ograniczenie (w pikselach) na szerokość miniatury tworzonej automatycznie z plików publikacji w kreatorze nowej publikacji. Domyślnie szerokość miniatury nie jest ograniczona.
  • miniature.maxHeight - ograniczenie (w pikselach) na wysokość miniatury tworzonej automatycznie z plików publikacji w kreatorze nowej publikacji. Domyślnie wysokość miniatury nie jest ograniczona. Jeśli ustawiono ograniczenie zarówno na wysokość jak i szerokość miniatury, ostatecznie wykorzystywane jest to ograniczenie, które skutkuje mniejszym rozmiarem miniatury.
  • searchDuplicates.roles.url - wartość to adres URL pod którym znajduje się lista ról Dublin Core atrybutów, które mają być wykorzystywane w mechaniźmie wyszukiwania duplikatów. Domyślna wartość to http://fbc.pionier.net.pl/owoc/ajax.xml?id=GetDCRolesForDups.
  • searchDuplicates.results.url - wartość to początek adresu URL, do którego zostaną dodane parametry wyszukiwawcze w procesie wyszukiwania duplikatów. Domyślna wartość to http://fbc.pionier.net.pl/owoc/ajax.xml?id=GetDups.
  • sortTokens - wartość to lista ciągów znaków oddzielonych symbolem |. Są to ciągi znaków, które nie są brane pod uwagę na początku nazwy elementów podczas sortowania publikacji na liście elementów i drzewie katalogów. Domyślna wartość to "|(|[...]|[|the |the.
  • attributesViews.url - wartość to adres URL pod którym znajduje się opis widoków atrybutów, które mają być dostępne w aplikacji redaktora. W przypadku pliku na dysku lokalnym należy pamiętać, aby poprzedzić ścieżkę frazą file:///, a kolejne foldery oddzielać ukośnikiem /. Dodatkowo, każdy dwukropek musi być poprzedzony ukośnikiem {{}}. Na przykład dla pliku widoki.xml, położonego w katalogu C:\dlibra, para klucz-wartość w pliku konfiguracyjnym przyjmie postać:

    Domyślnie wykorzystywany jest zestaw widoków wbudowany bezpośrednio w aplikację redaktora.

Należy pamiętać o zaznaczeniu pola Używaj konfiguracji z podanego źródła. W przeciwnym razie plik konfiguracyjny nie zostanie wczytany.

Przykładowy plik konfiguracji mógłby wyglądać następująco (jeśli w pliku nie ma jakiegoś klucza to przyjmowana jest wartość domyślna):

Pobieranie domyślnej konfiguracji z zewnętrznego źródła

W bibliotece cyfrowej może pojawić się potrzeba, by wszyscy redaktorzy pracowali z konkretnym zbiorem ustawień, innym niż ustawienia domyślne. Na przykład, wykorzystanie niestandardowego schematu metadanych może spowodować, że dla wygodnej pracy redaktorów trzeba będzie przygotować specjalne widoki atrybutów, a także zmienić atrybuty wykorzystywane przy tworzeniu domyślnej nazwy publikacji. W tej sytuacji odpowiedni plik konfiguracyjny najlepiej jest umieścić Internecie.

Aby redaktorzy nie musieli samodzielnie wprowadzać adresu takiego pliku, można tak ustawić aplikację czytelnika (www), aby aplikacja redaktora automatycznie otrzymywała odpowiedni adres i wczytywała konfigurację przy każdym uruchomieniu, zastępując domyślne opcje. Funkcja ta jest również wygodna wtedy, gdy w późniejszym czasie zajdzie potrzeba zmiany pewnych ustawień u wszystkich redaktorów. Oczywiście, każdy redaktor może nadpisać pobrane w ten sposób ustawienia na swoim komputerze, stosując metody wymienione w poprzednim podrozdziale.

Adres pliku konfiguracyjnego aplikacji redaktora należy wprowadzić w pliku components.xml, znajdującym się w katalogu konfiguracyjnym aplikacji czytelnika (WEB-INF). Wewnątrz znacznika <component name="pl.psnc.dlibra.web.comp.pages.components.JnlpComponent"> domyślnie znajduje się zakomentowana właściwość w postaci:

Aby uruchomić funkcję automatycznego pobierania dokumentacji, należy odkomentować ten fragment i zmienić przykładowy adres na własny. Zmiana ta nie wymaga restartu serwera www (ale aplikacja redaktora musi być jeszcze raz pobrana ze strony biblioteki cyfrowej).

Konfiguracja rozszerzeń

Zakładka Konfiguracja rozszerzeń umożliwia dostosowanie ustawień poszczególnych rozszerzeń. Na panelu (rysunek poniżej) znajduje się lista rozszerzeń, które można konfigurować. Aby zmieniń ustawienia konkretnego rozszerzenia należy zaznaczyć je na liście i wybrać przycisk Konfiguruj.... Domyślnie w aplikacji znajdują się następujące rozszerzenia:

Konfiguracja - zakładka Konfiguracja rozszerzeń
  • No labels