HopperWiki editing guidelines

From HopperWiki
Jump to navigation Jump to search

How do I edit an existing page?

🎥 Watch a tutorial here
At a glance: Use sentence case for all headings, spell out and (instead of using & in titles and text), cite as much as possible, and when in doubt ask miraries@asu.edu!

  • Follow the citation format of The Journal of Orthoptera Research (JOR) review here

Advance your knowledge with these resources

How do I add citations?

example:

Paste at the bottom of your page:
<references> <ref name="Word et al. 2019"> Word ML, Hall SJ, Robinson BE, Manneh B, Beye A, Cease AJ (2019) Soil-targeted interventions could alleviate locust and grasshopper pest pressure in West Africa. Science of The Total Environment 663: 632–643. https://doi.org/10.1016/j.scitotenv.2019.01.313 </ref> duplicate for as many different references as you need. </references> For the in-line citations use after the period: <ref name="Word et al. 2019"/>


How do I create a new page?

  • 🎥 Watch a tutorial here
  • Search the Wiki and make sure the page doesn't already exist before creating a new one
  • Title the page as simply and clearly as possible using "sentence case" format (only the first word of a sentence and proper nouns are capitalized, with the rest of the words in lowercase)
  • Review other pages and copy the standard section categories where relevant (also use sentence case for headers)

Chosing a title for a new page

Creating effective titles for Wiki pages involves a balance between being descriptive, concise, and informative. Here are some good practices to consider but first check for redundancy. Ensure the title doesn't duplicate information already present in the article name or is redundant with other Wiki page titles.

  • Use sentence case
  • Clarity and Relevance: Titles should be clear, descriptive, and directly related to the content of the page. They should accurately represent the subject matter and be easily understandable to readers.
  • Conciseness: Keep titles concise and to the point. Avoid overly long titles that may confuse or overwhelm readers. Aim for clarity without unnecessary words or details.
  • Use of Keywords: Incorporate relevant keywords that users might search for when looking for information on the topic. This helps with search engine optimization (SEO) and makes the page more discoverable.
  • Avoid Ambiguity: Steer clear of ambiguous or vague titles that could have multiple interpretations. Be specific about the content covered in the page.
  • Consistency: Maintain a consistent style of titling across related pages within the Wiki. This makes navigation easier for users and creates a cohesive structure.
  • Capitalization and Formatting: Follow the Wiki's guidelines on capitalization and formatting. Some Wikis have specific style guidelines for titles, including rules about capitalizing the first letter of each word or using sentence case.
  • Avoid Special Characters: Refrain from using special characters or symbols in titles that could hinder readability or cause technical issues.
  • Update if Necessary: Over time, topics or information might evolve. Periodically review and update titles to reflect any changes or developments in the subject matter.

HopperWiki manual of style

In general, we follow Wikipedia's manual of style. For more details of HopperWiki variations and relevant guidelines on organization names, species names, and more click here.

How do I add a photo or other media?

  1. First, check the copyright on the photo if it isn't yours. For more information on creative commons click here.
  2. Use the Upload file link under Tools on the wiki sidebar
  3. Fill in the following information in the summary section or "Edit" at a minimum if it is not included in the metadata.
  4. Source filename: Despite what the original name of the file is you are uploading, you should strongly consider renaming the file using the standard below. Creating a succinct title that includes enough detail to be unique without making it too crazy long is useful. Use title casing with spaces for files. See Wikipedia style guidelines for more information. Examples:
    • Schistocerca cancellata adult Argentina 2022.jpg
    • Schistocerca cancellata adult Argentina 2022 (cropped small).jpg
    • Oedaleus senegalensis eating millet in Senegal.jpg
  5. For technical reasons, file names cannot contain any of the following characters: # < > [ ] | : { } /~
  6. Add more description in the summary as needed:
    • Author:
    • Date:
    • Copyright:
    • Minimum Description: Add more detail than the title if necessary/wanted. What is this a photo of?
  7. Before finally selecting Upload file at the bottom of the screen, make a note of what you named the file and note the instructions at the top of the Upload file page for inserting the image into the page where you want to use it. The basic syntax for this is [[File:Your file name here.jpg]], but see the MediaWiki help page on images for many useful examples on how to insert images with different formatting options.
  8. Once the image has been uploaded it is stored in a large repository which can be accessed through the Article Index link in the sidebar, but it shouldn't normally be necessary to use this page unless you are troubleshooting a missing file or some other problem.

Batch upload

There are two different modes of batch uploading files. The first—is when you want to upload a bunch of files that don’t need to be linked to an article. You do this by clicking on "Batch upload" on the "Special Pages" sidebar. The second way which is probably much more useful generally—is in the article itself. you’ll notice the little “drop files here” box now that you can drag files to and follow the instructions. Once you drag in the files it shows you these options to upload and then to choose to embed as links or files. Note that this all has to be done through the “Edit Source” (old school editing) vs the “edit” (fancy editor) button—but once you have the images in there—if you edit with the fancy editor you can move images and resize them with your mouse. Note that file names for both methods should be edited before uploading.

What are the rules of engagement?

We generally follow the format and style guidelines of Wikipedia.
Read about HopperWiki Governance