Content Style Guide and Workflow
Audience: iDigBio content creators, iDigBio Wiki staff content creators The following are some guidelines to help content creators make consistent document repository of iDigBio assets.
Suggested style elements
- date
- version
- audience
- tags
Tagging
Our tagging supports our website design: this helps direct content to the right sub-sites, this control is not fully developed yet. Our tagging supports how our design works: this helps assure that content is searchable according to the existing Drupal custom-made views of the content. See Drupal tags below. Within each technology, at least one of the default tags should be used in each piece of content. The number defaults tags could grow with need.
in Drupal
The following are a set of recommended content-related Drupal tags:
- Cyberinfrastructure
- Data Ingestion
- Database
- Digitization
- Documentation
- Education
- Outreach
- Policy
- Public Participation
- Workflow
- Workshop
Put them into the 'Tags' field when you 'Add Content'.
Other tags may be useful, use with parsimony, and good search engine strategy in mind, e.g, 'Workshop' and 'workshops' - only one ie required, and unless a collective noun, the singular is preferred.
Follow the Wiki style for tags by using capitalization only on the first word if the tag is multi-word, e.g, Data ingestion.
in Wiki
Wiki tags are created with a syntax like
[[Category:tag]]
and can put anywhere in the content. If practical, put them at the top of the content so that they are easily found.
When to use Wiki
Wiki content is by default always published. It is intended to be a means for collaboration, within and without of the project.
When to use Drupal
Drupal content are documents that are not likely to so collaborative in nature once they are published. They are meeting reports, policy, webforms.
For iDigBio staff and named working groups or participants, there is a feature to upload files via our content management system. The only restrictions on this space are the physical limitations of our servers and file system. The easiest way to use this service is to log into iDigBio and visit:
Authorized users see a file browser. You can see that there are directories for workshop presentations and workshop images. Navigate to "workshop-presentations" or "workshop-images' and then to your file folder of interest. Use the "Upload" tool at the top of the screen to place files. If not already there, create a folder for the workshop of interest, make the name unambiguous.
Linking to this content is easy. Highlight the file you just uploaded by clicking on it. At the bottom of the file browser window you should see "File URL path". Copy this and place "www.idigbio.org" in front of it, and you have a valid URL to this file. Once you have filled in the link to the document, given it the appropriate tags (see above), make it published. The state of 'Unpublished' does not prevent it from being found in the iDigBio Google search box. If you want it to be in the homepage carousel, be sure to give it the ';Featured' tag.