Help:New Contributor Quickstart

From WikiPathways

(Difference between revisions)
Jump to: navigation, search
Line 6: Line 6:
== Browse pathway archives or find a specific pathway ==
== Browse pathway archives or find a specific pathway ==
-
# To get an overview of the WikiPathways archives, select the ''Browse'' thumbnail on the main page. You can browse pathways by species, and fine-tune the results by ''Collection''. Results can be viewed as thumbnail images or a list.  
+
# To get an overview of the WikiPathways archives, select the '''Browse''' thumbnail on the main page. You can browse pathways by species, and fine-tune the results by '''Collection'''. Results can be viewed as thumbnail images or a list.  
# To find a specific pathway, search for it by name, data node name or identifier or keyword.
# To find a specific pathway, search for it by name, data node name or identifier or keyword.
For details '''Search''' and '''Browse''', see [[:Help:Finding_Pathways|Finding Pathways]].
For details '''Search''' and '''Browse''', see [[:Help:Finding_Pathways|Finding Pathways]].
Line 14: Line 14:
==== Graphical pathway representation ====
==== Graphical pathway representation ====
# Once you decide on a pathway to edit, open the [[:Help:Viewing Pathways|Pathway Page]] for that pathway.  
# Once you decide on a pathway to edit, open the [[:Help:Viewing Pathways|Pathway Page]] for that pathway.  
-
# Click the ''Edit pathway'' link under the pathway image. This will open the pathway in the WikiPathways editor, where you can [[:Help:Editing Pathways|edit]] the pathway.
+
# Click the '''Edit pathway''' link under the pathway image. This will open the pathway in the WikiPathways editor, where you can [[:Help:Editing Pathways|edit]] the pathway.
:The content at WikiPathways is diverse in both style and content. While we don't enforce a particular drawing style, there are some guidelines for editing and graphical style. Our guidelines include [[:Help:Guidelines|general editing guidelines]] as well as a [[:Help:Guidelines#Example_pathways|list of example pathways]] for your reference. There is also a specific process for including pathways into specific pathway collections at WikiPathways, read more about it [[:Help:Guidelines#Inclusion_of_pathways_into_specific_pathway_collections|here]].  
:The content at WikiPathways is diverse in both style and content. While we don't enforce a particular drawing style, there are some guidelines for editing and graphical style. Our guidelines include [[:Help:Guidelines|general editing guidelines]] as well as a [[:Help:Guidelines#Example_pathways|list of example pathways]] for your reference. There is also a specific process for including pathways into specific pathway collections at WikiPathways, read more about it [[:Help:Guidelines#Inclusion_of_pathways_into_specific_pathway_collections|here]].  
-
:When you are done editing, save the pathway in PathVisio by clicking the "Close the editor" button and then return to the ''Pathway Page''. Click the ''Refresh'' button in your browser to view your recent changes.<br />
+
:When you are done editing, save the pathway in PathVisio by clicking the "Close the editor" button and then return to the '''Pathway Page'''. Click the '''Refresh''' button in your browser to view your recent changes.<br />
==== Additional fields of the pathway page ====
==== Additional fields of the pathway page ====
In addition to the graphical pathway representation, the [[:Help:Viewing_Pathways|Pathway Page]] has additional information fields that can be edited.
In addition to the graphical pathway representation, the [[:Help:Viewing_Pathways|Pathway Page]] has additional information fields that can be edited.
-
# Add or remove relevant curation tags. For example, if you added database references to all unassigned DataNodes on the pathway, remove the "Missing gene/protein database references" tag by clicking the ''Remove'' button next to the tag. Similarly, to add a curation tag, click the ''New tag'' button at the bottom of the Curation Tags section and select a tag from the drop-down menu. For example, if you consider the pathway incomplete, add the "Needs work" tag.
+
# Add or remove relevant curation tags. For example, if you added database references to all unassigned DataNodes on the pathway, remove the "Missing gene/protein database references" tag by clicking the '''Remove''' button next to the tag. Similarly, to add a curation tag, click the '''New tag''' button at the bottom of the Curation Tags section and select a tag from the drop-down menu. For example, if you consider the pathway incomplete, add the "Needs work" tag.
-
# To edit the pathway description, click the ''Edit'' link in the ''Description'' section.
+
# To edit the pathway description, click the '''Edit''' link in the '''Description''' section.
# Add relevant ontology tags by searching for tags or by browsing the three ontologies.
# Add relevant ontology tags by searching for tags or by browsing the three ontologies.
== Create a new pathway at WikiPathways ==
== Create a new pathway at WikiPathways ==
# Become part of the WikiPathways community by [[:Special:Userlogin|creating a user account]].
# Become part of the WikiPathways community by [[:Special:Userlogin|creating a user account]].
-
# Click the [[:Special:CreatePathwayPage|Create]] thumbnail on the main page or click the ''Create'' link in the left navigation panel.  
+
# Click the [[:Special:CreatePathwayPage|Create]] thumbnail on the main page or click the '''Create''' link in the left navigation panel.  
-
# On the ''Create new pathway'' page, enter a name for the pathway and then select which species the pathway is for from the drop-down menu. Selecting the ''Make pathway private'' option hides your pathway from the rest of the community for 30 days. See the section on [[:Help:Private Pathways|Private Pathways]] for details. Click the ''Create pathway'' button to continue.
+
# On the '''Create new pathway''' page, enter a name for the pathway and then select which species the pathway is for from the drop-down menu. Selecting the '''Make pathway private''' option hides your pathway from the rest of the community for 30 days. See the section on [[:Help:Private Pathways|Private Pathways]] for details. Click the '''Create pathway''' button to continue.
# The WikiPathways editor contains a full set of drawing tools for pathway creation. See [[:Help:Editing_Pathways|Editing Pathways]] for details.
# The WikiPathways editor contains a full set of drawing tools for pathway creation. See [[:Help:Editing_Pathways|Editing Pathways]] for details.
For information on editing guidelines, please review our [[:Help:Guidelines|general editing guidelines]] and our [[:Help:Guidelines#Example_pathways|list of example pathways]].  
For information on editing guidelines, please review our [[:Help:Guidelines|general editing guidelines]] and our [[:Help:Guidelines#Example_pathways|list of example pathways]].  
-
# When your pathway is complete, click the "Close the editor" button to save your pathway to WikiPathways. A new browser window will open with the ''Pathway Page'' for your newly created pathway at WikiPathways.
+
# When your pathway is complete, click the '''Close the editor''' button to save your pathway to WikiPathways. The '''Pathway Page''' for your newly created pathway will be displayed.
-
# Add information about your pathway by [[:Help:Editing Pathways|editing]] the text fields in the ''Pathway Page''. '''Remember to assign a category to your pathway so that the pathway will appear on the [[Special:BrowsePathwaysPage|browse page]] listing all categorized pathways at WikiPathways.
+
# Add information about your pathway by [[:Help:Editing Pathways|editing]] the text fields in the '''Pathway Page'''. '''Remember to assign a category to your pathway so that the pathway will appear on the [[Special:BrowsePathwaysPage|browse page]] listing all categorized pathways at WikiPathways.
== Transfer pathway from GenMAPP to WikiPathways ==
== Transfer pathway from GenMAPP to WikiPathways ==
-
You can transfer a pathway that you have created in the GenMAPP program to WikiPathways using PathVisio. If you have the [http://www.pathvisio.org/plugin/wikipathways-plugin/ WikiPathways] plugin installed in PathVisio, you can upload the pathway directly from PathVisio. Otherwise, you can save the pathway in gpml format and upload the pathway it to WikiPathways under ''Create new pathway''.   
+
You can transfer a pathway that you have created in the GenMAPP program to WikiPathways using PathVisio. If you have the [http://www.pathvisio.org/plugin/wikipathways-plugin/ WikiPathways] plugin installed in PathVisio, you can upload the pathway directly from PathVisio. Otherwise, you can save the pathway in gpml format and upload the pathway it to WikiPathways under '''Create new pathway'''.   
# Become part of the WikiPathways community by [[:Special:Userlogin|creating a user account]].
# Become part of the WikiPathways community by [[:Special:Userlogin|creating a user account]].
-
# Launch PathVisio. PathVisio will open with a blank drawing board. To access your existing GenMAPP pathway, go to ''File -> Import'' and select the appropriate .mapp file.  
+
# Launch PathVisio. PathVisio will open with a blank drawing board. To access your existing GenMAPP pathway, go to '''File -> Import''' and select the appropriate .mapp file.  
# Make any necessary changes to the pathway in PathVisio.
# Make any necessary changes to the pathway in PathVisio.
-
## If you have the WikiPathways plugin installed in PathVisio, select ''Plugins -> WikiPathways -> Upload New''. You will be asked to specify your login information and a description of the pathway.
+
## If you have the WikiPathways plugin installed in PathVisio, select '''Plugins -> WikiPathways -> Upload New'''. You will be asked to specify your login information and a description of the pathway.
-
## To upload the pathway without the plugin, click the [[:Special:CreatePathwayPage|Create]] thumbnail on the main page or click the ''Create'' link in the left navigation panel.  
+
## To upload the pathway without the plugin, click the [[:Special:CreatePathwayPage|Create]] thumbnail on the main page or click the '''Create''' link in the left navigation panel.  
-
## On the ''Create new pathway'' page, enter a name for the pathway and then select which species the pathway is for from the drop-down menu. Click the ''Upload file'' button to continue.
+
## On the '''Create new pathway''' page, enter a name for the pathway and then select which species the pathway is for from the drop-down menu. Click the '''Upload file''' button to continue.
-
## Select the gpml file using the file browser. There is also an option to make the pathway private, meaning it will be hidden from public view for 30 days. Click ''Upload pathway'' when done.
+
## Select the gpml file using the file browser. There is also an option to make the pathway private, meaning it will be hidden from public view for 30 days. Click '''Upload pathway''' when done.
-
# Add information about your pathway by [[:Help:Editing Pathways|editing]] the text fields in the ''Pathway Page''. Remember to assign a category to your pathway so that the pathway will appear in the lists of all pathways at WikiPathways.
+
# Add information about your pathway by [[:Help:Editing Pathways|editing]] the text fields in the '''Pathway Page'''. Remember to assign a category to your pathway so that the pathway will appear in the lists of all pathways at WikiPathways.
<p>[[:Help:Contents|Return to Help Contents]]</p>
<p>[[:Help:Contents|Return to Help Contents]]</p>
<p>[[:Help:Finding_Pathways|Continue to Finding Pathways]]</p>
<p>[[:Help:Finding_Pathways|Continue to Finding Pathways]]</p>

Revision as of 23:28, 27 January 2014

Welcome to WikiPathways! This guide presents a quick overview of the most common use cases of WikiPathways.

Where do you want to start?

Browse pathway archives or find a specific pathway

  1. To get an overview of the WikiPathways archives, select the Browse thumbnail on the main page. You can browse pathways by species, and fine-tune the results by Collection. Results can be viewed as thumbnail images or a list.
  2. To find a specific pathway, search for it by name, data node name or identifier or keyword.

For details Search and Browse, see Finding Pathways.

Edit an existing pathway

  1. Become part of the WikiPathways community by creating a user account.
  2. Find a pathway to edit.
    To identify a pathway that is in need of editing, use the curation tag system. You can find lists of pathways organized by curation tag. For example, pathways tagged with the "Missing gene/protein database references" (MissingXRef) tag or the "Unconnected lines" (NoInteractions) tag can be greatly improved by relatively simple editing. You can also find a pathway through search or browse.

Graphical pathway representation

  1. Once you decide on a pathway to edit, open the Pathway Page for that pathway.
  2. Click the Edit pathway link under the pathway image. This will open the pathway in the WikiPathways editor, where you can edit the pathway.
The content at WikiPathways is diverse in both style and content. While we don't enforce a particular drawing style, there are some guidelines for editing and graphical style. Our guidelines include general editing guidelines as well as a list of example pathways for your reference. There is also a specific process for including pathways into specific pathway collections at WikiPathways, read more about it here.
When you are done editing, save the pathway in PathVisio by clicking the "Close the editor" button and then return to the Pathway Page. Click the Refresh button in your browser to view your recent changes.

Additional fields of the pathway page

In addition to the graphical pathway representation, the Pathway Page has additional information fields that can be edited.

  1. Add or remove relevant curation tags. For example, if you added database references to all unassigned DataNodes on the pathway, remove the "Missing gene/protein database references" tag by clicking the Remove button next to the tag. Similarly, to add a curation tag, click the New tag button at the bottom of the Curation Tags section and select a tag from the drop-down menu. For example, if you consider the pathway incomplete, add the "Needs work" tag.
  2. To edit the pathway description, click the Edit link in the Description section.
  3. Add relevant ontology tags by searching for tags or by browsing the three ontologies.

Create a new pathway at WikiPathways

  1. Become part of the WikiPathways community by creating a user account.
  2. Click the Create thumbnail on the main page or click the Create link in the left navigation panel.
  3. On the Create new pathway page, enter a name for the pathway and then select which species the pathway is for from the drop-down menu. Selecting the Make pathway private option hides your pathway from the rest of the community for 30 days. See the section on Private Pathways for details. Click the Create pathway button to continue.
  4. The WikiPathways editor contains a full set of drawing tools for pathway creation. See Editing Pathways for details.

For information on editing guidelines, please review our general editing guidelines and our list of example pathways.

  1. When your pathway is complete, click the Close the editor button to save your pathway to WikiPathways. The Pathway Page for your newly created pathway will be displayed.
  2. Add information about your pathway by editing the text fields in the Pathway Page. Remember to assign a category to your pathway so that the pathway will appear on the browse page listing all categorized pathways at WikiPathways.

Transfer pathway from GenMAPP to WikiPathways

You can transfer a pathway that you have created in the GenMAPP program to WikiPathways using PathVisio. If you have the WikiPathways plugin installed in PathVisio, you can upload the pathway directly from PathVisio. Otherwise, you can save the pathway in gpml format and upload the pathway it to WikiPathways under Create new pathway.

  1. Become part of the WikiPathways community by creating a user account.
  2. Launch PathVisio. PathVisio will open with a blank drawing board. To access your existing GenMAPP pathway, go to File -> Import and select the appropriate .mapp file.
  3. Make any necessary changes to the pathway in PathVisio.
    1. If you have the WikiPathways plugin installed in PathVisio, select Plugins -> WikiPathways -> Upload New. You will be asked to specify your login information and a description of the pathway.
    2. To upload the pathway without the plugin, click the Create thumbnail on the main page or click the Create link in the left navigation panel.
    3. On the Create new pathway page, enter a name for the pathway and then select which species the pathway is for from the drop-down menu. Click the Upload file button to continue.
    4. Select the gpml file using the file browser. There is also an option to make the pathway private, meaning it will be hidden from public view for 30 days. Click Upload pathway when done.
  4. Add information about your pathway by editing the text fields in the Pathway Page. Remember to assign a category to your pathway so that the pathway will appear in the lists of all pathways at WikiPathways.

Return to Help Contents

Continue to Finding Pathways

Personal tools