Difference between revisions of "Wiki Requirements"
m |
|||
(39 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{2015Top}} |
− | + | ||
<html> | <html> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<!-- this is where the submenu is placed --> | <!-- this is where the submenu is placed --> | ||
− | + | <div id="leftColumn"> | |
− | + | <ul> | |
− | + | <a href= "https://2015.igem.org/Wiki_Requirements#requirements"> <li class="menusubtopic"> Wiki Requirements</li></a> | |
− | + | <a href= "https://2015.igem.org/Wiki_How-To/Standard_Pages"> <li><b>New</b> - Standard Pages</li></a> | |
− | + | <a href= "https://2015.igem.org/Wiki_Requirements#dosanddonts"> <li>Wiki Dos and Don'ts</li></a> | |
− | + | <a href= "https://2015.igem.org/Wiki_Requirements#editing"> <li>Wiki Editing</li></a> | |
− | + | <a href= "https://2015.igem.org/Wiki_Requirements#perspective"> <li>Perspectives from an iGEM veteran</li></a> | |
− | + | <br><br> | |
− | + | <a href="https://2015.igem.org/Wiki_Requirements/Using_HTML,_CSS,_and_Javascript"><li class="menusubtopic">Using HTML, CSS, and Javascript</li></a></ul> | |
− | + | </div> | |
<!-- this is where the content is placed ---> | <!-- this is where the content is placed ---> | ||
Line 29: | Line 21: | ||
<!-- start of content ----------------------------------------> | <!-- start of content ----------------------------------------> | ||
− | < | + | <!-- **** ALERT *** --> |
− | < | + | <div style="width:700px; margin:auto; background-color:pink; border-radius:5px; border:1px solid #ccc; margin-bottom:15px; margin-top:15px; padding:5px;"> |
− | <p> All iGEM 2015 Team Wikis are required to have the iGEM Login Bar. The Login Bar includes essential links, tools, and information for all users: both wiki creators and viewers. The judges need these tools. Teams are not allowed to hide, disable, or alter the login bar, so please keep this in mind as you design your wiki.</p> | + | <h4>2015 WIKI Frozen</h4> |
+ | <p>The wiki has been archived into a permanent record of iGEM 2015.<p> | ||
+ | </div> | ||
+ | <div style="width:700px; margin:auto; background-color:pink; border-radius:5px; border:1px solid #ccc; margin-bottom:15px; margin-top:15px; padding:5px;"> | ||
+ | <h4>Other teams' content showing up in your wiki?</h4> | ||
+ | <p>There is a problem with some team wikis, where content from the wrong team appeared by accident. | ||
+ | <span class="highlightText">Please do not edit other teams' wiki pages! Instead, just remove their content from your wiki page, and add your own.</span> | ||
+ | If you want to get a "clean copy" of the blank wiki, you may copy from the <a href="https://2015.igem.org/Team:Example2">Example2</a> wiki. Remember to change "Example2" to your own team name whenever it appears!<p> | ||
+ | </div> | ||
+ | |||
+ | |||
+ | |||
+ | <h3>The iGEM Login Bar</h3> | ||
+ | <p> All iGEM 2015 Team Wikis are required to have the iGEM Login Bar. The Login Bar includes essential links, tools, and information for all users: both wiki creators and viewers. The judges need these tools. <b><i>Teams are not allowed to hide, disable, or alter the login bar</b></i>, so please keep this in mind as you design your wiki. This is a new rule for 2015.</p> | ||
<p>The iGEM Login Bar is a 20 pixel high, full-width menu bar that exists on all 2015.igem.org pages. It contains: | <p>The iGEM Login Bar is a 20 pixel high, full-width menu bar that exists on all 2015.igem.org pages. It contains: | ||
<ul> | <ul> | ||
Line 42: | Line 47: | ||
</ul> | </ul> | ||
</p> | </p> | ||
+ | |||
+ | <div class="clear"></div> <div class="clear"></div> | ||
+ | <h3><a id="standardpages"></a>Standard Pages and links</h3> | ||
+ | <p>We have created standard pages with static links for all awards and for most medal criteria. If your team wants to be evaluated for an award, you will need to document your achievements related to this award on a standard page. </p> | ||
+ | <p>Please read all about this big change on our new <a href="https://2015.igem.org/Wiki_How-To/Standard_Pages">Standard Pages</a> Page.</p> | ||
+ | |||
<h4>No Adobe Flash</h4> | <h4>No Adobe Flash</h4> | ||
<p>Flash is not permitted on the iGEM 2015 wiki. Adobe flash is 100% proprietary and you cannot view the source like you can with our wiki. We chose wikis for teams to build their projects so the source code would be available for future teams, to build on the concept of open source. Flash can also be hosted on external sites and we want 100% of the content of our wikis to be on our wikis. </p> | <p>Flash is not permitted on the iGEM 2015 wiki. Adobe flash is 100% proprietary and you cannot view the source like you can with our wiki. We chose wikis for teams to build their projects so the source code would be available for future teams, to build on the concept of open source. Flash can also be hosted on external sites and we want 100% of the content of our wikis to be on our wikis. </p> | ||
− | <h4> | + | |
− | <p>All team pages, images, documents | + | <h4>Host all content on 2015.igem.org</h4> |
− | <p>Additionally, hosting content outside of 2015.iGEM.org allows teams to change/add information to their wiki after the wiki freeze. Please note | + | <p>All team pages, images, documents <b>and code</b> must be hosted on the <b>2015.igem.org</b> server. We preserve all iGEM content on our own servers so future teams can learn from what you have done. When you store content on your own sites or servers, after time, links might become broken, sites might go down, and information will be lost. </p> |
− | <p>Load your CSS and Javascript into the wiki, either directly into your page or using templates.</p> | + | <p>Additionally, hosting content outside of 2015.iGEM.org allows teams to change/add information to their wiki after the wiki freeze. Please note that altering content after the wiki freeze is a <a href="https://2015.igem.org/Responsible_Conduct">form of cheating</a>. </p> |
+ | |||
+ | <p>Load your CSS and Javascript into the wiki, either directly into your page or using templates. Do not link to scripts or stylesheets that are hosted on other servers.</p> | ||
</p> | </p> | ||
<h4>No iframes</h4> | <h4>No iframes</h4> | ||
<p><b>iframes</b> are not permitted on the iGEM wiki. If an iframe was used to access content outside of <b>2015.igem.org</b>... | <p><b>iframes</b> are not permitted on the iGEM wiki. If an iframe was used to access content outside of <b>2015.igem.org</b>... | ||
<ul> | <ul> | ||
− | <li>it would break when | + | <li>it would break when the outside server had any problems</li> |
− | <li>it would allow a team to | + | <li>it would allow a team to change/add content after the wiki freeze. Please note that altering content after the wiki freeze is a <a href="https://2015.igem.org/Responsible_Conduct">form of cheating</a></li> |
</ul> | </ul> | ||
</p> | </p> | ||
+ | |||
+ | <h4>No Copyrighted Materials</h4> | ||
+ | <p><b>Copyrighted</b> images and other materials are not permitted on the iGEM wiki. (You may use materials that are appropriately licensed for reuse, such as open-source code or Creative Commons licensed images.)</p> | ||
+ | |||
<h4>2015.igem.org/Team:Team_Name</h4> | <h4>2015.igem.org/Team:Team_Name</h4> | ||
<p>All iGEM 2015 teams are given a namespace on the iGEM 2015 wiki with their team name. Teams are allowed to create and edit pages within their respective team namespace. Teams are <b>not allowed</b> to create or edit pages belonging to another team's namespace.</p> | <p>All iGEM 2015 teams are given a namespace on the iGEM 2015 wiki with their team name. Teams are allowed to create and edit pages within their respective team namespace. Teams are <b>not allowed</b> to create or edit pages belonging to another team's namespace.</p> | ||
− | <h4>Wiki Freeze -September 18</h4> | + | <h4>Wiki Freeze - September 18</h4> |
<p>The wiki freeze for the 2015 Giant Jamboree is on <a href="https://2015.igem.org/Calendar_of_Events">September 18,</a> along with other deadlines. iGEM experiences higher than normal traffic on this day which can lead to strain on our servers and sessions timing out for users. iGEM HQ recommends that users do not wait till the last day to work/finish their wikis. <b>Once the wikis are frozen, users can no longer make any changes until they are unfrozen after the Jamboree.</b></p> | <p>The wiki freeze for the 2015 Giant Jamboree is on <a href="https://2015.igem.org/Calendar_of_Events">September 18,</a> along with other deadlines. iGEM experiences higher than normal traffic on this day which can lead to strain on our servers and sessions timing out for users. iGEM HQ recommends that users do not wait till the last day to work/finish their wikis. <b>Once the wikis are frozen, users can no longer make any changes until they are unfrozen after the Jamboree.</b></p> | ||
<h4>Other deadlines</h4> | <h4>Other deadlines</h4> | ||
Line 66: | Line 83: | ||
<p>All content on this wiki is available under the Creative Commons <a href="http://creativecommons.org/licenses/by/4.0/">Attribution 4.0</a> license (or any later version). | <p>All content on this wiki is available under the Creative Commons <a href="http://creativecommons.org/licenses/by/4.0/">Attribution 4.0</a> license (or any later version). | ||
<img src="http://i.creativecommons.org/l/by/3.0/88x31.png"></p> | <img src="http://i.creativecommons.org/l/by/3.0/88x31.png"></p> | ||
− | |||
− | |||
+ | <div class="clear"></div> <div class="clear"></div> | ||
<h2><a id="dosanddonts"></a>Wiki Dos and Don'ts</h2> | <h2><a id="dosanddonts"></a>Wiki Dos and Don'ts</h2> | ||
Line 79: | Line 95: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td>Make sure all wiki content | + | <td>Make sure all wiki content is hosted on <b>2015.igem.org</b>. (This includes text, files, HTML, CSS, Javascript, and other scripts.)</td> |
− | <td>Don't host your wiki or parts of your wiki elsewhere. <!-- It is possible to display contents from another server onto your wiki, using iframes or other methods. Please be aware that this violates the requirement for hosting all content on 2015.igem.org--> </td> | + | <td>Don't host your wiki or parts of your wiki elsewhere. Don't include scripts or stylesheets from other servers. <!-- It is possible to display contents from another server onto your wiki, using iframes or other methods. Please be aware that this violates the requirement for hosting all content on 2015.igem.org--> </td> |
<td>iGEM content is preserved on our servers so future teams can learn from what you've done. When content is stored on other sites/servers, links may become broken (<a href="https://static.igem.org/mediawiki/2015/d/d6/Wiki_server_example1.jpg" title="images were stored off-site, and became broken" target="_blank">example</a>), sites may go down, and <b>information will be lost.</b></td> | <td>iGEM content is preserved on our servers so future teams can learn from what you've done. When content is stored on other sites/servers, links may become broken (<a href="https://static.igem.org/mediawiki/2015/d/d6/Wiki_server_example1.jpg" title="images were stored off-site, and became broken" target="_blank">example</a>), sites may go down, and <b>information will be lost.</b></td> | ||
</tr> | </tr> | ||
Line 91: | Line 107: | ||
<td>Name uploaded files clearly and uniquely (TeamName_Header.png)</td> | <td>Name uploaded files clearly and uniquely (TeamName_Header.png)</td> | ||
<td>Don't use generic names for you files (Header.png)</td> | <td>Don't use generic names for you files (Header.png)</td> | ||
− | <td>Using <b>unique names</b> makes searching/identification of uploaded files easier, and | + | <td>Using <b>unique names</b> makes searching/identification of uploaded files easier, and reduces the chance that another team will accidentally overwrite your file with a different one having the same name.</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
Line 99: | Line 115: | ||
</tr> | </tr> | ||
</table> | </table> | ||
− | |||
+ | <div class="clear"></div> <div class="clear"></div> | ||
<h2><a id="editing"></a> Wiki Editing </h2> | <h2><a id="editing"></a> Wiki Editing </h2> | ||
Line 112: | Line 128: | ||
<p>You must keep your team's pages in your team namespace. For example, take a look at <a href="https://2015.igem.org/Team:Example">2015.igem.org/Team:Example</a></p> | <p>You must keep your team's pages in your team namespace. For example, take a look at <a href="https://2015.igem.org/Team:Example">2015.igem.org/Team:Example</a></p> | ||
<p>Specifically, when you create a new page, you just have to name it <b>Team</b>:<a href="https://igem.org/Team_List">OFFICIAL team name</a>/PageName. For example, if you were on Team Example and wanted to create a Biosensor project page you would name it <b>Team:Example/Biosensor_project</b>.</p> | <p>Specifically, when you create a new page, you just have to name it <b>Team</b>:<a href="https://igem.org/Team_List">OFFICIAL team name</a>/PageName. For example, if you were on Team Example and wanted to create a Biosensor project page you would name it <b>Team:Example/Biosensor_project</b>.</p> | ||
+ | <p>You should keep ALL your content within your team's namespace. This includes uploaded files, templates, CSS and Javascript pages, not just your main wiki pages.</p> | ||
<h4>Using html in wiki pages</h4> | <h4>Using html in wiki pages</h4> | ||
− | <p>Instead of using wiki markup, you can use <b> | + | <p>Instead of using wiki markup, you can use <b>HTML</b> in the wiki editor. Just put your html code in between <code><html> ... </html></code> tags.</p> |
<h4>Using CSS and/or Javascript</h4> | <h4>Using CSS and/or Javascript</h4> | ||
<p>You can also use <b>CSS</b> and <b>Javascript</b> on the wiki by adding your <i><style></i> and <i><script></i> tags into your <i><html></i> code.</p> | <p>You can also use <b>CSS</b> and <b>Javascript</b> on the wiki by adding your <i><style></i> and <i><script></i> tags into your <i><html></i> code.</p> | ||
<p>If you want to use a CSS stylesheet or Javascript on multiple pages, you can create a <b>wiki template page</b>.</p> | <p>If you want to use a CSS stylesheet or Javascript on multiple pages, you can create a <b>wiki template page</b>.</p> | ||
+ | |||
+ | <h4>Using <a href="http://learn.jquery.com/">jQuery</a></h4> | ||
+ | <p><b>jQuery 1.11.1</b> is already installed across all iGEM webpages. It adds many useful abilities to JavaScript. You do not need to include any extra source to use jQuery.</p> | ||
+ | |||
+ | <h4>Using <a href="http://www.mathjax.org/">MathJax</a></h4> | ||
+ | <p>MathJax is a JavaScript library for displaying mathematical equations. A copy of <b>MathJax 2.5</b> is installed on 2015.igem.org. To use it, add the following line to your HTML:</p> | ||
+ | <code><script src="https://2015.igem.org/common/MathJax-2.5-latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></code> | ||
+ | <p>For more information, visit the <a href="http://docs.mathjax.org/en/latest/start.html#putting-mathematics-in-a-web-page">MathJax documentation</a>.</p> | ||
<h4>Using Wiki Templates</h4> | <h4>Using Wiki Templates</h4> | ||
Line 126: | Line 151: | ||
<h4>Uploading videos and using HTML 5 to display them</h4> | <h4>Uploading videos and using HTML 5 to display them</h4> | ||
− | <p>You can upload videos (ogg, | + | <p>You can upload videos (ogg, mp4, webm) to the 2015 wiki by using Mediawiki's <a href="https://2015.igem.org/Special:Upload">Upload tool</a>.</p> |
− | <p>You can display videos by using the HTML 5 <i><video></i> tag, along with <i><source src="file_url" type="video/ | + | <p>You can display videos by using the HTML 5 <i><video></i> tag, along with <i><source src="file_url" type="video/ogg" /></i>.</p> |
<p>Take a look at the <a href="https://2013.igem.org/Team:Leeds">2013 Leed's team wiki</a> to see how they displayed their video. You can do this by going to their wiki, and looking for <i>view source</i> in the default wiki links at the top of the page.</p> | <p>Take a look at the <a href="https://2013.igem.org/Team:Leeds">2013 Leed's team wiki</a> to see how they displayed their video. You can do this by going to their wiki, and looking for <i>view source</i> in the default wiki links at the top of the page.</p> | ||
+ | |||
+ | <h4>Pages with Static Links</h4> | ||
+ | <p>This year, we are requiring that information pertinent to specific prizes must appear on specific, static URLs on your wiki. Dynamically generated pages may not be understood correctly by the Judging Form.</p> | ||
+ | <p>Please review <a href="https://2015.igem.org/Wiki_How-To/Standard_Pages">the Wiki Standard Pages requirements</a>, and perhaps <a href="https://igem.org/Team_Judging">test your pages on the Judging Form</a> to see if they are understood correctly. If they are not, you risk that the judges may not evaluate those parts of your wiki.<p> | ||
+ | |||
+ | <h4>Need more technical details?</h4> | ||
+ | <p>Visit our extra help page on <a href="https://2015.igem.org/Wiki_Requirements/Using_HTML,_CSS,_and_Javascript">Using HTML, CSS, and Javascript on the iGEM wikis</a>.</p> | ||
<br /><br /> | <br /><br /> | ||
+ | |||
+ | <div class="clear"></div> <div class="clear"></div> | ||
<h2><a id="perspective"></a> Perspectives from an iGEM veteran </h2> | <h2><a id="perspective"></a> Perspectives from an iGEM veteran </h2> | ||
Line 139: | Line 173: | ||
In 2011 and 2012 my role was to design and create our team’s wiki. So wiki freeze was my major deadline. I am by no means an expert but let me share with you some of the things I learned with two wiki freezes under my belt.</p> | In 2011 and 2012 my role was to design and create our team’s wiki. So wiki freeze was my major deadline. I am by no means an expert but let me share with you some of the things I learned with two wiki freezes under my belt.</p> | ||
− | <h4> 1. | + | <h4> 1. Test your webpage layout: is information easy to find?</h4> |
<p>I made the terrible mistake of not asking for a third party’s opinion about the layout of information on our site. It was obvious for me how things were laid out and organized. It wasn’t for the people evaluating us. <br> | <p>I made the terrible mistake of not asking for a third party’s opinion about the layout of information on our site. It was obvious for me how things were laid out and organized. It wasn’t for the people evaluating us. <br> | ||
Also, stick to the 3 click rule: content must reachable within 3 clicks so the user does not feel lost or confused. If someone wants to read your abstract, their path should be something like this (Menu –> Project –> Project Description -> Abstract)</p> | Also, stick to the 3 click rule: content must reachable within 3 clicks so the user does not feel lost or confused. If someone wants to read your abstract, their path should be something like this (Menu –> Project –> Project Description -> Abstract)</p> | ||
− | <h4> 2. | + | <h4> 2. Look at other teams’ code, see how they documented and what resources they used. </h4> |
<p>It is always good to get inspiration from other iGEM teams. See what you liked that they did and strive to improve! </p> | <p>It is always good to get inspiration from other iGEM teams. See what you liked that they did and strive to improve! </p> | ||
− | <h4> 3. | + | <h4> 3. Start working on your documentation early on. </h4> |
<p>This was a good thing that we did; we created a common file that more than one person can edit at a time. Divide the documentation into smaller files and assign a team member to fully document that topic. In the end you will have a printable version of your project that you can share as a pdf file with other people!</p> | <p>This was a good thing that we did; we created a common file that more than one person can edit at a time. Divide the documentation into smaller files and assign a team member to fully document that topic. In the end you will have a printable version of your project that you can share as a pdf file with other people!</p> | ||
− | <h4>4. | + | <h4>4. Name your images according to the project and keep them all in a folder on your computer.</h4> |
<p> Sometimes naming your gel image “gelthingy_whyiamworkingat3am” sounds perfect at 3AM but later it may not be easy to know what or when that photograph was taken or that image created. <br> | <p> Sometimes naming your gel image “gelthingy_whyiamworkingat3am” sounds perfect at 3AM but later it may not be easy to know what or when that photograph was taken or that image created. <br> | ||
Also, the iGEM database doesn’t know that you created that file so if someone names their file with the same name it can end up being replaced! Avoid using generic names like “banner.png” or “logo.jpg”.<br> | Also, the iGEM database doesn’t know that you created that file so if someone names their file with the same name it can end up being replaced! Avoid using generic names like “banner.png” or “logo.jpg”.<br> | ||
Try using your team’s name and the webpage where the image will appear, this helps you remember where to place it and reduce the risk of another team overwriting. “JoyUniversity_TeamBios_Richard.jpg” </p> | Try using your team’s name and the webpage where the image will appear, this helps you remember where to place it and reduce the risk of another team overwriting. “JoyUniversity_TeamBios_Richard.jpg” </p> | ||
− | <h4>5. | + | <h4>5. Do not leave everything to the last minute! </h4> |
<p>Plan ahead. The last thing you want to be doing at 11:30PM the night of wiki freeze is uploading images. It is very stressful to be looking at the clock and hoping some kind of coding miracle helps you fix bugs faster. Plan to have everything online at least one week ahead so you can go enjoy a nice dinner with your team that night! </p> | <p>Plan ahead. The last thing you want to be doing at 11:30PM the night of wiki freeze is uploading images. It is very stressful to be looking at the clock and hoping some kind of coding miracle helps you fix bugs faster. Plan to have everything online at least one week ahead so you can go enjoy a nice dinner with your team that night! </p> | ||
<br /> | <br /> | ||
Line 161: | Line 195: | ||
<br> | <br> | ||
<i> <A HREF="https://twitter.com/anita_sifuentes" > @anita_sifuentes </A> </i></p> | <i> <A HREF="https://twitter.com/anita_sifuentes" > @anita_sifuentes </A> </i></p> | ||
− | + | ||
<!-- end of content ----------------------------------------> | <!-- end of content ----------------------------------------> | ||
</div> | </div> | ||
− | <div class="clear"></div> | + | <div class="clear"></div> |
− | </html> {{ | + | </html> {{2015Bottom}}<html> |
</div> | </div> | ||
− | |||
</html> | </html> |
Latest revision as of 18:46, 4 January 2016
2015 WIKI Frozen
The wiki has been archived into a permanent record of iGEM 2015.
Other teams' content showing up in your wiki?
There is a problem with some team wikis, where content from the wrong team appeared by accident. Please do not edit other teams' wiki pages! Instead, just remove their content from your wiki page, and add your own. If you want to get a "clean copy" of the blank wiki, you may copy from the Example2 wiki. Remember to change "Example2" to your own team name whenever it appears!
The iGEM Login Bar
All iGEM 2015 Team Wikis are required to have the iGEM Login Bar. The Login Bar includes essential links, tools, and information for all users: both wiki creators and viewers. The judges need these tools. Teams are not allowed to hide, disable, or alter the login bar, so please keep this in mind as you design your wiki. This is a new rule for 2015.
The iGEM Login Bar is a 20 pixel high, full-width menu bar that exists on all 2015.igem.org pages. It contains:
- iGEM related pages
- wiki tools (edit, history, watch, etc.)
- search tools
- team information (not released yet)
- login
- site menu
Standard Pages and links
We have created standard pages with static links for all awards and for most medal criteria. If your team wants to be evaluated for an award, you will need to document your achievements related to this award on a standard page.
Please read all about this big change on our new Standard Pages Page.
No Adobe Flash
Flash is not permitted on the iGEM 2015 wiki. Adobe flash is 100% proprietary and you cannot view the source like you can with our wiki. We chose wikis for teams to build their projects so the source code would be available for future teams, to build on the concept of open source. Flash can also be hosted on external sites and we want 100% of the content of our wikis to be on our wikis.
Host all content on 2015.igem.org
All team pages, images, documents and code must be hosted on the 2015.igem.org server. We preserve all iGEM content on our own servers so future teams can learn from what you have done. When you store content on your own sites or servers, after time, links might become broken, sites might go down, and information will be lost.
Additionally, hosting content outside of 2015.iGEM.org allows teams to change/add information to their wiki after the wiki freeze. Please note that altering content after the wiki freeze is a form of cheating.
Load your CSS and Javascript into the wiki, either directly into your page or using templates. Do not link to scripts or stylesheets that are hosted on other servers.
No iframes
iframes are not permitted on the iGEM wiki. If an iframe was used to access content outside of 2015.igem.org...
- it would break when the outside server had any problems
- it would allow a team to change/add content after the wiki freeze. Please note that altering content after the wiki freeze is a form of cheating
No Copyrighted Materials
Copyrighted images and other materials are not permitted on the iGEM wiki. (You may use materials that are appropriately licensed for reuse, such as open-source code or Creative Commons licensed images.)
2015.igem.org/Team:Team_Name
All iGEM 2015 teams are given a namespace on the iGEM 2015 wiki with their team name. Teams are allowed to create and edit pages within their respective team namespace. Teams are not allowed to create or edit pages belonging to another team's namespace.
Wiki Freeze - September 18
The wiki freeze for the 2015 Giant Jamboree is on September 18, along with other deadlines. iGEM experiences higher than normal traffic on this day which can lead to strain on our servers and sessions timing out for users. iGEM HQ recommends that users do not wait till the last day to work/finish their wikis. Once the wikis are frozen, users can no longer make any changes until they are unfrozen after the Jamboree.
Other deadlines
The team's project description must be documented on their iGEM Team Wiki by the deadline. The project description should be 1-3 paragraphs and only needs to include an up-to-date explanation of the project.
The team's wiki must include an attributions section.
Creative Commons
All content on this wiki is available under the Creative Commons Attribution 4.0 license (or any later version).
Wiki Dos and Don'ts
Do | Don't | Why? |
---|---|---|
Make sure all wiki content is hosted on 2015.igem.org. (This includes text, files, HTML, CSS, Javascript, and other scripts.) | Don't host your wiki or parts of your wiki elsewhere. Don't include scripts or stylesheets from other servers. | iGEM content is preserved on our servers so future teams can learn from what you've done. When content is stored on other sites/servers, links may become broken (example), sites may go down, and information will be lost. |
Work on your wiki throughout the year and save small edits for last | Don't wait to add/edit large portions of wiki content the day of the Wiki Freeze | Just before the Wiki Freeze, iGEM websites experience increased traffic and server loads. This can be a difficult time to make larger changes or additions to your wiki. Don't wait till the last minute! |
Name uploaded files clearly and uniquely (TeamName_Header.png) | Don't use generic names for you files (Header.png) | Using unique names makes searching/identification of uploaded files easier, and reduces the chance that another team will accidentally overwrite your file with a different one having the same name. |
Load your CSS and Javascript into the wiki, either directly into your page or using templates (see below) | Don't try to host your CSS and Javascript on a third party server | You are required to host all content on the iGEM servers (see above) |
Wiki Editing
Add a wiki page, change a wiki page, delete a wiki page, etc.
All iGEM wiki sites are powered by Mediawiki. See the Mediawiki Help page for details on how to edit wiki pages and more.
Using/editing the wiki is a trial-and-error process. Editing the wiki is a simple, fun thing to do and you definitely get better the more you play around with it. The key is to take a look at other wiki pages and see what you like. Then all you have to do is go to the source (either view source if you're not logged in, or edit if you are logged in), copy it, and modify it to fit your needs. It doesn't have to be perfect before you can take a look at what it looks like. Try things out and see what results they yield.
Adding a page to your team's namespace?
You must keep your team's pages in your team namespace. For example, take a look at 2015.igem.org/Team:Example
Specifically, when you create a new page, you just have to name it Team:OFFICIAL team name/PageName. For example, if you were on Team Example and wanted to create a Biosensor project page you would name it Team:Example/Biosensor_project.
You should keep ALL your content within your team's namespace. This includes uploaded files, templates, CSS and Javascript pages, not just your main wiki pages.
Using html in wiki pages
Instead of using wiki markup, you can use HTML in the wiki editor. Just put your html code in between <html> ... </html>
tags.
Using CSS and/or Javascript
You can also use CSS and Javascript on the wiki by adding your <style> and <script> tags into your <html> code.
If you want to use a CSS stylesheet or Javascript on multiple pages, you can create a wiki template page.
Using jQuery
jQuery 1.11.1 is already installed across all iGEM webpages. It adds many useful abilities to JavaScript. You do not need to include any extra source to use jQuery.
Using MathJax
MathJax is a JavaScript library for displaying mathematical equations. A copy of MathJax 2.5 is installed on 2015.igem.org. To use it, add the following line to your HTML:
<script src="https://2015.igem.org/common/MathJax-2.5-latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
For more information, visit the MathJax documentation.
Using Wiki Templates
If there is standard text/code that you want to add to more than one page, like a CSS style or script, then you can use MediaWiki templates
You can create a wiki template page to house your HTML/CSS/Javascript, by entering {{Team:YourTeamName/CSS}} into your wiki markup. Saving the page will create a link for a new template page, which you can edit and enter all of your CSS code. You can then call {{Team:YourTeamName/CSS}} on other pages.
Take a look at a few 2013 team wikis to see how other teams setup the styling. You can do this by going to a wiki, and looking for view source in the default wiki links at the top of the page. See MIT's and TU-Munich's for examples.
Uploading videos and using HTML 5 to display them
You can upload videos (ogg, mp4, webm) to the 2015 wiki by using Mediawiki's Upload tool.
You can display videos by using the HTML 5 <video> tag, along with <source src="file_url" type="video/ogg" />.
Take a look at the 2013 Leed's team wiki to see how they displayed their video. You can do this by going to their wiki, and looking for view source in the default wiki links at the top of the page.
Pages with Static Links
This year, we are requiring that information pertinent to specific prizes must appear on specific, static URLs on your wiki. Dynamically generated pages may not be understood correctly by the Judging Form.
Please review the Wiki Standard Pages requirements, and perhaps test your pages on the Judging Form to see if they are understood correctly. If they are not, you risk that the judges may not evaluate those parts of your wiki.
Need more technical details?
Visit our extra help page on Using HTML, CSS, and Javascript on the iGEM wikis.
Perspectives from an iGEM veteran
Hello iGEMers!
I was also part of an iGEM team!
In 2011 and 2012 my role was to design and create our team’s wiki. So wiki freeze was my major deadline. I am by no means an expert but let me share with you some of the things I learned with two wiki freezes under my belt.
1. Test your webpage layout: is information easy to find?
I made the terrible mistake of not asking for a third party’s opinion about the layout of information on our site. It was obvious for me how things were laid out and organized. It wasn’t for the people evaluating us.
Also, stick to the 3 click rule: content must reachable within 3 clicks so the user does not feel lost or confused. If someone wants to read your abstract, their path should be something like this (Menu –> Project –> Project Description -> Abstract)
2. Look at other teams’ code, see how they documented and what resources they used.
It is always good to get inspiration from other iGEM teams. See what you liked that they did and strive to improve!
3. Start working on your documentation early on.
This was a good thing that we did; we created a common file that more than one person can edit at a time. Divide the documentation into smaller files and assign a team member to fully document that topic. In the end you will have a printable version of your project that you can share as a pdf file with other people!
4. Name your images according to the project and keep them all in a folder on your computer.
Sometimes naming your gel image “gelthingy_whyiamworkingat3am” sounds perfect at 3AM but later it may not be easy to know what or when that photograph was taken or that image created.
Also, the iGEM database doesn’t know that you created that file so if someone names their file with the same name it can end up being replaced! Avoid using generic names like “banner.png” or “logo.jpg”.
Try using your team’s name and the webpage where the image will appear, this helps you remember where to place it and reduce the risk of another team overwriting. “JoyUniversity_TeamBios_Richard.jpg”
5. Do not leave everything to the last minute!
Plan ahead. The last thing you want to be doing at 11:30PM the night of wiki freeze is uploading images. It is very stressful to be looking at the clock and hoping some kind of coding miracle helps you fix bugs faster. Plan to have everything online at least one week ahead so you can go enjoy a nice dinner with your team that night!
I hope this helps and if you have any questions, feel free to email me or send me a tweet!
ana at igem dot org
@anita_sifuentes