Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In the dLibra system, standard publications are versionized. The elements which make it possible are releases. A publication release is a specific version of an electronic document. Let us illustrate the operating principle of the versionizing mechanism with an example. Let us assume that an author created document A. This is the first version. The author sent the document to an editor who entered it to a digital library and, in this way, created a publication (the dLibra system automatically creates the first release of that publication). Next, the author corrected document A, so the editor received another version of it, that is, document A'. In order to make the new version, document A', available in the digital library, the editor should add a new release of the publication (not enter a new publication). After that action, the publication has two releases: one corresponding to document A and one corresponding to document A', Thus, the reader of the digital library can see the whole ‘life history’ (subsequent releases) of the document (publication).

In the context of files, a release is a set of particular versions of files. A file version is here defined as the file at a particular time (for example, the version from January 17, 2006, 7:32 a.m.). Coming back to our example: document A is the first version of the document, which groups the file versions sent to the editor after the document had been created. Document A' groups the file versions sent to the editor after the document had been modified. To sum up, the first release of the publication (created automatically when the publication was being created) groups the file versions of document A, and the second release – of document A'. It should be added that if the document had many files and the author’s modifications did not apply to all those files, the second release would group a part of the files from document A (the unmodified files) and a part of the files from document A' (the modified files).

We could illustrate the versionizing mechanism in greater detail with the example illustrated below. Let us assume that a given publication only has one file at the beginning, body.html. An editor creates a publication in the dLibra system and indicates that file as its content. The dLibra system creates the first release of the publication. The release groups the available file version. After a time, the author modifies the body.html file and adds the title.jpg file to the document. The editor creates a second release, which groups the title.jpg file and the modified version of the body.html file. Some time later, the author modifies the document again, changing the body.html and title.jpg files and adding a new file, logo.gif. The editor creates a third release, which groups the new logo.gif file and the newest versions of the body.html and title.jpg files. In the end, the publication consists of three releases. Each of them groups a set of particular versions of the files. The publication contains three files. Each file groups its own versions (for example, the title.jpg file groups version 1.1 and 1.3, and the logo.gif file only groups the 1.1 version).


Image Added

Another example is shown in the image below, which presents the dependencies among a publication, its releases, its files, and the file version. As we can see, the publication consists of two releases and two files. The files contain the subsequent file versions, and the releases group particular file versions across files. The web site user (reader) can see the publication and its two releases. When the reader wants to see the contents of a particular release, the dLibra system displays the file versions relevant for that release.

Image Added

W systemie dLibra wersjonowaniu podlegają publikacje zwykłe. Elementami, które umożliwiają wersjonowanie publikacji są wydania. Wydanie publikacji jest konkretną wersją dokumentu elektronicznego. Aby zrozumieć zasadę działania mechanizmu wersjonowania prześledźmy następujący przykład. Załóżmy, że autor stworzył dokument A - jest to pierwsza wersja. Autor przesłał pliki dokumentu redaktorowi, który wprowadził ten dokument do biblioteki cyfrowej tworząc publikację (podczas tworzenia publikacji system dLibra automatycznie tworzy również pierwsze wydanie tej publikacji). Następnie autor poprawił dokument A w wyniku czego redaktor otrzymał kolejną wersję dokumentu - dokument A'. Aby udostępnić nową wersję dokumentu (A') w bibliotece cyfrowej redaktor powinien dodać do publikacji nowe wydanie (nie wprowadzać nowej publikacji!). Po dodaniu nowego wydania publikacja posiada dwa wydania - jedno odpowiadające dokumentowi A, a drugie odpowiadające dokumentowi A'. Dzięki takiemu podejściu użytkownik biblioteki cyfrowej ma udostępnioną całą "historię życia" (kolejne wydania) dokumentu (publikacji).

W kontekście plików wydanie jest zbiorem konkretnych wersji plików, przy czym wersję pliku rozumiemy jako plik w określonym czasie (np. plik z dnia 17.01.2006, godziny 07:32). Zgadza się to z informacjami z poprzedniego paragrafu - dokument A to pierwsza wersja dokumentu, która grupuje wersje plików przesłane redaktorowi po utworzeniu dokumentu. Dokument A' grupuje natomiast wersje plików przesłane po modyfikacji dokumentu. Podsumowując, wydanie pierwsze publikacji (stworzone automatycznie podczas tworzenia publikacji) grupuje wersje plików dokumentu A, wydanie drugie grupuje wersje plików dokumentu A'. Warto tu również dodać, że jeżeli dokument byłby wieloplikowy i modyfikacje wykonane przez autora nie dotyczyłyby wszystkich plików to wydanie drugie grupowałoby część plików w wersji z dokumentu A (pliki nie zmodyfikowane) i część plików w wersji z dokumentu A' (pliki zmodyfikowane).

Aby dokładniej wyjaśnić kwestię wersjonowania prześledźmy przykład (ilustracja przykładu poniżej). Załóżmy, że początkowo dana publikacja składa się tylko z jednego pliku body.html. Redaktor tworzy publikację w systemie dLibra wskazując ten plik jako zawartość. System dLibra tworząc publikację tworzy jej pierwsze wydanie, które grupuje tę konkretną wersję pliku. Po pewnym czasie autor zmodyfikował plik body.html oraz dodał do dokumentu plik title.jpg. Redaktor utworzył drugie wydanie które grupuje plik body.html w wersji po modyfikacji oraz plik title.jpg w jego pierwszej wersji. Po pewnym czasie autor ponownie zmodyfikował dokument zmieniając pliki body.html i title.jpg oraz dodając plik logo.gif. Redaktor utworzył trzecie wydanie, które grupuje najnowsze wersje plików body.html i title.jpg oraz pierwszą wersję pliku logo.gif. Podsumowując, publikacja ostatecznie składa się z trzech wydań. Wydania te grupują pliki w określonych wersjach. Publikacja zawiera ogółem 3 pliki, które grupują konkretne wersje pliku (np. plik title.jpg grupuje wersję 1.1 oraz wersję 1.3, a plik logo.gif grupuje jedną wersję 1.1). Image Removed
Kolejny przykład znajduje się na rysunku poniżej. Przedstawia on zależności między publikacją, wydaniami, plikami i wersjami plików. Jak widać publikacja składa się z dwóch wydań i dwóch plików. Pliki zawierają konkretne wersje plików, natomiast wydania grupują konkretne wersje plików. Użytkownik stron internetowych (czytelnik) widzi publikację oraz jej dwa wydania. Gdy chce zobaczyć zawartość konkretnego wydania system dLibra serwuje mu odpowiadające wydaniu wersje plików.

Image Removed