Documents: Difference between revisions

From Salish Sea Wiki
No edit summary
Line 2: Line 2:
'''The document category is used for all pages that provide information about published reports and articles either uploaded here or published.  Documents may be either uploaded to the wiki when public domain (on-wiki) or located on another server or physical location as identified by a link when copyrighted or not released for posting by the author (off-wiki).'''
'''The document category is used for all pages that provide information about published reports and articles either uploaded here or published.  Documents may be either uploaded to the wiki when public domain (on-wiki) or located on another server or physical location as identified by a link when copyrighted or not released for posting by the author (off-wiki).'''


'''Please follow our [[social contract]] around posting documents, and use good [[categories]] and interlinking to make your document easy to find.'''
==Social Contract==
Uploading and providing analysis of documents should be consistent with our social contract.  Don't violate copyright.  Provide impersonal, evidence-driven analysis.  Use concise language.
==Creating a document page for an off-wiki document==
To create a document page, just type in a standard document name in the search window, and press [Go].  This will give you the option of creating the page.  Please include the following elements in a document page:
*Standard name
*'''Document Template Code''' - Don't forget to put the code {{document}} at the top of text.
*'''Categories''' - Pick some appropriate categories and add them to the top of text (following instructions).
*'''Standard Bibliographic Citation''' - Please provide a text string that will let someone cut and paste a standard bibliographic citation.
*'''Link to Document''' - If the document has a stable link location, than please provide it.  Consider a google scholar search if you have doubts about the stability of the document link.
*'''Google Scholar Search''' - If the document is under copyright, you CAN insert a google scholar link, like so: <nowiki>[http://scholar.google.com/scholar?q=Simenstad+Cordell+2000+salmonid+habitat+assessment&btnG=&hl=en&as_sdt=0%2C48 Google Scholar Search]</nowiki>
We just cut the search result address added some brackets and produced the following results: [http://scholar.google.com/scholar?q=Simenstad+Cordell+2000+salmonid+habitat+assessment&btnG=&hl=en&as_sdt=0%2C48 Google Scholar Search]
*'''Analysis''' - Why not tell us why you think the document is important, strong or weak.  Don't forget to sign with three tildas like so: <nowiki>'''~~~'''</nowiki>.  This will create an author stamp with a link back to your user page.  Anyone cane provide analysis.
If you don't have time, at least do steps 1 and 2 and then flag it with the <nowiki>[[category:raw]]</nowiki> indicating some sloppy work that needs fixing.
==Uploading file to create an on-wiki document page==
The second way to create a document page is to actually upload a document to the wiki.  This is a good choice if there is not currently a stable web location for the document, or you just want to contribute to our archive. 
 
Follow the [[special:upload|Upload a Document]] link found on any document page and follow instructions.
 
==Creating a redirect page for easy citation==
If you create a on-wiki document page it will have a complicated page name like '''''File:Simenstad & Cordell 2000 criteria for restoring salmonid habitat'''''. To make it easy to cite, you can create a [[redirect]] page, called '''''Simenstad & Cordell 2000''''', which points to the full document page.  In this way you can cite a document page by just typing the file name into your text like this:
<nowiki>Salmon like to eat invertebrates ([[Simenstad & Cordell 2000]])</nowiki>
Which will produce the following text: Salmon like to eat invertebrates ([[Simenstad & Cordell 2000]]).  A click on the link takes you to the full document page using the redirect.  [[Redirect|Learn how to create a redirect page]].


==Documents loaded on the wiki==
==Documents loaded on the wiki==
Line 24: Line 45:
suppresserrors=true
suppresserrors=true
</DynamicPageList>
</DynamicPageList>
==Creating a document page==
There are two ways to create a document page, depending on whether the document is a uploaded file (i.e. on-wiki), or whether you are referecing a document that is off-wiki.
'''To load a document onto the wiki:'''
#'''Copy''' the template below. 
#'''Click''' on the [[Special:upload|Upload File]] link. 
#'''Name''' the file using a standard citation format such as "Author et al 20##". 
#'''Paste''' the template into the summary box, and use the resulting wiki page (which will be named ''File:Author_et_al_20##'') as you document page.
#'''Assign''' [[categories]] that makes sense for your document.  Is it associated with a particular [[site]] or [[place]] or [[topic]]?
#'''Create''' a redirect page by 1) typing your new title, ''Author et al 20##'' into the search box, 2) select the 'create page' link, 3) type ''<nowiki>#REDIRECT[[File:Author et al 20##]]</nowiki>'' into the blank page, and save.  This creates a page that will direct a <nowiki>[[Author et al 20##]]</nowiki> link to your uploaded file.
'''Off-wiki''' - Use a regular document wiki page named ''Author et al 20##'' to describe the document, using the template below and including a link to an appropriate source for the document (which could include a google scholor search for the document title.)
==Standard Document Template==
''For each document page adapt the following template depending if your document is on- or off-wiki''
::<nowiki> {{document}} </nowiki>
::<nowiki>'''Citation'''</nowiki>
::<nowiki>==Links to Document==</nowiki>
::<nowiki>*'''[[Link]]''' - text</nowiki>
::<nowiki>==Abstract (Closed to Editing)==</nowiki>
::<nowiki>Abstract written by author</nowiki>
::<nowiki>==Analysis==</nowiki>
::<nowiki>Description of importance of document in relation to other efforts including links to any other documents found in this wiki</nowiki>

Revision as of 16:09, 25 April 2013


The document category is used for all pages that provide information about published reports and articles either uploaded here or published. Documents may be either uploaded to the wiki when public domain (on-wiki) or located on another server or physical location as identified by a link when copyrighted or not released for posting by the author (off-wiki).

Social Contract

Uploading and providing analysis of documents should be consistent with our social contract. Don't violate copyright. Provide impersonal, evidence-driven analysis. Use concise language.

Creating a document page for an off-wiki document

To create a document page, just type in a standard document name in the search window, and press [Go]. This will give you the option of creating the page. Please include the following elements in a document page:

  • Standard name
  • Document Template Code - Don't forget to put the code

at the top of text.

  • Categories - Pick some appropriate categories and add them to the top of text (following instructions).
  • Standard Bibliographic Citation - Please provide a text string that will let someone cut and paste a standard bibliographic citation.
  • Link to Document - If the document has a stable link location, than please provide it. Consider a google scholar search if you have doubts about the stability of the document link.
  • Google Scholar Search - If the document is under copyright, you CAN insert a google scholar link, like so: [http://scholar.google.com/scholar?q=Simenstad+Cordell+2000+salmonid+habitat+assessment&btnG=&hl=en&as_sdt=0%2C48 Google Scholar Search]

We just cut the search result address added some brackets and produced the following results: Google Scholar Search

  • Analysis - Why not tell us why you think the document is important, strong or weak. Don't forget to sign with three tildas like so: '''~~~'''. This will create an author stamp with a link back to your user page. Anyone cane provide analysis.

If you don't have time, at least do steps 1 and 2 and then flag it with the [[category:raw]] indicating some sloppy work that needs fixing.

Uploading file to create an on-wiki document page

The second way to create a document page is to actually upload a document to the wiki. This is a good choice if there is not currently a stable web location for the document, or you just want to contribute to our archive.

Follow the Upload a Document link found on any document page and follow instructions.

Creating a redirect page for easy citation

If you create a on-wiki document page it will have a complicated page name like File:Simenstad & Cordell 2000 criteria for restoring salmonid habitat. To make it easy to cite, you can create a redirect page, called Simenstad & Cordell 2000, which points to the full document page. In this way you can cite a document page by just typing the file name into your text like this:

Salmon like to eat invertebrates ([[Simenstad & Cordell 2000]])

Which will produce the following text: Salmon like to eat invertebrates (Simenstad & Cordell 2000). A click on the link takes you to the full document page using the redirect. Learn how to create a redirect page.

Documents loaded on the wiki

Documents cited in the wiki