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.
A novel feature in the latest versions of EJS is the digital library concept. This option allows EJS users to distribute their own simulations by means of servers working as digital repositories. These repositories will be accesible by any EJS user as long as he/she made them visible. As any repository on the Internet, a EJS 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 EJS 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:
1) A web server with PHP support (download the php file from here) to host and publish the EJS simulation files.
2) The simulation (.zip) files created by EJS (http://www.um.es/fem/EjsWiki/Main/Deployment) you want to share with the community.
3) A html file presenting your digital library and some others html files giving a brief description of each simulation at your repository. These html files are shown by EJS when navigating through the digital library.
The steps for setting up the digital library are listed below:
1) Create a folder with the name you want to give to your digital library and copy this file to it.
2) You can add as many folders as you desire to your root folder in order to separate the simulations into different topics or subjects.
3) A 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) A default plain text introductory page, if there are no simulations (zip files) in its folder.
B) Or a plain text with the list of the simulations available at that folder of the digital library, otherwise.
4) Place the simulation (.zip) files created by EJS in the previous subfolders. You may now also add a 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).