QESTonline - User contributions [en]

Help:Contents

2007-11-19T21:40:53Z

Michael.howland:

For help about Wiki's in general, try [http://en.wikipedia.org/wiki/Help:Contents Wikipedia Help] (Wikipedia).

For tips on searching try [[QESTonline:Searching]]

If you are looking for help with one of our products, try the [[QESTLab:User Guide|QESTLab User Guide]] or the [[QESTMix:User Guide|QESTMix User Guide]].

If you are looking for help on wiki editing syntax, try [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page How to edit a page] (Wikipedia).

QESTonline:Browser Compatibility

2007-11-19T21:39:43Z

Michael.howland: Fixed QESTonline and recommended

QESTonline uses a type of collaborative, user-driven database called a ''[http://en.wikipedia.org/wiki/Wiki Wiki]''. The Wiki project is maintained by the project contributors and administrators at ''[http://www.mediawiki.org MediaWiki]''. The most well-known Wiki is the collaborative online encyclopaedia, ''[http://en.wikipedia.org/ Wikipedia]''.

The Wiki uses several features of many of the popular languages that are used on the Web; including [http://en.wikipedia.org/wiki/XHTML XHTML], [http://en.wikipedia.org/wiki/CSS CSS], and [http://en.wikipedia.org/wiki/PHP PHP]. These languages are extremely widely used and are supported by all major graphical web browsers. However, because their specifications are '''recommended guidelines only''', they are not enforced. Additionally, those who write the specifications are not the same people who design and create the web browsers that implement them. Because of this, different web browsers will render a given page slightly differently.

QESTonline is best viewed with the free ''[http://www.getfirefox.com/ Mozilla Firefox]'' web browser1. Viewing QESTonline the way it was intended to be displayed is best done using Mozilla Firefox. Microsoft's Internet Explorer (which is vulnerable to many [http://en.wikipedia.org/wiki/Criticism_of_Internet_Explorer security exploits]), as well as Apple's Safari, render QESTonline and many other web sites incorrectly. The ''[http://www.opera.com/ Opera]''1 browser is another excellent free web browser which renders QESTonline correctly.

==Notes==
1This site and software is not affiliated with Spectra QEST. We have no control over the content of its pages nor the function of the software. Usage is at the users' own risk.

[[Category:QESTonline|{{PAGENAME}}]]

QESTonline:Guide to the User Guide

2007-10-03T16:48:09Z

Michael.howland:

== Purpose ==

This document outlines the procedures to be followed when adding pages to the QESTLab/QESTMix user guide or when creating any other user guide.

== Scope ==

This document applies to all Spectra QEST personnel past, present, and future. Failure to adhere to the rules outlined in this document will cause the wrath of Michael Howland to be released on the offender. Michael is not a nice man.

Failure to read this document does not excuse you from Michael's wrath. You have been warned.

== Prerequisites ==

* Ability to read and write English
* Knowledge of wiki syntax
* Read the editors guideline at [[QESTonline:Guidelines]]

== Introduction ==

Writing/Editing pages for a user guide is slightly more difficult than writing stand-alone pages due to the extra editing that must be performed. To add a new page, edits will need to be made to:
*The online contents page e.g. [[QESTLab:User_Guide]]
*The pages preceeding and following the new page in order to adjust the links in the headers and footers
*The printable version of the user guide e.g. [http://online.spectraqest.com/index.php?title=QESTLab:User_guide_module_1_-_system_administration&printable=yes Printable version of QESTLab user guide]

This document will look to introduce the basic concepts by of adding a new page to the QESTLab user guide.

==Procedure==

To add a newly created page to the QESTLab user guide:
# Add a header and a footer to the new page. Link these to the pages preceding and following the new page.
# Update the header and footer of the page preceeding the new page in the user guide.
# Update the header and footer of the page following the new page in the user guide.
#Add the new page to the user guide contents page.
#Add the new page to the printable version of the user guide. The printable version is a separate page that imports other pages. Access it via the links in the user guide. To edit the page, remove the '&printable=yes' from the url and load the page.
#Check that no header and footer information appears in the printable version. If it does, add <nowiki> <noinclude> </noinclude> </nowiki> tags around the header and footer.
#Check that the heading levels are correct in the printable version.

QESTonline:Guide to the User Guide

2007-10-03T16:03:15Z

Michael.howland: QESTLab:Guide to the User Guide moved to QESTonline:Guide to the User Guide

== Purpose ==

This document outlines the procedures to be followed when adding pages to the QESTLab/QESTMix user guide or when creating any other user guide.

== Scope ==

This document applies to all Spectra QEST personnel past, present, and future. Failure to adhere to the rules outlined in this document will cause the wrath of Michael Howland to be released on the offender. Michael is not a nice man.

Failure to read this document does not excuse you from Michael's wrath. You have been warned.

== Prerequisites ==

* Ability to read and write English
* Knowledge of wiki syntax
* Read the editors guideline at [[QESTonline:Guidelines]]

== Introduction ==

Writing/Editing pages for a user guide is slightly more difficult than writing stand-alone pages due to the extra editing that must be performed. To add a new page, edits will need to be made to:
*The online contents page e.g. [[QESTLab:User_Guide]]
*The pages preceeding and following the new page in order to adjust the links in the headers and footers
*The printable version of the user guide e.g. [http://online.spectraqest.com/index.php?title=QESTLab:User_guide_module_1_-_system_administration&printable=yes Printable version of QESTLab user guide]

This document will look to introduce the basic concepts by of adding a new page to the QESTLab user guide.

==Procedure==

To add a newly created page to the QESTLab user guide:
# Add a header and a footer to the new page. Link these to the pages preceding and following the new page.
# Update the header and footer of the page preceeding the new page in the user guide.
# Update the header and footer of the page following the new page in the user guide.
#Add the new page to the user guide contents page.
#Add the new page to the printable version of the user guide. The printable version is a separate page that imports other pages. Access it via the links in the user guide.
#Check that no header and footer information appears in the printable version. If it does, add <nowiki> <noinclude> </noinclude> </nowiki> tags around the header and footer.
#Check that the heading levels are correct in the printable version.

QESTonline:Guide to the User Guide

2007-10-02T22:09:23Z

Michael.howland:

== Purpose ==

This document outlines the procedures to be followed when adding pages to the QESTLab/QESTMix user guide or when creating any other user guide.

== Scope ==

This document applies to all Spectra QEST personnel past, present, and future. Failure to adhere to the rules outlined in this document will cause the wrath of Michael Howland to be released on the offender. Michael is not a nice man.

Failure to read this document does not excuse you from Michael's wrath. You have been warned.

== Prerequisites ==

* Ability to read and write English
* Knowledge of wiki syntax
* Read the editors guideline at [[QESTonline:Guidelines]]

== Introduction ==

Writing/Editing pages for a user guide is slightly more difficult than writing stand-alone pages due to the extra editing that must be performed. To add a new page, edits will need to be made to:
*The online contents page e.g. [[QESTLab:User_Guide]]
*The pages preceeding and following the new page in order to adjust the links in the headers and footers
*The printable version of the user guide e.g. [http://online.spectraqest.com/index.php?title=QESTLab:User_guide_module_1_-_system_administration&printable=yes Printable version of QESTLab user guide]

This document will look to introduce the basic concepts by of adding a new page to the QESTLab user guide.

==Procedure==

To add a newly created page to the QESTLab user guide:
# Add a header and a footer to the new page. Link these to the pages preceding and following the new page.
# Update the header and footer of the page preceeding the new page in the user guide.
# Update the header and footer of the page following the new page in the user guide.
#Add the new page to the user guide contents page.
#Add the new page to the printable version of the user guide. The printable version is a separate page that imports other pages. Access it via the links in the user guide.
#Check that no header and footer information appears in the printable version. If it does, add <nowiki> <noinclude> </noinclude> </nowiki> tags around the header and footer.
#Check that the heading levels are correct in the printable version.

QESTonline:Guidelines

2007-10-02T21:56:04Z

Michael.howland:

==General==
# After creating/editing a page, proof-read and spellcheck the page. This is '''not''' optional.
# If the page is for external viewing, it is advisable to have another Spectra QEST employee give the page a thorough review.
# If the page is for external viewing (especially any work to the user guide), please remember that most customers are not computer proficient. Pictures are highly encouraged; missing instructions (no matter how obvious the instruction appears to you) is not.

==Page Header and Footer==
Where the page is a part of a guide, or a set of pages, "Navigation" links should be provided at the top and bottom of the page. These should be labelled "Prev" and "Next". There should also be a link back to the main page that it is accessed from (usually the user guide main page - add an anchor where possible using a #). These links should be separated by a pair of pipes '||'

<pre>[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]
----</pre>

In the footer, you should also specify the categories that the page is in, using the following syntax.
<pre>----
[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]

[[Category:Help|{{PAGENAME}}]]</pre>

If a printable version of the page is to be created, use the format described below ([[QESTonline:Guidelines#<nowiki><noinclude> </noinclude></nowiki>]])

==Tables==
Tables should be of the '''spectratable''' class. The class can be specified at the top of the table
<pre>{| class="spectratable" |
! Header Row, Column 1
! Header Row, Column 2
|-
| Content Row 1, Column 1
| Content Row 1, Column 2
|-
| Content Row 2, Column 1
| Content Row 2, Column 2
|}</pre>

More information on the syntax for tables (in case you want to merge cells or do something else a little bit fancy) can be found at [http://en.wikipedia.org/wiki/Help:Table|Help:Table] (Wikipedia).

==Naming Conventions==
* Pages should generally be named using '''Sentence case'''.
* The guidelines laid out in [http://en.wikipedia.org/wiki/Wikipedia:Naming_conventions Naming conventions] (Wikipedia) are a good place to look if you are unsure.

Examples of names:
<pre>Users
Adding users
Removing users
Adding and removing users
Editing users</pre>

When adding a page, avoid replication. If you later find that there are two pages that are about the same thing, see if it makes sense to turn one of them into a ''redirect page''. Syntax for a redirect page is:
<pre>#redirect [[Redirect Target]]</pre>
You don't need any extra information on the redirect page. You can also use the ''What links here'' tool to find which pages link to the redirect page, and change them to link to the correct page instead.

It can be useful to add redirect pages for singular/plural variations of the same thing. e.g. it could be useful to redirect ''User'' to ''Users'' (or vice-versa).

==Tags==
Use '''bold''' and ''italics'' to highlight important words, however, use them sparingly. They tend to make the text harder to read if used excessively.
<pre>'''bold'''
''italics''</pre>

==Images==
Images should use the '''frame''' option. Smaller images can be placed to the side of text, however, large images should have the '''center''' tag to prevent text being placed in a very small column to the side of the image.

Image Names should be prefixed by the page on which the image appears.
<pre>[[Image:Guidelines Example.png|frame|center]]
[[Image:Guidelines Example.png|frame]]</pre>

==Namespaces==
* Appear in the article title before the colon e.g., the page QESTLab:User_Guide is in the QESTlab namespace.
* Are invisible to the user (except for in the title)
* ALL articles appear in ONE namespace.
* Used to provide access control to articles (QESTLab, QESTMix and Support are the only namespaces available to external users).
* Must see me if you need a new namespace to be created. Simply inventing a new one will not create a new namespace. The article will appear in the main namespace e.g., creating an article 'Crows:Are_Stupid' will create an article in the main namespace.
* The important namespaces are:
**(Main)
**Administration
**Implementation
**Implementation Internal
**QESTLab
**QESTLab Internal
**QESTMix
**QESTMix Internal
**Support
**Support Internal
**Systems Admin
**Development

==Categories==
* Used to separate articles into logical groups.
* Are visible to the user - click on the categories link in the navigation box to be taken to a list of categories.
* An article may appear none, one or many categories(It should appear in at least one)
* Add an article to a category by adding <nowiki>[[Category:Category_name]]</nowiki> to the end of the article e.g., <nowiki>[[Category:QESTLab]]</nowiki> will add the article to the QESTLab category.
* Categories can have sub-categories.
* A new category can be created by using the <nowiki>[[Category:Category_name]]</nowiki> tag. Please check that a suitable category does not already exist before creating a new category.

Please note: When a new category is created, a new link will appear allowing users to browse that category. This page will not contain any information and so will open in 'edit' mode when the link is clicked. External users do not have edit rights and will therefore not be allowed to view this page. To avoid this, when creating a new category:
Go to the category page and save the page with some text (saving an unchanged page will not work)
Edit the page again but remove the newly added text. Save the page.
Check that the category page now opens in 'article' mode i.e., not edit mode.

==Importing Pages==
The tags <nowiki> [[Link title]] </nowiki> are used to link to pages within the wiki. Alternatively, users may use the syntax <nowiki> {{Link title}} </nowiki> to import pages onto the document. An example of this tags use is the printable user guides - these pages simply import information from other pages.

The following line imports the page 'QESTLab:Aggregate/soil & asphalt testing - finding samples' and sets it at a heading of 4 (see below for information on using the tier variable).

<pre>
{{QESTLab:Aggregate/soil & asphalt testing - finding samples|tier===}}
</pre>

In order to make the resulting importee page legible, users must make use of the following wiki tags.

===<nowiki> <noinclude> </noinclude> </nowiki>===
Text between the <nowiki> <noinclude> </noinclude> </nowiki> tags will be shown only when a page is '''not''' imported. This tag should be used around the page header and footer for pages in the user guide. Failure to include these tags will mean that the footer information is printed when the page is imported.

<pre>
<noinclude>
[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]
----</pre>
</noinclude>

<pre>
<noinclude>
----
[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]
</noinclude>
[[Category:Help|{{PAGENAME}}]]</pre>

===<nowiki><includeonly> </includeonly></nowiki>===
Text between the <nowiki><includeonly> </includeonly></nowiki> tags will be shown only when a page is imported. The following example sets the heading level on the imported page to tier + 1 on the imported page.
<pre>
<includeonly>{{{tier}}}</includeonly><noinclude>=</noinclude>=Registering a sample=<noinclude>=</noinclude><includeonly>{{{tier}}}</includeonly>
</pre>

==Other stuff==
* When referring to a specific object, add a link. e.g. [[QESTMix:System Administrator|system administrator]] - even if that page just has a couple of lines, and directs the user to a different page in the wiki.
*Avoid repeating information - it becomes impossible to maintain the wiki when information is spread across multiple pages. Use a link to the article or import it into the page.
* Include the name of the website in brackets after external links. E.g. See the [http://meta.wikimedia.org/wiki/Help:Help help page] (WikiMedia) for editing information.

[[Category:QESTonline|{{PAGENAME}}]]
[[Category:Guidelines|{{PAGENAME}}]]

QESTonline:Guide to the User Guide

2007-10-02T20:26:57Z

Michael.howland:

== Purpose ==

This document outlines the procedures to be followed when adding pages to the QESTLab/QESTMix user guide or when creating any other user guide.

== Scope ==

This document applies to all Spectra QEST personnel past, present, and future. Failure to adhere to the rules outlined in this document will cause the wrath of Michael Howland to be released on the offender. Michael is not a nice man.

Failure to read this document does not excuse you from Michael's wrath. You have been warned.

== Prerequisites ==

* Ability to read and write English
* Knowledge of wiki syntax
* Read the editors guideline at [[QESTonline:Guidelines]]

== Introduction ==

Writing/Editing pages for a user guide is slightly more difficult than writing stand-alone pages due to the extra editing that must be performed. To add a new page, edits will need to be made to:
*The online contents page e.g. [[QESTLab:User_Guide]]
*The pages preceeding and following the new page in order to adjust the links in the headers and footers
*The printable version of the user guide e.g. [http://online.spectraqest.com/index.php?title=QESTLab:User_guide_module_1_-_system_administration&printable=yes]

This document will look to introduce the basic concepts by of adding a new page to the QESTLab user guide.

==Procedure==

To add a newly created page to the QESTLab user guide:
# Add a header and a footer to the new page. Link these to the pages preceding and following the new page.
# Update the header and footer of the page preceeding the new page in the user guide.
# Update the header and footer of the page following the new page in the user guide.
#Add the new page to the user guide contents page.
#Add the new page to the printable version of the user guide.
#Check that no header and footer information appears in the printable version. If it does, add <nowiki> <noinclude> </noinclude> </nowiki> tags around the header and footer.
#Check that the heading levels are correct in the printable version.

QESTonline:Guide to the User Guide

2007-10-02T19:42:29Z

Michael.howland:

QESTonline:Guidelines

2007-10-02T19:20:11Z

Michael.howland:

==Page Header and Footer==
Where the page is a part of a guide, or a set of pages, "Navigation" links should be provided at the top and bottom of the page. These should be labelled "Prev" and "Next". There should also be a link back to the main page that it is accessed from (usually the user guide main page - add an anchor where possible using a #). These links should be separated by a pair of pipes '||'

<pre>[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]
----</pre>

In the footer, you should also specify the categories that the page is in, using the following syntax.
<pre>----
[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]

[[Category:Help|{{PAGENAME}}]]</pre>

==Tables==
Tables should be of the '''spectratable''' class. The class can be specified at the top of the table
<pre>{| class="spectratable" |
! Header Row, Column 1
! Header Row, Column 2
|-
| Content Row 1, Column 1
| Content Row 1, Column 2
|-
| Content Row 2, Column 1
| Content Row 2, Column 2
|}</pre>

More information on the syntax for tables (in case you want to merge cells or do something else a little bit fancy) can be found at [http://en.wikipedia.org/wiki/Help:Table|Help:Table] (Wikipedia).

==Naming Conventions==
* Pages should generally be named using '''Sentence case'''.
* The guidelines laid out in [http://en.wikipedia.org/wiki/Wikipedia:Naming_conventions Naming conventions] (Wikipedia) are a good place to look if you are unsure.

Examples of names:
<pre>Users
Adding users
Removing users
Adding and removing users
Editing users</pre>

When adding a page, avoid replication. If you later find that there are two pages that are about the same thing, see if it makes sense to turn one of them into a ''redirect page''. Syntax for a redirect page is:
<pre>#redirect [[Redirect Target]]</pre>
You don't need any extra information on the redirect page. You can also use the ''What links here'' tool to find which pages link to the redirect page, and change them to link to the correct page instead.

It can be useful to add redirect pages for singular/plural variations of the same thing. e.g. it could be useful to redirect ''User'' to ''Users'' (or vice-versa).

==Tags==
Use '''bold''' and ''italics'' to highlight important words, however, use them sparingly. They tend to make the text harder to read if used excessively.
<pre>'''bold'''
''italics''</pre>

==Images==
Images should use the '''frame''' option. Smaller images can be placed to the side of text, however, large images should have the '''center''' tag to prevent text being placed in a very small column to the side of the image.

Image Names should be prefixed by the page on which the image appears.
<pre>[[Image:Guidelines Example.png|frame|center]]
[[Image:Guidelines Example.png|frame]]</pre>

==Namespaces==
* Appear in the article title before the colon e.g., the page QESTLab:User_Guide is in the QESTlab namespace.
* Are invisible to the user (except for in the title)
* ALL articles appear in ONE namespace.
* Used to provide access control to articles (QESTLab, QESTMix and Support are the only namespaces available to external users).
* Must see me if you need a new namespace to be created. Simply inventing a new one will not create a new namespace. The article will appear in the main namespace e.g., creating an article 'Crows:Are_Stupid' will create an article in the main namespace.
* The important namespaces are:
**(Main)
**Administration
**Implementation
**Implementation Internal
**QESTLab
**QESTLab Internal
**QESTMix
**QESTMix Internal
**Support
**Support Internal
**Systems Admin
**Development

==Categories==
* Used to separate articles into logical groups.
* Are visible to the user - click on the categories link in the navigation box to be taken to a list of categories.
* An article may appear none, one or many categories(It should appear in at least one)
* Add an article to a category by adding <nowiki>[[Category:Category_name]]</nowiki> to the end of the article e.g., <nowiki>[[Category:QESTLab]]</nowiki> will add the article to the QESTLab category.
* Categories can have sub-categories.
* A new category can be created by using the <nowiki>[[Category:Category_name]]</nowiki> tag. Please check that a suitable category does not already exist before creating a new category.

Please note: When a new category is created, a new link will appear allowing users to browse that category. This page will not contain any information and so will open in 'edit' mode when the link is clicked. External users do not have edit rights and will therefore not be allowed to view this page. To avoid this, when creating a new category:
Go to the category page and save the page with some text (saving an unchanged page will not work)
Edit the page again but remove the newly added text. Save the page.
Check that the category page now opens in 'article' mode i.e., not edit mode.

==Importing Pages==
The tags <nowiki> [[Link title]] </nowiki> are used to link to pages within the wiki. Alternatively, users may use the syntax <nowiki> {{Link title}} </nowiki> to import pages onto the document. An example of this tags use is the printable user guides - these pages simply import information from other pages.

The following line imports the page 'QESTLab:Aggregate/soil & asphalt testing - finding samples' and sets it at a heading of 4 (see below for information on using the tier variable).

<pre>
{{QESTLab:Aggregate/soil & asphalt testing - finding samples|tier===}}
</pre>

In order to make the resulting importee page legible, users must make use of the following wiki tags.

===<nowiki> <noinclude> </noinclude> </nowiki>===
Text between the <nowiki> <noinclude> </noinclude> </nowiki> tags will be shown only when a page is '''not''' imported. This tag should be used around the page header and footer for pages in the user guide. Failure to include these tags will mean that the footer information is printed when the page is imported.

<pre>
<noinclude>
[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]
----</pre>
</noinclude>

<pre>
<noinclude>
----
[[QestOnline:Guidelines Prev|Prev]] ||
[[QestOnline:Guidelines Next|Next]] ||
[[Main Page#Editing|Main Page]]
</noinclude>
[[Category:Help|{{PAGENAME}}]]</pre>

===<nowiki><includeonly> </includeonly></nowiki>===
Text between the <nowiki><includeonly> </includeonly></nowiki> tags will be shown only when a page is imported. The following example sets the heading level on the imported page to tier + 1 on the imported page.
<pre>
<includeonly>{{{tier}}}</includeonly><noinclude>=</noinclude>=Registering a sample=<noinclude>=</noinclude><includeonly>{{{tier}}}</includeonly>
</pre>

==Other stuff==
* When referring to a specific object, add a link. e.g. [[QESTMix:System Administrator|system administrator]] - even if that page just has a couple of lines, and directs the user to a different page in the wiki.
*Avoid repeating information - it becomes impossible to maintain the wiki when information is spread across multiple pages. Use a link to the article or import it into the page.
* Include the name of the website in brackets after external links. E.g. See the [http://meta.wikimedia.org/wiki/Help:Help help page] (WikiMedia) for editing information.

[[Category:QESTonline|{{PAGENAME}}]]
[[Category:Guidelines|{{PAGENAME}}]]