Tutorial: Adding a document to the repository
(we need help to improve this translated tutorial)jLibrary document structure is very similar to the typical file-based structure. The two basic units of any repository are directories and documents.Directories, are folder where information will be stored. Documents, represent any media type stored on the repository, from text files to multimedia video.
Before starting with the turoial, you should have in mind that to create documents you must have write permissions on the repository. In case that you don't have permissions, you'll get an error message. If that happens, you should contact with your jLibrary server admin to ask him for write permissions.
Directory creation is a very easy task. Simply you have to right press over the repository in which you want to create the document, or over another directory, and choose the menu option New -> Create new directory
Once you have done it, it will appear a new directory wizard that will ask you for the name and description of the repository. Enter directory data and press Accept to continue.
When you have selected that option, it will appear the document creation wizard. This wizard has four sections: document data loading, resources loading, metadata loading and categories loading. The first one is the document loading page:
The first thing you must do is press the document loading button. This button will show a file selection dialog. Select the document you want to load and press Open. One you have done this, jLibrary will try to obtain document metadata automatically. This operation can take some seconds if the file is too big, because jLibrary analyzes file content searching for the most appropiate keywords.
In the case of jLibrary not being able to get metadata, or if jLibrary founds wrong metadata, you have to enter manually the name and description for hte document. You can also modify the importancy of the document. One important document would have preference at the time of performing searchs.
The second page is the resources one:
In this page you can add files from which the document depends for its correct visualization or operation. This files can be video files, audio files, text documents, etc. One typical example of such dependencies would be a web pages with images, css stylesheets or JavaScript files. From this page, you can also add complete resouces directories.
The third page is about document metadata:
In this page you can enter document metadata. This metadata offer additional information about the document. This information will be specially useful at the time of search operations. If jLibrary recognizes the document format (PDF, Word, XML, HTML, etc.), it will try to automatically extract the metadat from document header. If the document doesn't have such metadata, you'll have to enter this metadata manually.
jLibrary also analyzes automaticall the document content to search for the most appropiate indexation keywords. If this keywords aren't useful for you, you can manually substitute them for others.
jLibrary also includes an authors management module. If jLibrary doesn't recognize the author of a document, it will assing the Unknown author to the document. Pressing the author management button, you can create new authors, and assign an author to the document.
The last page is the categories one:
This page allows adding the document to different categories. By default, the document is classified under Unknown category. If you wish to add the document to another category, you can press the plus button. If you wish to remove the document from any category, you can select that category and press the minus button.
Once that you have entered all document data, you can press Finish button to create the document. If that button isn't enabled, then you have forgotten to enter some important mandatory data. In such cases, an informative message should be shown in the wizard's top, telling you which is the missing data.
Congratulations ! You have created your first document :)
-martin