Difference between revisions of "FND-Wiki editing"

From "A B C"
Jump to navigation Jump to search
m
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
<div id="BIO">
+
<div id="ABC">
  <div class="b1">
+
<div style="padding:5px; border:1px solid #000000; background-color:#b3dbce; font-size:300%; font-weight:400; color: #000000; width:100%;">
 
Wiki editing
 
Wiki editing
  </div>
+
<div style="padding:5px; margin-top:20px; margin-bottom:10px; background-color:#b3dbce; font-size:30%; font-weight:200; color: #000000; ">
 +
(Wiki editing, namespaces; user page setup; copyright, a Course Journal stub page, and an insights! stub page)
 +
</div>
 +
</div>
 +
 
 +
{{Smallvspace}}
 +
 
  
  {{Vspace}}
+
<div style="padding:5px; border:1px solid #000000; background-color:#b3dbce33; font-size:85%;">
 
+
<div style="font-size:118%;">
<div class="keywords">
+
<b>Abstract:</b><br />
<b>Keywords:</b>&nbsp;
+
<section begin=abstract />
Wiki editing, namespaces; user page setup; copyright, a course journal stub page, and an insights! stub page
+
This should be the first learning unit you work with, since your Course Journal will be kept on a Wiki, as well as all other deliverables. This unit includes an introduction to authoring Wikitext and the structure of Wikis, in particular how different pages live in separate "Namespaces". The unit also covers the standard markup conventions - "Wikitext markup" - the same conventions that are used on Wikipedia - as well as some extensions that are specific to our Course- and Student Wiki. We also discuss page categories that help keep a Wiki organized, licensing under a Creative Commons Attribution license, and how to add licenses and other page components through template codes.
 +
<section end=abstract />
 +
</div>
 +
<!-- ============================  -->
 +
<hr>
 +
<table>
 +
<tr>
 +
<td style="padding:10px;">
 +
<b>Objectives:</b><br />
 +
* Provide an introduction to Wiki principles and Wikitext markup.
 +
* Create first pages on your own on the [http://steipe.biochemistry.utoronto.ca/abc/students/ Student Wiki].
 +
* Learn about copyright, why we use Creative Commons licenses for the Student Wiki and how to place a license tag.
 +
</td>
 +
<td style="padding:10px;">
 +
<b>Outcomes:</b><br />
 +
* You are competent with basic Wiki markup and the extensions on this Wiki.
 +
* You can create pages and add them to categories while taking care to create them into your own user space.
 +
* You have created your own user page on the Student Wiki and added contents.
 +
* You have created page stubs for a Course Journal and an <b>insights!</b> page.
 +
</td>
 +
</tr>
 +
</table>
 +
<!-- ============================  -->
 +
<hr>
 +
<b>Deliverables:</b><br />
 +
<section begin=deliverables />
 +
<li><b>Specified as "Tasks"</b>: There are no general deliverables for this unit; specific deliverables are described in the "Task" sections.</li>
 +
<section end=deliverables />
 +
<!-- ============================  -->
 
</div>
 
</div>
  
{{Vspace}}
+
{{Smallvspace}}
 +
 
 +
 
 +
 
 +
{{Smallvspace}}
  
  
Line 19: Line 57:
  
  
{{LIVE}}
+
=== Evaluation ===
 +
<b>Evaluation: NA</b><br />
 +
<div style="margin-left: 2rem;">This unit is not evaluated for course marks.</div>
 +
== Contents ==
 +
 
 +
Collaboration is a common theme for modern lab work and a Wiki is a great way to share and seamlessly update information in groups - or just for yourself. Probably the most sophisticated Wiki software is MediaWiki, a set of PHP scripts that is under continuous development by the Wikimedia foundation; it is the same software that runs Wikipedia. This is open source, free software that is easy to install, is well documented and requires very little resources other than a machine that runs a {{WP|MySQL|MySQL}} database server and an {{WP|Apache HTTP Server|Apache}} Webserver. Numerous extensions exist (and extensions are not hard to write); they enhance the already rich functionality. But let's start with small steps. You will receive a user account on the [http://steipe.biochemistry.utoronto.ca/abc/students Student Wiki], and I have configured that Wiki so that
 +
* only logged in users can view the pages; but ...
 +
* all logged in users can create and edit (most) pages.
 +
 
 +
This means you could edit pages that don't "belong" to you. Respect the "House Rules" and don't edit others' things without permission, even if you can think of a particularly witty comment or hilarious prank. If you want to comment on a page: every page has an associated "Discussion" page that you can freely edit. Remember to "sign your name" to discussion entries.
  
 
{{Vspace}}
 
{{Vspace}}
  
 +
{{Task|1=
 +
* Access the [http://steipe.biochemistry.utoronto.ca/abc/students '''Student Wiki'''];
 +
* log in and navigate to your user page. (Your user page is linked to your name that appears at the top of every Wikipage once you are logged in.) Create / edit the page, try out and experiment with the Wikitext syntax that this unit covers as you read about the different elements.
 +
* Work through the contents below.
 +
}}
  
</div>
+
=== Wikitext User Page Template ===
<div id="ABC-unit-framework">
+
 
== Abstract ==
+
<div class="mw-collapsible mw-collapsed" data-expandtext="Expand" data-collapsetext="Collapse" style="width:100%; ">
<section begin=abstract />
+
;Expand for template code.
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "abstract" -->
+
<div class="mw-collapsible-content" style="padding:10px;">
This will likely be the first learning unit you work with, since your Course Journal will be kept on a Wiki, as well as all other deliverables. This unit includes an introduction to authoring Wikitext and the structure of Wikis, in particular how different pages live in separate "Namespaces". The unit also covers the standard markup conventions - "Wikitext markup" - the same conventions that are used on Wikipedia - as well as some extensions that are specific to our Course- and Student Wiki. We also discuss page categories that help keep a Wiki organized, licensing under a Creative Commons Attribution license, and how to add licenses and other page components through template codes.
 
<section end=abstract />
 
  
{{Vspace}}
+
Copy the whole block of text, paste it into your "User" page on the Student Wiki and study it. You can make changes and click '''Show preview''' to see what they look like. When you are satisfied, click '''Save changes'''.
  
 +
<pre><nowiki>
  
== This unit ... ==
+
<!-- HTML comments will not be rendered by the wiki. -->
=== Prerequisites ===
 
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "prerequisites" -->
 
<!-- included from "ABC-unit_components.wtxt", section: "notes-no_prerequisites" -->
 
This unit has no prerequisites.
 
  
{{Vspace}}
+
__NOTOC__
 +
<div style="overflow: hidden">
 +
[[File:<MY PICTURE FILE NAME AND EXTENSION>|250px|right|<ALT TEXT>]]
  
 +
'''<MY USER NAME (王一大)>'''
  
=== Objectives ===
+
<MY POSt OR MAJORS>
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "objectives" -->
 
* Provide an introduction to Wiki principles and Wikitext markup.
 
* Create first pages on your own on the [http://steipe.biochemistry.utoronto.ca/abc/students/ Student Wiki].
 
* Learn about copyright, why we use Creative Commons licenses for the Student Wiki and how to place a license tag.
 
  
{{Vspace}}
+
:E: [mailto:<MY EMAIL>@mail.utoronto.ca <MY EMAIL>@utoronto.ca]
 +
</div>
  
 +
----
 +
;About ...
 +
: Really just anything you would hope others could relate to. An interesting paper you read recently. Your professor's funny habits. Your pet. The awesome, magnificent monstera you grew. What you could use some help with in this course. Or in your life. Your favourite artwork. What you are going to do after class. Or after graduating ...
  
=== Outcomes ===
+
----
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "outcomes" -->
 
* You are competent with basic Wiki markup and the extensions on this Wiki.
 
* You can create pages and add them to categories while taking care to create them into your own user space.
 
* You have created your own user page on the Student Wiki and added contents.
 
* You have created page stubs for a course journal and an <b>insights!</b> page.
 
  
 
{{Vspace}}
 
{{Vspace}}
  
 +
==Course Things==
 +
* [[User:<MY USER NAME>/Journal|Course Journal]]
 +
* [[User:<MY USER NAME>/insights!|insights!]]
 +
 +
{{Vspace}}
  
=== Deliverables ===
+
==To Do==
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "deliverables" -->
+
* Laundry!
<!-- included from "ABC-unit_components.wtxt", section: "deliverables-tasks_only" -->
+
* Dishes! SRSLY
*<b>Specified as "Tasks"</b>: There are no general deliverables for this unit; specific deliverables are described in the "Task" sections.
+
* ...
  
 
{{Vspace}}
 
{{Vspace}}
 +
 +
==Resources==
 +
* [http://steipe.biochemistry.utoronto.ca/bio/img/ABC-units_map.svg Map]
 +
* [http://steipe.biochemistry.utoronto.ca/bio Syllabus]
 +
* [https://q.utoronto.ca/courses/234479 BCH441 on Quercus]
  
  
=== Evaluation ===
 
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "evaluation" -->
 
<!-- included from "ABC-unit_components.wtxt", section: "eval-none" -->
 
<b>Evaluation: NA</b><br />
 
:This unit is not evaluated for course marks.
 
  
 
{{Vspace}}
 
{{Vspace}}
  
 +
----
  
</div>
+
{{Smallvspace}}
<div id="BIO">
+
 
== Contents ==
+
[[Category:BCH441_2021]]
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "contents" -->
 
  
Collaboration is a common theme for modern lab work and a Wiki is a great way to share and seamlessly update information in groups - or just for yourself. Probably the most sophisticated Wiki software is MediaWiki, a set of PHP scripts that is under continuous development by the Wikimedia foundation; it is the same software that runs Wikipedia. This is open source, free software that is easy to install, is well documented and requires very little resources other than a machine that runs a {{WP|MySQL}} database server and an {{WP|Apache HTTP Server|Apache}} Webserver. Numerous extensions exist (and extensions are not hard to write); they enhance the already rich functionality. But let's start with small steps. You should by now have a user account on the [http://steipe.biochemistry.utoronto.ca/abc/students Student Wiki], and I have configured that Wiki so that
+
{{CC-BY}}
* only logged in users can view the pages; but ...
 
* all logged in users can create and edit (most) pages at will.
 
  
This means you could edit pages that don't "belong" to you. Respect the "House Rules" and don't edit other's things without permission, even if you can think of a particularly witty comment or hilarious prank. If you want to comment on a page: every page has an associated "Discussion" page that you can freely edit. Remember to "sign your name" to discussion entries.
+
<!-- [END] -->
  
{{Vspace}}
+
</nowiki></pre>
  
{{Task|1=
+
</div>
* Access the [http://steipe.biochemistry.utoronto.ca/abc/students '''Student Wiki];
+
</div>
* log in and navigate to your user page. You can edit it and experiment with the Wikitext syntax that we will cover in this unit.
 
* Work through the contents below.
 
}}
 
  
 
{{Vspace}}
 
{{Vspace}}
  
{{#lst:Help:Editing|Wiki-editing}}
+
==The "User space" and its "subpages"==
  
{{Vspace}}
+
The <code>User:</code> namespace on the Student Wiki is especially important.
  
==The "User space" and subpages==
+
Namespaces allow us to partition a Wiki into logical sections. The most important sections are the <code>Main:</code> space - for general pages, and the <code>User:</code>-space, for pages that are associated with specific users, like you, yourself. This is important when we need to create similar but unique pages, for assignments and such.
  
The <code>User:</code> namespace on the Student Wiki is especially important.
+
For example, every student will create a journal page, but page titles on the Wiki must be unique. Thus there can be only one <code><nowiki>[[Journal]]</nowiki></code> page on the Wiki. The obvious solution is to keep your "own" pages in the <code>User:</code> namespace, and create them as <b>subpages</b> of everyone's User page. The page name of your user page is <code><nowiki>[[User:<your-login-name>]]</nowiki></code>; subpages are created with a backslash, and therefore your Course Journal page should be <code><nowiki>[[User:<your-login-name>/Journal]]</nowiki></code>.
  
Namespaces allow us to distinguish pages that share the same logical name. Every student will create a journal page, but of course there can be only one <code><nowiki>[[Journal]]</nowiki></code> page on the Wiki. Therefore each of these pages needs a distinct name. The obvious solution is to keep them in the <code>User:</code> namespace, and create them as <b>subpages</b> of everyone's User page. The page name of your user page is <code><nowiki>[[User:<your-login-name>]]</nowiki></code>; subpages are created with a backslash, and therefore your course journal page should be <code><nowiki>[[User:<your-login-name>/Journal]]</nowiki></code>. if you take more than one course, you can separate the journals like <code><nowiki>[[User:<your-login-name>/BCH441-Journal]]</nowiki></code>, <code><nowiki>[[User:<your-login-name>/BCB410-Journal]]</nowiki></code>, etc.
+
'''Please do not create pages in the "Main space" of the Student Wiki! (I will delete such pages.) Do not omit the <code>User:<your-login-name>/</code> part of the page name.'''
  
 
{{Vspace}}
 
{{Vspace}}
Line 115: Line 160:
 
==Copyright==
 
==Copyright==
  
Over the last decades, in bioinformatics and many other fields of science, the paradigm under which we create value has profoundly changed. While we previously considered restrictions on the use of our insights important, tried to keep knowledge under control, and thought in terms of <i>intellectual property</i>, the modern paradigm is <b>mindshare</b>. We strive to make our work maximally useful to others, and to document how we are creating this utility. This does not mean that we are simply putting everything into the public domain: yes, people should use our ideas, but we <b>must</b> receive credit - as a currency for grant and scholarship applications and the like, to enable our future work. The right tool for this is copyright.
+
Over the last decades, the paradigm under which we create value in science  has profoundly changed. Years ago we placed numerous restrictions on the use of our insights, tried to keep control data, and thought in terms of <i>intellectual property</i>. Today, we think about <b>mindshare</b>. We strive to make our work maximally useful to others, and to document how we are creating this utility. This does not mean that we are simply putting everything into the public domain: certainly, people should use our ideas, but we <b>must</b> receive credit - acknowledgement is the currency for grant- and scholarship applications and such, which enables our future work. The right tool for this is '''copyright'''.
  
 
Everything we write and create automatically falls under our copyright, there is no special copyright tag required. To have our material reused, we can either relinquish our copyright or grant a license to reuse. Material that is created in coursework will ideally be useful elsewhere, but it is only useful if its use is permitted and regulated.
 
Everything we write and create automatically falls under our copyright, there is no special copyright tag required. To have our material reused, we can either relinquish our copyright or grant a license to reuse. Material that is created in coursework will ideally be useful elsewhere, but it is only useful if its use is permitted and regulated.
  
Wikis are tools for collaboration, and Wikipedia generally applies a site-wise license to all material. In our work we take a similar approach, but we apply licenses more specifically<ref>Note that additional rules for collaboration in the context of coursework derive from the rules for academic integrity and plagiarism. If some text is not copyrighted, this does <b>not</b> mean you can use it without reference and thus imply it is your own idea. That would be plagiarism.</ref>. All material submitted for credit, including code, documentation, essays, manuals, images, lab journal entries, <b>insights!</b> pages etc. '''must''' be licensed with an appropriate open-source license. This is a strict requirement for the course. For code this is the {{WP|GNU_General_Public_License|GNU GPL 3.0}}, for everything else this is the [http://creativecommons.org/licenses/by/4.0/ Creative Commons Attribution 4.0 International License]. The GPL license for code guarantees that you will be able to use any derivative work under terms that are no weaker than the code you originally wrote. The CC license guarantees proper attribution of authorship but allows free use otherwise. Together, these licenses allow the material to be used, refactored, updated and republished and thus (hopefully) give it a fertile future life.
+
Wikis are tools for collaboration, and Wikipedia generally applies a site-wise license to all material. In our work we take a similar approach, but we apply licenses more specifically<ref>Note that additional rules for collaboration in the context of coursework derive from the rules for academic integrity and plagiarism. If some text is not copyrighted, this does <b>not</b> mean you can use it without reference and thus imply it is your own idea. That would be plagiarism.</ref>. All material submitted for credit, including code, documentation, essays, manuals, images, lab journal entries, <b>insights!</b> pages etc. '''must''' be licensed with an appropriate open-source license. This is a strict requirement for the course. For code this is the {{WP|MIT_License|MIT software license}}, for everything else this is the [http://creativecommons.org/licenses/by/4.0/ Creative Commons Attribution 4.0 International License]. The MIT license for code guarantees that there are no restrictions on re-use '''other than fair and visible attribution''' of the authors' work. The CC license guarantees proper attribution of authorship but allows free use otherwise. Together, these licenses allow the material to be used, refactored, updated and republished and thus (hopefully) give it a fertile future life.
  
In order to keep copyright notes consistent throughout the site, we use a template tag - simply insert it at the bottom of a page:
+
In order to keep copyright and licenses consistent throughout the site, we use a template tag - simply insert it at the bottom of a page:
  
 
Entering the template code ...<br />
 
Entering the template code ...<br />
Line 133: Line 178:
  
 
{{Task|1=
 
{{Task|1=
* practice basic editing syntax by editing your User Page:
+
* Practice basic editing syntax by putting contents on your User Page:
 
** enter your name,
 
** enter your name,
 
** your major(s), specialist program, year of study - or a link to your lab and your thesis theme if you are a graduate student;
 
** your major(s), specialist program, year of study - or a link to your lab and your thesis theme if you are a graduate student;
 
** enter your email address. <small>I use this information a lot when I need to contact students, so make sure it is correct and current</small>.
 
** enter your email address. <small>I use this information a lot when I need to contact students, so make sure it is correct and current</small>.
** Add a category tag to your User page for the course you are taking. <small>All pages with this tag are accessible via the link in the sidebar. What should the category tag say? Good question ... go and find out.</small>
+
** Add a category tag to your User page. The Wikitext is <code><nowiki>[[Category:BCH441_2020]]</nowiki></code>. PLace this at the bottom of the page. <small>All pages with this tag are accessible via the link in the sidebar.</small>
 
** Add a copyright template to the bottom of your user page by putting a <code><nowiki>{{CC-BY}}</nowiki></code> tag on its bottom.
 
** Add a copyright template to the bottom of your user page by putting a <code><nowiki>{{CC-BY}}</nowiki></code> tag on its bottom.
  
Feel free to look at my User Page for code examples: clicking on the edit link will show you the source text. <small>How do you find my User Page? Good question ... </small>
+
Feel free to look at my User Page (or others') for code examples: clicking on the edit link of any page will show you the source text. <small>How do you find my User Page? Good question ... </small>
  
 
* Create a '''subpage to your User Page'''; call it "Journal". <small>Note: the link '''MUST''' be in your "User space". If you don't add the prefix <code>User:''yourname''/...</code> before your page name, the new page will end up in the main "namespace". I'll then have to delete it. That's not good. Make sure you know what you are doing, for example by looking at the code on my User Page, asking someone who knows, or asking on the mailing list.</small>
 
* Create a '''subpage to your User Page'''; call it "Journal". <small>Note: the link '''MUST''' be in your "User space". If you don't add the prefix <code>User:''yourname''/...</code> before your page name, the new page will end up in the main "namespace". I'll then have to delete it. That's not good. Make sure you know what you are doing, for example by looking at the code on my User Page, asking someone who knows, or asking on the mailing list.</small>
Line 148: Line 193:
 
}}
 
}}
  
 
{{Vspace}}
 
 
 
== Further reading, links and resources ==
 
<!-- {{#pmid: 19957275}} -->
 
<!-- {{WWW|WWW_GMOD}} -->
 
<!-- <div class="reference-box">[http://www.ncbi.nlm.nih.gov]</div> -->
 
 
{{Vspace}}
 
 
 
== Notes ==
 
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "notes" -->
 
<!-- included from "ABC-unit_components.wtxt", section: "notes" -->
 
<references />
 
 
{{Vspace}}
 
 
 
</div>
 
<div id="ABC-unit-framework">
 
 
== Self-evaluation ==
 
== Self-evaluation ==
<!-- included from "../components/FND-Wiki_editing.components.wtxt", section: "self-evaluation" -->
 
  
 
You should be familiar with the following:
 
You should be familiar with the following:
Line 202: Line 224:
  
 
-->
 
-->
 +
== Notes ==
 +
<references />
  
 
{{Vspace}}
 
{{Vspace}}
  
 
 
{{Vspace}}
 
 
 
<!-- included from "ABC-unit_components.wtxt", section: "ABC-unit_ask" -->
 
 
----
 
 
{{Vspace}}
 
 
<b>If in doubt, ask!</b> If anything about this learning unit is not clear to you, do not proceed blindly but ask for clarification. Post your question on the course mailing list: others are likely to have similar problems. Or send an email to your instructor.
 
 
----
 
 
{{Vspace}}
 
  
 
<div class="about">
 
<div class="about">
Line 230: Line 238:
 
:2017-08-05
 
:2017-08-05
 
<b>Modified:</b><br />
 
<b>Modified:</b><br />
:2017-08-13
+
:2020-09-08
 
<b>Version:</b><br />
 
<b>Version:</b><br />
:1.0
+
:1.2
 
<b>Version history:</b><br />
 
<b>Version history:</b><br />
 +
*1.2 Maintenance updates
 +
*1.1 Changed software license from GNU-GPL to MIT
 
*1.0 Completed outcomes/objectives. Added copyright. First live version.
 
*1.0 Completed outcomes/objectives. Added copyright. First live version.
 
*0.2 First contents imported from <code>Help:editing</code>. Added tasks.
 
*0.2 First contents imported from <code>Help:editing</code>. Added tasks.
 
*0.1 First stub
 
*0.1 First stub
 
</div>
 
</div>
 +
 
[[Category:ABC-units]]
 
[[Category:ABC-units]]
<!-- included from "ABC-unit_components.wtxt", section: "ABC-unit_footer" -->
+
{{UNIT}}
 
+
{{LIVE}}
{{CC-BY}}
 
 
 
 
</div>
 
</div>
 
<!-- [END] -->
 
<!-- [END] -->

Latest revision as of 22:33, 14 September 2021

Wiki editing

(Wiki editing, namespaces; user page setup; copyright, a Course Journal stub page, and an insights! stub page)


 


Abstract:

This should be the first learning unit you work with, since your Course Journal will be kept on a Wiki, as well as all other deliverables. This unit includes an introduction to authoring Wikitext and the structure of Wikis, in particular how different pages live in separate "Namespaces". The unit also covers the standard markup conventions - "Wikitext markup" - the same conventions that are used on Wikipedia - as well as some extensions that are specific to our Course- and Student Wiki. We also discuss page categories that help keep a Wiki organized, licensing under a Creative Commons Attribution license, and how to add licenses and other page components through template codes.


Objectives:

  • Provide an introduction to Wiki principles and Wikitext markup.
  • Create first pages on your own on the Student Wiki.
  • Learn about copyright, why we use Creative Commons licenses for the Student Wiki and how to place a license tag.

Outcomes:

  • You are competent with basic Wiki markup and the extensions on this Wiki.
  • You can create pages and add them to categories while taking care to create them into your own user space.
  • You have created your own user page on the Student Wiki and added contents.
  • You have created page stubs for a Course Journal and an insights! page.

Deliverables:

  • Specified as "Tasks": There are no general deliverables for this unit; specific deliverables are described in the "Task" sections.

  •  



     



     


    Evaluation

    Evaluation: NA

    This unit is not evaluated for course marks.

    Contents

    Collaboration is a common theme for modern lab work and a Wiki is a great way to share and seamlessly update information in groups - or just for yourself. Probably the most sophisticated Wiki software is MediaWiki, a set of PHP scripts that is under continuous development by the Wikimedia foundation; it is the same software that runs Wikipedia. This is open source, free software that is easy to install, is well documented and requires very little resources other than a machine that runs a MySQL database server and an Apache Webserver. Numerous extensions exist (and extensions are not hard to write); they enhance the already rich functionality. But let's start with small steps. You will receive a user account on the Student Wiki, and I have configured that Wiki so that

    • only logged in users can view the pages; but ...
    • all logged in users can create and edit (most) pages.

    This means you could edit pages that don't "belong" to you. Respect the "House Rules" and don't edit others' things without permission, even if you can think of a particularly witty comment or hilarious prank. If you want to comment on a page: every page has an associated "Discussion" page that you can freely edit. Remember to "sign your name" to discussion entries.


     

    Task:

    • Access the Student Wiki;
    • log in and navigate to your user page. (Your user page is linked to your name that appears at the top of every Wikipage once you are logged in.) Create / edit the page, try out and experiment with the Wikitext syntax that this unit covers as you read about the different elements.
    • Work through the contents below.

    Wikitext User Page Template

    Expand for template code.

    Copy the whole block of text, paste it into your "User" page on the Student Wiki and study it. You can make changes and click Show preview to see what they look like. When you are satisfied, click Save changes.

    
    <!-- HTML comments will not be rendered by the wiki. -->
    
    __NOTOC__
    <div style="overflow: hidden">
    [[File:<MY PICTURE FILE NAME AND EXTENSION>|250px|right|<ALT TEXT>]]
    
    '''<MY USER NAME (王一大)>'''
    
    <MY POSt OR MAJORS>
    
    :E: [mailto:<MY EMAIL>@mail.utoronto.ca <MY EMAIL>@utoronto.ca]
    </div>
    
    ----
    ;About ...
    : Really just anything you would hope others could relate to. An interesting paper you read recently. Your professor's funny habits. Your pet. The awesome, magnificent monstera you grew. What you could use some help with in this course. Or in your life. Your favourite artwork. What you are going to do after class. Or after graduating ...
    
    ----
    
    {{Vspace}}
    
    ==Course Things==
    * [[User:<MY USER NAME>/Journal|Course Journal]]
    * [[User:<MY USER NAME>/insights!|insights!]]
    
    {{Vspace}}
    
    ==To Do==
    * Laundry!
    * Dishes! SRSLY
    * ...
    
    {{Vspace}}
    
    ==Resources==
    * [http://steipe.biochemistry.utoronto.ca/bio/img/ABC-units_map.svg Map]
    * [http://steipe.biochemistry.utoronto.ca/bio Syllabus]
    * [https://q.utoronto.ca/courses/234479 BCH441 on Quercus]
    
    
    
    {{Vspace}}
    
    ----
    
    {{Smallvspace}}
    
    [[Category:BCH441_2021]]
    
    {{CC-BY}}
    
    <!-- [END] -->
    
    


     

    The "User space" and its "subpages"

    The User: namespace on the Student Wiki is especially important.

    Namespaces allow us to partition a Wiki into logical sections. The most important sections are the Main: space - for general pages, and the User:-space, for pages that are associated with specific users, like you, yourself. This is important when we need to create similar but unique pages, for assignments and such.

    For example, every student will create a journal page, but page titles on the Wiki must be unique. Thus there can be only one [[Journal]] page on the Wiki. The obvious solution is to keep your "own" pages in the User: namespace, and create them as subpages of everyone's User page. The page name of your user page is [[User:<your-login-name>]]; subpages are created with a backslash, and therefore your Course Journal page should be [[User:<your-login-name>/Journal]].

    Please do not create pages in the "Main space" of the Student Wiki! (I will delete such pages.) Do not omit the User:<your-login-name>/ part of the page name.


     

    Copyright

    Over the last decades, the paradigm under which we create value in science has profoundly changed. Years ago we placed numerous restrictions on the use of our insights, tried to keep control data, and thought in terms of intellectual property. Today, we think about mindshare. We strive to make our work maximally useful to others, and to document how we are creating this utility. This does not mean that we are simply putting everything into the public domain: certainly, people should use our ideas, but we must receive credit - acknowledgement is the currency for grant- and scholarship applications and such, which enables our future work. The right tool for this is copyright.

    Everything we write and create automatically falls under our copyright, there is no special copyright tag required. To have our material reused, we can either relinquish our copyright or grant a license to reuse. Material that is created in coursework will ideally be useful elsewhere, but it is only useful if its use is permitted and regulated.

    Wikis are tools for collaboration, and Wikipedia generally applies a site-wise license to all material. In our work we take a similar approach, but we apply licenses more specifically[1]. All material submitted for credit, including code, documentation, essays, manuals, images, lab journal entries, insights! pages etc. must be licensed with an appropriate open-source license. This is a strict requirement for the course. For code this is the MIT software license, for everything else this is the Creative Commons Attribution 4.0 International License. The MIT license for code guarantees that there are no restrictions on re-use other than fair and visible attribution of the authors' work. The CC license guarantees proper attribution of authorship but allows free use otherwise. Together, these licenses allow the material to be used, refactored, updated and republished and thus (hopefully) give it a fertile future life.

    In order to keep copyright and licenses consistent throughout the site, we use a template tag - simply insert it at the bottom of a page:

    Entering the template code ...
    {{CC-BY}}
    creates the copyright message ...


    CreativeCommonsBy.png This copyrighted material is licensed under a Creative Commons Attribution 4.0 International License. Follow the link to learn more.


     

    Task:

    • Practice basic editing syntax by putting contents on your User Page:
      • enter your name,
      • your major(s), specialist program, year of study - or a link to your lab and your thesis theme if you are a graduate student;
      • enter your email address. I use this information a lot when I need to contact students, so make sure it is correct and current.
      • Add a category tag to your User page. The Wikitext is [[Category:BCH441_2020]]. PLace this at the bottom of the page. All pages with this tag are accessible via the link in the sidebar.
      • Add a copyright template to the bottom of your user page by putting a {{CC-BY}} tag on its bottom.

    Feel free to look at my User Page (or others') for code examples: clicking on the edit link of any page will show you the source text. How do you find my User Page? Good question ...

    • Create a subpage to your User Page; call it "Journal". Note: the link MUST be in your "User space". If you don't add the prefix User:yourname/... before your page name, the new page will end up in the main "namespace". I'll then have to delete it. That's not good. Make sure you know what you are doing, for example by looking at the code on my User Page, asking someone who knows, or asking on the mailing list.
    • Put some placeholder text on your journal page, you will fill it in when you work through the Journal unit.
    • Similarly, create an "insights!" page on a subpage to your User Page and add some placeholder text. That will be expanded when you work through the insights! unit.
    • Play around some more. Feel free to ask how to go about achieving a particular effect that you may have seen elsewhere.

    Self-evaluation

    You should be familiar with the following:

    • How to Login to the Student Wiki and access your user page;
    • viewing a page's history;
    • basic text formatting and Wiki markup;
    • "signing" your name;
    • creating internal and external links;
    • creating section headers on a page on multiple levels;
    • reverting a changed page to an earlier version;
    • creating a new page (as a subpage of an existing page);
    • the concept of namespaces - especially the default ("main") and User: namespace;
    • the concept of categories and how to add a page to a category;
    • copyright on the Student Wiki, and how to insert a license note.

    Notes

    1. Note that additional rules for collaboration in the context of coursework derive from the rules for academic integrity and plagiarism. If some text is not copyrighted, this does not mean you can use it without reference and thus imply it is your own idea. That would be plagiarism.


     


    About ...
     
    Author:

    Boris Steipe <boris.steipe@utoronto.ca>

    Created:

    2017-08-05

    Modified:

    2020-09-08

    Version:

    1.2

    Version history:

    • 1.2 Maintenance updates
    • 1.1 Changed software license from GNU-GPL to MIT
    • 1.0 Completed outcomes/objectives. Added copyright. First live version.
    • 0.2 First contents imported from Help:editing. Added tasks.
    • 0.1 First stub