Difference between revisions of "Team:Cambridge-JIC/Wiki Design"

Line 27: Line 27:
 
<h3> Using CSS and JS </h2>
 
<h3> Using CSS and JS </h2>
 
<p>As iGEM teams are unable to upload and refer to CSS and Javascript files, styling your webpages takes a different method to the standard way. Instead, we have uploaded pages that end in _CSS and _JS that are linked in the html of our other pages. To use a page as a file, simply put the code in HTML and refer to the URL with:</p>
 
<p>As iGEM teams are unable to upload and refer to CSS and Javascript files, styling your webpages takes a different method to the standard way. Instead, we have uploaded pages that end in _CSS and _JS that are linked in the html of our other pages. To use a page as a file, simply put the code in HTML and refer to the URL with:</p>
−
<br>
+
<code> < script src="//2015.igem.org/Team:YourTeam/file_js?action=raw&ctype=text/javascript">< /script ></code>
−
<code> < script src="//2015.igem.org/Team:YourTeam/file_js?action=raw&ctype=text/javascript"></script ></code>
+
 
<p>
 
<p>
 
for javascript and:</p>
 
for javascript and:</p>
 
<code>< link href="//2015.igem.org/Team:YourTeam/file_css?action=raw&ctype=text/css" rel="stylesheet" ></code>  
 
<code>< link href="//2015.igem.org/Team:YourTeam/file_css?action=raw&ctype=text/css" rel="stylesheet" ></code>  
−
<br> <p>for css. This takes the raw code that was entered as if it was an uploaded file.</p>
+
<p>for css. This takes the raw code that was entered as if it was an uploaded file.</p>
 
<h3> Bootstrapping your Wiki <h3>
 
<h3> Bootstrapping your Wiki <h3>
  

Revision as of 22:45, 18 September 2015

CAMBRIDGE-JIC

Wiki Design Guide

Make your wiki more beautiful than our team.

This guide briefly dives into incorporating CSS, Java Script and JQuery into your wiki, a few graphic design tips, and ways to improve the user experience.

Using CSS and JS

As iGEM teams are unable to upload and refer to CSS and Javascript files, styling your webpages takes a different method to the standard way. Instead, we have uploaded pages that end in _CSS and _JS that are linked in the html of our other pages. To use a page as a file, simply put the code in HTML and refer to the URL with:

< script src="//2015.igem.org/Team:YourTeam/file_js?action=raw&ctype=text/javascript">< /script >

for javascript and:

< link href="//2015.igem.org/Team:YourTeam/file_css?action=raw&ctype=text/css" rel="stylesheet" >

for css. This takes the raw code that was entered as if it was an uploaded file.

Bootstrapping your Wiki

JQuery

Graphic Design

Colours

Before creating too many images and colouring in your wiki, deciding on a colour scheme can ensure your wiki looks professional.

Colours in HTML are given as RGB values. These can be difficult to visualise and match. Instead pick your colours first with HSL (hue, saturation and lightness) values. As a guide, three to four different hues is easy to work with.

  • We used four different hues that were all cool colours.

  • Each hue was split into two or three shades, made by changing the lightness and saturation.

  • For backgrounds, avoid using highly saturated colours. None of the colours we chose were very saturated, this is to reduce the strain on viewers' eyes. This is why pastel palettes can be so visually pleasing.

  • It's useful to have both dark (around 80/255 lightness) and light (around 220/250 lightness) colours when considering text on backgrounds. High contrast is needed to easily make out the features of words. Note also that fine details in bright blue can be hard to resolve with the human eye due to the lower abundance of S-cone receptor cells in the eye.

  • Once you have picked a few colours then find their RGB values, ready to use for your website!

Fonts

Unify your fonts across your webpage. Ideally, decide on one or two serif fonts and one or two sans-serif fonts. Serifs are the ticks on text that can make it easier to read, as letters are identified more easily. Our wiki uses three fonts: Sabon - a serif font, Open Sans, and Hiragino Sans GB.

When including fonts in style tags in your wiki, assign a family of fonts using font-family: font1, font2,... where font1, font2,... is the preferential order of similar fonts to be displayed in case a certain font isn't supported by the user's browser.


Making Images with Inkscape

Almost all of our images have been made on the program Inkscape. Inkscape is a free multi platform graphic designing software which is extremely easy to pick up and make graphics with. Three of our team learned the basics over night and created all of the back-panels of this website subsequently with it.

Check out Inkscape here.

User Experience

Navigation

Navigation is really important in an iGEM wiki. Users need to be guided through the website, with out losing the freedom to navigate quickly to any other location. Whereever you are in a team's wiki, having an impression of how much information is on the page, and on the other pages keeps the user from feeling lost.

Our approach to the navigation of our website involves two depth levels of information. The top menu bar contains the six different aspects of our project and going one by one through these allows for a brief overview of everything that we've done. Links to each of these pages are available from our home page. Each page has links to the deeper level of information, clicking on one of these from our home page gives you the details and specifics, including downloads and reports.

And the best part, at any point you can swap between the brief overviews and detailed information. Just click "learn more" for details.



By structuring the website as a 2 layer deep hierarchy, users can travel through our wiki to get an overall idea and go indepth on anything that catches their eye. Of course, they are also free to teleport to any page with the menu bar above. Finally, our downloads page contain all the possible downloads found throughout the website for ease of access.

Happy Navigating!