Help:Getting Started in Proteopedia: Difference between revisions

Eric Martz (talk | contribs)
Eric Martz (talk | contribs)
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This article, ''Getting Started'', is intended to help orient beginners who wish to author content in [[Proteopedia]]. If you have questions that are not answered here, please email the Proteopedia Staff at {{Contact}}.
This article, ''Getting Started'', is intended to help orient beginners who wish to '''author content''' in [[Proteopedia]]. If you have questions that are not answered here, please email the Proteopedia Staff at {{Contact}}.


Of course you can use Proteopedia as a reference resource without authoring content. A good way to get oriented to using Proteopedia is to watch some of the [[Proteopedia:Video Guide]].
Of course you can use Proteopedia as a reference resource '''without logging in or authoring content''': see [[Help:Contents]]. A good way to get oriented to using Proteopedia is to watch some of the [[Proteopedia:Video Guide]].


==Login==
==Login==


Everything below assumes that you have applied for, and been given, a login account. Your account name will be your real, full name, as it would appear when you are an author on a scientific publication. Indeed, your name will appear at the bottom of every Proteopedia page to which you contribute. Look at the bottom of this page and you will see the names of members who have contributed to it.
Everything below assumes that you wish to '''author content''' in Proteopedia, and have applied for, and been given, a login account. (You '''don't need an account''' to read what is already in Proteopedia.) Your account name will be your real, full name, as it would appear when you are an author on a scientific publication. Indeed, your name will appear at the bottom of every Proteopedia page to which you contribute. Look at the bottom of this page and you will see the names of members who have contributed to it.


Please login now. You can tell when you are logged in because your name appears at the very top of the page.
Please login now. You can tell when you are logged in because your name appears at the very top of the page.
Line 36: Line 36:
*'''Boldface''', ''italics'', subtitles, etc. have convenience buttons at the top of the wikitext box.
*'''Boldface''', ''italics'', subtitles, etc. have convenience buttons at the top of the wikitext box.
   
   
*If you need to push a paragraph below a graphic object (image, table, Jmol), insert <nowiki>{{Clear}}</nowiki>.
*If you need to push a paragraph below a graphic object (image, table, Jmol), insert <!--[[Image:Clear.png]]--><nowiki> {{Clear}} </nowiki>.


*You can always see how a page is formatted by clicking on ''edit this page'' to see the wikitext, then clicking '''Cancel''' instead of making any changes.
*You can always see the markup used to format a page by clicking on ''edit this page'' to see the wikitext, then clicking '''Cancel''' instead of making any changes.


===Links===
===Links===
Line 50: Line 50:
**However, if the topic concerns structural biology, the link should be to a page within Proteopedia (which you may need to create -- see [[Help:Editing#How_To_Create_A_New_Page|How To Create A New Page]]). That page within Proteopedia is the correct place to put a link to an external source, such as an article in Wikipedia (see [[Proteopedia:Policy]]). For example, if you wish to link to the Wikipedia page on HIV, you should link to the Proteopedia page [[Human Immunodeficiency Virus]], which in turn contains a link to [http://www.proteopedia.org/wiki/index.php/Human_Immunodeficiency_Virus HIV in Wikipedia].
**However, if the topic concerns structural biology, the link should be to a page within Proteopedia (which you may need to create -- see [[Help:Editing#How_To_Create_A_New_Page|How To Create A New Page]]). That page within Proteopedia is the correct place to put a link to an external source, such as an article in Wikipedia (see [[Proteopedia:Policy]]). For example, if you wish to link to the Wikipedia page on HIV, you should link to the Proteopedia page [[Human Immunodeficiency Virus]], which in turn contains a link to [http://www.proteopedia.org/wiki/index.php/Human_Immunodeficiency_Virus HIV in Wikipedia].
**If the topic does not concern structural biology, and needs no page in Proteopedia, you can link within the text of an article, or in a footnote (see below). For example, <nowiki>[http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wiki Markup Cheatsheet]</nowiki> makes the link [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wiki Markup Cheatsheet].
**If the topic does not concern structural biology, and needs no page in Proteopedia, you can link within the text of an article, or in a footnote (see below). For example, <nowiki>[http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wiki Markup Cheatsheet]</nowiki> makes the link [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wiki Markup Cheatsheet].
**The label in an external link is placed within the single square brackets, after a space. For example, <nowiki>[http://www.proteopedia.org/wiki/index.php/Human_Immunodeficiency_Virus HIV in Wikipedia]</nowiki> makes the link [http://www.proteopedia.org/wiki/index.php/Human_Immunodeficiency_Virus HIV in Wikipedia].
**The label in an external link is placed within the single square brackets, after a '''space'''. For example, <nowiki>[http://www.proteopedia.org/wiki/index.php/Human_Immunodeficiency_Virus HIV in Wikipedia]</nowiki> makes the link [http://www.proteopedia.org/wiki/index.php/Human_Immunodeficiency_Virus HIV in Wikipedia].


===References & Footnotes===
===References & Footnotes===
References to published literature are easy to make -- please see [[Help:Editing#Citing_Literature_References|Citing Literature References]]. Footnotes are also straightforward -- please see [Help:Editing#Footnotes|Footnotes]].
References to published literature are easy to make -- please see [[Help:Editing#Citing_Literature_References|Citing Literature References]]. Footnotes are also straightforward -- please see [[Help:Editing#Footnotes|Footnotes]].


===Advanced===
===Advanced===
Line 62: Line 62:
*Not covered here? Please ask: {{Contact}}.
*Not covered here? Please ask: {{Contact}}.


==Make A Personal Sandbox==
==Your First Article==
 
There are two places you can put your first article. You can start it in a ''Sandbox'' (which makes it obvious that it is a work in progress, or just a practice page), then when it is far enough along, move it to a permanent article titled with the subject of the article. Alternatively, you can start it in a new page titled with the subject of the article. The choice is yours. Here are instructions for each approach.
 
===Using a Subject Title===
It is good to start a new article titled with your subject, even if you only put a small amount of information there. Others can expand the article collaboratively later. Just make sure you are not duplicating an existing subject -- here are detailed [[Proteopedia:How_to_Make_a_Page#Creating_the_page|instructions]].
 
If the article needs a lot of additional content, you can insert <nowiki>{ {Stub} }</nowiki> at the top (but omit the spaces between the curly braces). This will display a notice at the top inviting others to contribute to the page.
 
===Using a Sandbox===
 
====Creating A Personal Sandbox====


A good place to get started is to create a page ''Sandbox 1'' in your User space. Here are [[Help:Sandboxes#How_to_Create_a_Protected_Sandbox_Page|step by step instructions]]. A ''Sandbox'' page is a page reserved for temporary, practice work -- see [[Help:Sandboxes]].
A good place to get started is to create a page ''Sandbox 1'' in your User space. Here are [[Help:Sandboxes#How_to_Create_a_Protected_Sandbox_Page|step by step instructions]]. A ''Sandbox'' page is a page reserved for temporary, practice work -- see [[Help:Sandboxes]].
Line 69: Line 80:


There are also numerous Sandbox pages that can be edited by anyone -- many are, however, reserved for use by university classes. See [[Teaching Strategies Using Proteopedia]].
There are also numerous Sandbox pages that can be edited by anyone -- many are, however, reserved for use by university classes. See [[Teaching Strategies Using Proteopedia]].
====Publishing Your Sandbox====
Even while you are working on an article in a ''Sandbox'' page, any visitor to Proteopedia who searches for terms in your article will find your ''Sandbox'' page, and be able to read your work in progress.
Once you feel your article is reasonably complete, you can move it to a permanently titled page (see [[Help:Sandboxes#Publishing_Your_Completed_Article|instructions]]). By doing so, you are announcing that the page is reasonably complete, and inviting others to contribute additional information or to improve the portions you have written. Proteopedia, like all wikis, is intended to foster such collaborations. For example, see the many contributors to the article [[Avian Influenza Neuraminidase, Tamiflu and Relenza]].


==Link Your Work To Your User Page==
==Link Your Work To Your User Page==
Line 97: Line 113:
'''Homology models''': If there is no empirically-determined 3D structure for the protein sequence of interest, you may be able to create (and then upload) a homology model. For more about this, please see [[Homology modeling]]. An example of an article based on a homology model is [[Structure of E. coli DnaC helicase loader]].
'''Homology models''': If there is no empirically-determined 3D structure for the protein sequence of interest, you may be able to create (and then upload) a homology model. For more about this, please see [[Homology modeling]]. An example of an article based on a homology model is [[Structure of E. coli DnaC helicase loader]].


==Publishing Your Sandbox==
Even while you are working on an article in a ''Sandbox'' page, any visitor to Proteopedia who searches for terms in your article will find your ''Sandbox'' page, and be able to read your work in progress.


Once you feel your article is reasonably complete, you can move it to a permanently titled page (see [[Help:Sandboxes#Publishing_Your_Completed_Article|instructions]]). By doing so, you are announcing that the page is reasonably complete, and inviting others to contribute additional information or to improve the portions you have written. Proteopedia, like all wikis, is intended to foster such collaborations. For example, see the many contributors to the article [[Avian Influenza Neuraminidase, Tamiflu and Relenza]].


==Other Help==
==Other Help==
Please consult [[Help:Contents]] for a list of help articles in Proteopedia. If you don't find an answer easily, don't hesitate to ask: {{Contact}}.
Please consult [[Help:Contents]] for a list of help articles in Proteopedia. If you don't find an answer easily, don't hesitate to ask: {{Contact}}.
==For Teachers & Professors==
* [[Teaching Strategies Using Proteopedia]]
* [[Teaching Scenes, Tutorials, and Educators' Pages]]
* [[High school teachers' resources]]
* [[Student Projects]]
* [[Proteopedia:News#Adoptions_in_University_Classes|Adoptions in University Classes]]
[[he:Help:Getting Started in Proteopedia (Hebrew)]]
[[Category: Help]]

Proteopedia Page Contributors and Editors (what is this?)Proteopedia Page Contributors and Editors (what is this?)

Eric Martz, Tagai Musaev, Jaime Prilusky