3.4. Advanced editor's tasks

This section describes advanced tasks performed by the editor.

3.4.1. Editor's application modes (views)

In the editor's application two work modes are possible:

  • Simple mode

  • Advanced mode

By default the simple mode is enabled. In order to switch to the advanced mode select the Advanced mode option from the View menu. In ordert to get back to the simple mode select again the Adcanced mode option from the View menu.

The differences between the modes (views) are presented on the Table 3.1, “Differences between editor's application work modes”.

Table 3.1. Differences between editor's application work modes

Feature \ ModeSimple modeAdvanced mode
Publication node
  • If the publication has only one edtion it is not visible --- after expanding the publication, edition's files versions are visible. All the properties for the edition and publication can be specified on the tabs in the properties window,

  • If the publication has more that one edition --- these editions are visible after expanding the publication (it is the same situation as in the advanced mode).

Afrter expanding publication all its editions are visible (includin the current one). Files' version which compose the edition are visible after expanding edition.

3.4.2. Downloading an edition of a publication

In order to further edit an existing publication, its files must be downloaded into editor's local machine.

To download an edition of a publication:

  1. On the elements list select the edition to be downloaded (it can be the current edition as well).

  2. From the context menu select the Download... function. Alternatively, the toolbar button or main menu options can be used.

  3. In the first step ( Figure 3.23, “Download Wizard - publication file selection page”) select the local disk directory the publication files shall be stored in.

    In the Files to download table the default file selection can be altered. To exclude a file from the download list --- uncheck the appropriate position in the Present column. Additionally, the version to be downloaded can be changed using a pull down list in the Version column.

    It is possible to download the publication as the zip archive. In order to do this check Download zipped publication check box.

    Press the Next button to proceed to the file download page.

    Figure 3.23. Download Wizard - publication file selection page

    Download Wizard - publication file selection page
  4. In the second step ( Figure 3.24, “Download wizard - file download page”) press the Start button to start downloading the selected publication files to the selected local disk directory. The process can be paused and resumed pressing the button again.

    After the downloading process finishes press the Finish button to close the wizard.

    Figure 3.24. Download wizard - file download page

    Download wizard - file download page

3.4.3. Adding new files' versions

After modifying some of files of an existing publication, for the changes to take effect the files must be sent back to the server (and the for example new edition can be created based on newly added filed).

To send the updated files to the server:

  1. On the elements list select the publication to which the new file versions shall be assigned.

  2. From the context menu select the Add new files' versions... function. Alternatively, the toolbar button or main menu options may be used.

  3. In the Add new files' versions wizard select the local disk directory that contains the updated publication files.

    Selected directory has to contain publication main file. Missing files are marked by .

    The wizard selects files to update based on the modification and storage dates. By default, files modified after the last store/add operation are selected. The selection can be altered by checking/unchecking appropriate positions in the Add column of the publication files table.

    Press the Next button to proceed to the file upload page.

    Figure 3.25. File Update Wizard - updated files directory page

    File Update Wizard - updated files directory page
  4. Press the Start button to start uploading selected publication files to the server. The process can be paused and resumed pressing the button again.

    After the uploading process finishes press the Finish button to close the wizard.

    Figure 3.26. File Update Wizard - file upload page

    File Update Wizard - file upload page

3.4.4. Creating/removing an edition of a publication

Edition is a viewable form of a publication - to make a publication available for viewing an edition must be created and published.

To create an edition of a publication:

  1. On the elements list select the edition (e.g. the current edition) the new edition should be based on.

  2. From the context menu select the New edition... function. Alternatively, the toolbar button or main menu options can be used.

  3. In the New Edition Wizard select the versions of publication files to compose the new edition.

    When the new edition is based on a branch of a publication, the newest versions of files lying on the branch are selected. When the new edition is based on an existing edition of a publication the selected file versions are the same as in the base edition.

    The selection of file versions can be altered using a drop down list embedded in the Version column of the Edition files table.

    To proceed to the edition properties page press the Next button.

    Figure 3.27. New Edition Wizard - file versions selection page

    New Edition Wizard - file versions selection page
  4. In this step enter bibliographic description for new edition. It is possible to import bibliographic description from MARC 21 lub RDF format.

    To proceed to the next step press Next button.

    Figure 3.28. New Edition Wizard - bibliographic description page

    New Edition Wizard - bibliographic description page
  5. Enter WWW information: Description which is presented on search results list, Comment available on edition information page and miniature presented on edition information page.

    To proceed to the next step press Next button.

    Figure 3.29. New Edition Wizard - WWW information

    New Edition Wizard - WWW information
  6. Enter the new edition's name and description in the Name and Description fields. To make the new edition published check the Published option. This can also be done after the edition is created.

    To create the new edition press the Finish button.

    Figure 3.30. New Edition Wizard - edition properties page

    New Edition Wizard - edition properties page

In order to remove edition two condition have to be fulfilled:

  • Edition is not the only one edition of publication

  • Edition is not published

Remove edition choosing Delete option from context menu.

3.4.5. Managing publication files

There are three mechanisms which allow publication files management. The first one is file version removal. File version can be removed when it is not the only one version of a file and it is does not belong to any edition. The second mechanism is file removal. File can be removed when none of its versions belongs to any edition. The third mechanism is automatic deletion of redundant files. Redundant files of publication are files and files versions which may be removed. In order to delete redundant files choose Remove redundant files... option from context menu of Publication files element (it is available after publication is opened, only in advanced mode).

3.4.6. Mass publication upload

In this section it is described mass publication upload mechanism.

3.4.6.1. Mass publication upload wizard

To start mass publication upload creator select Mass publication upload from Tools menu.

  1. In the first step ( Figure 3.31, “Mass publication upload creator - publications selection.”) we specify publications which will be sent to dLibra server.

    First step's window is splitted into two parts: on the left side there is a system directories tree, on the right side there is a list of publication to upload. In order to add publication to upload:

    1. On the system directories tree check a directory containing subdirectories describing publications (information about the structure of a directory describing a publication are placed in the next section).

    2. Press the button. Application will check corectness of directories describing publications. In case of errors, appropriate messages will be shown.

    After adding publications to send it is possible to go to the next step.

    Figure 3.31. Mass publication upload creator - publications selection.

    Mass publication upload creator - publications selection.
  2. In the second step we send publication to the server.

    Figure 3.32, “Mass publication upload creator - publications upload” shows a window of the second step. To send publications press Start button. During the upload process is it is possible to monitor the progress throught to the progress bars. When the process finished appropriate summary is shown. If for any reason uploading of one or more publications failed, it is possible to check error messages by pressing the Errors details... button.

    Figure 3.32. Mass publication upload creator - publications upload

    Mass publication upload creator - publications upload

3.4.6.2. Structure of a directory describing a publication

Directory describing a publication consists of:

  • publication.properties file which describes publication,

  • Optional RDF file which contains bibliographic description fo the publication,

  • Publication files.

3.4.6.2.1. publication.properties file

publication.properties file is publication properties file. It consists of attribute—value pairs. Attribute is separated from value by the equals sign (=). Every pair is placed in separate line.

Possible attributes and their values are presented below.

  • Attribute publication.actorsRights.<user login or group name to which we will assign rights>

    Rights separated with a comma. The list of possible rights:

    • pv – publication view

    • pr – publication read

    • pe – publication management (edit)

  • Attribute publication.collections

    Collections identifiers separated by a comma to which publication is be assigned to.

  • Attribute publication.destination.directoryId

    Destination directory identifier.

  • Attribute publication.destination.parentPublicationId

    Destination group publication identifier.

  • Attribute publication.mainFile

    The name of the publication main file (including extension). Specified file has to be in directory describing this publication.

  • Attribute publication.metadataFile

    Metadata filename (including extension). Metadata file has to be accordant with RDF format and it has to be placed in directory describing a publication. By default metadata filename is the same as publication main file name except the extension—it is .rdf.

  • Attribute publication.name

    Publication name.

  • Attribute publication.notes

    Administrative notes concerning publication.

  • Attribute publication.published

    Attribute indicating whether the firs edition of this publication should be published or not. If the value is true edition will be published. In any other case the edition will not be published. Default value is false.

  • Attribute publication.secured

    Attribute indicating whether the publication should be secured or not. If the value is true publication will be secured. In any other case it will not be secured. Default value is false.

Examplary publication.properties file:

publication.actorsRights.publicGroup=pv,pr
publication.collections=2,7,12
publication.destination.directoryId=1
publication.mainFile=index.htm
publication.metadataFile=metadata.rdf
publication.name=Przykładowa publikacja
publication.notes=Stworzone przez Jana Kowalskiego
publication.published=true                    

Above examplary file specifies a publication. publicGroup will have right to view (pv) and read (pr) it. Publication will be assigned to collections indicated by identifier 2, 7 and 12. Publication will be placed in the directory indicated by identifier 1. Publication main file will be index.htm and metadata are in metadata.rdf file. Publication name is “Examplary publication” and administrative notes are “Created by John Smith”. First edition of this publication will be published and publication itself will not be secured.

To create publication it is required a minimal set of informations described below. It it is impossible to gain all these informations it is impossible to creata a publication.

  • Publication destination in Directories Tree. There are two ways to specify it: destination directory (publication.destination.directoryId attribute) and destination group publication (publication.destination.parentPublicationId attribute) or destination directory only.

  • Publication main file. It is specified by publication.mainFile attribute and it is required.

  • Publication name. There are two ways to specify publication name. First way is to specify publication.name attribute. If this attribute is not specified metadata file will be checked in order to compose publication name in the same way as in fourth step of new publication creator (it is composed of title, author and date). So metadata file is the second way.

3.4.6.2.2. Inheritance in publication.properties files

Inheritance mechanism was introduced in order to simplify assigning some attributes from publication.properties file.

Inheritance mechanism works in the following way: For every publication.properties file, which is to be read (let us name it a “child”), it is checked if there exists a publication.properties file in the upper directory (let us name it a “parent”). If the “parent” file exists its content is read, then the content of “child” is read. During the reading process there is a rule that says that attribute values are overridden. It means that if both “parent” file and “child” file specify the same attribute, the “child”'s attribute value is taken (“parent” attribute value is overridden).

Notice that this mechanism works recorsivelly. It means that before the “parent” file is read, it is checked if there exists its “parent” (if yes, it is read).

3.4.6.2.3. Metadata file inheritance

This mechanism works in the same way as for publication.properties files with one exception—“parent” file should have publication.rdf name.

So, if we will specify in publication.properties file attribute publication.metadataFile, it will be checked if there exists its “parent” (publication.rdf).

3.4.6.2.4. 

Menu item Save properties file... in menu Tools makes it possible to save information describing selected on the elements list publication (such a file can be used as an example for mass publication upload).

3.4.7. Editor's application configuration

After choosing the Configuration option from the Program menu configuration window will appear ( Figure 3.33, “Application's configuration window”).

Figure 3.33. Application's configuration window

Application's configuration window

Tabs placed in configuration window are responsible for configuration of particular application features. In the following sections all the tabs are described.

3.4.7.1. Program configurarion

Program settings tab enables user to adjust editor program view. This configuration is connected with editor program modes. If Always show publication's editions option is not checked then editor application works in simple mode, otherwise it works in advanced mode. Switching mode in editor application this option is switched in fact. The meaning of the option is described in Table 3.1, “Differences between editor's application work modes”.

3.4.7.2. MARC and RDF settings

MARC and RDF settings tab allows adjusting bibliographic description import from files in MARC 21 communication and RDF format. On the Import settings panel two points are placed.

Figure 3.34. Konfiguracja - zakładka Ustawienia MARC i RDF

Konfiguracja - zakładka Ustawienia MARC i RDF
  1. Configures imports from both formats. Here, you can specify source of external configuration. The source may be either directory (Directory option) or web link (WWW link option). In both cases in specified place (directory on hard drive or on the web page) three configuration files should be present:

    In case of Directory option you have to select directory which contains configuration files by pressing the Open... button. In case of WWW link option you have to type web page address in the text field and press Download button in order to retrieve configuration files.

    If the Use formats from specified location check box is selected then the configuration from specified location is used, otherwise default configuration is used ( Appendix D, Editor's application default configuration).

  2. It concerns only MARC configuration. On the MARC files encoding list you can select encoding used to read files in MARC 21 communication format.