<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html><head>
<meta http-equiv="Content-type" content="text/html; charset=ISO8859-1" />
<title>tree exported from hnb</title>
<style type="text/css" id="internalStyle">
body {
padding-right: 3em;
padding-left: 3em;
}
div {
padding-top: 0.5em;
font-family: verdana, arial, helvetica, sans-serif; position:relative;
font-size: 10pt;
left: 2em;
padding-right: 2em;
}
div.level1 {
padding-top: 2.5em;
font-family: verdana, arial, helvetica, sans-serif; position:relative;
font-size: 18pt;
text-decoration: underline;
font-weight: bold;
left: 0em;
padding-right: 0em;
}
div.level2 {
padding-top: 0.5em;
font-family: verdana, arial, helvetica, sans-serif; position:relative;
font-size: 12pt;
text-decoration: none;
font-weight: bold;
left: 0em;
padding-right: 0em;
}
</style>
</head>
<body xmlns="http://www.w3.org/1999/xhtml">
<div class="level1">Introduction to hnb
<div class="level2">Introducing hnb
<div class="level3">hnb is an hierarchical notebook, that is an editor that focuses on editing and managing information in a hierarchical manner. This type of editor is also known as outline editors.</div>
<div class="level3">hnb was written as a personal itch of the author, he knew no other such program and thought out how he wanted it to work. Some of the additional features in hnb have been inspired by other similar programs.</div>
<div class="level3">I, that is Øyvind Kolås <pippin@users.sourceforge.net> use hnb to maintain my contact list, my to-do lists, my calendar, writing documentation and reports.</div>
</div>
<div class="level2">Installing hnb
<div class="level3">Unix
<div class="level4">prepackaged binaries
<div class="level5">prepackaged binaries for hnb exist for some operating-systems/distributions, these might not be the latest versions.</div>
<div class="level5">Andras Bali maintains a Debian package of hnb, which can be installed by issuing
<div class="level6">apt-get install hnb</div>
</div>
<div class="level5">Patrick Li maintains a Free-BSD ports package of hnb, I don't know how to install it on Free-BSD.</div>
</div>
<div class="level4">compiling
<div class="level5">hnb comes packaged in a tar.gz file, this file contains a Makefile, hopefully installing hnb is as simple as:
<div class="level6">make</div>
<div class="level6">su
<div class="level7"><enter root password></div>
</div>
<div class="level6">make install</div>
</div>
<div class="level5">platform specific workarounds
<div class="level6">SuSE Linux:
<div class="level7">SuSE Linux doesn't install ncurses as curses, which ncurses actually does by default if it is allowed to. Changing the CFLAGS line in src/Makefile to -lncurses instead of -lcurses makes hnb compile on SuSE</div>
</div>
<div class="level6">OS X / Darwin:
<div class="level7">the preprocessor that OS X uses doesn't work properly. Adding -no-cpp-precomp to the Makefile should make it compile properly on OS/X as well</div>
</div>
</div>
</div>
</div>
</div>
<div class="level2">Starting hnb
<div class="level3">When you start hnb it automatically loads the default database, ~/.hnb and lets you edit it, this is to make it convenient to have your personal information like contacts and to-do list readily available.
<div class="level4">If ~/.hnb doesn't exist a sample database will be loaded instead</div>
</div>
<div class="level3">The full commandline usage for hnb is
<div class="level4">hnb [options] [filename] [-e 'comand' ['command' ['command' ..]]]</div>
<div class="level4">options:
<div class="level5">-h or --help show recognized options</div>
<div class="level5"></div>
<div class="level5">-a or --ascii use tab indented ASCII for loading/saving database
<div class="level6">ASCII doesn't remember attributes like to-do status, done etc.</div>
</div>
<div class="level5">-o or --opml use OPML DTD for loading/saving database</div>
<div class="level5">-x or --xml invoke hnb as a XML editor</div>
<div class="level5">--hnb use hnb DTD for loading/saving database, this is the default unless you've changed it in the preferences file</div>
</div>
<div class="level4">running commands
<div class="level5">by running
<div class="level6">hnb -e 'go_root' 'oexport_htmlcss test.html'</div>
</div>
<div class="level5">hnb will load the default database, go to the start of the database, and export it with the htmlcss filter to a file called test.html</div>
</div>
</div>
<div class="level3">In the latest version hnb also contains a menu that can be invoked by pressing F9, for advanced commands the commandline (F5) is preferred.</div>
</div>
<div class="level2">Quitting hnb
<div class="level3">By pressing ESC, hnb will ask you whether you want to save or not, if you press ESC again hnb will return to normal operation.</div>
</div>
<div class="level2">Importing data
<div class="level3">To import the contents of another file, you press ^L (Ctrk+L), you will then get a list of choices of format to import from.</div>
<div class="level3">Choose the desired format</div>
<div class="level3">Enter the relative or full path of the filename you want imported.</div>
<div class="level3">hnb will add that file under the current level.</div>
</div>
<div class="level2">Exporting data
<div class="level3">To export the current tree to another file.</div>
<div class="level3">press ^E (ctrl+E)</div>
<div class="level3">Choose the desired format</div>
<div class="level3">Enter the relative or full path of the filename you want to write to.</div>
</div>
<div class="level2">Printing
<div class="level3">hnb doesn't support printing to a printer directly, but by using an intermediate format you can get some quite good printouts, a good candidate is the HTML/CSS format.</div>
</div>
</div>
<div class="level1">Using Outlines
<div class="level2">Managing entries
<div class="level3">Navigating amongst entries
<div class="level4">The arrow keys will move you amongst the entries in the tree, you may also start typing the name of a entry that exist on the current level, and hnb will take you to the entry that matches what you've typed, pressing tab twice will enter the sub-level of the current entry, this behavior is modeled after the name completion in Unix shells.</div>
<div class="level4">PageUp/PageDown will skip a large amount of entries up and down.</div>
<div class="level4">Home will bring you to the 'root' (the first entry) of the tree.</div>
<div class="level4">Searching
<div class="level5">^F will ask you for a search term, you may thereafter navigate amongst the occurrences of the search term with up/down n/p, pressing space or return will make you stop where you found the substring, ESC will bring you back to where you started the search.</div>
</div>
</div>
<div class="level3">Moving entries
<div class="level4">You can move entries either by pressing shift and using the arrow keys, the entry will then move within the constraints of the hierarchical structure.</div>
<div class="level4">You can also move entries by cutting and pasting a entry, this has much of the same effect, cut is instantiated with ^C and the paste command is ^V</div>
</div>
<div class="level3">Adding entries
<div class="level4">Pressing insert will add a new entry below the current. You will also immediately enter edit mode.</div>
<div class="level4">You may also exploit the fact that searching by keyboard for a entry that doesn't exist, and pressing enter, will create the entry name that you entered.</div>
</div>
<div class="level3">Deleting entries
<div class="level4">If you press delete the current entry will be deleted, if it has children you will be asked to confirm the action.</div>
<div class="level4">Cutting can also be used to remove data, no confirmation will be asked whether you want to fulfill you action or not, but the data will be available from the clipboard.</div>
</div>
<div class="level3">Indenting and Outdenting entries
<div class="level4">> will move the current entry and all the following entries of the same level to be children of the preceding entry.</div>
<div class="level4">< will move the current entry and all the following entries of the same level to follow the parent of the preceding entry.</div>
</div>
<div class="level3">Expanding and Collapsing entries
<div class="level4">expanding
<div class="level5">pressing '+' on a entry with sub entries will display the sub entries even when you're not within them, thus displaying a larger portion of the tree.</div>
</div>
<div class="level4">collapsing
<div class="level5">Pressing '-' has the opposite effect of '+' it hides the expanded entries</div>
</div>
<div class="level4">operations working on the whole outline
<div class="level5">pressing F10 brings up the user menu,.. a menu where miscellany commands that don't fit anywhere else are added,.. here you may expand or collapse all entries in the current tree.</div>
</div>
</div>
</div>
<div class="level2">Editing entries
<div class="level3">Pressing Return will start editing the current entry, now the cursor keys move between the characters of the data in the entry instead amongst the entries</div>
<div class="level3">(most) Default editing shortcuts</div>
<div class="level3">Splitting entries
<div class="level4">When editing a entry you may press ^S, the entry being edited will be split in the current position. The data to the left of the cursor will be retained in the current entry, whilst the remaining data will be inserted in a new entry below.</div>
</div>
<div class="level3">Joining entries
<div class="level4">Pressing ^J whilst editing a entry will join the following entry, (as long as it doesn't have sub-nodes) will merge the data in; at the end of the entry being edited.</div>
</div>
</div>
<div class="level2">Spell-checking
<div class="level3">By default hnb is configured to use ispell for spell-checking.</div>
<div class="level3">Pressing F6 will spell-check the current entry</div>
<div class="level3">Ispell will start and guide you through the unmatched words in the current entry.</div>
<div class="level3">Thereafter you can press space to spell check the next entry, escape to cancel the changes or return to accept the changes made.</div>
</div>
<div class="level2">Sorting entries
<div class="level3">pressing ctrl+s will sort the entries on the current level</div>
</div>
</div>
<div class="level1">Other features
<div class="level2">Todo-list mode
<div class="level3">^T toggles checkmarks instead of bullets,. ^D checks or unchecks the checkmarks.</div>
<div class="level3">percentages are shown for unchecked parents that have checked subentries</div>
</div>
<div class="level2">Using URL's
<div class="level3">If an entry contains a web url ^A will bring up the configured web browser, (see your ~/.hnbrc for more information about configuration)</div>
</div>
<div class="level2">Calendars
<div class="level3">From the commandline you can issue a command like 'insert_cal 3 2003' to insert a calendar template.</div>
</div>
<div class="level2">Using Email addresses
<div class="level3">If an entry contains a email-address ^A will bring up the configured mail client, (see your ~/.hnbrc for more information about configuration)</div>
</div>
</div>
<div class="level1">Configuring hnb
<div class="level2">Nothing here yet, please examine your ~/.hnbrc (created automatically the first time you run hnb) for information.</div>
</div>
<div class="level1">sample data
<div class="level2">This is a stripped down version of the authors default database.. the real database contains >4000 entires</div>
<div class="level2">contacts
<div class="level3">frodo baggins
<div class="level4">or perhaps underhill</div>
<div class="level4">555-12341324</div>
<div class="level4">frode@bagend.net</div>
</div>
<div class="level3">merry
<div class="level4">meridoc somthing</div>
<div class="level4">555-23234324</div>
</div>
<div class="level3">peregrin took
<div class="level4">aka pippin</div>
<div class="level4">pippin@users.sourceforge.net</div>
</div>
<div class="level3">sam gamgee
<div class="level4">samwise</div>
<div class="level4">555-12341234</div>
<div class="level4">sam@gamgee.com</div>
</div>
</div>
<div class="level2">calendar
<div class="level3">2003 March
<div class="level4">Sat_01 </div>
<div class="level4">Sun_02 </div>
<div class="level4">Mon 03 </div>
<div class="level4">Tue 04 </div>
<div class="level4">Wed 05 </div>
<div class="level4">Thu 06 </div>
<div class="level4">Fri 07 </div>
<div class="level4">Sat_08 </div>
<div class="level4">Sun_09 </div>
<div class="level4">Mon 10 </div>
<div class="level4">Tue 11 remember to do some stuff</div>
<div class="level4">Wed 12 </div>
<div class="level4">Thu 13 </div>
<div class="level4">Fri 14 </div>
<div class="level4">Sat_15 </div>
<div class="level4">Sun_16
<div class="level5">got some sub entries on my todolist here,..</div>
</div>
<div class="level4">Mon 17 </div>
<div class="level4">Tue 18 </div>
<div class="level4">Wed 19 </div>
<div class="level4">Thu 20 </div>
<div class="level4">Fri 21 </div>
<div class="level4">Sat_22 </div>
<div class="level4">Sun_23 </div>
<div class="level4">Mon 24 </div>
<div class="level4">Tue 25 </div>
<div class="level4">Wed 26 </div>
<div class="level4">Thu 27 </div>
<div class="level4">Fri 28 </div>
<div class="level4">Sat_29 </div>
<div class="level4">Sun_30 </div>
<div class="level4">Mon 31 </div>
</div>
<div class="level3">2003 April
<div class="level4">Tue 01 Aprils Fool
<div class="level5">need to find some good ideas for jokes</div>
</div>
<div class="level4">Wed 02 </div>
<div class="level4">Thu 03 </div>
<div class="level4">Fri 04 </div>
<div class="level4">Sat_05 </div>
<div class="level4">Sun_06 </div>
<div class="level4">Mon 07 </div>
<div class="level4">Tue 08 </div>
<div class="level4">Wed 09 </div>
<div class="level4">Thu 10 </div>
<div class="level4">Fri 11 </div>
<div class="level4">Sat_12 </div>
<div class="level4">Sun_13 </div>
<div class="level4">Mon 14 </div>
<div class="level4">Tue 15 </div>
<div class="level4">Wed 16 </div>
<div class="level4">Thu 17 </div>
<div class="level4">Fri 18 </div>
<div class="level4">Sat_19 </div>
<div class="level4">Sun_20 </div>
<div class="level4">Mon 21 </div>
<div class="level4">Tue 22 </div>
<div class="level4">Wed 23 </div>
<div class="level4">Thu 24 </div>
<div class="level4">Fri 25 </div>
<div class="level4">Sat_26 </div>
<div class="level4">Sun_27 </div>
<div class="level4">Mon 28 </div>
<div class="level4">Tue 29 </div>
<div class="level4">Wed 30 </div>
</div>
</div>
<div class="level2">to-do
<div class="level3">hnb todo
<div class="level4">force all expanded</div>
<div class="level4">clones</div>
<div class="level4">calendar</div>
<div class="level4">new documentation
<div class="level5">start</div>
<div class="level5">asdfasdfadsf</div>
<div class="level5">blah</div>
<div class="level5">asdfasdf</div>
<div class="level5">asdfasdf</div>
</div>
<div class="level4">revert to last saved version</div>
<div class="level4">known bugs
<div class="level5">insert bug
<div class="level6">press right</div>
<div class="level6">type data</div>
<div class="level6">press insert</div>
<div class="level6">data is lost,..</div>
</div>
</div>
<div class="level4">show all of bottommost node when possible</div>
<div class="level4">menu</div>
<div class="level4">add real percentages again,.. so I don't have to fake it like I did above on new documentation,..</div>
</div>
</div>
<div class="level2">school
<div class="level3">notes from exam cramming,..</div>
<div class="level3">paper outlines</div>
<div class="level3">...</div>
</div>
<div class="level2">work
<div class="level3">I've removed quite a lot of the stuff I actually keep in my database...</div>
</div>
<div class="level2">movie manuscripts
<div class="level3">one of them made,.. some of them in planning,.</div>
<div class="level3">I don't want everybody to see them,..</div>
<div class="level3">but it's an actual node in my database</div>
</div>
<div class="level2">bookmarks
<div class="level3">http://hnb.sourceforge.net/</div>
<div class="level3">norwegian short film festivals
<div class="level4">http://www.kortfilmfestivalen.no/</div>
<div class="level4">http://www.minimalen.com/</div>
</div>
<div class="level3">news
<div class="level4">k5
<div class="level5">http://www.kuro5hin.org/</div>
</div>
<div class="level4">slashdot
<div class="level5">http://slashdot.org/</div>
</div>
<div class="level4">nettavisen
<div class="level5">http://www.nettavisen.no/</div>
</div>
<div class="level4">dagbladet
<div class="level5">http://www.dagbladet.no/</div>
</div>
<div class="level4">vg
<div class="level5">http://www.vg.no/</div>
</div>
<div class="level4">fark.com
<div class="level5">http://www.fark.com/</div>
</div>
</div>
</div>
<div class="level2">quotations
<div class="level3">Peoples Front To Reunite Gondwanaland: 'Stop the Laurasian Separatist Movement!' </div>
<div class="level3">slashdot
<div class="level4">disbelief
<div class="level5">To anyone who is still stubborn enough to insist that BlackICE Defender is actually good for something: PLEASE do not write to me. I don't want to hear it. I'm a scientist who will not find your mystic beliefs to be compelling. I respect your right to your own opinions, no matter how blatantly they fly in the face of logic and reality. That is, after all, the nature of faith. Happy computing. I suggest prayer. </div>
</div>
</div>
<div class="level3">the movie zardoz
<div class="level4">The gun is good. The penis is evil. The penis shoots seeds, and makes new life, and poisons the earth with a plague of men, as once it was. But the gun shoots death, and purifies the earth of the filth of brutals. Go forth and kill!</div>
</div>
</div>
<div class="level2">old
<div class="level3">I keep a 'trashbin' where I stow away outdated entries,.. just to be able to search it,.. and save it later,..</div>
</div>
</div>
</body></html>
