How to create your own EJS digital library
Here you will find a description on how to create a digital library for the simulations you develop.
An interesting feature in EjsS is the Digital Library concept. This option allows EjsS users to distribute their own simulations by means of servers working as digital repositories. These repositories will be accesible by any EjsS user as long as he/she made them visible. As any repository on the Internet, an EjsS digital library is accesible from an Internet address, provided by the developer of the digital library. This address is added from the “EJS options” icon of the toolbar, as shown in figure below. Users are then able to read the corresponding library by clicking on the “Read from an EJS digital library” icon of the EjsS toolbar and selecting it from the list of libraries available in the “Connect to the EJS digital library” list.
Some digital libraries are already public and so the previous steps are not necessary since any user can access them directly. If you want your library to be public, please contact the author.
The only requirements in order to create your own digital library are:
- A web server with PHP support.
- (Optionally) A set of html files presenting your digital library and giving a brief description of each simulation at your repository. These html files are shown by EjsS when navigating through the digital library.
The steps for setting up the digital library are listed below:
- Create a folder with the name you want to give to your digital library. Download and unzip this ZIP file and place the two extracted PHP scripts in that folder.
- You can add as many folders as you desire to your root folder in order to separate the simulations into different topics or subjects.
- An html file (name it info.html) presenting the digital library may be placed in the root folder and in every subfolder too, although this is not necessary. Create a folder named “_yourFolderName” to contain the images used in your info.html files. You need to do this for every folder with at least one info.html file having any images. Folders beginning with “_” will not be shown to the users of the digital library. In case the info.html file is not provided, EJS will show:
- A default plain text introductory page, if there are no simulations (zip files) in its folder.
- Or a plain text with the list of the simulations available at that folder of the digital library, otherwise.
- You may now also add an html file per simulation (.zip file) at that subfolder sharing the same name and containing a brief description of them. Remember to add “_” at the beginning of any folder name you do not want to be seen, (for example, the folders with images for these html files).