Flying Meat
VoodooPad Docs: Importing

Bringing Things into VoodooPad

This document describes Importing, but make sure to also read up on Creating Links, and Linking to Another Document .


VoodooPad is a great resource for typing stuff out, but what about when you have something on your computer that you want to import?  Well...learn more below!


There are quite a few different ways to bring things into your VoodooPad document.  



Paste

Copy and paste is the most common way of bringing something into your document.  Most of the time it is easiest to copy things from email or websites and paste it into your VoodooPad document. The same thing can be applied to images as well.  Pasting puts the content into the page you are currently on, and if deleted it all goes away.  If you have pasted an image that you would like to edit later on, please read the page on VoodooPad Edit Images.




Dragging a File into the Work Area

The easiest way to bring things into VoodooPad is to simply drag and drop them in. For image file types you will get the option to Paste or Link.  If VoodooPad cannot Paste the file in, it will automatically link it.  You can also drag in a whole bunch of files which will all be linked at once.  Linking does not copy the file into the VoodooPad document, so be sure not to delete it.  Clicking the link will do the same thing as double clicking the documents icon in Finder.  You can move the file around and VoodooPad will find it again.  Once a file is linked, every time you type the file name VoodooPad will link to that file.  You can check out what you have linked by choosing Window ▸ PalettesDocument Info and looking at the box that says Files & URLs next to it.


When dragging in a PDF file to VoodooPad, it will respond differently depending on whether the file is a single page or multiple pages.  If the PDF is a single page, you will be given the option to either paste or link to the file.  If the PDF is multiple pages, VoodooPad will automatically link to the file.   


Pro Tip:   If you would like a single page or multi-page PDF imported then you must hold down the option key while dragging the file into the VoodooPad.  


When dragging and dropping a VoodooPad document into another VoodooPad document in order to create a link, you will be asked whether you want to link to the entire document or a specific page within it.  If you choose to link to a specific page, you will be given the list of pages within your document to choose from.  


Examples of dragging a file into VoodooPad:


vplinking.acorn

The file 'test.vpdoc' is being dragged and dropped into VoodooPad from the documents folder.



vplinking1.acorn


Alternatively, the file 'test.vpdoc' can be dragged and dropped into VoodooPad from its file name in the title bar (highlighted on the upper right).


vplinking2.acorn

A link has now been created to the file 'test.vpdoc'.  Clicking on the link will open the file.


File ▸ Import

This will allow you to bring in text files, images, and any other file type VoodooPad supports.  A new VoodooPad page is created within the document for each file imported.


If you do not like the name of the imported page, you can rename the page in the Page Info palette.




Importing Complete Web Pages


If you want to import a complete web page into VoodooPad, you can import it as a PDF or a web archive.   Safari is the recommended web browser.  To import a web page as a PDF:


To import a web page as a web archive:




The Bucket

The bucket is your instant link to VoodooPad from anywhere on your computer.  It pops up by hitting ⌘⇧7 all at the same time.  Type, paste, and drag things into VoodooPad without ever bringing the application forward. 



bucket-default.png



To get started, have VoodooPad open with a document you would like to use to store notes.  VoodooPad does not have to be the active application in order for the bucket to open, it just has to be open on your computer.  While you are in another application, like Safari or the Finder, hit the shortcut key ⌘⇧7 (this can be changed in VoodooPad's preferences).  You will see the bucket pop up, giving you an area to type in, as well as some options to choose from at the bottom. 


The text area of the bucket works that same as in VoodooPad.  You can type, paste, or drag pictures and files into it.  Give it a try.


Where is the stuff in the bucket going?  Select the document and page you would like the bucket to send the data to.  You can select a page one of the following ways:


The bucket will also remember the last page you dumped things into, and fill that in automatically when you open the bucket.


You can get the bucket to automatically pick up whatever you have selected on a website by using this nifty bookmarklet.  To add it to your web browser: 


If everything worked according to plan, the bucket will pop up and whatever text you have selected will be automatically put into the bucket.  And for the curious, here is the javascript behind the link above: javascript:document.location='x-voodoopad-bucket:'+encodeURIComponent(getSelection());



Services Menu

If you find yourself needing to paste stuff into your document but do not want to mess with all those pesky steps, try using the Services Menu.  From anywhere on your computer, highlight a bit of text.  Choose the Application Menu (the one that comes to the right of the apple) then Services ▸ VoodooPad.  From there you will have the option of Appending to Current Page, Appending to Services Drop Page, or Make a New Page and the text you have highlighted will magically find its way onto that page.



Clippings

Clippings are bits of text you use often that can be easily inserted into the current document. You can find them under Edit ▸ Insert and add your own by dropping text files into ~/Library/Application Support/VoodooPad/Clippings.


If you are interested in creating you own, follow these steps:


  1. Open up VoodooPad and create a new page. Its name is not important.
  2. Type some text on that page that you would like to have as your clip.
  3. Choose File ▸ Export Page As.
  4. Choose to save the file as an RTFD and save it into ~/Library/Application Support/VoodooPad/Clippings.  Give it a descriptive name.
  5. Restart VoodooPad to see your changes.
  6. Now go under Edit ▸ Insert to see the file you saved into the clippings folder. Selecting that file will add its contents wherever the cursor is on the page.


The text file does not have to come from VoodooPad, it just needs to be a TXT or RTFD formatted file. If it is RTFD, then the color and formating of the text as well as files embedded in it will also transfer over.




Combining Documents

It is possible in VoodooPad to combine documents, or import one document into another document.



VoodooPad will now attempt to import all of the pages from the document you found into the open document.  If it runs into a conflict, it will prompt you by asking whether you would like to replace the existing page with the new one or not.


You can not have two pages with the same name.  If you are merging two similar documents, you might have to rename a few pages before importing with this method.




In Summary....


Pasting an item into VoodooPad places that item onto the current VoodooPad page that you are on.  


Importing an item into VoodooPad places that item onto its own VoodooPad page.  The entire item will be viewable within VoodooPad.  


Linking to an item keeps that item outside of VoodooPad, but allows you to access it by clicking on the Link.  Clicking on the link will open the item in whatever program you have set as a default to open that file type.  Linking does not copy the file into the VoodooPad document.




Back to VoodooPad