Difference between revisions of "Help:Editors Instructions"

From SoilsWorldwide
Jump to: navigation, search
(Language)
(Categories)
 
(16 intermediate revisions by one user not shown)
Line 13: Line 13:
  
 
==User accounts==
 
==User accounts==
Becoming a SoilPIC editor requires an account. These are currently only made available on request from the Wossac/SoilPIC team. Please [http://www.wossac.com/contact/index.htm contact us] to request an account, including your email and a preferred username. Details of how to log on will then be emailed to you.
+
Becoming a SoilPIC editor requires an account. These are currently only made available on request from the Wossac/SoilPIC team. Please [http://www.wossac.com/contact/index.htm contact us] to request an account, including your email and a preferred username. Details of how to log on will then be emailed to you. To save time, you may also wish to forward us a completed [[ Media:Donor_Agreement.pdf|Donor form]].
  
 
=Editing SoilPIC=
 
=Editing SoilPIC=
Line 60: Line 60:
  
 
===Creator===
 
===Creator===
Here, enter your own details in if appropriate. The ‘[[User:Horizon|Horizon]] 17:29, 19 January 2008 (UTC)’ symbol used includes automatically your user name as the editor for this article.  
+
Here, enter your own details in if appropriate. The ‘<nowiki>~~~~</nowiki>’ symbol used includes automatically your user name as the editor for this article.
  
 
===Subject===
 
===Subject===
Line 71: Line 71:
  
 
===Contributor===
 
===Contributor===
 +
Potentially you! You are the contributor. Use the wiki technique of entering '<nowiki>~~~~</nowiki>', which once the page is saved is translated into a reference to your username.
  
 
===Date===
 
===Date===
 +
Enter the date the image was taken if known.
  
 
===Type===
 
===Type===
Line 84: Line 86:
  
 
===Source===
 
===Source===
 +
The source of the image is 'SoilPIC Archive'.
  
 
===Language===
 
===Language===
Line 92: Line 95:
  
 
<pre>
 
<pre>
|       Relation = [[Image:IMG005.jpg|thumb]][[Image:IMG006.jpg|thumb]]
+
| Relation = [[Image:IMG005.jpg|thumb]][[Image:IMG006.jpg|thumb]]
 
</pre>
 
</pre>
  
Line 99: Line 102:
  
 
<pre>
 
<pre>
|       Coverage = {{gbmaprim|SU485982|SU 485 982}}
+
| Coverage = {{gbmaprim|SU485982|SU 485 982}}
 
</pre>
 
</pre>
  
Line 105: Line 108:
  
 
==Categories==
 
==Categories==
SoilPIC image files can belong to one or more categories. All images automatically belong to the category 'SoilPIC'. When editing images, copy and paste the appropriate category/categories from the list below into the image's page description. Note the categories are arranged hierarchically. It is considered preferable not to combine multiple categories where one is the parent of another (you may like to view the source for this section and copy it ready to paste to edited image pages - omit the '*'s in pasting to pages, these are just to indicate the hierarchy):
+
SoilPIC image files can belong to one or more categories. All images automatically belong to the category 'SoilPIC' (so you don't have to add that one yourself). When editing images, copy and paste the appropriate category/categories from the list below into the image's page description. Note the categories are arranged hierarchically. It is considered preferable not to combine multiple categories where one is the parent of another (you may like to view the source for this section and copy it ready to paste to edited image pages - omit the '*'s in pasting to pages, these are just to indicate the hierarchy):
  
 
<pre>
 
<pre>

Latest revision as of 11:57, 3 December 2008

This page is aimed at those volunteers who are kindly assisting Cranfield University in the process of categorising and organising the SoilPIC materials, and assumes a working knowledge of editing a Wiki site.

Contents

[edit] The SoilPIC Project

This page lays out instructions to assist in editing the SoilPIC archive. SoilPIC is all about soil profile and landscape photographs which are received from a number of sources – for example perhaps from yourself. This website is restricted in terms of who can upload images so we can manage carefully issues such as Copyright and ownership. Before any images are uploaded to the site, we MUST have on file a completed and signed ‘Donor Agreement’ form which allows originators to state clearly their willingness for images to be used on the site. Once this is in place the instructions below can help in editing the entries.

SoilPIC uses the MediaWiki software, as used in Wikipedia. There are a range of web resources to help edit wiki pages, these include:

Navigation http://www.mediawiki.org/wiki/Help:Navigation
Editing pages http://www.mediawiki.org/wiki/Help:Editing_pages
More help http://www.mediawiki.org/wiki/User_hub

[edit] User accounts

Becoming a SoilPIC editor requires an account. These are currently only made available on request from the Wossac/SoilPIC team. Please contact us to request an account, including your email and a preferred username. Details of how to log on will then be emailed to you. To save time, you may also wish to forward us a completed Donor form.

[edit] Editing SoilPIC

SoilPIC images are loaded into the wiki, either individually by you, or in bulk by the administrators. Each file has a descriptive page, which has added to it metadata descriptions of the image. Furthermore, each image is assigned one or more categories to assist in retrieving images. The editor's role is to add the metadata and category entries.

Further to the many thousands of images, there are also descriptive articles associated with each of the categories available. SoilPIC has settled upon a well-developed set of categories (such as erosion and biodiversity) that can be used to describe and apportion images in the archive. These categories have their own descriptive article pages, allowing for full descriptions of each topical theme. Each of these category pages is also intended to present a 'gallery', or a subset of the best images illustrating that topic. This documentation will develop over time with assistance from all the editors.

[edit] Editing Images

Individual iages can be uploaded using the Upload file function. If you have a great many images to load, it may be more efficient to forward them directly to us (e.g. by CD-ROM) so they can be uploaded in bulk ready for descriptive entry editing.

It is best to ensure that Image file names are short and descriptive, preferably without spaces (use underscores). Also, avoid unusual characters in filenames. Image names must be unique and not already in use. You can see the names of the images currently loaded into the system using the Allpages command and selecting namespace 'images'.

[edit] Metadata

All slides need to have the same descriptive metadata elements captured. We have decided to adopt the ‘Dublin Core’ international standard for metadata (http://dublincore.org/), a standard widely used by other archives for bibliographic referencing. Dublin Core was developed and managed by DCMI (an international open forum with participants from Academic institutions, library groups etc.). Its simple form has 15 free text elements with no mandatory fields. It was originally designed for handling bibliographic records. Dublin Core has no specification of ‘mandatory’ fields and all entries are purely optional.

SoilsWorldwide uses a Wiki DublinCore template to hold and present metadata in the Dublin Core format for each image. Using a Wiki means pre-defined templates can be established and used. Individual image pages can have a blank template attached, which can then be completed. Copy the example below to the text section of newly uploaded image pages, ready for editing:

 == Summary ==
 {{DublinCore
 | Title = 
 | Creator = ~~~~, Cranfield University
 | Subject = 
 | Description = 
 | Publisher = Cranfield University
 | Contributor = 
 | Date = 
 | Type = Still Image
 | Format = JPEG
 | Identifier = filename.jpg
 | Source = SoilPIC Archive
 | Language = N/A
 | Relation = 
 | Coverage =
 | Rights  =
 }}

There are 15 fields to enter. If certain of these are left blank, the template will automatically blank them out or, if in some case where appropriate, complete them for you. An example of this is the ‘Rights’ copyright statement. Therefore be sure to complete any entries whose contents deviate from the accepted defaults for SoilPIC. Be sure to retain the ‘|’ symbols as these indicate rows in the final output metadata table.

The fields follow the standard Dublin Core metadata element set, and can be completed as described below.

[edit] Title

Enter here the title of the Image. Typically this will be the same as the filename itself (without the extension).

[edit] Creator

Here, enter your own details in if appropriate. The ‘~~~~’ symbol used includes automatically your user name as the editor for this article.

[edit] Subject

[edit] Description

Enter a full description of the image. This can be as long or concise as required.

[edit] Publisher

For the purposes of the metadata, the publisher of SoilPIC is Cranfield University.

[edit] Contributor

Potentially you! You are the contributor. Use the wiki technique of entering '~~~~', which once the page is saved is translated into a reference to your username.

[edit] Date

Enter the date the image was taken if known.

[edit] Type

The type is likely to be a 'Still Image' file

[edit] Format

The format is likely to be 'JPEG'.

[edit] Identifier

The identifier is the filename, including the file extension.

[edit] Source

The source of the image is 'SoilPIC Archive'.

[edit] Language

Language is not applicable for a photograph, thus 'N/A'.

[edit] Relation - Related images

Relation identifies related images in the SoilPIC archive. These can be explicitly referenced as follows (here for two related images):

| Relation = [[Image:IMG005.jpg|thumb]][[Image:IMG006.jpg|thumb]]

[edit] Coverage

OS Grid Coordinates can be explicitly referenced for UK slides using the following format:

| Coverage = {{gbmaprim|SU485982|SU 485 982}}

[edit] Rights

[edit] Categories

SoilPIC image files can belong to one or more categories. All images automatically belong to the category 'SoilPIC' (so you don't have to add that one yourself). When editing images, copy and paste the appropriate category/categories from the list below into the image's page description. Note the categories are arranged hierarchically. It is considered preferable not to combine multiple categories where one is the parent of another (you may like to view the source for this section and copy it ready to paste to edited image pages - omit the '*'s in pasting to pages, these are just to indicate the hierarchy):

*[[Category:World Soils Nature, Uses and Issues]]
**[[Category:Future Soil Protection]]
***[[Category:Biological Diversity]]
***[[Category:Food Safety and Health]]
***[[Category:Population and Food]]
***[[Category:Population and Infrastructure]]
***[[Category:Sustainable Soils]]
***[[Category:Waste Disposal]]
***[[Category:Water Resource Management]]
**[[Category:Global Soil Issues]]
***[[Category:Carbon Cycle]]
***[[Category:Climate Change]]
***[[Category:Feeding the World]]
***[[Category:Hydrological Cycle]]
***[[Category:Nitrogen Cycle]]
***[[Category:Nutrient Cycle]]
***[[Category:Oxygen Cycle]]
**[[Category:Living Soil]]
***[[Category:Macrofauna]]
***[[Category:Macroflora]]
***[[Category:Mesofauna]]
***[[Category:Microfauna]]
***[[Category:Microflora]]
**[[Category:Soil Composition]]
***[[Category:Components]]
***[[Category:Macrostructure]]
***[[Category:Microstructure]]
***[[Category:Soil Air]]
***[[Category:Soil Water]]
***[[Category:Texture]]
**[[Category:Soil Forming Influences]]
***[[Category:Climate]]
***[[Category:Human Influence]]
***[[Category:Landscapes and Relief]]
***[[Category:Parent Material]]
***[[Category:Time]]
***[[Category:Vegetation]]
**[[Category:Soil Processes]]
***[[Category:Calcification]]
***[[Category:Leaching]]
***[[Category:Lessivage]]
***[[Category:Podsolisation]]
***[[Category:Rubification]]
***[[Category:Salinisation]]
***[[Category:Shrinking and Swelling]]
***[[Category:Weathering]]
**[[Category:Soil Threats]]
***[[Category:Acid Rain]]
***[[Category:Building on Soils]]
***[[Category:Deforestation]]
***[[Category:Desertification]]
***[[Category:Loss of Biodiversity]]
***[[Category:Loss of Organic Matter]]
***[[Category:Salt Encroachment]]
***[[Category:Soil Compaction]]
***[[Category:Soil Erosion]]
***[[Category:Soil Pollution]]
**[[Category:Soil Use and Management]]
***[[Category:Agriculture]]
***[[Category:Archaeology]]
***[[Category:Buildings and Infrastructure]]
***[[Category:Flora]]
***[[Category:Forestry]]
***[[Category:Gardening and Horticulture]]
***[[Category:Hydrology]]
***[[Category:Soil Quality and Planning]]
***[[Category:Soils and Health]]

For example, to have two categories for a given page, place the category entries one after the other at the end of the page, thus:

[[Category:Agriculture]][[Category:Soil Water]]
Personal tools
SoilPIC