Unitraverse Desktop Productivity App
Documentation
Section 5
Products
Contact us
About us
Section 5
Unitraverse Desktop Productivity Application - Version 1.2

Capturing URLs
There will be times you will have opened browser tabs outside of the UD App window, of course. Not to worry, there is a way to pull URLs in from any open tab. This is done simply by clicking on the 'capture urls' menuitem.
After you have navigated to a place in your vault where you would like to store web addresses for currently opened pages in the browser, click on the 'capture urls' menu action. After doing this you should see items for each currently opened tab, and you can check the boxes for each URL that you want to pull in.

Here is the popup box you will see that let's you do this:

Once you have checked the boxes for each URL you want, click on the 'Done' button. At this point you should see the web pages added to your vault, in the current scope.

Copying vault items
You can use the keyboard shortcut 'c' to copy an entire branch or a single resource item to an internal clipboard. First select the item you would like to copy, and then press 'c'.

Pasting vault items
You can use the keyboard shortcut 'v' to paste what has been copied most recently, to the current page. The placement rules are the same as for creating a new item: if you paste a context node and it's branch contents to a new location, it will become the last item if there is no context node currently selected, and if there is such a selected node, your pasted item will be inserted in front of it.

There is no support for copying only the top level items of a branch. Unwanted child items must be removed after you have finished pasting the copied branch.

JSON copy & paste method
The default copy and paste method uses a simple buffer in the JavaScript sandbox. This limits how much you can move things around. What if I want to move some stuff from one vault to another, and from one computer system to another?

The need for this is, in part, because vaults will grow in size and users will want the option of working inside a new vault dedicated to some specific subset of items. Clearly, there needed to be a way to transport parts of a vault to a different vault.

Since the OS clipboard is not generally available to JavaScript running inside a browser, the following workaround was devised to allow you to copy and paste something between vaults and different systems:

  1. Navigate to the context node or resource item you wish to copy, so it becomes the selected item.
  2. Press and hold the 'ALT' key and click on 'view json'

    This creates a popup with an editable content window that contains just the items you want to grab in the JSON format.

  3. Select and copy all of the text to your operating system clipboard. Use CTRL+a followed by CTRL+c for Windows and COMMAND+a followed by COMMAND+c for Mac
    NOTE: Special JSON code has been included to to identify the type of vault items being moved. Don't try to modify this text unless you know exactly what you are doing.
  4. If the vault items are being moved to a different computer, send that copied text via email, thumbdrive or some other media, and select and copy to that other system's clipboard from a text editor or email client.
  5. Inside the destination vault, navigate to the context node that you want to recieve items. Unlike how you selected an item to copy, here you will be selecting an insertion location for pasting, as added content at some vault location. Selecting nothing will cause pasted items to be placed in the last position.
  6. Click on 'add -> from json' action or simply use the 'j' shortcut. This will bring up a dialog: that allows you to paste the JSON data into an editable text field similar to the one you copied from earlier.
  7. Paste the text into the edit window with CTRL+v or COMMAND+v.
  8. Click on the 'Done' button. (You're done).

"ALT+Copy" for symbolic links
NOTE: TO SAFELY USE THIS FEATURE, PLEASE MAKE FREQUENT BACK-UPS OF THE VAULT FILE FOR ROLL-BACK AND RECOVERY PURPOSES, PER THE USER AGREEMENT'S RECOMMENDATION. ALSO, BE SURE TO FIRST DOWNLOAD VERSION 1.2.49 (OR LATER) OF THE UD APP TO GET THE EXTRA, BUILT-IN SAFE GUARDS WHEN USING SYM LINKS

It is not a good idea to leave copies of something in more than one place in the vault. That means having to manually update both locations if they are supposed to be the same. Inevitably vaults will start to have more than one pathway that accesses the same information, that's how our brains work and that's not necessarily a bad thing. So to make two locations point to the same vault items, you can use the ALT+c command.

When you select a context node in your currently open vault page, and then, while holding down 'ALT', you press the 'c' key, it places a sym link into the internal UD App clipboard. After that, navigate to the new location and do a paste operation, (as already discussed in this secion) by pressing the 'v' key. ('ALT' is unnecessary when doing the paste).

So despite having the basic copy in your arsenal, it's best to use ALT+copy whenever you intentionally want to refer to the same thing. Use the basic copy operation for shuffling things around and rearranging things. If you create a link to another link, that is supported. If you try to remove an original object that has links pointing to it, you will be asked to confirm the removal.

Editing display properties
So far, we've mentioned context nodes and resource items, but haven't talked about display properties. Each context node displays its contents in accordance with node container property settings that are applied when a page is drawn. Currently, the list of display properties is quite short, consisting of a value called 'default presentation', a 'title', and a 'no title' checkbox.

In order to edit display properties for a context node, you need to select the container portion of the node you want to edit. The container is in the selection sequence that 'ARROW' keys cycle through. This screen shot shows what it looks like when a container is selected:

After you have selected the container, then hit the 'Edit' menuitem or press the 'e' shortcut key. This action has different behavior when you container select, bringing up the Page Edit dialog. Here is the Page Edit Dialog box that allows you to edit your display properties:

The most important of these is the default presentation, which determines the basic layout, styling and sometimes even the behavior exhibited when a context node is viewed.

The 'no title' property controls, most of the time, whether or not the title of an item is hidden or displayed. Titles will be displayed in the locator path even if you check this option, and some customization code that are add-ons, may ignore this flag and display the title anyway.

These display properties are used when a particular node becomes the scope item. A 'scope item' is where you currently are in your navigation. The last component of the 'locator' path is the current 'scope item'.

There is another situation, though, when the display properties are used, and that is when one node tells another node to draw itself. Basically, the 'scope item' does not control how everything is drawn in this case, but instead the hosted node will use its own default presentation properties.

Things start to get pretty cool when you select different presentation styles for the vault nodes. When you want to see a couple levels down, you can select 'two-level hierarchy', if you want to see more than that you can choose 'entire branch'. If you want some items in a table, there is the 'table' option also. You can select the different presentation options and try them out.

email: support@unitraverse.com

Our company was founded in July 2017 by Bradley Pliam.

The headquarters is currently in Austin, Texas.

Ideas that have been in gestation since the early 2000s have now finally been given 'wings'.

The mission of the company is to deliver happiness in the form of value and great user experience via high quality software, being honest about what is being delivered, and up-front about any current limitations. The world of software has some great things, along with some insidiously bad aspects. We intend to be a positive influence.

Meet our current staff...

Brad Pliam - Dev lead

Unitraverse