Changes between Version 1 and Version 2 of Documentation/Howto

Show
Ignore:
Timestamp:
07/22/10 22:51:40 (3 years ago)
Author:
ijacobs
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentation/Howto

    v1 v2  
    1 = User's guide for Unicorn = 
     1To jump into [http://validator.w3.org/unicorn/ Unicorn], just provide a URI and push the button. Unicorn will call a series of validation services and report the results. 
    22 
    3 == Quick Start == 
     3What else is there? 
    44 
    5 Just type (or Cut&Paste) the URL for the page you want to validate into the text field on the form and press the "Check" button. 
     5== What do you want to validate? == 
    66 
    7 If you have a local file you want to validate, choose the "File Upload" link from the navigation menu. Select the button labeled "Browse..." (or something like that, depending on your browser) and choose the file you want to upload in the usual manner for your OS. 
     7You can tell Unicorn what to validate in any of the following ways: 
    88 
    9 Alternatively, you can also copy and paste the complete content of a document in the "Direct Input" box. 
     9 * By identifying a page on the Web with a URI. 
     10 * By uploading a file (useful when your page isn't yet on the Web). Choose the "By File Upload" tab for this option. 
     11 * By pasting markup directly into a form. Choose the "By Direct Input" tab for this option. 
    1012 
    11 == Introduction == 
     13== What services do you want Unicorn to perform? == 
    1214 
    13 Unicorn is W3C's unified validator, which helps people improve the quality of their Web pages by performing a variety of @@checks@@. Unicorn gathers the results of the popular HTML and CSS validators, as well as other useful services.  
     15By default, Unicorn performs all the [http://code.w3.org/unicorn/wiki/Documentation/FAQ#checks checks] it can for the type of document you tell it to validate. This is the "General Conformance Check" option under "Select a task" 
    1416 
    15 When you send a document to Unicorn, it will fetch that URL and dispatch it to several validators, depending on the task you selected. 
     17You may also choose individual tasks in the same pulldown menu, such as (just) "CSS Profile Validation" or (just) "mobileOK checking". Individual checkers may offer "advanced options," for example whether the CSS validator should display errors and warnings, or just errors. 
    1618 
    17 == Tasks == 
    18  
    19 To check a document, it is necessary to select a task. A task is a set of validations that are going to be performed depending on the type of the submitted document and results from other validations withing this same task. 
    20 Each task may also have basic and advanced options to tune a little bit its behaviour. 
    21  
     19In the task pulldown menu, there is also a "Custom task" pulldown. When you choose this, you may choose which tests you wish to perform from the validation services known to Unicorn. Note that some validation services may not make sense for certain types of content (and those services will let you know)!