logoHN

HyperNote Read Me


homeemail

  • HyperNote v. 5.6 released March 1999.
    HyperNote is a biographical-bibliographical notetaking environment designed for academic research.

    Online overview of HyperNote: http://www.earthvisions.net/stacks.html

    Key words: Index cards, bibliography, prosopography, dissertation, academic writing, notecards, note-processor, HyperCard.

    HyperNote is Open-Script FREEWARE; send us your improvements: please help us make it better!
    Copyright by Kerry V. Magruder and Aaron K. Poffenberger
    ©1991-99; ALL RIGHTS RESERVED
    DO NOT BUNDLE WITHOUT PERMISSION

    Shareware versions of HyperNote were released as follows:
    Version 1.1 to 1.9 in 1991; v. 2.4 May 1992; v. 3.4 Fall 1993; v. 4.1 May 1994, etc.

  • Kerry Magruder
    706 S. Halliburton
    Kirksville, MO 63501
    Internet: KVMagruder@earthvisions.net

  • Aaron Poffenberger
    akp@hypernote.com

  • HyperNote is available on the Internet via our
    World Wide Web home page:
    http://www.earthvisions.net/stacks.html
    http://www.hypernote.com/hypernote (temporarily disabled)

    rule

    CONTENTS OF THIS READ-ME FILE:

    Greetings!
    I. Quick Start for HyperNote
    II. What's in the HyperNote folder?
    III. Concept of HyperNote & HyperNote Features
    IV. Registration Form

    Print this READ ME file for reference with the Print command in the File menu.

    rule

    Greetings!


    HyperNote is a note-processor; a notetaking environment based on HyperCard.

    Much has been written about "paperless" offices; with HyperNote you can have a "paperless research trail" in the library or study. If you use paper notecards for any purpose, then HyperNote might be for you!

    HyperNote helps writers and researchers accomplish *ordinary* notetaking tasks with the extraordinary power of a Macintosh computer. HyperNote is not meant for computer experts who want their computers to do something extraordinary that was never done before (even if no one ever wanted to do it). HyperNote will not let you time-travel (except through your imagination, by means of history notetaking). Nor will it transform your Mac into a Holodeck (or you into Data). We developed HyperNote because we found the available word-processing and bibliography programs unsuited for handling the most *everyday* research needs of serious writers.

    The many powerful features of HyperNote make it ideal for organizing extensive or long-term projects such as books or dissertations. And if you are familiar with basic Macintosh conventions (such as moving the mouse and entering text into fields), you can begin notetaking in HyperNote immediately. Get started by experimenting around, with the assistance of Balloon Help and practical "hands-on" orientation stacks, and learn about its more powerful features as you need them.

    The three of us who have developed HyperNote are (or were) graduate students in the University of Oklahoma History of Science Department who can't live without it! Mike Keas graduated in 1993 after completing his dissertation with HyperNote. Aaron Poffenberger has been helping me since v. 3.1, when he began graduate studies in the department. Aaron completed his Masters Thesis in late medieval intellectual history using HyperNote. And I, Kerry Magruder, a former public school teacher, am now working hard to complete my dissertation (you can see a website created with HyperNote as part of my dissertation research at http://www.earthvisions.net).

    Share the latest version of HyperNote with anyone; it is freeware so long as you can use it without bothering us! If you want phone or Email support please send us $20. If you send in moolah so we can buy one more book (have you checked the prices of academic books recently?), then we'll toast your health (and writing success!) over morning coffee and muffins.

    We work on HyperNote continuously and incrementally. There is no final, ideal, archetypal version of HyperNote. If you have a suggestion for a helpful feature or custom notecard, write us and we'll try to incorporate it. Or better yet, learn HyperCard scripting, explore HyperNote's scripts for yourself, and send us the improvements so that we can incorporate them in our next release.

    Every feature of HyperNote has worked for us at some time. However, it's a complex organism, its features are interrelated, and sometimes when we tweak one part of it to accommodate some new idea, some remote link is lost and a lesser-used function becomes buggy as a consequence (with no danger to your files, however). If you encounter any bugs, let us know (with as specific a description as possible so that we can replicate the problem). We'll promptly fix it and return a sound copy to you. Nevertheless, stability usually triumphs, and we never send out a version until it's been used for a while without major perturbations. Bon chance!

    PEACE!
    Kerry Magruder



    rule

    I. Quick Start for HyperNote


    1. Make sure you have HyperCard 2.4 and HyperCard Home on your hard drive.

    HyperNote requires:

  • HyperCard 2.4 (with a HyperCard Home stack).
  • A Power Macintosh (an iMac or G3 or faster is *strongly* recommended).
  • At least 20 MB of hard disk space (not counting the new HyperNote stacks you will create, the HyperNote folder will take about 8 MB; in addition, HyperCard requires a fair amount of free disk space to operate).
  • Enough RAM to set HyperCard to 20 MB RAM (recommended), or at least 10 MB (minimum).
  • A monitor or screen size of at least 800 x 600 pixels. (HyperNote cards are 768 x 514 pixels, which are too large for most pre-G3 PowerBooks.)

    Note: HyperCard Player will not run HyperNote, and may even crash while trying to view HyperNote. If you like what you see in HyperNote, then invest in HyperCard 2.4!

    2. Unstuff the HyperNote stuffit file you downloaded from the web.
    Haven't got it yet? Download HyperNote (2.5MB) from http://www.earthvisions.net/stacks.html

    3. Copy the HyperNote folder to your hard drive; place it anywhere you wish.

    4. Open the HyperNote folder and make sure it includes the following:
    HyperNote Intro
    HyperNote Home
    HyperNote Resources folder
    HyperNote Tutor folder
    Practice Stacks folder (includes 3 Project stacks)
    Website folder

    The first time you go to a HyperCard stack you will be asked in a dialog box to locate it. The first time you open HyperNote you will have to show HyperCard where all the stacks are within the various HyperNote folders. After the first time, HyperCard will remember their location and find them automatically.

    5. If you have never used HyperCard before, glance at the HyperCard Tour stack (supplied by Apple with HyperCard).

    6. Open the HyperNote Intro stack and explore the general concept and layout of HyperNote. (The other Tutor stacks serve as a reference manual to use as needed. Ignore them for now.)

    7. Open the "Project B" sample practice stack. You will find yourself on the first card, an Index to a standard notetaking stack. Click on the button labeled "Comments" (or simply press Tab).

    8. Follow the "Getting Started" instructions in the Comments field of the Index of "Project B." This orientation session will take about two evenings. Use Balloon Help anytime to survey card layouts. Experiment with the step-by-step instructions provided!

    9. On a third and forth evenings, explore the advanced features of HyperNote with the "Project C" and "Project B2" practice stacks. These introduce the standard biographical and bibliographical notecard formats.

    10. Remember to turn on Balloon Help whenever you want simple explanations of basic features or buttons.

    11. The Project stacks are fully functional. Whenever you want others for your own notetaking projects, make them with the New Stack... command on the File Menu.

    (If you are updating from a previous version, see the instructions on the first card of the HyperNote Intro.)



    rule

    II. What's in the HyperNote folder?


    Here's what you should find included with HyperNote:

    1. HyperNote Read Me file.
    2. HyperNote Intro stack.
    3. HyperNote Tutor folder
    4. Project stacks folder.
    5. HyperNote Resource folder.
    6. HyperNote Extras folder (ignore for now).
    7. Website folder (for exporting HyperNote stacks as a web site).

    1. You are reading the HyperNote READ ME file now.

    2. HyperNote Intro stack.
    Look at the HyperNote Intro stack first. It explains the concept and overall structure of HyperNote. (It is NOT a functional HyperNote notetaking stack.)

    3. HyperNote Tutor folder.
    The Tutor stacks compose a detailed reference manual that should explain every remote and obscure feature of the latest HyperNote stacks. This is too much to absorb all at once, but you'll want to keep them handy.
    --Click the Help button n on any HyperNote card to go directly to the place in the Tutor where the features of that card are explained. --Browse the Tutor stacks often, using the Contents card of each as a jumping-off point.
    --Using the Contents card of the Tutor, or the Help buttons on any HyperNote card, is easier than browsing a written manual, but you can print the Tutor anyway if you prefer (there's a button on the first card to print it with).

    4. Project stacks (for latest version).
    For your convenience, sample HyperNote ote stacks are already set up and ready for you to begin exploring the features of HyperNote. After viewing the HyperNote Intro, open the "Project B" practice stack and take HyperNote on a test drive!

    The three project stacks serve as a "Getting Started" session, an introductory "hands on" orientation to HyperNote (which will take about three or four evenings). Major features are introduced with brief explanations on successive cards, with step-by-step instructions for trying them out in the Project stacks themselves. Open Project B, and press Tab or click the "Comments" button on the Index (the first card you will see) to get started!

    (These Project stacks accompany the latest version of HyperNote, and will not work correctly with earlier versions.)


    5. HyperNote resources, v. 5.x.
    --This folder contains the resource stacks that are essential for running HyperNote, along with HyperNote Home and HyperNote Exemplars.
    --HyperNote Home is the command center of HyperNote, and contains all of the control cards and XCMD's essential for HyperNote functions to work properly.
    --HyperNote Exemplars contains card templates that are used by HyperNote to construct new notetaking stacks. Normally you will not need to go to the Exemplars stack, and it is not used for notetaking, but it must be present on your hard disk for many HyperNote functions to work properly.
    --HyperNote Resources and HyperNote HTML are other resource stacks that must be kept in the HyperNote Resources folder. They contain the scripts for HyperNote functions, so that stacks do not have to replicate the scripts (which would make them larger). Do not take notes in them; until you want to tinker with HyperNote's scripts and customize them yourself, you have no need to open these stacks at all.


    TO START HYPERNOTE:

  • You need your own HyperCard and (HyperCard) Home.
    --You might want to put a button on your Home stack to go to HyperNote Home (there is a button to do that in the HyperNote Tutor stack--just click it and it will paste a copy into your own Home if you wish; see the HyperNote Home section of the Tutor).
  • To start HyperNote, all you need to do is open HyperNote Home or any HyperNote stack.

    Choose "New Stack..." from the File Menu, and you'll be off to the races. Type in a "cluster" name such as "19th Century" or "Ethics" or whatever, and it will make a set of four related stacks. See the Tutor or Project B stack for information on clusters, types of stacks, etc.


    rule

    III. Concept of HyperNote


    What is the difference between HyperNote and your Word Processor?

    Word processors greatly aid us in all kinds of writing projects, giving us the the ability to rearrange paragraphs or sentences, alter formatting according to standardized templates, manage footnotes, etc., all with a few key strokes. Despite the indispensable power and convenience such word-processing functions provide, however, there remain many initial writing tasks that word processors simply can't help us with. We turn to a word processor at a relatively late stage of research, after we have gathered our thoughts and imposed some kind of semi-coherent outline upon our notes.

    So how did we juggle our ideas into order in the first place? To take advantage of the Macintosh in the earlier juggling stage, before we have imposed a linear order upon our thoughts and research information, we need something more like a note processor. HyperNote uses HyperCard's built-in functions to create a powerful and flexible note-processor, to assist the researcher in the earliest stages of a writing project, forming a smooth interface with the eventual word-processing stage.

    HyperNote includes sophisticated bibliographical, biographical, and general notetaking formats. Combined with special index features and custom menu commands, HyperNotes are paper notecards "cubed." If you use paper notecards for any purpose, HyperNote may be what you're looking for to become more productive on your Macintosh.

    Throw away your bundles of index cards: no more reshuffling, retyping, searching for that lost tidbit of information or bibliographic source.... Use the Macintosh and HyperCard 2.1 for serious general notetaking, and take advantage of powerful organizational features (such as sorting, finding, linking, etc.) at the earliest stages of writing. Collect and organize your thoughts in "byte" size pieces, before it's necessary to arrange them in a linear manner, and bring your work to the Mac sooner rather than later (even for large research projects such as dissertations), in a way that complements and merges seamlessly with your word processor.

    We developed HyperNote in the course of our own academic research as graduate students in the history of science. To us it meets a need for organizing ideas and notes in the initial stages of writing that other programs have not addressed. Database applications, word processors, outlining programs and specialized HyperCard stacks all exist that provide excellent bibliographic and writing aids. HyperNote differs from these in the way its components interact together to form a complete note-processing environment, integrating notetaking, browsing, writing, and record-keeping functions.

    rule

    HyperNote Features


    Is HyperNote a word processor?

  • NO! But you can edit your notes in HyperCard without losing word-processing features such as:
    --Powerful find or replace searches
    --Word counting
    --Paragraph numbering, sorting, bulleting
    --Changing from double to single or triple spacing within a field
    --Using curly quotes
    --Changing styles of selected text, including capitalization, rich-text-format exportable italics, bold, superscript, subscript, font designation, etc.

  • Export your HyperNotes to any Macintosh word processor after note processing, without retyping, for the final stages of document polishing.
    --Text is exported into a text file which can be opened by any word processor.
    --Rich-Text-Format support is given for italics, superscripts, subscripts, specified fonts, etc., and is automatically applied to bibliographic exports. Many other flexible formatting options are available when exporting.
    --Macros are supplied for formatting block quotations and footnote text with Microsoft Word (requires QuicKeys) or Nisus.
    --Export in HTML Format to create a web page from a stack, or a website from a cluster of related stacks, with many automatically-generated hyperlinks and other features (see the Tutor stacks for details). Use HTML exporting to create academic websites featuring online bibliographies, biographies, and course notes.

  • How does HyperNote manage Footnotes and Bibliographies?
    --Actual notetaking is done in Bios format stacks, while bibliographic information is stored in Bibliofile stacks.
    --To export a properly formatted bibliography, one marks all desired cards in the appropriate Bibliofile stack, and then exports with the Export Stack Menu command. When the exported text file is opened by a word processor, and converted from rich-text-format (word processors perform this conversion easily or even automatically), the bibliography will be ready-made, completely formatted (with italics applied as needed).
    --Footnote text becomes integrated with notetaking stacks during actual notetaking. There is no need to scan the exported text file back through a bibliography program after writing is completed to add the source references. Rather, source references are added during the notetaking process (while everything is still fresh in your mind), and are easily integrated with comments and further information to be included in the footnotes. Footnote text is surrounded in HyperNote with special characters to facilitate its eventual conversion to footnotes in the word processor. This conversion is accomplished by macros. (Footnote source records from HyperNote Bibliofile stacks can be automatically placed into the Source fields of notetaking Bios cards, already preformatted for use with a footnote macro.)

    Is HyperNote an outliner?
    NO! But it supports powerful organizing features:
  • Sort all or marked notecards by any field.
  • Link notecards easily to other cards or stacks.
  • Quickly find selected text in related stacks.
  • Index cards display contents of specified fields for all notecards in the stack, and support editing, marking, and sorting functions.
  • Sort, index, find or mark notecards by Section or Record number fields.
  • Merge stacks, split stacks, copy multiple notecards between stacks, reconcile different copies of stacks, etc., as organizing themes and conceptual boundaries change during the course of your research.

    Is HyperNote a database?
    NO! But it supports bibliographic and biographical record-keeping like a database:
  • The three standard types of HyperNote formats--Bios (notetaking), Chronicon n (biographical record-keeping), and Bibliofile (bibliographic records) respectively-- become integrated as you work on any theme or project. All fulfill various roles as information bases optimized for browsing during notetaking, which you can easily modify and tailor to your own needs as you go.
  • Import files into HyperNote stacks from your word-processor (or Pro-Cite), according to various flexible options.

    Does HyperNote take advantage of the flexibility of HyperCard?
    YES!
  • Customize your note-taking format to your specific needs as you go, without losing previously entered information.
  • Update older stacks to customized or improved formats with the Insert Exemplars function, without loss oss of text or tedious reformatting stack-by-stack.
  • Custom HyperNote formats are designed for texts and commentaries, gradebooks, to do lists, language drill, etc.
  • In sum, HyperNote is not a particular HyperCard stack; it is a working environment within HyperCard, where various stack templates and (more importantly) script handlers are available to every stack you create and customize for various projects.

  • HyperNote is a completely new kind of writing program; neither word processor, outliner, nor data base, but probably much like the methods you've already used (far more tediously) on paper notecards.

  • HyperNote should help you easily and quickly get more out of HyperCard, especially for academic purposes.

    How can I learn to use HyperNote?
  • Balloon Help is available on every card.
  • Sample Project stacks included with HyperNote are fully-functional notetaking stacks (Project B, Project C, Project B2). Their step-by-step instructions provide an interactive, "hands-on" orientation to get started.
  • Feel free to just experiment and try things out! Warnings are given before operations that alter text, and you may ignore the more powerful features of HyperNote until you need them. Use the supplied Project stacks to get started entering notes right away.
  • HyperNote Tutor stacks provide a comprehensive onscreen reference manual, which can be browsed as needed, or printed if you have 300 sheets of paper. (Nicely bound, laser-printed manuals are no longer available from us; see the registration form.)

    What hardware and software do I need?
  • Recommended for use with G3 PowerPC Macintosh computers such as the iMac or G3 PowerBooks (HyperCard requires extreme patience on anything slower, and the notecards are too large for the screens of many pre-G3 PowerBooks).
  • HyperCard 2.4 is required for Hyper Note v. 5.x. It will not run with the HyperCard Player.
  • 20 MB of RAM or more are suggested for HyperCard.
  • See the "Description and Set-Up of HyperNote" section of the HyperNote Tutor stack for complete information.


    "Congratulations on designing one of the most useful programs that I have ever seen.... The program is extremely versatile and gets an A+ for the way it can be applied to many subject areas."
    Jean Catani, user of HyperNote 1.7

    "I'm a graduate student, and was looking desperately for something like what you have to offer. I do massive amounts of research and writing.... Imagine my delight at finding your program!....The organizational possibilities are extensive, to say the least. The more I think about the possibilities of what you've created here, the more enthusiastic I feel about it."
    Alexandria Pallas, user of HyperNote 2.4

    "HyperNote has much more utility than other commercial programs and I consider it a bargain at $50.00."
    Bill Perednia, user of HyperNote 3.4

    (Click the "Registration Form" button or press Tab to hide this field...)

    1. Information (v. 5.5).

    Name:

    Address:


    Internet or email address:

    Date:


    Vocation (optional):

    a. If you have a copy of HyperNote...
    What version(s) do you have?

    How did you hear of HyperNote or from what source did you obtain your copy?


    b. What kind of Macintosh do you use?

    c. Which OS do you use?

    d. Which word processor do you use? Which version?
    (We're working on quick-keys macros for HyperNote text imported into AppleWorks and Adobe Framemaker.)


    2. Registration request.

    YES: Send me the latest version of HyperNote, and receive any Email or phone calls from me for HyperNote support and advice with grace and charity. I have enclosed $20.

    Please send HyperNote to me on: (please check or circle)
    -- Zip (enclose an extra $15)
    -- email attached file
    -- I already have downloaded a copy; I just want user support.

    Note: You may print the HyperNote Tutor stacks on your own printer, or browse the Tutor stacks on screen. We no longer supply printed copies of the manual.


    3. Survey. Please answer any of the following that you like (or none, if you prefer). Your feedback will help us to make HyperNote better.

    a. Did you find the Project and Tutor stacks helpful? How so? What could be done to improve them?




    b. How do you use HyperNote? For what tasks do you find it useful? (or would like to find it useful...) What do you like best about HyperNote? What could be better?





    c. Which types of stacks do you use or expect to use? (Circle any that apply)
    -- None; I have not yet begun to use HyperNote.
    -- Chronicon
    -- Bios
    -- Bibliofile
    -- Bios Text
    -- Bios Translation

    What other custom stack templates would be useful?
    Comments:




    d. Have you used HyperNote in conjunction with your word processor? If so, what worked easily, and what gave you the greatest difficulties?





    e. Suggestions/Bugs/Ideas/etc.:





    Call or write us anytime with your questions, bugs, suggestions, etc., and we will try to help as best we can.

    Thanks for supporting shareware!
    This page is based on a index-format HyperNote notecards exported from a HyperCard stack entitled "."

     

    logo hypernote Kerry Magruder