All Blogs | Help | Support | About
x This LabTrove instance has just been upgraded to 2.3, to see what new check out the documentation, http://www.labtrove.org/documentation/
25th July 2013 @ 01:19

Hello and thank you for your interest in OSM and the ELN.

This post serves as a general 'How To' for creating an OSM lab book entry. Specific guidelines for Creating the 'Perfect' Chemistry ELN entry or Creating the 'Perfect' Biological Data ELN entry are found elsewhere.

If you have any questions or queries contact the team on G+, Twitter or as a last resort email.

Get me to the ELN!

Navigate to the electronic lab notebook (ELN) using link from the OSM landing page or by going directly to: www.malaria.ourexperiment.org.

 

Login

Anyone can view the content in the lab notebooks but in order to comment or to create content, a simple login step is required.

Login as OSM ELN (all administrative posts)

For 99% of ELN posts where data is reported the scientist/author should login as themseleves - see next paragraph. However, for some administrative or collaborative posts, it may be more appropriate to login as 'OSM ELN' so that others can edit the text. If you would like to post as OSM ELN then message us on twitter or email: opensourcemalariaeln@gmail.com and we will send you the password.

Creating a Personal Login (all regular experimental posts)

Click the ‘Login’ button in the top left-hand corner of the page. 

You can use your login details for any one of a number of web services - so no need to create yet another username and password! (N.B for the purposes of this 'how to' Google has been chosen for the login, so slight variations may apply to the login instructions for other web service providers.)


Select your preferred 'login' and choose 'remember me' if you would like to login more quickly next time. Your internet browser will automatically log you out after a certain amount of time.

The first time that you use your login you will be asked to provide a few extra details. Fill in your email and password (or other requested details depending on the web service) and then choose 'sign in'.

 

 

You will be asked to enter your name and email address once again. Please use your full name, for example 'Alice Williamson' rather than a nickname or alias - that makes it easier to track who has written what. Then press continue. 

Congratulations, you are now a signed up member of the OSM ELN! Following your first login, you can subscribe to the OSM lab books you're interested in. Click 'All Blogs' in the top right-hand menu.

 

Next tick the box next to the blogs (lab books) you'd like to subscribe to (if in doubt select all). 

Once you have selected all of the blogs you would like to read/contribute to press save and navigate back to the dashboard by clicking 'Dashboard' in the top right-hand corner of the screen.

                                    


Getting Started with Creating a Post

Now you are ready to post your first entry!

Your dashboard should now look a lot busier. Select the relevant blog you want to contribute to. Blogs are "authored" according to the person who first posted in the blog, however anyone can contribute to any blog. In general, there is no need to create a new blog unless your contribution to the OSM ELN is linked to a different series of compounds, if in doubt ask the team.

 

Once you have selected the relevant blog a blank template should appear on your screen. Firstly, create a title for your post (see here for experimental blog instructions) and then enter text into the blank window below. The formatting tools are similar to those used in standard word processing programs.

Saving

To avoid losing your work, or in order to save your work for further editing before publication, scroll down to the bottom of the page and click 'Save for Later'. 

A new page will now appear showing that your post is now saved and that only you can read it


In order to edit your post, scroll down to the bottom and click 'Edit Post'.

Inserting a Link

To insert a link in your post, firstly copy the link address that you wish to include.

Next highlight the text in your post that you would like to hyperlink and then click on link icon in the toolbar.

 

The window shown below will appear. Simply paste the link address in the box and then press insert.

The link is now active in your text.

However, if you want to link to other entries in the ELN then click the icon in the toolbar shown below. This is a very useful tool for navigation between blog entries so please use this where applicable.

Place the cursor where you would like to insert the link then click on the 'insert link to blog post icon'. 

A new window will open, click on the blog post that you would like to link.

The link will now appear in the text. The post you have linked to will automatically show a link to your current post - very cool, and keeps all relevant posts nicely linked. 

Uploading Files

Almost any kind of file can be uploaded to the ELN. This means that it is a great place to store, share and access raw data, and therefore ideal for an open source science project.

Uploading files is easy. Firstly, scroll to the bottom of your post and click 'upload data'.

A new window (as shown below) will appear. You can either drag files directly into the window or click on the blue button to upload a file.

Select the file(s) to upload and then press 'Open'.

The selected file(s) will appear in the box higlighted in yellow. Click 'Start Upload' and watch as the file(s) change from yellow=not uploaded to green=uploaded. 

    

Once the file(s) are highlighted green, the upload is complete and you can exit the window and return to the ELN blog page.

The uploaded files now appear as thumbnails at the bottom of the post.

To insert a link to a particular file in the text (makes the post easier to read), click your cursor where you want the link to go and click 'add link to text' for the chosen file.

The link will appear in a code format until you save or publish your post, when it will change to a thumbnail in the main body of the text.

  

Inserting an Image

To insert an image in the main text body, follow the previous instructions for uploading the image file. It is best to save the image in 'PNG' format. Other formats may also work, but this might require some experimentation.

Once the chosen PNG image has been uploaded, click on the thumbnail.

A new window will open with a html link in the address bar. This is not the correct address to copy. Instead click on 'open as PNG' in the bottom left-hand corner.

A new window will appear, and the address ending with '.png' should be copied and then the window closed.

On returning to the blog entry, place the cursor in the position where the picture should go and click on the add image icon in the tool bar. 

A new window will open. Paste the address into the top box and then edit the size of the image in the 'Appearance' tab. Then press insert. The image can be edited further after insertion into the text so don't worry if it doesn't look perfect first time.

     

The image will now appear in the body of the post.

Publishing

When you are happy with your post, have a final proofread and then get ready to publish. In particular, check the blog title as @labtrove simultaneously tweets the title of your blog when you press 'Publish'.  

Firstly, select the appropriate section (like a post classification) from the dropdown menu.

If the right description isn't there then create a new section and then press publish.

 

Editing

Don't panic if you notice a mistake after publication or if you would like to add some more text, data etc. Press 'Edit Blog Entry' to return to your post. One of the very important things about this ELN is its revision history. This means that a 'hidden' log of all changes to the blog is stored on each edit. This is particularly important for experimental data and procedures for legal reasons as they are time and date stamped. Additionally, nobody can sabotage a lab notebook entry by deleting or modifying data without a record of this being logged. 

When you edit a blog post you need to enter a reason for your edit before you will be able to save your entry by hitting 'Publish' again. Try to make this brief but informative.

 

Adding Comments

If you would like to comment on someone else's post, login and click 'Add Comment' below the post you wish to comment upon.

Please bear in mind that there are no notifications currently active on labtrove, so you may wish to alert the author of your comment.

Accessing your Post

It is possible to search the whole of the OSM ELN or in individual blogs to find a particular entry by typing keywords in the search box.

Additionally, the blog posts are collated by author and/or other metadata that has been added (month, author, section, etc) so hopefully navigation will be a breeze.

Sharing ELN Links

Once you have finished writing your post, hopefully you will want to share it with the world. The URL for a blog (as copied from the address bar) is quite cumbersome. For example, this blog's address is:

http://malaria.ourexperiment.org/osm_logos_and_templ/7773/Creating_a_General_Blog_Entry_on_the_Open_Source_Malaria_Electronic_Lab_Notebook_OSM_ELN.html

In order to shorten the link, click on 'URI Label' from the righ-hand panel.

Next, select and copy the URI. This link (e.g., http://malaria.ourexperiment.org/uri/3dc)

 can be used to share your work with others.

Thanks for reading this 'how to' and Happy ELN-ING!

Cheers,

The OSM Team

Attached Files
ELN fromlandingpage.png
Choose Login.png
Login.png
Unchecked blogs.png
Registration.png
Blog Subscription.png
google login.png
Back to dashboard.png
Subscribing.png
Subscriptions added.png
Saving sub.png
upload5.png
upload2.png
upload4.png
upload data1.png
Save.png
link added.png
saved.png
Add link Part3.png
adding link Part2.png
Typing.png
Adding link.png
New Post.png
upload6.png
upload 7.png
editpost.png
comment.png
add link to blogpost.png
image done.png
insertimage4.png
insertimage7.png
insertimage3.png
insertimage5.png
insertimage1.png
insertimage2.png
addlinktotext.png
codeformat.png
thumbnail.png
added files.png
new section.png
publish.png
editing.png
bloglink1.png
bloglink2.png
bloglink1.png
bloglink2.png
blog link added.png
bloglink1.png
navigation.png
URI.png
URI Label.png