Proteopedia:How to Make a Page: Difference between revisions
Eran Hodis (talk | contribs) |
Eran Hodis (talk | contribs) No edit summary |
||
Line 5: | Line 5: | ||
Before you begin, if this is your first time editing a Proteopedia page you should begin by watching the [[Proteopedia:Video Guide|video guide]] and referring to the [[Help:Editing|editing help]] reference pages. | Before you begin, if this is your first time editing a Proteopedia page you should begin by watching the [[Proteopedia:Video Guide|video guide]] and referring to the [[Help:Editing|editing help]] reference pages. | ||
== | ==Creating the page== | ||
# choose your topic (generally: a protein, a molecule, or a concept) | # choose your topic (generally: a protein, a molecule, or a concept) | ||
Line 24: | Line 22: | ||
*if a page on your topic already exists, you may edit that page to improve it | *if a page on your topic already exists, you may edit that page to improve it | ||
==The basic beginnings of your page== | |||
In this section we describe the first elements every a new Proteopedia page should begin with. | |||
===Adding an introduction=== | |||
*3-7 sentences | |||
*first sentence should contain the name of the biomolecule or topic and it should be an interwiki link (so on the Hemoglobin page, you might start by writing "<nowiki>[[Hemoglobin]] is the protein...</nowiki>") | |||
*touch on medical relevance if there is any | |||
===Add a 2D image== | |||
*use such and such syntax | |||
*somethign about the view it should be | |||
*something about the size | |||
===Add a 3D applet== | |||
*consider the STRUCTURE box | |||
*choose a good scene | |||
*caption | |||
*include the PDB entry | |||
==Planning the rest of the page== | |||
* good to write down on paper | |||
==Structural description== | |||
*structuresection is ideal for this | |||
==Rules to live by== | |||
* max number of applets (absolute max is 3 including the upper right one) - if you need more use structuresection | * max number of applets (absolute max is 3 including the upper right one) - if you need more use structuresection | ||
* use wikitext rather than HTML | |||
* use | |||
===Scenes=== | ===Scenes=== | ||
Line 50: | Line 62: | ||
*use morphs to illustrate conformational changes | *use morphs to illustrate conformational changes | ||
*use a structuresection if you have a section with many green scene links | *use a structuresection if you have a section with many green scene links | ||
===References=== | |||
*how to use them | |||
===Add Internal Links=== | ===Add Internal Links=== | ||
Line 64: | Line 79: | ||
# create redirects for alternative spellings or capitalizations of your page name | # create redirects for alternative spellings or capitalizations of your page name | ||
# link to your page from other relevant Proteopedia pages | # link to your page from other relevant Proteopedia pages | ||
# add categories to the bottom of your page | |||
===Images=== | ===Images=== | ||
Line 76: | Line 92: | ||
* add interwiki links to link your page up to the wiki (say how to do this) | * add interwiki links to link your page up to the wiki (say how to do this) | ||
* create redirects for alternative spellings and capitalizations of the page name | * create redirects for alternative spellings and capitalizations of the page name | ||
==Extra stuff need to be organized== | |||
* applet on the upper right should be a representative structure | |||
* mention all PDB ids (where?) | |||
* use references correctly | |||
* make sure your scenes meet these guidelines -> [[Proteopedia:How to Make a Scene]] | |||
* upper left have a static image, preferably that shows a different view of the same protein, (i.e. if the one on the right in 3d is in cartoon, make the static image on the left in spacefill, so that it has a purpose beyond looking good) | |||
* intro section - less than 8 sentences that describes what the protein is and why we should care. The first sentence should say the name of the protein and it should be enclosed in interwiki link brackets | |||
* start broad and go narrow (use headlines, start with two equal signs, never use a single equal sign heading) | |||
* use captions for your images | |||
* if your protein has any medical relevance whatsoever, make sure to talk about it | |||
* cite the most important references | |||
* If page topic fits within one of the subcategories listed in the table of contents, i.e. "Diabetes" or "Lyase" add a section at bottom of page, before the references section called "Additional Resources" with the phrase "See [[Diabetes]] for more information". | |||
* add a list of all PDB entries, organized (say, similar to XXX page) |