USER2:TUTOR-HYPERSCOPE.AUG.6

<BI5, USER2:HYPERSCOPE, TUTOR-HYPERSCOPE.AUG.6,>, 7-Sep-2006 22:10-PDT CE ;;;;
  INTRODUCTION
    Welcome to the HyperScope tutorial! This file is a sort of "programmed text" for new users. By following the instructions contained in it, you can quickly learn how to navigate using the unique and powerful features of this tool. In this lesson you will learn the basics of browsing HyperScope enabled files.
    Don't worry if you make a mistake -- you can't hurt anything.
  AUGMENTED BROWSING
    The HyperScope provides enhanced power and efficiency to your internet browser in a simple, easy-to-use format. The simplest form of HyperScope browsing offers these value-added features:
      * Zoom buttons for zooming in and out of structure
      * automatic numbering of each object for easy reference
      * jumping by number
      * custom view settings
      * use of the numbers and custom view settings inside URL links
    All designed to provide unified access into a "living" repository of documents, email and other dialog records, intelligence collections, briefings, source code, workflow, etc.
    Let's begin with zooming.
  ZOOMING
    Most files in a knowledge repository have a logical structure, be it a document, email, meeting records, source code, work breakdown, briefings, or time logs. For example, this tutor file is structured with the headings, paragraphs, and lists. HyperScope actually uses this structure for rapid and efficient browsing. Using the Zoom buttons provided in the left margin (these appear when you pass your cursor over the text), you can quickly zoom in and out of the structure for less or more detail on a particular topic:

      FULL VIEW: The rightmost button provides a "normal" view, or
      "full" view (the same view you have now).

      ZOOM OUT: The leftmost button zooms OUT to an outline view.

      ZOOM IN: The middle button zooms IN for a more detailed
      outline view.

      Note that all three buttons will hoist, or "Jump" the associated heading or paragraph to the top of the viewing window.
    Now try it.
      => Zooming Instructions:

        1. First, note where you are now so you can find your way back.
        2. Click on the Zoom Buttons to explore this tutorial file.
        3. Return to this ZOOMING section with a full view when finished.

    Just for practice, instead of scrolling to the next section, jump to KNOWLEDGE REPOSITORIES using its Zoom button for a full open view.
  KNOWLEDGE REPOSITORIES
    A NOTE ABOUT REPOSITORIES: A knowledge repository is typically a collection of knowledge, such as a web site, a wiki, a project group's documents and memos, or a digital library. For example, the HyperScope repository is a growing library of documents about HyperScope -- what it is and how it was implemented, plus key articles describing the significant prior work that inspired HyperScope, namely Doug Engelbart's AUGMENT System and its precursor NLS. For more details you can browse the articles at http://blueoxen.net/c/hyperscope/wiki.pl?action=browse&id=HistoricalReferences
  "LIVING" KNOWLEDGE REPOSITORIES
    The browser you are using is part of a suite of tools designed specifically to boost "Collective IQ" of teams, organizations, and communities. "Collective IQ" is a measure of how quickly and intelligently people can work collectively toward common goals. This goes well beyond getting more information faster, to include leveraging their collective memory, perception, foresight, planning, problem-solving, and so on, into applicable knowledge. This knowledge goes well beyond the published documents, to include successive drafts, commentary, dialog records, rationale, intelligence collections, and so forth.
    This tool was designed to facilitate
      * the collaborative process

      * the unified development, capture, integration, management,
      cross-referencing, and tracking of heterogeneous knowledge

      * value-added utilization of this knowledge
    So instead of an archive of publications, a "living" knowledge repository should be a dynamic work environment, and a vehicle for collaboration across time, space, and organizational boundaries.
    HyperScope was conceived as a tool to support working in the thick of living repositories. The version of HyperScope you are using now is an early prototype for enhanced browsing. Future versions are envisioned to add enhanced editing, publishing, and more.
    Again for practice, please jump to the next heading using its Zoom button for an open view.
  BASIC JUMPING AND VIEWING
    Now you will learn to:

      * jump by number
      * change your view
      * create HyperScope links that you can edit, annotate, email, etc.

    These select features add enhanced power and utility to navigating, integrating, and utilizing a dynamic knowledge environment.
    To continue, jump to CHANGING VIEWSPECS using its Zoom button for a full open view.
  CHANGING VIEWSPECS
    The Zoom Buttons changed your view with preset view settings, which we call "viewspecs". The Viewspecs button above allows you to select your own settings.
    => Viewspec Instructions

      1. Click on the Viewspecs button.
      2. Click to deselect "Blank lines" and "Numbering"
      3. Click Apply and Cancel

    Notice how your view has changed. Blank lines and numbering are gone.
    => More Viewspec Instructions

      1. Click on the Viewspecs button again.
      2. This time notice the one-letter codes next to each checkbox
      "y" and "z" for Blank Lines ON and OFF
      "m" and "n" for Numbering ON and OFF
      3. Click to select "Blank lines" and "Numbering"
      4. Click Apply and Cancel

    You can use those one-letter viewspec codes as shortcuts. Here's how:
    => Viewspec Shortcut Instructions

      1. Click on the Viewspecs button.
      2. Type the letters nz to turn Numbering and Blank Lines OFF
      3. Click Apply and Cancel

    => Now try clicking or typing in the other Viewspecs choices
    => Before you continue, please turn Numbering and Blank Lines ON with All lines and levels showing.
  JUMPING
    You have already learned to "jump" to a particular heading or paragraph using the Zoom buttons. Now you can jump directly to any heading or paragraph using its number. For example, in the following exercise you will jump to the first section in this file (Item 1), then back here (Item 8).
    => Jump by Number Instructions (review all the steps before you begin)

      1. Make a note to jump back here when finished (Item 8).
      2. Click on the Jump button above
      3. Type the number 1.
      4. Click OK.
      5. Repeat the jump, this time entering 8 instead of 1.

    Note that you can jump to any item in this file by its number. Go ahead and try jumping around some more by number, and return here (Item 8c)
    You can also click on the item you want to jump to instead of typing in its number. With the Jump and Click feature, clicking on the item will fill in its number for you.
    => Jump and Click Instructions (review all the steps before you begin)

      1. Make a note to jump back here when finished (Item 8e).
      2. Click on the Jump button
      3. Click on the item you want to jump to (notice that HyperScope then supplies the number automatically).
      4. Click OK.
      5. Repeat again, and again to get the hang of it.
      6. Jump back here when finished (Item 8e).
      7. Click Cancel to close the Jump box.

  MORE VIEWSPECS
    Now let's get into some more interesting viewspecs. For example, when you have numbering turned on, you can controlou can control whether you want numbers shown on the right or the left.
    => Number Placement

      1. Click on the Viewspecs button above.
      2. Click on the More button in the Viewspecs box.
      3. Click on the "Left" radio dial.
      4. Click Apply and Cancel.
      5. Repeat, this time placing the numbers on the Right.

    => Outline levels and lines

      1. Click on the Viewspecs button above.
      2. Select viewspec x (1st line and level).
      3. Now click b and a to add and subtract levels in the outline.
      4. Click Apply and Cancel.
      5. Repeat, this time selecting r and q to add and subtract the number of lines showing.

    Set viewspec w for all lines and levels showing before continuing.
  FILTERED VIEWS
    You can get a filtered view of the file using the Filter button. When you enter the text to be searched, and turn the filter ON, your view will contain only those items which contain that text. When you turn the filter OFF, you will get your previous view back.
    => Filtering Instructions (read all steps before you begin)

      1. Make a note to jump back here when finished (Item 10b with viewspec j).
      2. Click on the Viewspecs button.
      3. Select Apply filter.
      4. In the typein box enter the word Instructions.
      5. Select Numbering to be sure numbers are on for this.
      6. Click Apply and Cancel.
      7. When finished, click on the Viewspecs button and deselect Apply filter

    When you enter the filter text, HyperScope will find all items with an exact word match for that text. For the computer buffs out there, you also have the option of entering a "regular expression" instead of a search string, encased in slash marks -- for example: /foo/
    Note that once a certain filter is set, you can turn it On or Off by entering viewspec i or j respectively using the Viewspecs button.
  JUMPING WITH VIEWSPECS
    Now you will learn how to combine Jump and Viewspecs for "on-the-fly" view control using the viewspec codes you learned above. Using the Jump button, after you indicate which item you wish to jump to you can add a colon ":" followed by as many viewspec codes as you want. The viewspecs will take effect when you OK the Jump.
    => Instructions (review all the steps before you begin)

      1. Make a note to jump back here when finished (Item 11b).
      2. Click on the Jump button.
      3. Type the number 3 into the Jump typein field.
      4. Add a colon":" followed by the viewspecs xbz.
      5. You should now see "Click on the item or enter its address: 3:xbz
      6. Click OK.
      7. Repeat the jump to return here, this time entering 11b instead of 3, and viewspecs yw instead of zxb.

    You are now on your way to becoming a high-performance user.
  CREATING LINKS & CUSTOM "BOOKMARKS"
    HyperScope supports two different ways you can quickly create links to specific items in the document you are browsing. One is using the Bookmarks icon above, and the other is using the purple numbering. The purple numbering contains a complete link to each numbered item in the file. The Bookmarks icon keeps track of which item you last jumped to and which viewspecs and filter are currently in effect. You can access this link info and paste it into your own custom bookmarks file. Or you can paste it into a document you are authoring, a forum posting, or an email to a friend or coworker. For examples see:
      http://codinginparadise.org/hyperscope/src/demos/sample_word_file.doc (MS Word Version) http://codinginparadise.org/hyperscope/src/demos/sample_word_file.pdf (PDF Version)
    To create a link to an item in a HyperScope browser window, right click on either the Hyperscope bookmark icon, or the purple number for the item you want to link to, select Copy Link Location (or equivalent), and then switch to your editor, email draft, or forum posting and paste it in. To make a hotlink, first copy and paste the text you are referencing, and then paste in the link using the Paste Link command or icon. The difference between copying from the HyperScope bookmark icon and the purple number is, the icon provides the full link to the item you last jumped to including whatever viewspecs and filter are in effect, whereas the purple number provides just the link to the item whose purple number you right click on with no viewspecs.
    => Instructions for using Bookmark Icon

      1) Right click on the Bookmark icon next to the Viewspecs button.
      2) Select Copy Link Location (or equivalent).
      3) Open your word processor, web editor, or email with a file or draft email where you can paste some links.
      4) Paste or insert the HyperScope bookmark you copied in step 2.
      5) Jump or zoom around with different viewspecs and copy more bookmarks into your new bookmarks file or email.
      6) In your new bookmarks file, click on the links you created and see what you get

    Now try the same procedure, this time copying from some purple numbers (be sure the numbering viewspecs are turned on before you start).
    Note there is nothing magic about the link you've just copied - once you paste it you can change the item number, add or change the viewspec codes or content filter.
  PRECISION BROWSING
    You have just experienced the tip of the iceberg in the powerful combination of jumping, viewspecs, numbering, and outline structuring -- which were first conceived in the AUGMENT System and its precursor NLS, in full operational use in Doug Engelbart's pioneering computer lab at SRI by 1968! In fact, the NLS/Augment System is an even more powerful system which includes cross-window jumping and editing, integrated email, a rich command language, user programmable macros, and more. Unfortunately it is written in an archaic software language and runs on a now obsolete operating system. HyperScope was designed to migrate the powerful functionality and lessons learned into mainstream browsers, and to be extended with these additional features in mind. Together these features form a foundation for a very powerful living knowledge environment designed specifically to boost our Collective IQ. This includes not only the highly efficient navigation through the knowledge space, but the development, integration, and application of that knowledge as well.

  Congratulations! This completes your lesson on the basics of HyperScope browsing. If you are feeling adventurous and have a bit more time, you can now advance to Turbo Mode.
  ______________________________________________

  TURBO MODE
    HyperScope was designed to support a wide range of users -- from the simplest point and click browser users, all the way up to professional high performance knowledge developers and harvestors, plus everyone in between. For the power user, we offer Turbo Mode, where you can enter command key equivalents for a wide variety of Jump and Set Viewspecs commands on the fly, without stopping to click on buttons and radio dials.
    => Morphing to Turbo Mode Instructions
      1. Click on the Turbo Mode button above.
  TURBO MODE JUMP COMMANDS
    In place of your Jump and Viewspecs buttons you now see the HyperScope command center homebase. The "C:" is a prompt awaiting your command ("C" for "Command").
    Let's start with a Jump command. The first Jump command you'll learn is the Jump (to) Item command which is similar to the Jump button you are already familiar with. All you have to enter is a "j" for "Jump" and an "i" for "Item" and HyperScope will fill out the command words for you and prompt you for what to do next. A "M/A:" prompts you to mark (click) or enter the address number of the item. A "V:" prompts you to enter any viewspecs you want for this jump. If you mess up hit the Backspace key on your keyboard to back up, or just hit Escape to start the command over. Now try it:
    => "Jump (to) Item" Command

      1. Make a note to return here when finished (16C)
      2. Type "ji" -- you will see "Jump (to) Item M/A:" filled out
      3. Type a "3" and hit Enter -- you will see "3! V:" filled out
      4. Type "mxb" for numbering and outline view and hit Enter
      5. Repeat the command, and try clicking on an item instead of typing in its number, and try different viewspec codes; if you want to pass on the viewspecs simply hit Enter at the V: prompt.

    To return to the browser mode at any time, just click the Browser Mode button.
    There are many more Jump and Viewspecs commands. For now they are simply listed below for you to try. The next revision of this tutorial will include more complete explanations and rationale.
    Jump commands for navigating based on context:
      Jump (to) Content First
      Jump (to) Content Next
      Jump (to) Word First
      Jump (to) Word Next
      Jump (to) Name First [note Name as in anchor name or label]
      Jump (to) Name Next
    Jump commands for navigating the structure of a file:
      Jump (to) Origin (of file)
      Jump (to) Next (from)
      Jump (to) Back (from)
      Jump (to) Down (from)
      Jump (to) Up (from)
      Jump (to) Successor (of)
      Jump (to) Predecessor (of)
      Jump (to) Head (of plex at)
      Jump (to) Tail (of plex at)
      Jump (to) End (of) Branch (at)
      Jump (to) End (of) Plex (at)
    Jump command for jumping to another file in this directory:
      Jump (to) File (named)
    Jump command for following a link. Note: In HyperScope to follow a link you can simply click on the link as you normally would, or use the following command and then click on the link:
      Jump (to) Link
  TURBO MODE VIEWSPEC COMMANDS
    To change viewspecs use the Set Viewspecs command -- note that the Set verb requires that you type a space (hit the space bar) followed by "se" to fill out the command word Set and then "v" for Viewspecs. At the V: prompt you type in as many viewspecs codes as you want and press Enter. A complete list of viewspec codes follows. To restore your viewspecs to the initial default viewspecs use the Reset Viewspecs command -- note that the Reset verb requires a space followed by "res" to fill out the command.
      <SPACE>SEt Viewspecs
      <SPACE>RESet Viewspecs
  VIEWSPECS CHART
    Blank lines Blank lines between items on/off y/z

    Numbering Numbering on/off m/n
    Numbering right/left G/H
    Show permanent/hierarchical numbers I/J

    Level clipping Show first/+1/-1/all levels d/b/a/c
    Show levels down to level of item e
    jumped to top of window
    Line clipping Show first/+1/-1/all lines t/r/q/s
    Outline/normal Show first level and first line only x
    Show all levels and all lines w

    Structure clipping Show branch only g
    Show all branches h
    Show plex only l

    Content filtering Filtering on based on the filter set* i
    Filtering off j
    Show next filtered item k

    Indenting Level indenting on/off A/B
    Offsets indenting, with viewspec l or Q
    g, starting from level of item jumped
    to; turn off with viewspec h or A

    ______
    *Setting the Filter: use the Set Viewspecs command and at the V: enter the viewspec codes followed by semicolon {FILTER} and semicolon where {FILTER} is either a regular expression such as /foo/ or a literal search string such as "Filterthistext" -- for example: Browser Mode Viewspecs More

      Set Viewspecs V: im;"Filterthistext";
      Set Viewspecs V: im;/foo/;
  THANK YOU!
    To practice what you've learned, click on this link (or use the Jump Link command and click on the link) for Historical References http://blueoxen.net/c/hyperscope/wiki.pl?action=browse&id=HistoricalReferences to browse key articles by Doug Engelbart describing the significant prior work that inspired HyperScope, and that HyperScope will continue to aspire to.
    Thank you for trying HyperScope! We hope you enjoyed your journey.