Difference between revisions of "Guidelines"

From Coastal Plain Plants Wiki
Jump to: navigation, search
 
(84 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
=Become a Contributor=
 
=Become a Contributor=
  
To become a contributor, click "Create Account" on the upper right hand side of the page, and send an email introducing yourself to webmaster [http://talltimbers.org/bio-robertson Kevin Robertson] including your username and real name. Contributors unknown to the webmaster will not be retained. It is suggested that you make the username short, preferably your initials, as it will be used to cite contributions with a link to your contributor page, explained below.  
+
To become a contributor, click "Create Account" on the upper right hand side of the page and complete the form.  Please send an email introducing yourself to webmaster [http://talltimbers.org/bio-robertson Kevin Robertson] including your username and real name. Contributors not known to the webmaster will not be retained. You will have a contributor webpage set up that will allow you to cite your contributions to your webpage using your username, explained below.  
 
   
 
   
=Overview=
 
 
Contributions to Coastal Plain Plants can be made in various ways: 
 
 
1) Edit pages directly using the guidelines below.
 
 
2) Request a plant species form as a Word (docx) file, edit the form and submit to [http://talltimbers.org/bio-robertson Kevin Robertson] for incorporation into the website.
 
 
3) Submit other sources of information, such as notes or spreadsheets containing relevant data about plants, for incorporation into the website.
 
 
4) Volunteer to be interviewed about your knowledge on certain plants by contacting [http://talltimbers.org/bio-robertson Kevin Robertson].
 
 
 
=Editing=
 
=Editing=
  
Coastal Plain Plants uses a Wikimedia platform, the same as used for Wikipedia. To edit pages, login, then click the "Edit" tab or and of the "Edit" hyperlinks on pages.  After editing, click the "Save Page" button at the bottom, which brings you back to the Read (front end) view.  If you are not familiar with editing in Wikimedia, a good place to start is this [http://en.wikipedia.org/wiki/Wikipedia:Tutorial tutorial].  Many more sophisticated commands can be searched online. Some basic commands are:
+
Coastal Plain Plants uses a Wikimedia platform, the same as used for Wikipedia. A good place to start learning how to edit is this [http://en.wikipedia.org/wiki/Wikipedia:Tutorial tutorial], and more sophisticated commands can be searched online, but some basic instructions are as follows:
  
<nowiki>''italic''</nowiki> (apostrophes, not quotation marks) Use for plant species binomials, e.g. ''Dyschoriste oblongifolia''.
+
To edit pages, login, then click the "Edit" tab or and of the "Edit" hyperlinks on pages.
  
<nowiki>'''bold'''</nowiki>
+
After editing, click the "Save Page" button at the bottom, and then it will go back to the front end view.
  
<nowiki>'''''bold italic'''''</nowiki>
+
If there were no edits, then clicking the "Read" tab at the top will bring you back to the front end view.
  
<nowiki>=Heading=</nowiki> e.g.
+
Latin names of plants and other organisms should be written in italics by adding two single apostrophes before and after the name (not quotation marks). For example:
  
<nowiki>==Subheading==</nowiki> e.g.  
+
Typing <nowiki>''Dyschoriste oblongifolia''</nowiki> (two apostrophes) returns ''Dyschoriste oblongifolia''.
  
<nowiki>===Sub-subheading===</nowiki> e.g.
+
Default subheadings are provided for each plant webpage.  However, if they do not have any information under them yet then they are hidden using the format <nowiki><!--</nowiki> hidden subheading <nowiki>--></nowiki>. If you delete the <nowiki><!--- and --></nowiki> then the subheading will appear in the Read window.  
  
Contributors are encouraged to use the default headings for plant species pages, but additional headings can be added as needed and appropriate.
+
==Content Guidelines==
  
pipe "|" divider: SHIFT + BACKSLASH
+
===General===
 +
The Webmaster adds plant pages to the website. If you would like a plant added, please contact the Webmaster at [http://talltimbers.org/bio-robertson Kevin Robertson].
  
<nowiki>: single indent</nowiki>
+
Use binomial (scientific) names of plants to species or finer taxonomic resolution. Common names can be added to the common names list at the top of the page.
  
<nowiki>:: double indent, etc.</nowiki>
+
Provide as much context for contributions as possible, such as habitat, geographic location, land use history (old-field, native community, pasture, etc.), and other potentially helpful information.
  
<nowiki>* bullet point</nowiki>
+
===Taxonomic notes===
 +
The Webmaster provides synonyms and varieties/subspecies using Weakley 2015, but other sources can be added by contributors. Include author(s) of species and varieties. Include only synonyms for which names are different than the page title at the genus or species level. However, include varieties and subspecies of those synonyms. For example, for ''Agalinis fasciculata'':
 +
Synonyms: ''Gerardia fasciculata'' Elliott ssp. ''typica'' (Pennell) Pennell; ''Garardia fasciculata'' Elliott ssp. ''peninsularis'' (Pennell) Pennell
  
Adding a thumbnail:
+
===Distribution===
 +
Summary of the distribution, and any information about the species' geographic distribution that is more specific than the state maps. For example, "This species may occur from North Carolina to Texas, but is mostly found in the Carolinas."
  
Link to an external source: <nowiki>Example: [http://plants.usda.gov NRCS Plants Database]</nowiki>  The part after the space is what will appear as a hyperlink: [http://plants.usda.gov NRCS Plants Database]
+
===Ecology===
 +
''Habitat'' – Any information about the species' natural communities, human disturbed habitats, sensitivity to soil disturbance, role in succession, topography, hydrology, soils, light, fire regime requirements, and the like. Also within this section can be added associated species, by just starting a new paragraph at the end: "Associated species – ''Andropogon gerardii''" etc.
  
=Citing Contributions=
+
''Phenology'' - Timing of flowering, fruiting, seed dispersal, and environmental triggers.
  
Contributions should always be cited, but they can be cited in various ways.  
+
''Seed dispersal'' – Mode of seed dispersal (e.g. wind, gravity, animals, explosive dehiscence), specific animals that disperse seeds, characteristics of seeds relevant to dispersal, and the like. Use highest resolution of latin names for animals as possible.
  
==Cite notes or literature using the <nowiki><ref> function</nowiki>==
+
''Seed bank and germination'' - Ability for seeds to remain dormant in the soil and how for long, germination requirements and cues, characteristics of seeds relevant to seed persistence and germination.
  
As typically done in Wikipedia, citations can be made so that they show only a hyperlinked superscript number in the text linking to a footnote at the bottom of the page.  For the purposes of this can be used to identify the contributor and provide notes on the source of information, or to provide a literature reference.  Type <nowiki><ref> followed by the note or reference text and then </ref></nowiki>. This will place the the note or reference at the end of the page in order of citation.   
+
''Fire ecology'' - Fire tolerance, fire dependence, morphological and life history characteristics that might be adaptive to fire and fire regimes, etc.   
  
If the reference is going to be referenced several times on that page, you can type <nowiki><refname=Smith and Blackburn 1994> then type the citation text followed by </ref>.  Every time the reference is cited afterward, just type <refname=Smith and Blackburn 1994> and it will link to the same full reference at the bottom of the page.</nowiki> However, it is only good for that page.  
+
''Pollination and insect hosting'' – What insects or other animals pollinate the flowers, adaptations to attract pollinators, use of plants for hosting larvae, etc.  
  
==Cite by Contributor username==
+
''Herbivory and toxicology'' - Herbivory, granivory, chemical traits influencing plant use, etc.
  
To only identify the contributor, type the username in double brackets, e.g. <nowiki>[[DDG]]</nowiki>.  This will create a link to a page that is not yet created, so it will appear as a red hyperlink after the page is saved and you are in Read view.  If you click on this hyperlink, you will be prompted to edit the new page that has your user name as the title.  To set up a template for this page, type or paste <nowiki>{{subst:Template:Contributor}}</nowiki> in the editing area.  After saving the page, this will create a template where you can fill in with information about yourself so that people may know who made the contribution.  This page can include links to a personal or professional web page where contact information may be more secure.  
+
''Diseases and parasites'' - Self explanatory.
  
After your Contributor page is created, typing your user name in double brackets will create a function link to that page.  
+
===Conservation, cultivation, and restoration===
 +
Field management techniques that restore or benefit the species, mostly relevant to foundational species and species of special concern.
 +
===Cultural use===
 +
Use by humans, whether traditional, homeopathic, modern medical, industrial, etc.
  
To appear on the list of Contributors, go to the [http://coastalplainplants.org/wiki/index.php/Contributors Contributors] page, start editing, and insert a link to your page in alphabetical order of Contributors' last names.  To do this, type your username and real name inside double brackets and separated by a pipe, e.g. <nowiki>[[KMR|Kevin Robertson]]</nowiki>.  This will provide a link to your Contributor page. 
+
==Citing Contributions==
  
==Cite literature using Author-Date form==
+
Contributions should always be cited using standard Wikimedia formats.
  
Simply cite the author(s) and date in parentheses, e.g. (Smith and Blackburn 1994), and write or paste the full reference in alphabetical order under the "References and Notes" section.  
+
Type <nowiki><ref> followed by the reference information to be cited, followed by </ref></nowiki>. This will insert a hyperlinked superscript number that links to the reference, which is automatically placed at the bottom of the page. This can be used to add specific notes about an observation or cite published literature.
  
If a reference is going to be used frequently on different pages, it can be made into a template. For example, type <nowiki>{{Template:Smith and Blackburn 1994}}. After the page is saved, this will appear as a red hyperlink.  If you click that hyperlink, it will bring you to a new page to bed edited.  Type in the full reference and save the page. Afterwards, any time you write {{Template:Smith and Blackburn 1994}} in the References section, the full reference will appear after you save the page.</nowiki>  
+
If the same source is going to be cited multiple times on the same page, the first time you cite the source, type <nowiki><ref name=short name of reference>, followed by the reference, then </ref>. Then every time afterward you can just write <ref name=short name of reference/></nowiki> and it cites the reference with a hyperlinked subscript as above.
  
 +
==Create links to other pages==
  
 +
Links to external webpages can be inserted by placing the URL followed by text for the hyperlink in single brackets.  For example, typing <nowiki>[http://plants.usda.gov NRCS]</nowiki> will appear as [http://plants.usda.gov NRCS]. 
  
==Cite with links to other pages==
+
Links to other pages within Coastal Plain Plants can be made by using double brackets.  For example <nowiki>[[Dyschoriste oblongifolia]]</nowiki> will return [[Dyschoriste oblongifolia]].
  
As described above, links to other pages can be inserted.  For example, typing <nowiki>([http://plants.usda.gov NRCS])</nowiki> will appear as [http://plants.usda.gov NRCS] linked to the USDA NRCS database.
+
==Add images==
  
If the same webpage is cited multiple times, text can be cited using the Author-Date form described above, e.g. (USDA NRCS 2015), and provide the link with the full citation under the References and Notes section.  
+
To add an image, it first has to be uploaded.  To upload an image, click Upload File under Tools in the side bar menu and follow the instructions.  If the file is over 2 MB then it cannot be uploaded.  In that case, the image size will need to be reduced in another software application, such as Microsoft Paint, before uploading.  Reference to the uploaded image is case-sensitive, so note the exact case of the file name and extension.  
  
=Add images=
+
===Add images to gallery===
  
To add an image, it first has to be uploaded.  To upload an image, click on Main Page in the sidebar menu, and under Tools click Upload file and follow the instructions.  If the file is too large then it will not allow the image to be uploaded. In that case, the image size will need to be reduced in another software application before uploadingWhen uploading, note whether or not the format indicator "JPG" is in lowercase or uppercase letters, as references made to the image later are case-sensitive.
+
To add an image to the Photo Gallery, add one line of information per image in between the gallery opening and closing statements, e.g.:
 +
   
 +
<nowiki><gallery widths=180px></nowiki>
  
The simplest command for adding an image has the format <nowiki>[[Image:image_name.JPG]]</nowiki>.  However, that does not specify the size or location.  More specific commands can be made separated by pipes (|), for example <nowiki>[[Image:image_name.JPG|thumb|left|image caption]]</nowiki>, which specifies that it is a thumbnail justified to the left with the caption "image caption". For more guidance, see Wikipedia's [https://en.wikipedia.org/wiki/Wikipedia:Picture_tutorial image tutorial].
+
<nowiki>File:Salvia_azurea.jpg|''Salvia azurea'' Photo by Kevin Robertson, Pebble Hill Plantation, GA</nowiki>
  
=Add a new plant species page=
+
</nowiki></gallery></nowiki>
  
*Navigate to the [http://coastalplainplants.org/wiki/index.php/Plant_species Plant Species] page, where the plant species binomials are listed in alphabetical order.
+
The part after the pipe provides a caption, so it looks like:
*Start editing. 
 
*In the correct alphbetical location, add a link using the name of the new species in double brackets, e.g. <nowiki>[[Dyschoriste oblongifolia]]</nowiki>.
 
*Save the page, and the link appears as a red hyperlink.
 
*Select the hyperlink, and you will be brought to the new page with the plant's name as the title.
 
*Type or paste the command <nowiki>{{subst:Template:PlantName}}</nowiki> to bring in the template text.
 
*Save the page and begin editing
 
  
The new page will include a "Taxobox", which is a template for creating the box with the plant name, image, taxonomy, and distribution. The Taxobox will need to be edited.  To fill in the Taxobox you will need:
+
<gallery widths=180px>
*Uploaded image for the species
+
File:Salvia_azurea.jpg|''Salvia azurea'' Photo by Kevin Robertson, Pebble Hill Plantation, GA, September 30, 2018
*Taxonomic information for the plant, which can be obtained from the [http://plants.usda.gov NRCS Plants Database] or other updated reliable source.
+
</gallery>
*Uploaded image for the distribution of the species.  Most pages so far have used images screen-saved from the [http://plants.usda.gov NRCS Plants Database].
 

Latest revision as of 15:23, 9 July 2024

Become a Contributor

To become a contributor, click "Create Account" on the upper right hand side of the page and complete the form. Please send an email introducing yourself to webmaster Kevin Robertson including your username and real name. Contributors not known to the webmaster will not be retained. You will have a contributor webpage set up that will allow you to cite your contributions to your webpage using your username, explained below.

Editing

Coastal Plain Plants uses a Wikimedia platform, the same as used for Wikipedia. A good place to start learning how to edit is this tutorial, and more sophisticated commands can be searched online, but some basic instructions are as follows:

To edit pages, login, then click the "Edit" tab or and of the "Edit" hyperlinks on pages.

After editing, click the "Save Page" button at the bottom, and then it will go back to the front end view.

If there were no edits, then clicking the "Read" tab at the top will bring you back to the front end view.

Latin names of plants and other organisms should be written in italics by adding two single apostrophes before and after the name (not quotation marks). For example:

Typing ''Dyschoriste oblongifolia'' (two apostrophes) returns Dyschoriste oblongifolia.

Default subheadings are provided for each plant webpage. However, if they do not have any information under them yet then they are hidden using the format <!-- hidden subheading -->. If you delete the <!--- and --> then the subheading will appear in the Read window.

Content Guidelines

General

The Webmaster adds plant pages to the website. If you would like a plant added, please contact the Webmaster at Kevin Robertson.

Use binomial (scientific) names of plants to species or finer taxonomic resolution. Common names can be added to the common names list at the top of the page.

Provide as much context for contributions as possible, such as habitat, geographic location, land use history (old-field, native community, pasture, etc.), and other potentially helpful information.

Taxonomic notes

The Webmaster provides synonyms and varieties/subspecies using Weakley 2015, but other sources can be added by contributors. Include author(s) of species and varieties. Include only synonyms for which names are different than the page title at the genus or species level. However, include varieties and subspecies of those synonyms. For example, for Agalinis fasciculata: Synonyms: Gerardia fasciculata Elliott ssp. typica (Pennell) Pennell; Garardia fasciculata Elliott ssp. peninsularis (Pennell) Pennell

Distribution

Summary of the distribution, and any information about the species' geographic distribution that is more specific than the state maps. For example, "This species may occur from North Carolina to Texas, but is mostly found in the Carolinas."

Ecology

Habitat – Any information about the species' natural communities, human disturbed habitats, sensitivity to soil disturbance, role in succession, topography, hydrology, soils, light, fire regime requirements, and the like. Also within this section can be added associated species, by just starting a new paragraph at the end: "Associated species – Andropogon gerardii" etc.

Phenology - Timing of flowering, fruiting, seed dispersal, and environmental triggers.

Seed dispersal – Mode of seed dispersal (e.g. wind, gravity, animals, explosive dehiscence), specific animals that disperse seeds, characteristics of seeds relevant to dispersal, and the like. Use highest resolution of latin names for animals as possible.

Seed bank and germination - Ability for seeds to remain dormant in the soil and how for long, germination requirements and cues, characteristics of seeds relevant to seed persistence and germination.

Fire ecology - Fire tolerance, fire dependence, morphological and life history characteristics that might be adaptive to fire and fire regimes, etc.

Pollination and insect hosting – What insects or other animals pollinate the flowers, adaptations to attract pollinators, use of plants for hosting larvae, etc.

Herbivory and toxicology - Herbivory, granivory, chemical traits influencing plant use, etc.

Diseases and parasites - Self explanatory.

Conservation, cultivation, and restoration

Field management techniques that restore or benefit the species, mostly relevant to foundational species and species of special concern.

Cultural use

Use by humans, whether traditional, homeopathic, modern medical, industrial, etc.

Citing Contributions

Contributions should always be cited using standard Wikimedia formats.

Type <ref> followed by the reference information to be cited, followed by </ref>. This will insert a hyperlinked superscript number that links to the reference, which is automatically placed at the bottom of the page. This can be used to add specific notes about an observation or cite published literature.

If the same source is going to be cited multiple times on the same page, the first time you cite the source, type <ref name=short name of reference>, followed by the reference, then </ref>. Then every time afterward you can just write <ref name=short name of reference/> and it cites the reference with a hyperlinked subscript as above.

Create links to other pages

Links to external webpages can be inserted by placing the URL followed by text for the hyperlink in single brackets. For example, typing [http://plants.usda.gov NRCS] will appear as NRCS.

Links to other pages within Coastal Plain Plants can be made by using double brackets. For example [[Dyschoriste oblongifolia]] will return Dyschoriste oblongifolia.

Add images

To add an image, it first has to be uploaded. To upload an image, click Upload File under Tools in the side bar menu and follow the instructions. If the file is over 2 MB then it cannot be uploaded. In that case, the image size will need to be reduced in another software application, such as Microsoft Paint, before uploading. Reference to the uploaded image is case-sensitive, so note the exact case of the file name and extension.

Add images to gallery

To add an image to the Photo Gallery, add one line of information per image in between the gallery opening and closing statements, e.g.:

<gallery widths=180px>

File:Salvia_azurea.jpg|''Salvia azurea'' Photo by Kevin Robertson, Pebble Hill Plantation, GA

</nowiki></gallery></nowiki>

The part after the pipe provides a caption, so it looks like: