Flying Meat's Wiki.2005-06-24T14:55:33ZFlying Meat Inc. and Friends of Flying Meaturn:uuid:547f7640-0089-44d0-a983-c2933b9c30dfVoodooPad: Start Pageurn:uuid:353ec59a-c72a-01d9-1c37-c0cbe4c4b920:832007-12-16T17:22:51Z2005-05-17T16:20:08Zh2. VoodooPad 3.0
* <b>VoodooPad Tutorial</b>: A gentle ~introduction to what VoodooPad is all about.
* <b>Glossary</b>: Terms you might want to learn to get around in VoodooPad.
* <b>Script Plugins</b>: Learn how to extend VoodooPad with simple scripts.
* <b>Lua Plugin Snippets</b>: Lots of examples of useful scripts.
* <b>AppleScript</b>: Learn how to automate VoodooPad with Apple's scripting language.
* <b>Aliases</b>: Make words or phrases link to another page.
* <b>Encryption in VoodooPad</b>: Hide your data from prying eyes.
* <b>How to register VoodooPad</b>: You bought it- now how do you stop the nagging?
* <b>Page Templates</b>: Customize the look of new pages.
* <b>Web Export</b>: Flexible exporting of your documents as HTML
* <b>Categories</b>: Organize pages in VoodooPad document according to topics
* <b>Tips</b>: Random bits of info.
* <b>Plugins</b>: Add functionality to VoodooPad via a downloadable plugin.
* <b>Linking, Pasting, and Embedding Files</b>: How does some stuff (like images) get in there anyway?
* <b>Hidden Preferences</b>: Change certain behaviors of VoodooPad
* <b>Data Sent to Flying Meat</b>: Find out what bits of information is sent to the mothership.
* <b>Old Versions</b>: Need to grab a previous version of VoodooPad?
h2. VoodooPad Pro
* <b>Triggers</b>: Script VoodooPad during specific events.
* <b>Web Server</b>: Share pages of your document to friends and co-workers.
* <b>Page Meta</b>: Customizable attributes for pages.
h3. Online
* "VoodooPad's mailing list / Yahoo! group":http://groups.yahoo.com/group/voodoopad/
Talk with and receive information from VoodooPad users around the world.
* "The official website":http://flyingmeat.com/voodoopad/
h3. Version information:
* New in 3.5
* New in 3.2
* New in 3.1
* New in 3.0
* New in 2.5
* New in 2.1
* New in 2.0
* "List of all pages":/fs/flystashweb.cgi?allPages=1&space=353ec59a-c72a-01d9-0eb2-c0cbe4c48523VoodooPad: New in 3.5urn:uuid:2dc35f78-ac3e-01dc-01d4-c0cbe4c4bd91:32007-12-16T17:22:39Z2007-12-16T17:19:57Zh2. VoodooPad 3.5:
h3. New Features:
* Double clicking an image open it up in a suitable external editor (such as Acorn or Preview or Photoshop or whatever). Saving the image will then update the original image located in your VoodooPad Page. You've seen Acorn, right? http://flyingmeat.com/acorn/
* You can now edit pages and sort the results in the search window (woo!).
* Option-clicking on a tab close button will close all the open tabs except the one clicked on.
* The "default page text" in the preferences now accepts rich text, so you can embolden certain phrases or whatever. Go crazy.
* Pages served up via VoodooPad Pro's built in webserver look a whole lot better, especially on the iPhone.
* Speaking of the webserver- you now have the ability to search through all the pages when looking at a document in your browser (VoodooPad Pro only).
* The zoom factor of the page is remembered in the document workspace, so it'll be remembered between launches.
* When splitting a document, links to pages in the original document are retained for the pages being copied out.
* Added a page index to the default Web Export templates. Now you have a handy list of all the pages in your Web Export.
* New AppleScript: tell window 1 of application "VoodooPad" to insert text "hello world!"
* New AppleScript command to add/embed a file to the current document.
* Added an option to VoodooPad AppleScript export command- "with synchronous", which makes the export happen in the foreground.
h3. Changes:
* Reworked AppleScript implementation, which may require changes to your previous AppleScripts.
* No longer showing the license when starting up a new version. Please don't sue me.
* Cleaned up a preferences dialog box which could be confusing.
* Exporting to the iPod Notes folder is now done on a background thread, which makes things more responsive if you have a ton of pages.
* Changed the shortcut for deleting a page from Command-D to Command-Shift-D, making in less likely to hit by accident.
* Double clicking an image with the option key down will now prompt you to save the image.
h3. Bug Fixes:
* Fixed a problem where cmd-w wouldn't always close a window.
* VoodooPad Lite no longer tries to install plugins, which it can't use.
* Fixed a bug where the wiki engine would not markup a link directly following an email in the format 'first.last@foo.com'.
* You can now copy and paste linkback data across pages.
* Fixed some issues where list bullets would seemingly pop out of nowhere.
* Fixed a bug where VP would crash with certain embedded webarchives.
h3. Other:
* New hidden pref for writing out images to the iPod Notes folder (Only works on 5th gen iPods):
defaults write com.flyingmeat.VoodooPad_Pro writeIpodImages 1
* When exporting to the iPod notes folder, pages that have been deleted from the document but were still around from the last export are now cleaned up
* New hidden pref: defaults write com.flyingmeat.VoodooPad_Pro alwaysShowRuler 1
VoodooPad: Simple AppleScript Examplesurn:uuid:8596b25e-3567-01da-0fb1-c0cbe4c4b51f:352007-12-16T16:02:51Z2005-10-04T23:16:10Zh2. Here are some snippets of AppleScript that you might find handy.
Note: These are examples that work in VoodooPad 3.5. If you have a previous version of VoodooPad, check the help files that came with that version. For folks with VoodooPad Pro, just substitute "VoodooPad Pro" where you see "VoodooPad below.
*Prepend to the top of a page:*
<carea class="textareaCodeMini">tell application "VoodooPad"
tell page "index" of document 1 to prepend text "this goes at the top" & return
end tell</carea>
*Append to the bottom of a page:*
<carea class="textareaCodeMini">tell application "VoodooPad Pro"
tell page "junk" of document 1 to append text "this goes at the bottom" & return
end tell</carea>
*Create a new page:*
<carea class="textareaCodeMini">tell application "VoodooPad"
tell document 1 to create new page with name "new page" with content "This is a new page."
end tell</carea>
*Export to iPod:*
<carea class="textareaCodeMedium">tell application "VoodooPad"
-- this is the path to your document.
open "srv:Users:gus:Desktop:astest.vdoc" as alias
tell front document
export to ipod
end tell
end tell</carea>
*Getting text from a specific page*:
<carea class="textareaCodeMini">tell application "VoodooPad"
set theString to (text of page "index" of document 1) as string
end tell</carea>
*An example that loops through all the pages and displays it's name and contents*
<carea class="textareaCode">tell application "VoodooPad"
tell document 1
repeat with i from 1 to number of items in pages
set s to text of page i
set n to name of page i
display dialog n & return & s
end repeat
end tell
end tell</carea>
*An example that loops through all the pages, and prepends some text to every page*
<carea class="textareaCodeSmall">tell application "VoodooPad"
repeat with i from 1 to number of items in pages of document 1
set n to name of page i of document 1
tell page n of document 1 to prepend text "this goes at the top" & return
end repeat
end tell</carea>
*Sort and pull out pages by create page:*
<carea class="textareaCode">tell application "VoodooPad Pro"
set theDoc to first document
tell theDoc
set myList to ordered names sorted by create date
repeat with idx from 1 to number of items in myList
set pageName to item idx of myList
set s to text of (page pageName of theDoc)
-- now do something exciting with s
end repeat
-- we could have also done:
-- set myList to ordered names sorted by modified date
-- set myList to ordered names -- default, sorted by key
end tell
end tell</carea>
*Call into VoodooPad's scripting language "Lua" from AppleScript* (it's kind of crazy)
<carea class="textareaCode">tell application "VoodooPad Pro"
set s to "print 'Hello World!'; table.foreach(applescriptProperties, print); applescriptProperties.output = 'Hello from the return value!'"
tell window 1
set x to use plugin named "Lua Script" with properties {source:s, aprop:"This is a property passed in"}
display dialog x
end tell
set s to "applescriptProperties.output = windowController:textView():string()"
tell window 1
set x to use plugin named "Lua Script" with properties {source:s}
display dialog (x as string)
end tell
end tell</carea>
*Fun with Meta Values*
<carea class="textareaCode300">tell application "VoodooPad Pro"
set currentPage to current page name
tell page currentPage of document 1 to add meta record with value {|the key|:"the value"}
activate
display dialog "did it add?"
set thePageMeta to meta record of page currentPage of document 1
set s to |the key| of thePageMeta
display dialog s
tell page currentPage of document 1 to remove meta record with key "the key"
delay 1
display dialog "did it go away?"
end tell</carea>
*Fun with Categories*
<carea class="textareaCode300">tell application "VoodooPad Pro"
set currentPage to current page name
activate
tell page currentPage of document 1 to add category named "foo"
delay 1
display dialog "did it add?"
tell page currentPage of document 1 to remove category named "foo"
delay 1
display dialog "did it remove?"
end tell
tell application "VoodooPad Pro"
activate
tell document 1 to add category named "Foo"
delay 1
display dialog "did it add?"
tell document 1 to remove category named "Foo"
delay 1
display dialog "did it remove?"
end tell</carea>
Flying Meat: Start Pageurn:uuid:c2cde496-c729-01d9-0405-c0cbe4c4a89b:412007-09-13T14:39:38Z2005-05-17T16:16:56Zh2. Welcome to Flying Meat's online documentation.
There are a couple of spaces on this here that you might be interested in:
* "Acorn":http://www.flyingmeat.com/acorn/docs/
A simple and easy to bitmap image editor
* "VoodooPad":$scriptName$/space-353ec59a-c72a-01d9-0eb2-c0cbe4c48523
The award winning desktop wiki for Mac OS X. You put your brain in it.
* "FlyGesture":$scriptName$/space-4982c31c-c72a-01d9-1928-c0cbe4c4ee67
Move a little, do a lot.VoodooPad: Encryptionurn:uuid:f5eafb3e-1fda-01da-16f7-c0cbe4c4fd6d:82007-08-24T11:57:23Z2005-09-07T13:07:05Zh1. Encryption in VoodooPad
There are two ways to encrypt your data in VoodooPad. The first one (available in VoodooPad and VoodooPad Pro) is the ability to encrypt a single page. This is known as "Page Level Encryption". The second way (available in Voodoopad Pro only) is known as "Document Level Encryption". We'll go over Page Level Encryption first.
h2. Page Level Encryption
VoodooPad supports encrypting pages one at time, so you can have a mix of encrypted and unencrypted pages in a single document.
When encrypting a page, you are prompted to enter your password twice (to make sure your typing matches your intentions), and an option to keep the password in the Keychain.
p=. !$imagesDir$/voodoopad/encryptsheet.png! <br/>(encrypting a page)
When you place your password on the Keychain, you won't have to remember it when decrypting or encrypting your page. If you change your mind later and you would like to have your password removed from the Keychain, hold down the option key when decrypting the page and the password will be removed from the Keychain. Holding down the option key when encrypting will bring up the sheet regardless if you have the password on the Keychain or not.
p=. !$imagesDir$/voodoopad/decryptsheet.png! <br/>(decrypting a page)
h2. Document Level Encryption
VoodooPad Pro has the ability to make your whole document encrypted. With this in effect, you enter your password once when opening up your document, and you gain access to all your pages inside.
To remove a password from an encrypted document choose "Set Document Password..." from the Edit menu, and leave the password fields empty. To add a password to a plain document, choose "Change Document Password..." from the Edit menu and enter your password in the fields.VoodooPad: Editing Texturn:uuid:c14ec986-ccba-01da-15c6-c0cbe4c4b595:62007-07-17T14:12:32Z2006-04-15T13:02:24Zh2. Editing Text
As we mentioned earlier, text editing in VoodooPad is very similar to editing the text in a Rich Text document using TextEdit (and most other rich text editors on the Mac). However, because the rich text features of the Mac's text system are more similar to a word processor than to a simple text editor, we'll review a few of these features to be sure you're aware of their availability in VoodooPad.
On the other hand, because most of this functionality is so basic to Mac OS X, we'll make use of the hyperlinking capability of VoodooPad to reference much of this topic so you can move through it quickly if it's already familiar. If you see an editing capability referenced followed by the parenthesized note: "see edit details", simply click on the edit details link. The resulting page will have a link back to this one.
Open a new VoodooPad document by choosing File->New Document, or by pressing Shft-Cmd-N on the keyboard. When the the new window opens you should see the same document, with the heading: "VoodooPad, You put your brain in it." that you saw the last time we created a new VoodooPad document.
h3. Letter, Word and Paragraph Selection
We can select a letter, word or paragraph by clicking and dragging across them. Dragging across letters contains no surprises (see edit details). Doing so allows us to demonstrate text resizing on individual letters in a word (see edit details).
Notice the ease with which you can precisely select words by double clicking on the first and dragging across more (see edit details). We can also add to existing text properties in a selection (see edit details).
Finally, a paragraph is most easily selected by triple clicking and multiple paragraphs are easily selected by triple clicking and dragging (see edit details).
h3. Multiple Undo
As with most things Macintosh, we can undo what we've done by choosing Edit->Undo or pressing the Cmd-z keys. In fact, if we press Cmd-z often enough, or simply hold it down for a few seconds, we can undo all the changes we've just made on this page.
h3. Font Properties
Triple click to select the first paragraph of the page. Now choose Format->Font->Strike Out. We can undo the strike outs by pressing Cmd-z or by choosing Format->Font->Strike Out again while the strike out text is still selected.
Click on the Format menu item and drag to the Font item to see its submenu. Notice the things you can do directly from this menu:
• Bold, Italic, Strike Out, Underline to change font properties
• Bigger, Smaller to incrementally increase or decrease the selected text size
• Kern to spread letters apart or compress them horizontally
• Ligature to add ligatures used in your font
• Baseline to raise or lower the baseline of selected text
...and so forth.
Feel free to play with these properties if you're not familiar with them. In particular, with some text selected, choose Underline. Notice that rather than underlining the text, VoodooPad instead displays this panel:
The reason for this preference is that VoodooPad uses both underlining and text color to indicate links. It can be difficult to determine which underlined words really represent links if non-link words and phrases are also underlined and/or colored. Use the application's Preferences panel to change from the default with care.
With the first paragraph still selected, choose Format->Font->Show Fonts to bring up the Font pallette. This allows us to choose a new font for the selected text, change it's size and many other of it's properties.
To create the perception of lifting some text off the page, for instance, try clicking on the rectangle centered directly under the "Font" title of the Font pallette. To confirm that you've selected the correct rectangle, just hold the mouse pointer on the rectangle for a few moments until a tool tip pops up indicating that this is the Text Shadow rectangle. If it says something else, try again.
With the first paragraph selected when this rectangle is activated, the text in the paragraph will display shadows for each character. Directly to the right of the rectangle are three sliders, slide the first about 2/3 of the way towards the right, slide the second about 1/8 from the left and slide the third about 3/4 of the way toward the right.
As you do this, notice how the text seems to lift off the page. You can also click and drag the small indentation in the circle to the right of the third slider. As you do this, you'll see an apparent shift of the virtual light illuminating the text to cast the shadows at a changing angle.
h3. Font Colors
You can also choose Format->Font->Show Colors to display the color pallette. However, like underlining, by default you will not be able to change text colors. Choose VoodooPad->Preferences... and select the Appearance tab to change this default behavior.
Text Alignment and the Ruler
In our overview, we touched on the text ruler. Triple click on the third paragraph to select the entire paragraph and bring the ruler up again by choosing Format->Text->Show Ruler.
The text ruler is primarily used for setting page margins, paragraph indentation, tabs and alignment or justification. It also has pop-down menus for selecting line spacing, bullet point styles and an alternate means of selecting font properties.
With the third paragraph still selected, click on the third tab in the ruler tab bar that looks like this:
This should justify (or straighten the edges of) the paragraph on both sides. Now select the document title, "You put your brain in it." and click the far left of the four tabs to left justify the title.
h3. Setting Tabs
As a final demonstration of VoodooPad's standard text editing features, let's set some tab stops. First be sure that the VoodooPad window is wide enough by looking for the red Delete icon in the far right side of window's tool bar. If the far right icon is not the red Delete icon, then drag the lower right corner of the window to the right until red Delete icon appears.
Next scroll to the bottom of the page and click to place the text insertion bar at the very end of the text. Press the Return key a couple times to make some room. Then type in the following text. Note that as you do so, space each word or number from the others by a single tab:
Be sure that you've entered no spaces but only a single tab between each word or number. Then select all of the text in those five lines. With all five lines selected, go to the text ruler at the top of the window and drag all the tab stops that are to the left of the 5" mark out of the ruler. Don't worry if words or numbers in the five lines we've selected seem to go a bit berserk. We'll bring order to them shortly.
Look for the tab stop well at the far right of the ruler which looks like this:
Put your mouse pointer on each of the icons in the tab stop well for a couple seconds until a tool tips label appears. You should see that they are called from left to right respectively, the "Left tab stop", the "Center tab stop", the "Right tab stop" and the "Decimal tab stop".
Now drag a left tab stop from the tab stop well to the ruler and drop it at the top of the 3/4" mark. Next drag a Center tab stop from the well and drop it on the 2 1/4" mark. Next drag a Decimal tab stop from the well and drop it on the 3 1/4" mark. Finally, drag a Decimal tab stop from the well and drop it on the 4 1/4" mark.
If you've done this correctly, your five lines should now look like this:
Notice that the words in the Item column are left justified in the column. The numbers in the Quantity column are centered and the money amounts in the Price and Amount columns are aligned on their decimal points. Also notice a couple weaknesses in our formatting: the numbers in the number column should probably be centered in the column and the headers for the Price and Amount columns are right justified on the Decimal tab stops for each of those columns.
We could clean this up a bit by using different tab stops for the heading line then we used in the item and total lines, and by centering the numbers in the Number column, but we've demonstrated how the tab stops can be used and that was our objective in this tutorial.
If the resulting columnar list makes you uncomfortable, feel free to clean it up by inserting a tab at the left end of each of the last four lines, selecting only those four lines and adding a Center tab stop at the 1/4" mark. You can also select only the header line and replace the two Decimal tab stops there with two left tab stops placed at the 3" and the 4" marks. If you decide to do that, your result should look as follows:
But wait a minute, you say... the price for VoodooPad and FlySketch are $39.95, not $19.95! However, we reply, if you buy them in quantities of two or more, they're only $19.95 each.
Advanced Text Editing VoodooPad: Importing and Exportingurn:uuid:53020980-ccaa-01da-067c-c0cbe4c4b7b0:102007-07-17T14:10:37Z2006-04-15T11:04:46Zh2. Importing and Exporting
How does one publish or distribute a VoodooPad document?
Beyond just emailing the VoodooPad document itself (which only works if the recipient also has the application), VoodooPad gives us other ways to export our work for distribution:
* as a set of RTFD files (Rich Text Format with graphics)
* as a set of plain text files
* as Microsoft Word documents
* as an XML file
* to your iPod
* to HTML pages that retain the same links
Let's try these one at a time.
h3. Exporting as RTFD
First, create a folder on your desktop or in your home folder in which to do some playing. For purposes of our discussion, we'll call it VDTemp but you can call it any other name you can remember.
If you've closed the LinksAndPages.vpdoc VoodooPad document, let's open it again. When it's open, choose File->Export->Export as RTFD files... Navigate the resulting File Save sheet to your new folder, VDTemp, then click the Export button.
Now open a Finder window into the VDTemp folder. You should see four documents in the folder:
If you double click on the Index.rtfd document, it should open in TextEdit as a Rich Text document containing the content of the page named VoodooPad from our LinksAndPages.vpdoc VoodooPad document.
Notice that all of the links that were present on that page in LinksAndPage.vpdoc are present here, but though they look like links, they're not. That's because TextEdit doesn't support links between TextEdit documents.
Instead of creating a single document with an arbitrary page order, VoodooPad creates a set of documents, one for each page, in a folder. You can reorder them and print them in any order you desire, rather than having an arbitrary order forced on you.
When you've examined those pages sufficiently, throw them in the trash (or drag them to some other folder) to clear the VDTemp folder for our next experiment.
h3. Exporting as Plain Text
Next, let's try exporting as plain text. Once again, click on the LinksAndPages.vpdoc to make it active. This time choose File->Export->Export as Text files... Once again navigate the resulting Save File sheet to our VDTemp folder and click the Export button.
Go back to the Finder window (or open a new one) in the VDTemp folder. Notice now that we have four files named the same as before, except this time they have the .txt suffix. Let's double click on Index.txt to open it again in TextEdit and examine its contents.
This time we see the same content that was in our Index page, but all in the same font with no font styles and no apparent links, not even simulated links. This should not be a surprise, since this was created as a plain text document. So if your only interest is in the content of your pages without regard to any formatting, this would be the appropriate export method.
h3. Exporting as XML
Once again, clear the VDTemp folder for our next experiment. This time, choose File->Export->Export as XML..., navigate the Save File sheet to the VDTemp folder and click Save. When we go back to our Finder window in VDTemp, we have a small surprise. Instead of four files, one for each page in the original document, we only have a single file named after the VoodooPad document and suffixed with ".xml".
Double clicking on this file could lead to various results depending on what applications you've installed that can open XML files. To make your results predictable so we can examine the file together, first open the TextEdit application (if it's not already open) and from its File menu, choose File->Open. Navigate the resulting File Open dialog box to our VDTemp folder and open the LinksAndPages.xml document.
It's beyond the scope of this tutorial to delve very deeply into what we're seeing here. It's legitimate XML, so if you're familiar with the XML format, the content of this open file might make some sense to you. For our purposes, it's sufficient to expose the file and add that this method of export works for at least two purposes:
* to take a backup of our LinksAndPages.vpdoc document from which a new version, identical to the one we saved here, can be reconstituted.
* to provide a human and machine readable back up file that can be meaningfully examined by humans and can be parsed by other applications for reasons we haven't even considered yet.
If you are a developer and have worked with XML formatted files, you'll recognize from this latter point that XML provides a medium for generated documents that may be directly imported into VoodooPad.
h3. Exporting to Your iPod
If you don't have an iPod, you can skip this section, but if you have one, then plug it in.
Once your iPod shows up in the Finder, choose File->Export->Export to iPod. Once this command has completed, eject your iPod and navigate using the scroll wheel to Extras->Notes. Next you will see the name of your document listed, and when clicked on using the scroll wheel, you'll see your index page show up on the pod, with links! To move around through your document on the iPod, use the scroll wheel to move up and down.
You will notice that sometimes a link has a dark underline, while all the other ones have a light grey underline. When a link is dark, you can use the iPod button in the middle of the scroll wheel to move to that page on your iPod, just like you would when clicking on a link in VoodooPad.
h3. Exporting to the Web
For our final exporting exercise, choose File->Export->Web Export... which will display the Web Export Manager panel. On this panel, choose RTFD in the Export Format popup menu. Next, click the Choose... button to the far right of "Output directory:". When the Open dialog sheet appears, navigate it to our VDTemp folder and click Open. Leave the rest of the panel controls as they were and click the Export button. When you see the phrase, "Finished exporting" to the far left of the three buttons, Reset, Close and Export, then click the Close button.
Go back to the Finder window (or open a new one) in the VDTemp folder. Notice that we have four files, as before, but this time with ".html" suffixes. If you double click on index.html, a page should open in your web browser with the content of our Index page showing links. If you click on any of the links, it should take you to the page comparable to that page in VoodooPad.
It's important to recognize that though we are seeing the same content and clicking links with the same functionality, we are doing all of this in a web browser and using .html files, not the VoodooPad document. If we made a change to our VoodooPad document at this point, we wouldn't see the corresponding change in the web browser unless we exported again into the same folder.
In fact, while keeping our web browser open, let's do that. Go back to our work area in VoodooPad and click on the Home button in the Toolbar. On the Index page, add the following indented line to the bottom of the page.
p{padding-left: 20px;}. This is a line not yet reflected in our web pages.
and click the Save button in the Toolbar. The line is now saved in our VoodooPad document, but should not be seen in our web version. To confirm that, let's go back to the Finder window and double click on the index.html file to reopen it in our web browser. The page that opens should be our Index page, but there should be no indication of the last line we added. Once again, keeping the page open in our web browser, go back to the Work Area in VoodooPad and choose Web export...
The Web Export Manager panel should already be set up the way we want it, but to be sure, check that the Output directory is our VDTemp folder. Now click the Export button. When you see the phrase, "Finished exporting" to the far left of the three buttons, Reset, Close and Export, then click the Close button.
Now if we go back to our web browser page and click the Reload button which looks like this in Safari:
...then we should see the last line appear. In other words, we've just updated our little local web site with the new content from VoodooPad.
The other settings for web exporting in the Web Export Manager panel can be found in the VoodooPad manual under the Help menu.
Exporting to the Web makes our document easier to distribute widely than the printed page. It is easily reviewed by anyone who has a web browser, and today, that includes nearly everyone using computers. Finally, it retains its dynamic organization of pages, in which each page is related to the others through hyperlinks rather than through some sort of simulated physical proximity.
h3. Importing
Now that we've seen how to get information out of a VoodooPad document in several different formats, the next natural concern is how to get information into the document. The most obvious answers, of course, are to do what we've been doing, that is, type or paste the information in. However, we have other options, including:
* importing files
* dragging text
* dragging pages
On to Editing TextVoodooPad: Pluginsurn:uuid:40de692c-e33c-01d9-12a1-c0cbe4c4d9e7:242007-07-17T11:03:49Z2005-06-22T09:39:51Zh2. Extra plugins you can have for VoodooPad
The plugin interface for VoodooPad is accessed via the Plugin menu. Plugins have files named *.vpplugin and are installed by selecting the VoodooPad application file (.app) in the Finder, executing the Get Info command from the File menu, opening the Plugin section, hitting Add, and selecting the plugin file from the dialog box. Then when VoodooPad is closed and reopened the plugin command will appear in the Plugin menu. <!-- The following isn't true.. not sure where this idea comes from... Note that when you update VoodooPad to a new version, your plugins are not carried along, so you'll need to keep them and install them again when you update the application file. -->
( If you would like to know about developing plugins for VoodooPad, please visit the Plugin Development page. )
h3. Script Plugins:
Check out the Script Plugins page for information on how to build and install quick plugins. Visit Lua Plugin Snippets for examples.
The View Document plugin opens up a window with a paginated view of your entire document, which really isn't all that useful by itself. However- you can then bring up the print panel, and choose "Save As PDF" to get a PDF of your entire document. That's cool and useful.
The source is available for hacking on as well:
http://flycode.googlecode.com/svn/trunk/voodoopadplugins/documentview/
The Python Plugin Enabler is a simple VoodooPad plugin that lets you write additional plugins .. in python. Just double click it and it will install examples in:
~/Library/Application Support/VoodooPad/Script PlugIns/
This plugin was written by Jonathan Wight of "Toxic Software":http://www.toxicsoftware.com/ . Support questions should go to gus@flyingmeat.com however.
Extract Images will add a plugin that will let you extract all the images in a page to the place of your choosing. Actually- it'll extract any file attachment in there, but you've probably only got images in. OS: 10.3.5+
The Hot Key plugin lets you assign a hot key to VoodooPad, which when pressed from any application will bring VoodooPad to the front. It is very useful for people who like to take down notes quickly. OS: 10.2.8+
HTML Tools provides a preview window for interpreting the current page as HTML. It also provides an option to view the page as rendered Textile or Markdown, as well as an option to copy the selected text as HTML. OS: 10.4+
h3. Script Stuff
Script Stuff provides two actions under the Script menu. The first on is "Execute as AppleScript", which will take the contents of the current page and run it like you would in ScriptEditor. The second function is "Format as Python", which will take the front page and colorize it like it is a python script. Make sure the preference "Allow manual underlining and font color changes" is enabled first. OS: 10.3.5+
Random options that should probably be in VoodooPad. OS: 10.4.3+
* "New Current Date Page" This creates a new page (and inserts a link at the current position) in the format of 2005.01.31 (for January 1, 2005)
* "Select Line" selects the current line
* "Select Paragraph" selects the current paragraph
(Available for VoodooPad 2.5 on the Lua Plugin Enabler page. VoodooPad 3.0 and later includes the Lua Plugin Enabler by default)VoodooPad: Andy's Blog Engineurn:uuid:2fa9d30e-6e27-01db-01a0-c0cbe4c4ec54:212007-07-16T12:49:34Z2006-11-06T22:14:12Zh2. Andy's Blog Engine
These are a couple of script plugins, for using the current document as a blog engine. To install... well, I should add some links to install them.
h3. Usage:
Bear in mind that these scripts don't do any rendering. That is done during the Web Export. Because these scripts utilize the page meta function; they will only work in VoodooPad Pro.
I have a line in my postflight script that changes the name of the rendered file @home.html@ to @index.html@. If you change the variable @homePageName@ from @home@ then this line will need to change as well.
To see what this looks like in action check out the site I'm doing for my son's "Boy Scout Troop 262":http://troop262ps.org/ . Please bear in mind this is a work in progress. I could point you to my business site, but I don't want to use this as a forum for advertising. ;-)
Neither of these scripts has any data that are specific to any VPP document. I did this so that if you have multiple VPP documents that you are using as a CMS for a blog then the only thing that needs to be done is creating the "HomepageMeta" page in each document for the data.
h4. Meta Markup
* This script is used to *mark* the pages whose content will be placed on the "home" page.
* It does this by adding several page meta tags. Personalizing these tags for your document will be necessary.
* If you aren't using @Markdown@ markup then you should set @isMarkdown = "0"@
* This is where you set the location of Desktop folder that you write out the @atom.xml@ file. If you don't want it to be on your Desktop then you need to make changes in the other script.
* baseURL is the location of your blog page.
* homeURL is the index page of your site.
* categoryId is the name of the VoodooPad category that you want all the "posts" to go in.
* outdir is will be a folder on your Desktop at ~/Desktop/outdir
*Set your data in a new document page named "HomepageMeta". It will be in the following format.*
* This is the script that does the work.
* It will find all the pages that you have marked using the *Meta Markup* script and concatenate their content.
* It will then place this content on a newly created page in the document named "home". You can change this name but you'll need to do it in this script.
* I've tried to keep most, if not all, the personalized data out of this script.
* I now make an Atom feed that converts relative URLs to absolute URLs, but only in the feed.
*Make Homepage & Feed* script
<carea class="textareaCodeLarge">--[[
VPLanguage = lua
VPScriptSuperMenuTitle = Blog
VPScriptMenuTitle = Make Homepage & Feed
VPEndConfig
]]
--Written by Andy Fragen <andy@thefragens.com>
--with lots of help by Gus Mueller. :-)
function xmlEscape(str)
str = string.gsub(str, "&", "&amp;")
str = string.gsub(str, "<", "&lt;")
str = string.gsub(str, ">", "&gt;")
return str
end
atom = string.replace(atom, "$baseURL$", baseURL)
atom = string.replace(atom, "$blogTitle$", blogTitle)
atom = string.replace(atom, "$authorName$", authorName)
atom = string.replace(atom, "$homeURL$", homeURL)
if isMarkdown == "1" then
content = content:string()
content = vp.formatViaMarkdown(content)
document:createNewVPDataWithKey(pageDate)
pageTemp = document:pageForKey(pageDate)
attributedString = pageTemp:dataAsAttributedString()
attributedString:objc_mutableString():setString(content)
pageTemp:setDataAsAttributedString(attributedString)
if feedEntry == nil then
feedEntry = template
else
feedEntry = feedEntry .. template
end
--end Atom feed
end
atom = atom .. feedEntry
all:objc_mutableString():appendString(postTagClose .. "\n")
if isMarkdown == "1" then
document:deleteItemWithKey(pageDate)
end
count = count + 1
if count >= maxPosts then
break
end
end
end
atom = atom .. "\n</feed>"
--write out homepage
page = document:pageForKey(homePageName)
page:setDataAsAttributedString(all)
--write out atom feed
os.execute('mkdir -p ' .. outdir)
file = outdir .. "/atom.xml"
fd = io.open(file, 'w')
fd:write(atom)
fd:close()
--os.execute("open http://srv.local/xxx/")
vpconsole("Homepage and Atom feed created.")
</carea>
Much thanks to Gus. I couldn't have completed this without his time responses to my constant pestering. :-)VoodooPad: Andy's Web Export Category Moving and Sitemap scripturn:uuid:e5c0b6b8-33d3-01dc-07c7-c0cbe4c49166:22007-07-16T12:36:50Z2007-07-16T12:36:50ZDescribe Andy's Web Export Category Moving and Sitemap script here.VoodooPad: Andy's Fix Relative Linksurn:uuid:440fe13e-7a5d-01db-029e-c0cbe4c4a87e:82007-07-16T12:33:04Z2006-11-22T11:11:33Zh2. Andy's Fix Relative Paths script
This is a little shell script that will traverse a VPWebExportOutputDirectory and convert any <code>./</code> into <code>../</code> in any <code>*.html</code> files that it finds.
h3. Usage
Make this script executable and put it in your web export plugin and reference it in the Info.plist as a postflight script.
h4. fixRelativePaths.sh
<carea class="textareaCode250">#!/bin/bash
# A script to fix the relative URL for folders one level deep
# for use in web export plugin
# written by Andy Fragen <andy@thefragens.com>
for i in `find $base -type d -mindepth 1 -maxdepth 1 -name '*' -print`; do
for F in `find $i -type f -maxdepth 1 -name '*.html' -print`; do
mv $F $F.tmp ;
sed 's_"\.\/_"\.\.\/_g' $F.tmp > $F ;
rm $F.tmp ;
echo $F
done
done
An alias in VoodooPad is a way to assign certain words or phrases to another page. For instance, if you have a page named "Pizza" and you would also like the words "Pizzas" and "Italian Pie" to link to the Pizza page, you would make an alias to it. Here's how:
First bring up the Pizza page, and then choose "Page and Document Inspector" from the Window-&gt;Palettes menu. A window will come up that looks like this:
p=. !$imagesDir$/voodoopad/pizza_alias1.png!
Press the " + " button on the bottom left, and then enter "Pizza". Press the " + " button again, and enter Italian Pie.
p=. !$imagesDir$/voodoopad/pizza_alias2.png!
Next, bring up another page such as the index page. Type in either "Pizzas" or "Italian Pie". The word(s) will highlight and when you click on them you will be taken to the Pizza page.VoodooPad: Advanced Text Editingurn:uuid:f9a2d632-ccbb-01da-0dd7-c0cbe4c4d793:72007-07-15T11:32:44Z2006-04-15T13:11:08Zh2. Advanced Text Editing
In our last topic, we demonstrated that VoodooPad shares the flexibility of the Mac OS X Text System as represented in TextEdit. However, VoodooPad provides text editing features beyond that basic set, features such as tables, flexible bullet lists, more sophisticated line and paragraph spacing, highlight colors and a convenient margin shift capability for more convenient outlining.
h3. Tables
Let's open a new VoodooPad document by pressing Cmd-Shft-n, select everything in the window and delete it all with the delete key for a blank page.
Now enter a title, such as "Comparing Apples and Oranges" at the top of the document followed by two blank lines. You can do this by typing the title in, or by copying it from the previous sentence and pasting it in. Instead, let's drag the text to the new window.
To do this, double click on the word "Comparing" in the first sentence of the last paragraph, drag to the work "Oranges" and release the mouse button. Then click and hold the mouse within the selected text until the mouse pointer changes from an insertion bar to an arrow, then drag the selected text to the new blank VoodooPad window. Be sure to leave a couple blank lines after this title.
Next, let's add a 4 row X 2 column table to our document. Choose Format->Table... from the menu bar and notice that two things happened when you did so:
* a 2 row X 3 column table was inserted into our document at the insertion bar
* a table control panel was displayed to help us configure the table
Since this is not quite the table configuration we wanted, let's change it. While the table is still selected, click on the Table control panel, change the rows to 4 and the columns to 2. You can do this either by selecting the "2" and pressing the 4 key, or by clicking twice on the up arrow immediately to the right of the Rows text field. When you've changed the Rows field, select the "3" in the columns field and type in 2, or click once on the down arrow immediately to the right of the Columns text field.
If the table hasn't changed its configuration, be sure that you've selected any cell of the table and that the window containing the table is the frontmost window. You can confirm this by noting that the three buttons in the upper left corner of the table are colored while you're changing the table's configuration.
Now let's enter some values into the table. In the top row, type "Fruit" in the left column and "Desirability" in the right. In the three rows of the left column under the heading "Fruit", type: "apples", "oranges" and "bananas". In the right hand column, type "7", "8", "10".
You've probably heard that it's not possible to compare apples to oranges. With VoodooPad, we quite often do what other's have found difficult to impossible. We've gone one better, in this case, and included bananas in our comparison. But what if you don't like the desirability levels we've chosen. Hey, it's your VoodooPad document; change the values to suit you. Just because we believe bananas to be the perfect fruit doesn't mean that you have to agree.
However, our goal here is to learn VoodooPad's special editing characteristics, so let's go back to making our page look better. To do that, first select the page title and press Cmd-t on the keyboard to bring up the font pallette. Then select some sans serif font in the "Family" column of the font table, such as Helvetica, click "Bold" in the Typeface column and either enter "18" in the size text field, or click on 18 in the column below that text field. Close the font pallette and while the title is still selected, choose Format->Text->Center (or just press the Cmd-Shft-| keys).
Next we want to center the numbers in the desirability column. To do that, let's make use of a little known trick in the Mac OS X text repertoire: column selection. To select a column, hold down the Option key as you click and drag the mouse from the top left of the first number to the bottom right of the last number in the desirability column.
As you do this, notice that only the bottom right three cells of the table are selected, which is exactly what we wanted. Now click on the Center alignment tab in the table control panel, which looks like this:
Let's next click and drag across the two heading cells at the top of the table to select the words "Fruit" and "Desirability" simultaneously. Then click on the Center alignment tab in the table control panel again and press Cmd-b to make both words bold. You wouldn't actually need to select both words to center them in their cells as long as some part of each of the two cells is selected. However, we needed the words selected to make them both bold.
To illustrate the flexibility of tables in VoodooPad, click anywhere in the table and increase the row count in the Table control panel from 4 to 5. Notice that a new row has been added to the bottom of the table. Next, we want to select the bottom two cells. The easiest way to do that is to double click in one of the cells of the new row and drag through the other. Then click the Merge Cells button in the Table control panel.
We should now have a single cell at the bottom of the table that spans the table width. Click in this new cell and type "* mostly cloned", and suffix the word, banana, above with an asterisk. FlyGesture: How to Purchase and Registerurn:uuid:53ca49ec-177c-01da-112c-c0cbe4c4e838:62007-07-03T11:01:35Z2005-08-27T21:29:31Zh2. How to Purchase and Register FlyGesture.
You don't have too anymore - it's free!FlyGesture: Start Pageurn:uuid:4982c326-c72a-01d9-07fe-c0cbe4c4e873:202007-07-03T11:01:17Z2005-05-17T16:20:42Zh2. FlyGesture
* About FlyGesture
Find out what Flying Meat's FlyGesture is all about.
* How it Works.
Find out what makes FlyGesture tick.
* Movies
Watch FlyGesture in action.
* Frequently Asked Questions
Do you have a question that needs to be answered? VoodooPad: Web Exporturn:uuid:33e3c704-3124-01da-160e-c0cbe4c4be5d:232007-05-25T15:03:33Z2005-09-29T13:04:12Zh1. Web Export
Web Export is a new feature in VoodooPad 2.5. It allows you to export your document as HTML files, with options for marking up the pages as Textile, Markdown, or just treating it as plain text.
In addition, you are given the opportunity to specify "Web export plugins" to apply special formatting with the export.
Here's a quick rundown of the various options available in the Web Export window.
*Export format*: This is the format that you would like the text in your VoodooPad pages to be written out as.
* RTFD to HTML is probably going to be the most used option- it tries to match exactly what your pages look like on output.
* No Markup exports your pages as-is. No attempt is used to try and interpret any formatting in the pages.
* Plain Text exports the pages without any special formatting, or images, but does format for line breaks.
* Interpret as Markdown exports your pages using a popular text to HTML formating script. For more information on Markdown please visit http://daringfireball.net/projects/markdown/
* Interpret as Textile exports your pages using another popular text o HTML formatting script. For more information on Textile, please visit http://www.textism.com/tools/textile/
*Output directory*: This is the folder where the html files and images are written to.
*Web export plugin*: You may select a specific plugin to be used to provided extra workflow options, or template for exporting. These plugins are located in your "~/Library/Application Support/VoodooPad/Web Export PlugIns" folder.
*Preflight script*: This is a unix script (or application) that you may choose to be run before the actual export is taken place. This is useful if you want to create resources such as folders or supporting files to manage your workflow.
*Postflight script*: This follows the same idea as the preflight script, but is run after the export has taken place. For example, you could use this to automate the uploading of your html files and images to a server.
*Preset*: If you spend a little bit of time and energy into setting up what scripts need to be run, and what folders you want everything to be exported to, then you might want to save those setting for use at a later time. That's what this setting is for. Use the + button to add or modify a preset, use the - button to remove a preset.
*Reset button*: This resets all the export options to their default state.
*Close button*: This closes the Web Export window.
*Export*: This kicks off the export, and progress is updated via a label in the lower left corner of the window.
<br/>
h2. Special Pages:
The Web Export feature allows you to create special pages within your VoodooPad document, which supply additional information, scripts, or templates to be used alongside whatever plugin is used for export.
WebExportPreflightScript: This page will be executed like a normal shell script, and is called at the beginning of the export.
WebExportPostflightScript: This page will be executed like a normal shell script, and is called at the end of the export.
WebExportProperties: this page will be written to meta.xml, so you can place config information in here if it is needed.
WebExportPageTemplate: this page will override the template given in the selected plugin.
That'll include the page named "header" in your document.
h2. Special Variables.
<pre>$page$</pre> This will be replaced with the contents of the page.
<pre>$alias$</pre> This will include the first alias you have for a page.
<pre>$alias[0]$</pre> This will also include the first alias you have for a page.
<pre>$alias[1]$</pre> This will include the second alias you have for a page.
<pre>$alias[2]$</pre> The third alias for a page...
<pre>$alias[x]$</pre> Etc... (you get the point).
<pre>$displayName$</pre> This will insert the page name. ($title$ works as well, but is deprecated).
<pre>$categories$</pre> This will list the categories the page is in.
<pre>$documentName$</pre> This will include the document name, with the .vpdoc extension
<pre>$documentTitle$</pre> This will include the document name, excluding the .vpdoc extension
<pre>$year$, $modifiedYear$, $shortDate$, $longDate$, $time$, $shortTime$,
$timeDate$, $modifiedShortDate$, $modifiedLongDate$, $modifiedTime$,
$modifiedShortTime$, $modifiedTimeDate$</pre> These will list the dates in various formats, for both the create date, and last modified dates.
h2. AppleScript
Web Export can be controlled via AppleScript. Below are a couple of examples doing this.
<carea class="textareaCode">
tell application "VoodooPad"
tell document 1
web export to "/tmp" with properties {fileExtension:"php",
postflightScript:"/path/to/some/script.sh",
preflightScript:"/path/to/another/script.sh"}
end tell
end tell
tell application "VoodooPad"
tell document 1
web export using conversion format plain text with properties {fileExtension:"html",
preset:"to markdown folder",
pluginName:"GMDC Blog Layout"}
end tell
end tell
</carea>
h2. Automator
There are a couple of Automator actions for invoking Web Export in VoodooPad. Launch Automator and you will see them listed if you have installed VoodooPad.
<br/>
h1. Information for advanced users or plugin developers.
h2. Export / Script Execution Order
The following steps are what takes place when you press the "Export" button in the Web Export window. The hope is that this information will be useful for anyone wanting to make a plugin, or for advanced uses.
1. Preflight script specified in the export window is run.
2. WebExportPreflightScript page, if available, is run.
3. Preflight script(s) specified in the "PreflightScripts" array of the plugin's Info.plist file are run.
4. Pages are exported to output directory.
5. meta.xml is written out to the output directory if the boolean key "WriteMetaInfo" is set to yes in the plugin's Info.plist
6. Category files are written out.
7. Postflight script(s) specified in the "PostflightScripts" array of the plugin's Info.plist file are run.
8. WebExportPostflightScript page, if available, is run.
9. Postflight script specified in the export window is run.
h2. Shell Script Environment Variables:
These are environment variables that VoodooPad exports, for use in pre and postflight scripts.
VPWebExportOutputDirectory: The directory the files are written to.
VPWebExportVoodooPadDocument: The document that is being exported.
VPPluginPath: The path to the web export plugin that is being used.
h2. Plugin Info.plist keys
These are the various keys you should have defined in the plugins Info.plist file. This is really only of any use if you are wanting to write a Web Export plugin.
*NSExcludedElementsDocumentAttribute* - An array with items to exclude for the apple rtf->html converter. Values are given on this page: http://developer.apple.com/releasenotes/Cocoa/AppKit.html (search for NSExcludedElementsDocumentAttribute) 10.4 only.
*DisplayName* - what shows up in the pulldown list for the plugin.
*PrincipalTemplate* - the path to the html template to use when exporting.
*PreviewImage* - the path to a png image, which will be used for a preview in the WebExport window.
*PreflightScripts* - an array of paths, pointing to scripts to be run before the export takes place.
*PostflightScripts* - an array of paths, pointing to scripts to be run after the export takes place.
VoodooPad: New in 3.2urn:uuid:20f83654-03df-01dc-1cdc-c0cbe4c4ad6b:52007-05-24T16:59:29Z2007-05-16T11:56:18Zh2. New in VoodooPad 3.2:
h3. View Categories as Tags.
Lots of people have been wanting the ability to view the assigned categories as "tags". Well, now you've got it. Just open up the category palette, and use the cog-widget in the categories list to change the view as "tags".
h3. Page Previews.
Holding down the command and control keys while hovering over an interal VoodooPad link gives you a preview of the linked page. This is awesome if you want to be able to see the first couple of lines of a page, but don't want to open it up.
h3. Drag and Drop Linking Between Documents.
You can now drag and drop a tab from one document to another to create links. It's a super easy way to have inter-document links.
h3. Copy Link to Item Command
We've got a new command- Edit-&gt;Copy Link to Item, which will copy text to the clipboard which you can use to link to the specific page. This will work for any applications that respect the NSLink attribute in rich text.
h3. Link to Specific pages
You no longer need to setup aliases to link custom text to pages in your document. Select some text and choose "Link selection to item" in the Edit menu, and away you go.
h3. Other Stuff
Now using Sparkle to do updates of the application, no longer removing custom link attributes, bug fixes, you can view embedded web archives, improved searching, and more. test: Start Pageurn:uuid:98230ce6-c019-01da-19cb-c0cbe4c4d0ff:32007-05-23T14:58:36Z2006-03-30T10:18:32ZLD
it's my home
not mine...
(To open up the Categories window, choose the Window->Palettes->Categories menu item)
VoodooPad has the ability to assign different categories to a specific page in your document. What this means is you can create a category named "Food" and then assign this category to the pages "Cupcake recipe", "Dinner Ideas", and "The Cake".
And pages can belong in multiple categories as well. For example, say we have a "Wedding" category and then assign the pages "Guest List", "Reception Info", and "The Cake" to it. Notice that "The Cake" is in the Food category as well.
This is an easy way to organize pages in VoodooPad document according to topics.
p=. !$imagesDir$/voodoopad/categories_list.png!
*Tip:* To rename a category, hold down the option key and double click its name in the listing view.
h2. Categories as Tags
You can also view the categories for an item as "tags". To switch to this view, click on the widget in the top right corner of the categories list, and select "View as Tags":
Here are a list of keys that you can use to activate certain tools or features, just in case your hands don't feel like moving away from the keyboard.
"0,1-9" Pressing the number keys will cycle the canvas through various levels of transparency.
Here are the various key commands to change the current tool:
"V" Selection arrow.
"C" Oval.
"L" Line.
"R" Rectangle.
"E" Round Rectangle.
"T" Text.
"F" Freehand Sketch.
"H" Highlighter
Command-C copies the current canvas, or the current selection if any.
Command-V pastes
Command-Shift-E will export the canvas as an image.
*FlySketch 1.5 Only:*
* Option-drag in a color well to change the level of opacity. Move up to make it opaque, move down to make it transparent.
* Command click in a color well to bring up the standard color picker.VoodooPad: Quicksilver Append to VoodooPadurn:uuid:4af589d2-5834-01da-05df-c0cbe4c4bc81:102007-03-04T07:18:47Z2005-11-18T05:07:38Z[AUTHOR UPDATE (MARCH 2007): This script is no longer necessary for appending to QS. If you want easy prepends and appends (and more!) for QS, go grab the Voodoopad plugin for QS, which has a great deal more functionality and is likely coded far better.]
This is a script allowing appends to a number of VoodooPad pages from Quicksilver using a keyword at the beginnning of an entry. I use it for quickly adding information on the fly to any of a number of lists without switching window focus and not maintaining several text files.
It's here in case anyone else might find it (or parts of it) useful.
Please feel free to make changes if you have ideas or can improve on my limited scripting ability.
<carea class="textareaCodeLarge">
--Quicksilver Append to VoodooPad.scpt
--Version 0.21 (2005-11-16)
-- IMPORTANT: This script MUST be modified in at least one place for it to work successfully. At a minimum, the values of the VPDoc and VPDocPath variables defined below must be modified to point to an existing VoodooPad file and its full path. Additionally, the triggers and pages in the big if block below should be modified to suit the particular desires of the user. Note that the page targets defined in the if block below must exist when the script is invoked. If they do not, data sent to those pages will be lost. At a bare minimum, the user should add a "Log" page to the target VoodooPad document to catch default log entries.
-- Purpose: This script works with the applications VoodooPad from Flying Meat Inc. and Quicksilver from Blacktree, Inc. Both must be installed for the script to work. It links the two to allow rapid-fire appends to VoodooPad pages by using a keyword of one or more letters at the beginning of a Quicksilver input string.
-- Installation: The script should be installed in a scripts folder. Note, however, that the script does not work if called directly from the scripts menu; it only works when invoked via Quicksilver with a "Process Text" action. Setting up a Quicksilver trigger that calls the script plus a "Process Text" action to allow one-keystroke access to the append command line is recommended.
-- Usage: The text input expected is a keyword plus a text string to add to the page. In the if block below, Quicksilver input string of "gr ice cream" would add "ice cream" to the "Groceries" page in Quicksilver. This generally occurs in the background without distracting the user from the current work. If a keyword is used by itself as input, however, it brings the corresponding VoodooPad page to the front of the current windows for input. If no keyword is recognized, the entire text is appended with a timestamp to the "Log" page.
-- Declare globals
global InputKeyword, InputString, VPDocPath, VPDoc
-- Grab the input string from Quicksilver.
using terms from application "Quicksilver"
on process text QSInputString
-- The following global variables point to the VoodooPad document to which Quicksilver should append, and that VoodooPad document specified with its full path. They should be changed by the user to match their preferred VoodooPad document and path.
set VPDoc to "main.vdoc"
set VPDocPath to "BB HD:Users:sample:Documents:VoodooPad:main.vdoc"
-- Copy Quicksilver input string to global InputString. The first word of InputString is InputKeyword which will be tested in the big if block below, and clipped (if specified) in the VPAppend handler.
set InputString to QSInputString
set InputKeyword to first word of InputString
-- The big if block. Essentially, it tests InputKeyword against lists of possible keywords for a particular page or list, and calls VPAppend with parameters matching how that list should be treated. The syntax is pretty straightforward: the list of strings in brackets in the if-clause are all the possible keywords that will trigger sending the input to the page specified in the PageName parameter in the then-clause. If a keyword is used in two different if clauses, the first clause will be the destination.
-- ClipKeyword: Calling the handler with ClipKeyword will remove the first word from the input string before appending (so lists do not have various abbreviations before each entry if not desired).
-- LogStyle: Calling the handler with LogStyle will append a full date and timestamp before the input string for time-sensitive entries.
-- IMPORTANT: The page specified in PageName MUST already exist in the target VoodooPad document. Entries will be lost if not.
if InputKeyword is in {"g", "gr", "gl", "groceries", "groc", "food"} then
VPAppend with ClipKeyword without LogStyle given PageName:"Groceries"
else if InputKeyword is in {"id", "idea", "ideas"} then
VPAppend with ClipKeyword without LogStyle given PageName:"Ideas"
else if InputKeyword is in {"ln", "link", "links"} then
VPAppend with ClipKeyword and LogStyle given PageName:"Links"
else if InputKeyword is in {"n", "note", "notes"} then
VPAppend with ClipKeyword without LogStyle given PageName:"Notes"
else if InputKeyword is in {"s", "sc", "scr", "scratch"} then
VPAppend with ClipKeyword without LogStyle given PageName:"Scratch"
else if InputKeyword is in {"w", "wishlist", "wish"} then
VPAppend with ClipKeyword without LogStyle given PageName:"Wishlist"
else if InputKeyword is in {"log", "l"} then
VPAppend with ClipKeyword and LogStyle given PageName:"Log"
else
-- Default action: if the first word of the input string is not recognized as a keyword, prepend "log" to the input string so that it is processed by the VPAppend handler as a log entry, then call the VPAppend handler. The prepend is necessary so that input of a single non-keyword doesn't automatically bring up the log.
set InputString to "log" & space & InputString
VPAppend with ClipKeyword and LogStyle given PageName:"Log"
end if
end process text
end using terms from
-- VPAppend handler. Takes the string PageName to which input should be directed, plus booleans LogStyle and ClipKeyword to define how the input string should be modified. Actions of LogStyle and ClipKeyword are described below.
on VPAppend given PageName:PageName, LogStyle:LogStyle, ClipKeyword:ClipKeyword
tell application "VoodooPad"
-- Check to see whether document is already open. If not, open it.
if not (exists document named VPDoc) then
open VPDocPath
end if
-- If only nonwhitespace and nonpunctuation input is the keyword, then bring document to the front for input, open corresponding page, move cursor to the bottom of the page, and return
ignoring white space and punctuation
if InputKeyword is InputString then
tell application "Finder" to activate document VPDoc of application "VoodooPad"
open page document VPDoc with title PageName
-- This is a little hack to deal with VoodooPad's placing the cursor at the bottom of text on pages with 100 characters or fewer, but at the very top of all text on pages with more than 100 characters, when "open page" is called. This sends a Command-DownArrow to the page to place the insert point at the bottom of the page. Replacing "ASCII character 31" with "ASCII Character 30" below would cause the cursor to be placed at the top of the page, if that is preferred.
tell application "System Events" to keystroke (ASCII character 31) using command down
return
end if
end ignoring
-- Process ClipKeyword: If true, delete the keyword from the append string (i.e., get second word through to the end of the string).
if ClipKeyword then
set AppendString to text from word 2 to last word in InputString
else
set AppendString to InputString
end if
-- Process LogStyle: If true, prepend timestamp to the string
if LogStyle then
set AppendString to short date string of (current date) & space & time string of (current date) & ":" & space & AppendString
end if
-- Finally, append the text and a return character to the selected page.
append text AppendString & return to page PageName of document VPDoc
end tell
end VPAppend
</carea>VoodooPad: Triggersurn:uuid:96d13fbc-ed3b-01da-126a-c0cbe4c4d8a1:142007-03-03T18:07:02Z2006-05-26T21:45:15Zh2. Triggers
A VoodooPad Pro only feature- triggers are a handy way to script VoodooPad when certain events occur, such as a new page being created or deleted, documents opening or closing, files being written on web export and more.
*Note*: triggers are written in a scripting language named Lua, and a little bit of programming experience is required. You can find out more about Lua from http://www.lua.org/ .
The easiest way to learn triggers is to create one. Start off by creating a new page named "New Page Trigger", and delete all the text on the new page so we have a clean slate to work with. Next, just copy and paste this quick script:
pre. newPage = triggerDictionary.item
vpconsole("we're creating a new page named " .. newPage:displayName())
What this script does is print out the name of the new page in the VoodooPad console. Next we need to assign this script to an event in VoodooPad. So bring up the Page and Document Inspector (under the "View" menu) and switch to the Triggers tab. Select the event "Page opened" for the "On event:" label, and then press the plus button at the bottom of the window to select our new page:
Now try creating a new page in VoodooPad named "random". You should see the text "we're creating a new page named random
" pop open in a little window. Go ahead and delete the random page, and let's take a look at this script with a little more detail.
pre. newPage = triggerDictionary.item
Every trigger that is executed has a couple of global variables setup automatically. One of these is named "triggerDictionary". This dictionary contains values that can be of use when your triggers are being run. An easy way to find out what all the values in the dictionary are is to use this simple line that will print out the keys in the dictionary:
pre. table.foreach(triggerDictionary, vpconsole)
So in the first line of our example, we are assigning the value "item" of the trigger dictionary to a new variable named "newPage". This represents the page that has just been created.
The next line simply prints out some text with the name of the page to the console:
pre. vpconsole("we're creating a new page named " .. newPage:displayName())
The two dots (..) is how Lua concatenates strings together, so we get a single line of text that we send to the console. the newPage:displayName() bit calls a method named "displayName" on the new page object. A couple of other methods that we could call are "modifiedDate", "createdDate", "key", "type". There are more, but we won't get into those right now. Instead, let's spice up our example a little more.
Next, we're going to take the contents of our new page and modify them a little bit by adding the current date to it. There are a couple of easier ways we could do this, but for this example let's just pretend there aren't. So to start, let's go back to our "New Page Trigger" page and delete all the text there, and replace it with this:
pre. newPage = triggerDictionary.item
attributedString = newPage:dataAsAttributedString()
newString = os.date("\nThis page was created on %A, in %B")
attributedString:objc_mutableString():appendString(newString)
newPage:setDataAsAttributedString(attributedString)
What we do here is:
1: Grab the new page that's being created.
2: Grab the attributed string out of the page. An attributed string is a technical way of saying "stylized text". It is what keeps track of your bold and italic text, custom margins, and other fancy text stuff.
3: Create our date string that will will append to the end of our new page, in the format of "This page was created on Tuesday, in May"
4: Append our new text to our attributed string
5: Set that attributed string back into the page so it'll show up when we view it.
Now whenever we create a new page, you'll see that text appended to the end of it.
Other Topics:
* Trigger Examples
* "Lua website":http://www.lua.org/VoodooPad: New in 3.0urn:uuid:fafb03d4-ed49-01da-1cee-c0cbe4c4e99c:162007-01-31T18:29:17Z2006-05-26T23:28:16Zh2. New in VoodooPad 3.0:
*Tabs*
Open up multiple pages in the same window using tabs. Command click on a link to open it in a new tab, or right click on a link and choose "Open Link in New Tab". (And you can still open up pages in new windows by holding down shift-command when clicking on a link)
*Search Improvements*
Search in VoodooPad is lightning fast now, and returns results in record times.
*Support for big documents*
Stuff gigabytes of data inside a VoodooPad document, it won't mind. A new file format makes saving documents super quick as well.
*Linkback*
A user can paste content from any LinkBack-enabled application into VoodooPad and reopen that content later for editing with just a double-click. See http://www.linkbackproject.org/ for more info.
*Embed images, pdfs, and other types of files.*
The improved file format for VoodooPad 3.0 means you can embed files such as images, pdfs, mp3s, and most other types of files as well. VoodooPad also includes a new PDF Service so you can print from any application directly into VoodooPad.
*Full Screen*
Edit your pages in full screen mode, to keep you focused on the task at hand.
*Script Plugins*
Script Plugins are an easy way to extend the functionality of VoodooPad. Download new plugins or write your own.
*Palettes*
VoodooPad sheds the drawer and moves content out into easy to use palettes. Find your backlinks, pages list, categories, recently updated pages, and (new for 3.0) recently visited pages quick and easily.
*Text Styles*
A new text styles palette lets you add and apply text styles to your pages.
*Custom Shortcuts*
VoodooPad has a new preference pane where you can set and change the menu item shortcuts. So if you don't like that a certain plugin has no shortcut- now you've got an easy way to fix it!
*Merge and Split*
Merge two VoodooPad documents together using the import menu option, or split pages from a document into a new file to slim things down a bit.
*Improvements and Other New Stuff*
* Rulers stay in place now when moving from page to page.
* Smooth lines for sketch
* Clippings folder now supports RTFD files
* Sending by mail now includes images
* New Web Export date placeholders
* Upgraded linking engine recognizes CJK links without spaces, and much more.
* Copy no longer copies links that are only good to VoodooPad
* Plain text pages
* New package file format which is subversion friendly
* Double clicking an image will now prompt you to save the image to disk
* New toolbar buttons
* Window and tab states are now stored in the document
* Updates to the plugin api
* New preference to choose wether or not to use the default welcome text for new documents
* The open page panel is no longer case sensitive
* New applescript command "current page name" to get the name of the front most page
h2. VoodooPad Pro
There's a new addition to the VoodooPad family for the 5% of you who want some crazy advanced features. And here's what it has:
*Document level encryption*
Have every bit of your VoodooPad document protected by a password, and not just on a page by page basis.
*Triggers*
A handy way to script VoodooPad when certain events occur such as a new page being created or deleted, documents opening or closing, files being written on web export and more.
*Item Meta*
Assign meta data to an individual page which can be used for whatever you'd like, and access them in script plugins or triggers.
*Webserver*
A built in webserver to share your pages with friends or co-workers on your local network without any pain. Bonjour support so you don't have to hand around cryptic urls. VoodooPad: Old Versionsurn:uuid:28fc7dd0-f3e0-01d9-0161-c0cbe4c49a7b:122007-01-02T17:15:53Z2005-07-13T13:53:27ZHere are a list of links to older versions of VoodooPad, just in case you need one for some reason. However, you should always be running the latest version of VP, since it usually has important bug fixes that older versions don't have.
VoodooPad-2.5.5.dmg: http://flyingmeat.com/download/VoodooPad-2.5.5.dmg (Requires at least 10.3.9)
VoodooPadLite-2.5.5.dmg: http://flyingmeat.com/download/VoodooPadLite-2.5.5.dmg (Requires at least 10.3.9)
VoodooPad 2.1.2 http://flyingmeat.com/download/VoodooPad-2.1.2.dmg
VoodooPad Lite 2.1.2: http://flyingmeat.com/download/VoodooPadLite-2.1.2.dmg
VoodooPad 2.1.1: http://flyingmeat.com/download/VoodooPad-2.1.1.dmg
VoodooPad Lite 2.1.1: http://flyingmeat.com/download/VoodooPadLite-2.1.1.dmg
VoodooPad 2.1: http://flyingmeat.com/download/VoodooPad-2.1.dmg
VoodooPad Lite 2.1: http://flyingmeat.com/download/VoodooPadLite-2.1.dmg
VoodooPad 2.0.2: http://flyingmeat.com/download/VoodooPad-2.0.2.dmg
VoodooPad Lite 2.0.2: http://flyingmeat.com/download/VoodooPadLite-2.0.2.dmg
VoodooPad 2.0.1: http://flyingmeat.com/download/VoodooPad-2.0.1.dmg
VoodooPad Lite 2.0.1: http://flyingmeat.com/download/VoodooPadLite-2.0.1.dmg
VoodooPad 2.0: http://flyingmeat.com/download/VoodooPad2.dmg
VoodooPad Lite 2.0: http://flyingmeat.com/download/VoodooPadLite2.dmg
VoodooPad 1.1.4 http://flyingmeat.com/x/VoodooPad1.1.4.dmg
VoodooPad Lite 1.1.4 http://flyingmeat.com/x/VoodooPadLite1.1.4.dmg VoodooPad: Hidden Preferencesurn:uuid:1b17df8c-c750-01d9-0c13-c0cbe4c4e94a:132006-12-26T19:10:58Z2005-05-17T20:51:25ZSometimes preferences will be built into VoodooPad without an interface to set them. Usually these are turned on and off via the command line, invoked from within one of Terminal.app's windows. Here are a few of them:
_(If you are using VoodooPad Pro instead of VoodooPad, substitute_ *com.flyingmeat.VoodooPad_Pro* _for_ *com.flyingmeat.VoodooPad* _below.)_
h3. Print Margins.
If you want to set the margins to 1/4 inch all around, open up the terminal and type this:
defaults write com.flyingmeat.VoodooPad VPPrintMarginHack -string "{{0.25, 0.25}, {0.25, 0.25}}"
The values are for left, right, top, bottom
To remove the margin, type:
defaults delete com.flyingmeat.VoodooPad VPPrintMarginHack
h3. Setting an external editor that is not BBEdit (VP 2.1+ only)
To use "SubEthaEdit":http://www.codingmonkeys.de/subethaedit/ type this in the terminal:
defaults write com.flyingmeat.VoodooPad odbeditor de.codingmonkeys.SubEthaEdit
To use "TextMate":http://macromates.com/ type:
defaults write com.flyingmeat.VoodooPad odbeditor com.macromates.textmate
h3. Single click to open a page from the drawer (2.1.2+ only)
Quit VoodooPad, and type this in the terminal:
defaults write com.flyingmeat.VoodooPad singleClickBacklinksToOpen -bool YES
Then relaunch and you should be good to go.
h3. Keep VoodooPad from opening a new document on launch (2.5+ only)
In some cases, for example when you quit VoodooPad without an open document, VP will try to create a blank document on relaunch. Use this hidden pref to change the behavior.
h3. Show the old "Export As HTML..." menu option (2.5+ only)
VoodooPad 2.5 has a new "Web Export" engine, replacing the older HTML export options. However, if still want to use the older export options, you can bring them back with the following command:
h3. Requiring a prefix for AddressBook links. (VoodooPad 3.1+ only)
If you don't like that the AddressBook links names automagically, you can make it so it only links up when a prefix is given, such as "ab:". For example, say I would like to link to the AddressBook entry "Gus Mueller", but I wanted to have to type "ab:Gus Mueller" for the link to show up, this is what I would enter in the terminal:
FlySketch: Extra Scriptsurn:uuid:5e635a12-d1f2-01d9-0622-c0cbe4c49347:132006-12-19T10:44:10Z2005-05-31T09:38:08Zh2. ~Extra Scripts
These extra scripts can be placed in your ~/Library/Application Support/FlySketch/Workflow Scripts/ folder, to add additional actions to the Workflow Scripts toolbar button.
As always, be careful when installing applications or scripts from third parties- they may contain malicious code who's sole purpose is to destroy your computer. Any scripts downloaded from flyingmeat.com have been verified to be safe.
* "Open in Eudora" script, by Stephen Dodd
http://flyingmeat.com/fs/contrib/flysketch/OpeninEudora.sh.zip
* Upload to Flickr (10.4+ only)
Build an "Automator":http://www.apple.com/macosx/features/automator/ action you can use to upload your canvas to http://flickr.com/
* Upload to Blog
Upload an image to your weblog via the MetaWeblog API.FlySketch: Upload to Blogurn:uuid:b56efb5a-a26b-01da-08d8-c0cbe4c4f980:42006-12-19T01:13:41Z2006-02-20T15:50:45Zh2. Upload to Blog
Here's a quick workflow script written in python to upload an image to your blog.
You'll have to change the parameters at the top to your specific settings, and besides that there are a couple of other requirements:
a) Your weblog system needs to support the metaweblog api (such as movable type)
b) Your workflow image format needs to be set to "PNG"
FlySketch: About FlySketchurn:uuid:bba1c8c6-fb14-01d9-06f5-c0cbe4c4c5ff:312006-12-11T11:18:11Z2005-07-22T17:57:25Zh2. About FlySketch
FlySketch is a unique new application that allows you to draw on top of just about anything on your screen. Highlight words or paragraphs, draw shapes to help define what you want to say, and then drag and drop the results onto another application, or email it to a friend
h3. Great uses for FlySketch:
Some applications just don’t do what you want them to do. Take TextEdit for example- it’s a great writing application, but it doesn’t come with any drawing tools, and the same can be said about many applications. With FlySketch you can bring up a window without ever leaving TextEdit to create diagrams using the built in line and shape tools. And then adding your creations to TextEdit is done with only the drag of a mouse.
Or maybe you’re surfing the web, and you come across a great interface that you would like to study in detail later or maybe a picture that you know might not be around for much longer. Pop up FlySketch, use the screen capture button and tuck it away to a special “web collections” folder that you added to the workflow actions.
Workflow actions may also be created out of regular applications. Simply drag an alias of Microsoft Entourage® to the workflow folder, and when you choose its corresponding action in the workflow actions the image will be attached to a new email. You can also apply the same trick to Corel Painter®, Adobe Photoshop®, Mail, or just about any other application that allows you to drag images on to its application icon.
h3. Getting images out of FlySketch is a piece of cake.
To place an image into an application, just hold down the command key and drag on the canvas to pull the image off. Let go of mouse when you have your cursor positioned over your destination. If you would like the image to have a transparent background when pasted, hold down command-option while you drag the image.VoodooPad: Trigger Examplesurn:uuid:6e981020-ed40-01da-0879-c0cbe4c48c72:142006-12-06T15:35:48Z2006-05-26T22:19:55Zh2. Trigger Examples
*A trigger that creates a new page based on the current date when a document opens*
<carea class="textareaCode60">-- assign this to the "Document did open" event.
pageName = os.date("%Y.%m.%d", os.time())
triggerDictionary.document:openPageWithTitle(pageName)</carea>
*A simple trigger that you could use to modify the default text on a new page*
<carea class="textareaCode300">-- assign this to the "Page created" event
newPage = triggerDictionary.item
-- check and see if we are dealing with a regular page type.
-- if it's not a regular page type, then bail out on this trigger.
if (newPage:type() ~= VPPageType) then
return
end
-- we grab the contents of the page
attributedString = newPage:dataAsAttributedString()
-- using objc_mutableString() insteadof mutableString() will return an objective-c object which we can then
-- call a function on, instead of a lua string.
attributedString:objc_mutableString():appendString("\nThis is an addition to the new page text.")
attributedString:objc_mutableString():appendString("\nThis new page's name is '" .. newPage:displayName() .. "'")
-- and now we set the value in the new page.
newPage:setDataAsAttributedString(attributedString)</carea>
*A WebServer trigger example:*
<carea class="textareaCode250">-- assign this to the "Web server will send page" event
-- check and see if we are dealing with a regular page type.
-- if it's not a regular page type, then return.
if (triggerDictionary.item:type() ~= VPPageType) then
&nbsp;&nbsp;&nbsp;&nbsp;return
end
-- grab what's going to be sent out to the browser (this is the raw html)
output = triggerDictionary.output
-- look for the key $lookingFor$ , and replace it with the string "replaceValue"
-- notice that we assign the value back to the trigger dictionary. This way, VoodooPad
-- gets the updated value.
triggerDictionary.output = output:replace("$lookingFor$", "replaceValue")</carea>
*A Trigger to update a page listing all the pages in the document:*
<carea class="textareaCode250">-- assign this to the "Page Deleted" and "Page Created" events.
-- the index is created in a page named "Page Index"
indexPageName = "Page Index"
document = triggerDictionary.document
list = "All the pages in this document:\n"
for key in objc.values(document:keys()) do
page = document:pageForKey(key)
list = list .. page:displayName() .. "\n"
end
document:createNewPageWithName(indexPageName) -- noop if it's already around.
pageData = document:pageForKey(indexPageName)
attributedString = pageData:dataAsAttributedString()
attributedString:objc_mutableString():setString(list)
pageData:setDataAsAttributedString(attributedString)
</carea>
*Replace the template placeholder $clipboard$ with the text on the clipboard:*
<carea class="textareaCode400">-- assign this to the "Page created" event
newPage = triggerDictionary.item
-- check and see if we are dealing with a regular page type.
-- if it's not a regular page type, then bail out on this trigger.
if (newPage:type() ~= VPPageType) then
return
end
-- we grab the contents of the page
attributedString = newPage:dataAsAttributedString()
-- grab the clipboard
p = objc.class("NSPasteboard"):generalPasteboard()
t = p:stringForType("NSStringPboardType")
range = objc.luaToNSRange({location=0, length=attributedString:objc_mutableString():length()})
if (t ~= nil) then
count = attributedString:objc_mutableString():replaceOccurrencesOfString_withString_options_range_("$clipboard$", t, 0, range)
else
-- otherwise just make the $clipboard$ placeholder an empty string
attributedString:objc_mutableString():replaceOccurrencesOfString_withString_options_range_("$clipboard$", "", 0, range)
end
-- and now we set the value in the new page.
newPage:setDataAsAttributedString(attributedString)</carea> VoodooPad: Gemsurn:uuid:81c0220a-83ea-01db-0f39-c0cbe4c4b42b:42006-12-04T14:57:41Z2006-12-04T14:55:16Zh2. VoodooPad Gems, or otherwise known as "Cool Tips"
h3. Moving text between open windows.
If you'd like to drag and drop text from window a, to window b, and have the text removed from window a after the drop, hold down the command key. If you just do a normal drag and drop it will be copied instead of moved.VoodooPad: New in 3.1urn:uuid:7df7bd64-3a0b-01db-0eee-c0cbe4c4f9b3:202006-11-29T04:11:57Z2006-09-01T15:44:57Zh2. New in VoodooPad 3.1:
(If you are new to VoodooPad, or are just curious; be sure to check out what's new in 3.0 as well)
h3. Unified Window look, and Drawers are back
After receiving tons off feedback we discovered something; people really liked the old drawers and the way the windows used to look. So now you can have it both ways! If you like the darker "Pro" look, you can turn that on in the prefs. Otherwise you get the 100% all natural, no-preservatives traditional “Unified” windows. And if you really liked the drawers or you would like to play with them to see how the other half lives, you can flip that option on in the prefs as well.
Our new motto is: "We're not changing our mind, we're just agile".
h3. New preferences pane for opening links in tabs and windows
We got a lot of feedback about opening pages in new windows too, and a few of you wanted them to open up in new tabs all the time as well. So for VoodooPad 3.1 a new preference pane has been added which allows you to control where new pages are opened up; in the same view, in a new tab, or in a new window.
h3. Text Zoom
VoodooPad as a presentation tool? It’s been done on multiple occasions. But man, sometimes that text is just a little too small to see from the back of the room...
Text Zoom to the rescue!
Located under the View menu, you can now control magnification of what you’re looking at. Too big? Shrink it down. Too small? Blow it up.
h3. Sketch Improvements
Want to draw some lines on an image you’ve already got in a VoodooPad page? Now you can select an inline image and bring it up in the sketch sheet to edit it.
h3. Links to run plugins.
There are some folks out there with some crazy ideas. They want to click on a link and have it run a plugin, and _make stuff happen_.
It seems like it could be useful, who am I to say otherwise? (Besides being the guy who wrote VoodooPad and having the ability to say “no!” that is…)
So VoodooPad 3.1 includes a new url scheme “runplugin:”. It’s pretty simple.
Let’s say you made your own little script plugin named “Send Page to Entourage". You could then make a custom url link like so: “runplugin:Send Page to Entourage” and with an alias of “Ent”. Stay with me here...
Now you can type Command-Shift-O to bring up the “Open Page” sheet, type “ent”, and have your plugin run automagically. You can also add on parameters to the custom url, and it will be passed along to your script plugin. How cool is that?
Yes, it’s very geeky. The theory is that some of you will be able to do some cool things with this and hopefully share it with everyone else.
h3. New document idle trigger for VoodooPad Pro
Have you got a trigger that you want to run when you aren’t doing anything? Maybe commit your document to a Subversion repository, or something else? With a new event named “Document went idle”, VoodooPad Pro can run a trigger to act on your very wishes. After 15 seconds of you doing nothing at the computer, it’ll run.
If you would like to change the timeout to something other than 15 seconds, you can do so with the following defaults command in Terminal.app:
Where the value 30 would make it time out at 30 seconds.
h3. New "Send To" plugin.
Take a copy of a page and send it to another application or folder.
Place aliases of applications, shell scripts, or aliases to folders in the ~/Library/Application Support/VoodooPad/Send To/ folder, and it will magically show up in the Plugin menu. You can then call on that menu item and the current page will be sent to it! And for things like audio files or PDFs it will be copied out of VoodooPad and handed to your app/script/whatever.
If you'd like for the current page to be sent as plain text to your "Send To" item, just hold down the option key when calling upon it.
h3. New "Record Audio" plugin.
Ok, this really happened in VoodooPad 3.0.2 but we thought it deserved its own headline here.
If you have a microphone hooked up to your mac, or you have one of those fancy new intel machines with the microphone built in, you can now record audio notes for yourself and keep them inside VoodooPad for listening to later. You can also combine this with the new "Send To" plugin to record something, and then send it off to your favorite email application to share with other folks.
h3. Bug fixes, little things, and performance enhancements
* VoodooPad is slightly faster at importing documents and xml files. It's also faster at exporting as xml as well.
* If a bad search index is found, it's deleted and rebuilt instead of just VP beeping at you.
* Palette windows no longer float above all other windows.
* When importing files, you are now given the option to skip all duplicates when a conflicting page name is found.
* Fixed a crasher when embedding a file with drag and drop
* $clipboard$, and $fromPage$ can be used now as a variable in the new page template.
* New lua functions- vp.formatViaMarkdown(string) and vp.formatViaTextile(string).
* The new page sheet now has an "open in new tab" button, and auto fills the name box with "Untitled", "Untitled 2", etc..
* New preference to use smart quotes when editing text.
* Added a bit of eye candy when switching tabs in the preferences window.
* The voodoopad: bookmarklet now accepts some new parameters, such as "pageName" and "addDate".
* Holding down the option key while clicking the categories toolbar button will add the current page to the currently selected category.
* The plugin menu now shows up in the contextual menu when editing text. You can right click on a link, and the Send To plugin will act on what is behind the link instead of the current page. VoodooPad: Andy's Web Export Category Movingurn:uuid:ffd0144a-7a5b-01db-1622-c0cbe4c4a00b:82006-11-25T21:59:16Z2006-11-22T11:02:29Zh2. Andy's Web Export Category Moving script
This is a script, written in Ruby, that will parse the meta.xml file that is created during a web export and move the rendered html files into folders named for the VoodooPad categories. These folders are created elsewhere, like in the preflight script.
h3. Usage
I have this script in my web export plugin and have modified my Info.plist to run it as a postflight script. Remember to make the script executable.
h4. parseMetaXml.rb
<carea class="textareaCodeLarge">#!/usr/bin/env ruby -w
# for use in web export plugin
# written by Andy Fragen <andy@thefragens.com>
require 'rexml/document'
require 'fileutils'
include REXML
include FileUtils
c = 0
dir = ENV['VPWebExportOutputDirectory'] + "/"
meta = dir + ("meta.xml")
file = File.new(meta)
doc = Document.new(file)
num = XPath.match(doc, "//page")
files = XPath.match(doc, "//fileName")
subcat = XPath.match(doc, "//category")
cat = XPath.match(doc, "//categories")
for i in 0..(num.size-1)
if cat[i].size == 1
c=c+1
next
end
newDir = dir + subcat[i-c].text
fp = subcat[i-c].text + ("/".concat(files[i].text))
fpOld = dir + (files[i].text)
fpNew = dir + fp
if File.exists?(fpOld)
if File.exists?(newDir)
mv(fpOld, fpNew)
else
next
end
else
next
end
end
</carea> VoodooPad: Poor Man's AppleScript HTML Exporturn:uuid:42444f08-3610-01da-10f7-c0cbe4c4e0d3:72006-11-22T23:18:44Z2005-10-05T19:24:02Zh2. Poor Man's AppleScript HTML Export
This example AppleScript will talk to the first document, gather all the pages, and then export them as pre-formatted html to the folder specified in the variable "outFolder"
<carea class="textareaCodeLarge">-- this is the path to the folder you would like to write out to.
set outFolder to "srv:Users:gus:Desktop:html"
tell application "VoodooPad"
repeat with i from 1 to number of items in pages of document 1
set s to text of page i of document 1
set n to name of page i of document 1
set s to my findAndReplace("&", "&amp;", s)
set s to my findAndReplace("<", "&lt;", s)
set s to my findAndReplace(">", "&gt;", s)
set outfile to outFolder & ":" & n & ".html"
set outText to "<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>Here the title</title></head><body><pre>" & s & "</pre></body></html>"
tell application "Finder"
set f to outfile
set nref to open for access file f with write permission
set eof nref to 0
write outText to file f
close access nref
end tell
end repeat
end tell
-- shamelessly stolen from http://bbs.applescript.net/viewtopic.php?id=13008
on findAndReplace(tofind, toreplace, TheString)
set ditd to text item delimiters
set text item delimiters to tofind
set textItems to text items of TheString
set text item delimiters to toreplace
if (class of TheString is string) then
set res to textItems as string
else -- if (class of TheString is Unicode text) then
set res to textItems as Unicode text
end if
set text item delimiters to ditd
return res
end findAndReplace</carea>VoodooPad: Files and Documentsurn:uuid:248431b4-ccaa-01da-044b-c0cbe4c49273:62006-11-01T10:08:01Z2006-04-15T11:03:29Zh2. Files and Documents
You can create several pages of text with VoodooPad, and like a word processor, when you save all the pages that you've created go into the single document.
However, unlike the pages in a word processor which represent printed pages, VoodooPad's pages represent ideas. They grow as large as needed to accommodate the text you add for the idea that the page represents. As long as you keep entering text in the page, it keeps growing.
To understand VoodooPad's notion of a document, let's start by opening the "LinksAndPages.vpdoc" document that we saved at the end of the last topic. The easiest way to do this in Mac OS X is to first make VoodooPad the active application. Do this by clicking on it's icon in the Dock. Then choose the File->Open Recent->LinksAndPage.vpdoc menu item. If you don't see LinksAndPage.vpdoc within that menu, it may have been discarded from the Recent Items list by other new documents that you've opened since you worked with it.
When the document has opened, hold down the command key and click the document icon in the Title bar of the window. This should open a drop-down menu showing the directories in the path to the document as menu item choices. If you drag to, and click on, one of the directories in the menu, of course, that directory will open in a Finder window, illustrating the fact that our VoodooPad document is similar in most ways to any other document or file on the system.
There is another way that VoodooPad are dissimilar to a word processor's pages. Within the VoodooPad document there is no "natural" sequence of pages. Like the web, any VoodooPad page is a click away on an appropriate hyperlink. And, of course, this is a natural way to organize ideas. Any given page is a single page (or click) away from any other page on which there is a link to it.
This is what helps VoodooPad organize our minds. As we write about an idea or concept on a named page, we naturally include words about related ideas on that page. The words for those related ideas can be made into pages of their own, in which case they are automatically related through links from the original page.
Where VoodooPad's pages represent ideas and are easy to physically relate to other pages for closely related ideas, a word processor uses a completely different model for pages. A word processor "page" is analogous to the printed page within a printed document. It is of a fixed size and comes in a predetermined sequence within the document. The printing of a word processor document is the natural consequence of creating such a document.
In the last topic, all the links that we created were to pages within the document that contained the link. This is convenient and works well for some situations. However, as our use of VoodooPad grows and we save several documents, it becomes increasingly useful to link between them.
To establish a link from one VoodooPad document to another, it helps to think of the source document which will contain the link we're trying to establish, and the target document which will be where we end up when we click the link.
First, make sure you have two documents open in VoodooPad, and make sure they have been saved. Next, click and hold the proxy icon in the title bar of the source document (the proxy icon is the little graphic in the toolbar next to the name of the document). Drag the proxy icon into a page of the target document. VoodooPad will then ask if you want pick a page in the document, or just link to the whole document. Choose "Pick Page".
A new sheet will come up asking for the name of the page you want to link to. Find your page in the combo box, and press "Insert". Tada! You've successfully created an inter-document link.
Next: Importing and Exporting. VoodooPad: GTDurn:uuid:66857fba-4a5d-01db-0c1c-c0cbe4c4de4e:42006-10-29T21:02:46Z2006-09-22T10:11:35Zh2. GTD, aka "Getting Things Done"
Share your scripts or plugins that help you get along in the GTD world.
Not Scripts perse, but here's a collection of resources on GTD and VoodooPad that I've come across in my search for the perfect VPgtd solution.
"A Rough Kinkless VoodooPad Sketch":http://flyingmeat.com/board/viewtopic.php?p=2517&sid=e0ee431cdd1576e2a0466e0206706110#2517
"Warmed Yet Streamlined: vpGTD":http://mistercharlie.co.uk/blog/getting-things-done-with-voodoopadVoodooPad: Trouble tickets / bugsurn:uuid:f2b06f12-48c4-01db-0735-c0cbe4c4e42e:82006-09-20T13:38:34Z2006-09-20T09:27:46ZIf you've got a bug you would like to let us know about, please use the bug reporter here:
Here are a set of questions that seem to get asked a bit. They are asked often enough to warrant their own entry on this page- maybe you will find an answer here.
h3. How can I open a single page in a new window?
Hold down the command key while clicking on a link.
h3. I don't like a certain menu shortcut, or it doesn't have one. How do I make/change it?
If you are running 10.3 or later, you can assign or change a menu shortcut in the "Keyboard Shortcuts" tab of the Keyboard & Mouse system preference pane.
h3. Does VoodooPad work with "Spotlight":http://www.apple.com/macosx/features/spotlight/?
VoodooPad 2.1 comes with a bundled Spotlight plugin. So yes, VoodooPad will work with Spotlight in version 2.1.
h3. Can VoodooPad resize images when they are pasted?
Currently this is not possible.
h3. I lost my registration number. How can I get it back?
Visit our handy "serial number page":http://www.flyingmeat.com/voodoopad/serial/ and we'll send it to you.
h3. Does VoodooPad support page anchors / can I link to a particular paragraph in a page?
Currently this is not possible, but it is something we are investigating.
h3. Can I pay with PayPal?
Yes.
h3. Does VoodooPad support versioning?
Not at this time.
h3. Does VoodooPad support Textile / Markdown formatting?
VoodooPad does not support Textile or Markdown formatting.
The primary reason for this is because things are supposed to be easy in VoodooPad. Command-b makes text bold, command-i italicizes text, etc... just like every other writing application you use on your Macintosh. While textile/markdown do offer some interesting features, they are not in line with what VoodooPad is about.
h3. Can I "unlink" a word?
Yes, VoodooPad 2.1 now supports the ability to unlink a single instance of a page link.
h3. Can I rename a page?
Yes, you can. Navigate to the page you want to rename, and then choose "Document and Page Inspector" from the Window-&gt;Palettes menu. A window will appear where you can change properties about the page, including the page name. (The one exception is when you are trying to rename your default page (normally "index"). You can't currently change the name of that one)
h3. How do I open a page in a new window, when I'm in browser mode?
Hold down the command key when you click on a link.
h3. What type of encryption does VoodooPad use?
"The Blowfish Encryption Algorithm.":http://www.schneier.com/blowfish.html
h3. How do I stop words from linking on just one page?
Click on the info toolbar button of the page you want links to go away on, and then uncheck the button "Highlight linked words"
h3. What's the difference between a page and a pad? What is considered a "document"?
A page is a single entry- a single window that you can type in. Multiple pages go in a pad, like a notebook. A pad and a document are the same thing- a collection of pages. A pad can also contain file links that you dropped in from the Finder. The document is stored in a file like a world processing application would, and it usually ends with the extension .vdoc
h3. Do I have to mash words together to make a link?
No, you do not. You can link a single word, with or without capitalization just as easily as a mashed word, it just doesn't appear underlined before you make it a link. To make a new page with the word (or phrase), just select the text and choose "Make Link" from the Edit menu, or type Command-L.
h3. Why can't I underline or change the font color?
VoodooPad uses colorized and underlined text to denote a link, so it would be confusing if you came across underlined text that does not function as a link. However you can change this behavior by opening up the Preferences and under the Appearance section turn on the option "Allow manual underlining and font color changes".
h3. Is there any revision control in VoodooPad like a full history of changes?
No, there is not.
h3. What is the difference between VoodooPad and VoodooPad Lite?
| Feature | VoodooPad Lite | VoodooPad |
| Inline editing and realtime linking of pages | • | • |
| Unicode, Rich Text support, and image embedding | • | • |
| Auto-complete page opening | • | • |
| Save / Export to iPod | • | • |
| Links to pages in another document | | • |
| Spotlight support | | • |
| Categories/tag support | | • |
| AppleScript support | | • |
| Encryption | | • |
| Sketch | | • |
| Plug-In Support | | • |
| Export as HTML or RTFD | | • |
| Save pages as Microsoft Word documents | | • |
| View recently updated pages | | • |
| Clippings folder for frequently used bits of text | | • |
h3. What are the valid options for the date format field in the Preferences?
| Specifier | Description |
| %% | A '%' character |
| %a | Abbreviated weekday name |
| %A | Full weekday name |
| %b | Abbreviated month name |
| %B | Full month name |
| %c | Shorthand for “%X %x", the locale format for date and time |
| %d | Day of the month as a decimal number (01-31) |
| %e | Same as %d but does not print the leading 0 for days 1 through 9 (unlike strftime(), does not print a leading space) |
| %F | Milliseconds as a decimal number (000-999) |
| %H | Hour based on a 24-hour clock as a decimal number (00-23) |
| %I | Hour based on a 12-hour clock as a decimal number (01-12) |
| %j | Day of the year as a decimal number (001-366) |
| %m | Month as a decimal number (01-12) |
| %M | Minute as a decimal number (00-59) |
| %p | AM/PM designation for the locale |
| %S | Second as a decimal number (00-59) |
| %w | Weekday as a decimal number (0-6), where Sunday is 0 |
| %x | Date using the date representation for the locale, including the time zone (produces different results from strftime()) |
| %X | Time using the time representation for the locale (produces different results from strftime()) |
| %y | Year without century (00-99) |
| %Y | Year with century (such as 1990) |
| %Z | Time zone name (such as Pacific Daylight Time; produces different results from strftime()) |
| %z | Time zone offset in hours and minutes from GMT (HHMM) |
Besides these examples, you'll want to read http://flyingmeat.com/fs/contrib/voodoopad/VPPlugin.h for information on what is available. It's just an Objective-C header file, but it's what we've got to go on for now :)
h3. List all the page names in the current document to the current page.
<carea class="textareaCode150">thelist = ""
textView = windowController:textView()
for key in objc.values(document:keys()) do
page = document:vpDataForKey(key)
thelist = thelist .. page:displayName() .. "\n"
end
This example displays a dialog box with a default button that says "Go Away"
<carea class="textareaCodeMini">objc.nsAlert("Hello", "This is a message", "Go Away", nil, nil)</carea>
<!--
The previous example works just fine for me- can you send me a bug report about it? gus@flyingmeat.com
<p><b>CAVEAT :</b> The following code does not appear to work with Mac OS X 10.4 (Tiger). On these systems, you can use the following Lua function instead.</p>
<carea class="textareaCode300">NSA_BUTTON1_PRESSED = 1000;
NSA_BUTTON2_PRESSED = 1001;
NSA_BUTTON3_PRESSED = 1002;
-- produce an objective-c NSAlert Dialog
function nsAlert(title, message, b1, b2, b3)
local nsaClass = objc:class("NSAlert")
local nsaObject = nsaClass:alloc():init():autorelease()
nsaObject:setMessageText(title)
nsaObject:setInformativeText(message)
nsaObject:addButtonWithTitle(b1)
nsaObject:addButtonWithTitle(b2)
nsaObject:addButtonWithTitle(b3)
return nsaObject:runModal()
end</carea>
-->
h3. Highlight the selected text yellow.
(this will work best as a plugin, since the Run as Lua Script option deselects the currently selected text before running the script)
h3. List all the pages in the document with a meta value named "todo".
(Metas are a feature only available in VoodooPad Pro)
<carea class="textareaCode">textView = windowController:textView()
list = "My todo pages list:\n"
for key in objc.values(document:keys()) do
page = document:pageForKey(key)
if (page:metaValueForKey("todo") ~= nil) then
list = list .. page:displayName() .. "\n"
end
end
textView:insertText(list)</carea><br/>
&#187; <a href="x-voodoopad-scriptplugin:http://www.flyingmeat.com/voodoopad/script_plugins/list_pages_with_todo_meta.lua">install</a>
h3. Look for the word "@todo" in all the pages, and list page name with the line.
<carea class="textareaCode300">function trim(s)
return (string.gsub(s, "^%s*(.-)%s*$", "%1"))
end
theList = ""
for key in objc.values(document:keys()) do
page = document:pageForKey(key)
if page:type() == VPPageType then
attString = page:dataAsAttributedString()
for line in objc.values(attString:objc_string():componentsSeparatedByString("\n")) do
if string.find(line, "@todo") ~= nil then
theList = theList .. "\n" .. page:displayName() .. ": " .. trim(line)
end
end
end
end
h3. Make a new page with the selected text, without opening it.
<carea class="textareaCode250">--[[
VPLanguage = lua
VPScriptMenuTitle = Make Link Without Opening
VPShortcutKey = l
VPShortcutMask = command shift
VPEndConfig
--]]
textView = windowController:textView()
pageName = textView:objc_string():objc_trim():substringWithRange(textView:selectedRange())
if pageName:len() == 0 then
objc.nsAlert("Sorry, blank words are not allowed")
return
end
document:createNewVPDataWithKey(pageName)
</carea><br/>
&#187; <a href="x-voodoopad-scriptplugin:http://www.flyingmeat.com/voodoopad/script_plugins/make_link_without_opening.lua">install</a>
h3. Commit changes to subversion
Subversion is a version control system. If you already have your document in a subversion repository this script will add new files, remove deleted files, and commit the changes. To learn more about subversion, visit http://subversion.org/
<carea class="textareaCode400">--[[
VPLanguage = lua
VPScriptMenuTitle = Subversion Commit
VPEndConfig
]]
-- we assume subversion is located in /usr/local/bin/svn
VoodooPad: Hello World in Luaurn:uuid:a38ed4de-6880-01da-1b45-c0cbe4c4f7dd:102006-08-18T12:28:16Z2005-12-08T22:54:27Zh2. Hello World in Lua
What's Lua? "Lua is a powerful light-weight programming language designed for extending applications" : http://www.lua.org/
We're going to create our own script plugin using Lua- a really simple one that just inserts the words "Hello World" into the current page. I promise it'll be really easy.
First, create a new page in your VoodooPad document named "Hello World". When the page comes up, select everything and delete it. We're going to want a completely empty page to write this in.
Next, type (or cut and paste) the following line into your new page:
Now go to the Plugin->Lua->Run Page as Lua Plugin menu item. You should then see the text "Hello World" inserted into the page. Congratulations! That's all it takes to make a simple VoodooPad plugin. Now let's explain what's going on.
There is a variable in every lua script plugin we write named "windowController". This can be thought of as a reference to the window that the plugin is running in. We can then call various methods on the windowController, one such is textView(). This returns the editing portion of the window- the one where we actually do the typing in VoodooPad. We could have also written this plugin as:
But that's two lines and isn't as good a demo. But it is however a little bit clearer.
So windowController is a reference to window stuff, and textView is a reference to the editing text part of the window. Then when we call the method insertText(), passing in the string Hello World, we're saying insert the text "Hello World", in the text view of the current window.
That's all great- but how do we get our Hello World plugin up in the menu bar? That it turns out, is a piece of cake as well. Delete the text in the page that got inserted (the part that sayd "Hello ..." and make sure your page just looks like this:
Now, select the "Plugin->Lua->Save Page as Lua Plugin..." menu item, and VoodooPad will prompt you to save the plugin in the Script Plugins folder. Press the Save button.
Now if you go back to the "Plugin->Lua" menu, you'll see a new item in there named "Hello World". Select it, and tada! your new plugin was run. You can now use this plugin from any page within VoodooPad.
For more examples of script plugins, visit the Lua Plugin Snippets page.FlySketch: Start Pageurn:uuid:442576da-c72a-01d9-080c-c0cbe4c4bd01:402006-08-16T17:48:11Z2005-05-17T16:20:33Zh2. "FlySketch":http://flyingmeat.com/flysketch/
* About FlySketch
Learn what FlySketch is all about.
* The Toolbar
Learn what all the little buttons in the toolbar do.
* The Palettes (New in FlySketch 1.5)
Find out what you can do with all those fun palettes.
* Extra Scripts
Add functionality to the workflow scripts menu.
* Shortcuts
Find out how to access features without using the mouse.
* Be Creative
Be an artist (or pretend to be one), and let FlySketch help you out.
* Compositing Modes (New in FlySketch 1.5)
What are all these options anyway?
* New in FlySketch 1.5
Find out the cool new features that makes you a happy FlySketch user.
* New in FlySketch 1.6
Full Screen Captures!
* Feedback Links
Find out how to contact us and tells us what you think.
* "List of all pages":/fs/flystashweb.cgi?allPages=1&space=442576da-c72a-01d9-1c64-c0cbe4c4e230FlyGesture: About FlyGestureurn:uuid:db0b0f42-0578-01da-19a5-c0cbe4c48706:62006-08-02T20:41:57Z2005-08-04T23:19:19Zh3. Quckstart:
Press and hold f1. Move mouse around. Watch as your bidding is done.
h3. The Longer Explanation:
FlyGesture is an application that sits in the background and waits for you to call on it. And when you do, FlyGesture executes an action based on the movements of your mouse through a series of "guides." (These guides are just little nifty circles that change color as you move your mouse through them, but they track your mouse movements to figure out what command to execute.)
A gesture's action(s) can be setup to launch an application, type some text, run your automator action, or even execute custom AppleScript. You decide. FlyGesture comes with multiple actions which you can mix, match, and rearrange to create your own workflows.
And after a bit of use, you'll find that you really don't need to pay attention to the gestures you're making—-muscle memory starts to take over for you. This is where the power of mouse gestures really shines. You don't even think about what you want to do because it just happens at the flick of a mouse--it's effortless.
By default, FlyGesture comes with a set of common commands such as "Close Window," "New Window," "Hide All Applications," "Open iTunes," "iTunes Next Song," "New Mail Message," etc.
You will probably want to add your own gestures and actions, which you can do by bringing up the catalog window (press Command-T or choose it from the Window menu) and clicking the "+" button. Single click your mouse in the middle of the gesture window and move your mouse through the guides you want to define your gesture with.
If you don't like F1 as the hot key, you can change it to something a bit more tasty in the Preferences. You may also change the color of the gesture line, or turn it off completely.
Create as many gestures as you want- an infinite number of guide combinations are available. Make a gesture to open all of your favorite applications at once. Or have it save the current window and put the computer to sleep. Or even open four different Web pages, start a new mail message, copy a file in the Finder to a remote server and display a dialog box saying "My work here is done."
As with any application from Flying Meat, we are eager to hear your comments and suggestions about FlyGesture. If you want to share them send an email to flygesture@flyingmeat.com VoodooPad: Script Pluginsurn:uuid:0b22e862-ee03-01da-010f-c0cbe4c49366:112006-07-25T08:57:14Z2006-05-27T21:33:00Zh2. Script Plugins
(For a quick start tutorial on writing a script plugin, visit the "Hello World in Lua" page. For a bunch of examples, see Lua Plugin Snippets)
Script Plugins are extensions to VoodooPad to add extra functionality. To put it simply, they are text files written in the Lua scripting language and executed inside VoodooPad. These scripts have access to certain parts of VoodooPad and may manipulate and create pages, carry out specific tasks, or just insert some text into a page.
The scripts are placed inside the ~/Library/Application Support/VoodooPad/Script&nbsp;~PlugIns folder, with a file name that has an extension of .lua . You can also write and test your scripts within a VoodooPad page, and then just select the "Plugin->Lua->Save Page as Lua Plugin..." for a quick and easy way of developing the plugin.
When run, a script plugin is given 2 global variables named "windowController" and "document". "windowController" basically represents the window that the script is running in (and the current page), while "document" represents the whole Voodoopad document. You can then call methods on these obects to perform certain tasks. Here's an example:
<carea class="textareaCodeMini">-- print out the file path of the current document
documentPath = document:fileName()
vpconsole(documentPath)</carea>
Copy and paste that script into an empty VoodooPad page, and select the "Plugin->Lua->Run Page as Lua Script" menu item. You will see a little window pop up and the path of the current document print out in it.
There are a couple of things to point out here:
* two dashes (--) mark the beginning of a comment, so that's not run by Lua.
* methods are called with ":", so when we do "document:fileName()" we are calling the fileName method of the document. (In objective-c this would be written as [document fileName] , and in java or python, it would be document.fileName())
* vpconsole() is a special method that is build into VoodooPad, and not a standard part of the Lua language.
What else can you call on windowController or document? (And the technical names are "VPPluginWindowController" and "VPPluginDocument")
*VPPluginWindowController:*
* :textView() returns the current "NSTextView":http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/Classes/NSTextView_Class/index.html#//apple_ref/doc/uid/TP40004140
* :window() returns the current "NSWindow":http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/Classes/NSWindow_Class/index.html#//apple_ref/doc/uid/TP40004151
* :setStatus(string) will send a string to the little status field at the bottom of the window.
* :key() will return the "key" for the current page name
* :document() will return an object that represents the current document.
The document that is returned by windowController:document() is known as "VPPluginDocument"
*VPPluginDocument:*
* :countOfPages() returns the number of pages in a document.
* :pageForKey(string) returns an object that represents the page for the given key
* :keys() returns a NSArray of all the keys in the document
* :fileName() returns the (posix) path of the document
* :synchronizeDocs() tells the document to commit all the data in the windows.
* :openPageWithTitle(string) open a page with the given title- if the page does not exist it is created.
* :createNewPageWithName(string) makes a new page, and returns it as an object.
VPData is the class that represents the contents on a page, plus other attributes.
*VPData*
* :modifiedDate() returns a NSDate representing the last time it was changed
* :createdDate() returns a NSDate representing the time it was created
* :displayName() returns a (possibly) mixed case name of the page
* :key() returns the "key" of the page, which is always lowercase.
* :dataAsAttributedString() returns the contents of the page as a "NSMutableAttributedString":http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSMutableAttributedString_Class/index.html#//apple_ref/doc/uid/TP40003689
* :setDataAsAttributedString(attributedString) sets the content of the page to the value passed in as a NSAttributedString.
* :isEncrypted() returns a boolean to let you know if the page is encrypted or not.
* :uuid() returns a Universally Unique Identifier (UUID) for the page.
* :type() returns the type of the page, such as VPPageType, VPAliasType, VPURLType, VPFileAliasType, and VPInjectedFileType.
* :metaValueForKey() returns the meta value for the given key, or null if it isn't there.
* :metaValues() returns a NSDictionary of the meta values and keys for the page.
For a full list of methods, check out VPPlugin.h which you can grab from the Plugin Development page.
h2. Extra functions
As already mentioned, "vpconsole(string)" can be used to print out text to a little window in VoodooPad. Another function that's built in is "objc.values(objc-array)", where you pass in a NSArray and get back an iterator. This comes in pretty handy when you want to cycle through all the pages in a document:
<carea class="textareaCodeMini">for key in objc.values(document:keys()) do
vpconsole(key)
end</carea>
Another extra function that needs to be mentioned is string.replace, and you use it like so:
<carea class="textareaCodeMini">s = "VoodooPad"
s = string.replace(s, "Voo", "Foo")
vpconsole(s)</carea>
This will take the string "VoodooPad, search for any occurrences of "Voo" and replace it with "Foo", giving us the string "FoodooPad".
An lastly, VoodooPad comes with a bunch of extra functions in the posix package:<br/>
posix.access, chdir, chmod, chown, ctermid, dir, errno, exec, files, fork, getcwd, getenv, getgroup, getlogin, getpasswd, getprocessid, kill, link, mkdir, mkfifo, pathconf, putenv, readlink, rmdir, setgid, setuid, sleep, stat, symlink, sysconf, times, ttyname, umask, uname, unlink, utime, wait, mkstemp, setenv, unsetenv
h2. Where do errors go?
Errors are printed out to Console.app, located in the Utilities folder. So if you have having problems running your script then it's likely that you're getting errors and you should check there. As well, any calls to print() appear in Console.app
h2. Type Conversions
Lua and VoodooPad talk to each other via a "bridge". Since VoodooPad is written in Objective-C (objc) and your scripts are written in Lua, a little bit of trickery has to happen behind the scenes to make things talk to each other. For instance, NSStrings in objc are converted to Lua strings, and ints, floats, doubles, longs, etc are translated into Lua numbers (Lua only has a single number type). If the bridge can't figure out how to convert an objc object into a Lua type then it is converted into a Lua table.
However, there are times when you don't want the bridge to convert a value for you. One such instance is for NSMutableString. Take this line of code:
Well, that's not going to work. When we call mutableString(), the bridge is going to convert that to a Lua string, and then when we try and add text to that object via the appendString() call Lua is going to throw an error. What we want is for the bridge to not convert the NSMutableString into a Lua string, and we do that by changing our call from attributedString:mutableString() to attributedString:objc_mutableString(). This tells the bridge to not convert the value to a Lua type, and we can then play with the value returned as a regular Objective-C type.
h2. VoodooPad Lua Constants
Pages in a VoodooPad document have a type associated with them. This lets the system distinguish between regular pages, pdf's, urls, etc. For example all the regular pages you create are of type "VPPageType". When you write triggers and you want to play with the contents of the page, you need to make sure it's a page type first. Use these values to compare what type page is combined with a call to page:type()
VPPageType, VPAliasType, VPURLType, VPFileAliasType, VPInjectedFileType
And here are some constant meta names you might find useful.:
VPFileWrapperMetaName, VPUTIMetaName
Extra data names:
VPIconExtraDataName (used for embed applications, to store the icon in).
Printing out stuff for debugging or whatever:
vpconsole("hello!") (used for debugging or whatever you'd like to use it for).
h2. Other topics:
* Lua Plugin Snippets
* The Lua Programming Language: http://www.lua.org/VoodooPad: Command Line Script to Pipe Texturn:uuid:3e12336c-6a92-01da-0ff6-c0cbe4c4c85d:72006-07-24T15:22:40Z2005-12-11T14:05:30Zh2. Command Line Script to Pipe Text.
This is a simple python script, that'll take text from stdin and pipe it to a page in VoodooPad:
<carea class="textareaCode400">#!/usr/bin/python
import sys
import os
import getopt
import string
pageName = "piped text"
if len(sys.argv) == 2:
pageName = sys.argv[1]
data = sys.stdin.read()
data = data.replace('"', '\\"')
script = '''tell application "VoodooPad"
tell document 1 to create page with title "%s" with contents ""
append text "%s" to page "%s" of document 1
activate
end tell''' % (pageName, data, pageName)
script = script.replace("'", "\\'")
os.popen("/usr/bin/osascript -e '%s'" % (script))</carea>VoodooPad: Cool Featuresurn:uuid:ef0fe032-368b-01da-19a2-c0cbe4c4e0de:52006-07-21T09:31:20Z2005-10-06T10:09:20Zh3. Export
No lock in! That is one of our favorite sayings. VoodooPad has 7 (SEVEN!) different ways for you to export or save your data.
* Export to your iPod Notes folder for a live wiki on the go. (3rd generation iPods only).
* Export to your iPod Contacts folder (1st and 2nd generation iPods)
* Save as Microsoft Word documents with Mac OS X 10.3.
* Export RTFD (Rich Text Format) files.
* Export as HTML, so you can view your wiki in a web browser, or ftp it to a website.
* XML Export. You can even import it back in (great for merging documents!).
* And finally, as good and reliable plain text files.
(Not all export options are available in VoodooPad Lite)
h3. Use the clippings folder to access frequently used text.
(Not available in VoodooPad Lite)
VoodooPad creates a folder in your home directory under ~/Library/Application Support/VoodooPad/Clippings/ where you can place text files which will show up in the "Insert" submenu under the Edit menu. When you choose the menu item, the text from the clipping will be inserted into the current page.
*Stupid Unix Tricks:* VoodooPad will also look to see if the text file has the executable bit set, and if it does it will be executed just like a shell script (using /bin/sh). Using this technique, you can place dynamic content into a page with a couple of mouse clicks!
h3. Customize the look of your HTML exports.
(Not available in VoodooPad Lite)
When exporting your document as HTML, VoodooPad will look for a certain page to apply formatting to your pages. Visit the HTML exporting section of the manual for more information.
h3. Command-Shift-O is your personal hero.
Did you know that there is a shortcut to open up any page with auto-complete hiding within VoodooPad? If you hit Command-Shift-O a sheet will open up in the current window, where you can begin typing the name of a page that you want access to quickly. And if you type in the name of a new page, it will be created for you!
h3. Auto-complete.
(Not available in VoodooPad Lite)
What was the name of that page again.. Voodoo.. something?
Bring up the "Open Page.." sheet by typing Command-Shift-O or selecting it under the Edit menu, and bring forth auto-complete goodness. Just type in the beginning of any page and VoodooPad will find it for you.
Mac OS X 10.3 even brings in auto-complete features in the page! Type the beginnings of a linked item, and hit Command-K to bring up an auto-complete selection based off what you typed.
h3. UNIX Scripting Geeks Wanted.
#!/bin/sh echo "Hello from VoodooPad!"
Whether it's Python, Perl, Ruby or any other of your favorite Unix scripting languages- VoodooPad can run it and display the results. Just type in a script and hit Command-R and it will run just like you were at a terminal. VoodooPad works great as a script library.
h3. What's New?
(Not available in VoodooPad Lite)
VoodooPad has a "Recently Updated" window that will show you what pages have been recently changed. Go to the menu "Window" and select "Recently Updated". Click on an item in the window to bring up it's corresponding page.
h3. iPod Note Navigation
If you are the lucky owner of at least a 3rd generation iPod, then we've got some great news for you- You can export your VoodooPad document to your "iPod Notes" folder, and you can read and navigate your document just like you were running VoodooPad on your iPod. The same linked words show up for you to click on, and you can go from page to page just like you were using VoodooPad, only with an iPod scroll wheel instead of a mouse!
h3. AppleScript Support
(Not available in VoodooPad Lite)
VoodooPad has AppleScript support for the basic document commands, as well as exporting your pages as RTFD, HTML or text. Find out more on VoodooPad's AppleScript page.
h3. Drag and Drop
VoodooPad does some cool tricks with drag and drop. If you drag and drop images into VoodooPad, it'l ask you if you want to embed them into the page, or link to it. Even drag and drop URL's and images straight from Safari or any other browser!
Drop files, folders, and applications from the Finder- they will be linked up just like a VoodooPad page.
h3. Mac OS X Goodness
VoodooPad takes advantage of cool Mac OS X features like sheets, Inkwell, Services, Toolbars, and OS X's Unix underpinnings.
h3. Unicode
Hello!, 早晨, 你好, こんにちは, 안녕하세요, Grüß Gott!
VoodooPad supports Unicode, for all your multi-lingual needs.
h3. Uber Rich Text
VoodooPad takes advantage of Mac OS X's built in text system, so you get access to all kinds of text services like spell checking, and formatting options like multiple fonts and font sizes per page, kerning, rulers, and even text shadowing and strike-through support in Mac OS X 10.3 and up.VoodooPad: OPML Export Pluginurn:uuid:39f39cfa-0e50-01db-1658-c0cbe4c4baff:62006-07-08T00:24:57Z2006-07-08T00:06:07Zh2. OPML Export Plugin
Here's the code for the start of a lua script to export the contents of the document into OPML. It's pretty bare.
<carea class="textareaCode400">NSFileHandlingPanelOKButton = 1
savePanel = objc.class("NSSavePanel"):savePanel()
savePanel:setTitle("Save the OPML file")
response = savePanel:runModalForDirectory_file_(nil, document: displayName() .. ".opml")
if response == NSFileHandlingPanelOKButton then
filename = savePanel:filename()
output = '<opml version="1.0"><head></head><body>'
for key in objc.values(document:keys()) do
page = document:vpDataForKey(key)
if page:type() == "page" then
pageString = page:dataAsAttributedString():string()
-- this stuff should be in a function
pageString = pageString:replace("&", "&amp;amp;")
pageString = pageString:replace("<", "&amp;lt;")
pageString = pageString:replace(">", "&amp;gt;")
pageString = pageString:replace("\"", "&amp;quot;")
pageString = '<outline text="' .. pageString .. '" />'
output = output .. pageString .. "\n"
end
end
output = output .. '</body></opml>'
fd = io.open(filename, "w")
fd:write(output)
fd:close()
vpconsole("all done")
end</carea>VoodooPad: Linking, Pasting, and Embedding Filesurn:uuid:7c19c9a2-02f1-01db-09c7-c0cbe4c496c8:32006-06-23T13:38:16Z2006-06-23T12:50:13Zh2. Linking, Pasting, and Embedding Files
*Linking or pasting images*
If you drag and drop a file into VoodooPad and it recognizes it as an image format, you'll get a sheet asking what you want to do with it. Since VoodooPad can paste images inline with text, you are given that option or you can link to the file on your disk.
If you paste it in, it will display inline with any text in your page. To get the image out just double click it and VoodooPad will ask you where to save it. If you drag and drop a PDF file in, it will display inline like any other image as well- but only if the PDF has a single page. If it has more pages then it will be treated like a regular file.
If you choose to link to the image, VoodooPad will make a new link for that file and insert it into the page. If you later decide you don't want the link anymore you can remove it from the File and URLs table of the document properties window.
Tip: To suppress VoodooPad from asking each time you want a dragged image to be pasted in , hold down the option and command keys when performing the action.
*Embedding Files*
If you want to include a file in VoodooPad, but you don't want it to display inline with text and you want to delete the original, then embedding is for you.
Choose "Embed Files…" from the File menu, and select the file(s) you'd like imported into your document. VoodooPad will then make links in your document to that file. If VoodooPad can display the file (such as images, pdfs, some movies, mp3 files) it will do so. Otherwise you'll get a simple page with the ability to save the item to disk. You can also choose "Export Page As…" from the file menu to save out an image or any other file that VoodooPad is displaying.VoodooPad: Data Sent to Flying Meaturn:uuid:171420a4-fd95-01da-05bd-c0cbe4c49338:42006-06-16T17:18:53Z2006-06-16T17:06:14Zh2. Data Sent to Flying Meat
h3. Auto-update:
When VoodooPad checks for newer versions, it sends along information such as what version of Mac OS X you are running, what brand of processor you are using (ppc or intel), a unique string to weed out duplicate requests, and of course- what version of VoodooPad you are running.
If you would like to have this information not sent when an update check is performed, uncheck the option "Include system information" in the Options preferences. If you would like to not have auto update performed at all, uncheck the option "Check for updates at startup".
h3. Registration:
When you register VoodooPad, your serial number is sent to our servers to make sure it is valid. This only happens once when you press the "Register" button in the registration panel. VoodooPad does not perform any other checks (besides auto-update if you have it turned on) after this.
If you are not online, VoodooPad will just try again at a later point and allow you to use the software like you normally would.VoodooPad: Links and New Pagesurn:uuid:f4d4271e-cca7-01da-1723-c0cbe4c49ef5:62006-06-05T13:33:15Z2006-04-15T10:47:50Zh2. Links and New Pages
VoodooPad is a tool to help you organize information. One of the most obvious ways to do this is to use hyperlinks, popularized by the World Wide Web.
Although hyperlinks, or links, on the web are a great way to find information and dig through related topics, most people have not had the tools or the experience with HTML (the markup language of most web pages) to make use of this organizing tool for their own notes and ideas.
Let's start fresh by creating a new VoodooPad document (by pressing Cmd-Shft-N) and removing all of its content. To do that, click anywhere in the text area of our new Work Area, choose Edit->Select All and press the Delete key.
In the new blank window, let's note some things we've discovered about VoodooPad. Type (or Copy from this tutorial and Paste) into the Work Area the following indented text:
p{padding-left: 20px;}. My VoodooPad notes:
p{padding-left: 20px;}. Uses HyperLinks
Creates pages automatically when needed
Allows ~aliases to access my pages
If you've entered the text exactly as shown above in the new page, notice that the words "VoodooPad" and "HyperLinks" are underlined. The reason that they're underlined is that they were created as default links. During input of text, whether typed in or Copied from the clipboard, VoodooPad parses the text looking for words that are mashed together. Basically, VoodooPad is looking for two or more sequences of uppercase letters in each word and when it finds such a word on its input, it immediately makes a potential link out of it.
The difference between a potential link and a real link is that no page yet exists for a potential link. That page is created, instead, the first time the potential link is clicked. To watch this happen, let's open the Pages List for our document. To do that, choose Window->Palettes->Pages List.
When the window appears, notice that there is only one page listed, "Index". That's because the Index page (or Home page) is always created as part of creating the new document. Now, let's click on the word VoodooPad and watch as a new page appears in the window and it's name appears on the Pages list.
As before, we'll add some text to be able to distinguish the new page from another one that VoodooPad might create just like it. So, on the new page named "VoodooPad", enter the following line:
p{padding-left: 20px;}. A tool for linking related information through local HyperLinks.
Next, click the Home button in the Toolbar to return to the first page. Now notice that though both "VoodooPad" and "HyperLinks" are underlined, only "VoodooPad" is displayed in blue. That's because "HyperLink is still only a potential link and "VoodooPad" is a link to a real page. Once again, watch the Pages list to the right as you click on the word, "HyperLinks".
A second new page, named "HyperLinks" has been created appearing in the Pages list. On this new "HyperLinks" page, enter the following line:
p{padding-left: 20px;}. VoodooPad's most used organizing principle.
as a brief note on HyperLinks as they relate to VoodooPad.
As you enter this line, notice that the word "VoodooPad" immediately turned to blue and became underlined as you typed the last letter. VoodooPad has recognized that this was a potential link and found the page it references, so it displays it as a bonafide link. Also note that no new page named "VoodooPad" was added to the Pages list. Since it already existed, there was no need to create another.
If we click on the word "VoodooPad" on the "HyperLinks" page, notice that it takes us back to the "VoodooPad" page on which we typed its definition. While we're on the "VoodooPad" page, we might want to add to the information here. So let's add the following new text:
p{padding-left: 20px;}. Always open for editing, additions
Now that we've moved through a few pages, let's look again at page navigation. To retrace the path we took to get here, try clicking the Back button in the Toolbar until it grays out (indicating that it's no longer active). Now click the Forward button until it does the same to move us forward to the end of our path.
Like browser Forward buttons, the path forward is only retained until we change our path. So if we've gone back a few pages and then click on another link to move forward, our previous Forward path will be deleted.
At this point we should be on the VoodooPad page in our Work Area. Let's add the following line to our notes on that page:
p{padding-left: 20px;}. A potential HyperLink is created whenever we smash capitalized words together.
As we enter this line, we notice that the word "HyperLink", though underlined, is not displayed in blue. That means that we've created a potential HyperLink, but there is no page to go with it yet. Of course, the reason is that we first pluralized the word "HyperLink", so only the plural form has an associated page. We have three choices, then: we can modify the line to integrate the plural form, "HyperLinks", we can click the word in its singular form to create a new page and repeat what we've put in the page for the plural form, or we can create an alias, so that both words point to the same page.
Clearly, the last of these options is the preferable one, so to create a "HyperLink" alias for "HyperLinks", either click on the word "HyperLinks" in the page, or double click on it in the Pages list to get to the page for the plural form. Next, click on the Info button in the Toolbar to make an Info sheet appear. Under the box labeled "Aliases:" at the bottom of the page's Info sheet, click on the "+" sign and enter the word "HyperLink" in the input text box that appears. To complete the input field, press either the Tab key or the Return key, then click the Close button.
If we now go back to the "VoodooPad" page by clicking on the link on the "HyperLinks" page, we can see that the word "HyperLink" (singular) is displayed in blue, indicating that it's a real hyperlink to a real page. Click on it, and we see that we've arrived back at the page labeled with the plural "HyperLinks". While we're back on the "HyperLinks" page, lets open the Info sheet again by clicking on the Info button in the Toolbar and add two more aliases to the page:
p{padding-left: 20px;}. hyper link
hyper links
Let's now return to the "VoodooPad" page and type the following note:
p{padding-left: 20px;}. A hyperlink is a hyper link is a HyperLink is a HyperLinks is a Hyper Link is a Hyper Links.
As we enter this line, notice that each form of "hyperlink" whether capitalized or not, has become a link to our page. In other words, although VoodooPad is sensitive to capitalization when automatically creating potential hyperlinks, it is insensitive to capitalization when entering words that already exist as linked pages.
The result is that once we've created a page for a hyperlink, we needn't enter all possible forms of capitalization as aliases to the page.
We can also create links manually which can be much more flexible than mashed and capitalized words. For instance, enter the following line on the Index page:
p{padding-left: 20px;}. Allows manual creation of links from any word or phrase without regard to capitalization.
Notice that none of the words in that line are aliases or potential aliases. In order to change that, select the phrase, "manual creation of links". Then click on the blue Link button in the Toolbar.
As we click on the Link button, notice that we've just created a new page for "manual creation of links", whose name was also just entered into the Pages list. If we use the Back button to go back to the previous page, we also notice that the phrase we selected is now a link.
Another problem arises if we have some material to copy into a VoodooPad document and aren't quite sure where, or even if, it's referenced in the rest of the document. To solve that problem, we can create a new page and give it a name whether the name exists anywhere else in the document or not. So, for instance, copy the following indented text to the clipboard:
p{padding-left: 20px;}. VoodooPad pages can be created without a corresponding link.
A new page is created by pressing Cmd-n on the keyboard.
A new page is also created by choosing File->New Page in the menu.
Upon creation, any reference to the new page automatically becomes a link.
After creation, the page title becomes a link immediately upon being input.
Now, go to the Work Area, press the Cmd-n keys to create a new page and enter the word "Pages" into the sheet that drops down for the page title and press Return. Paste the text you copied above from the clipboard to the new page. Go back to the Index page and notice that the word "pages" has become a link on the line "Allows aliases to access my pages".
Creating a page is easy and we've seen a couple ways to do it. How about deleting one of those pages if we created it by mistake or if we simply no longer need it? First we have to be on the page we want to delete. So to illustrate, let's first create a new page called "mistake". Press Cmd-n to display the New Page Title sheet, enter the word "mistake", and press Return. We now have a new page named mistake which is just what the name implies, a mistake. So how do we delete it?
If you see a red "Delete" icon at the far right of the Toolbar in the Work Area, that represents the easiest way to delete a page. If you don't see it, either click on the double arrow heads at the far right of the Toolbar to see and click it, or simply widen the Work Area window until it appears.
When we click the Delete icon, a confirmation sheet appears. When you see it, click the Delete button and the new page named mistake will be deleted from our document. Any links to the new document would no longer be links, but would revert back to regular words or revert back to potential links if they were capitalized words mashed together.
When a VoodooPad document starts to become large, it often becomes helpful to know where all the links are to a given page. For instance, if we are on the "HyperLinks" page, we might want to check all the links to this page for additional information about "HyperLinks" from the context of the sentences in which the links are found.
In order to find back links to a given page, we first go to the referenced page. In order to demonstrate, let's return to the "HyperLinks" page. Once there, choose the menu item Window->Palettes->Backlinks and a Backlink palette listing all the pages with hyperlinks to this page.
If we click on any of the titles in the Backlinks page, it will take us to the page with that title in which we're guaranteed at least one back link to the original page.
Go to Files and Documents VoodooPad: Tutorial Introductionurn:uuid:87bf921e-cca5-01da-0982-c0cbe4c4bd2e:62006-06-05T13:32:32Z2006-04-15T10:30:28Zh2. Tutorial Introduction
Before we explore VoodooPad's details, let's take a brief top level view of what VoodooPad is about.
When you install VoodooPad and open it up for the first time, you should see a page with a clipboard pictured at the top and a heading underneath that says, "VoodooPad. You put your brain in it." like this:
p=. !/fs/images/voodoopad/vp2introheader.png!
Let's use that page to get a brief overview of VoodooPad. If that page isn't currently showing, then go to the File menu and choose New Document. We'll call the window holding this page our Work Area. One way to get a good overview of VoodooPad is to read that page. It provides an excellent overview of VoodooPad's capabilities.
Don't worry about losing that description. It will appear just like you see it on the first page of any new VoodooPad document you create. We're going to ask you to modify it's text, but remember, you can always get a new version of it with a new document. So let's continue by reviewing some of that description here in a tutorial format.
Although it's much more, VoodooPad is a text editor at its foundation. For instance, click on the new window you've opened and click at the end of the first sentence before the period. That should put the blinking text insertion bar between the word "explanation" and the sentence's period.
Now, type a space followed by the words, "and it's all some people need". Notice that as you typed, your words were inserted into the sentence at the insertion bar pushing the rest of the words of the paragraph to the right and rewrapping the text appropriately. Nothing particularly surprising here if you're familiar with most any text editor on the Mac.
Now, double click the word "some" that you've just typed, hold the Command key down and press the "i" key on your keyboard. Notice that you've just italicized the word "some" in the sentence.
For convenience in this tutorial, from now on we'll abbreviate such key combinations in the following ways:
so that holding the Command and the Option keys simultaneously while pressing the "k" key will be abbreviated Cmd-Opt-k.
Of course, we could also have italicized the word "some" by selecting it, as before, and then clicking the Font menu item in the Format menu and dragging to the right in the hierarchical menu to choose the Italic menu item. Again, for convenience, we will abbreviate such menu choices as follows: "Format->Font->Italic"
p=. !$imagesDir$/voodoopad/vp2formatmenu.png!
In short, on the surface, VoodooPad behaves very much like the Apple TextEdit program when TextEdit is in Rich Text mode. Like TextEdit, we can display the Text Ruler and format our paragraphs.
To do this, click just before the first word of the first paragraph in the Work Area and drag all the way to the bottom of the last paragraph. That is, select all the text of the page except the graphic at the top and the heading. Now choose the menu item Format->Text->Show Ruler.
A text ruler should appear at the top of the page, like this
p=. !/fs/images/voodoopad/vp2ruler.png!
which will allow you to format the paragraphs. Notice a triangle pointing downward with a short bar over it at the left edge of the ruler.
This is used to set the indentation for any selected paragraphs. Notice that you've just indented all the paragraphs on this page.
There's much more to text editing, but VoodooPad generally uses the text editing capabilities built into MacOS X. If you're not familiar with the richness associated with such text editing capabilities, you can open TextEdit and choose Help->TextEdit Help for help with most of those text editing capabilities. We've also included a couple topics at the end of this tutorial if you would like to explore the text editing facilities in greater depth.
Our purpose here, however, is to help you learn how VoodooPad can help you organize your mind, so let's do a couple more fun things.
Notice in your document that the word, VoodooPad is highlighted and underlined just like a link in a web browser. That's because it is a link. Just click on it and you will be taken to a new page within VoodooPad.
The first interesting thing about clicking on that word is that the page you are taken to didn't exist until you clicked. When you did so, VoodooPad looked for a page for that alias, and when unable to find it, created a new page with the sentence "Write about VoodooPad here." at the top.
In general, when a new page is created for a link, the default format is to put a similar sentence at the top of an empty page that mentions the word (or phrase) you clicked, as follows:
"Write about <referenced word or phrase> here."
In order to see this in action, click at the end of the sentence on the new page and press the Return key twice to enter an empty line. Now type (or copy from this page) the words, "VoodooPad has shown that it clearly differs from TextEdit." As you do this, notice that the word "TextEdit" displays as a link as well.
Now click on the new TextEdit link and another new page will be created as we described. Add your name to this new page to make it unique.
Now, click the Back button at the very top of the new page twice and you will be taken back to the first page that was opened. We will refer to this first page as the Home page from now on. Once again, click on the word VoodooPad anywhere else in the Home page and you will be taken back to the VoodooPad page to see the additional text you added. This demonstrates that you're going to the same VoodooPad page from any VoodooPad link.
Once again, click on the Home page of VoodooPad and click to put the insertion bar at the very bottom of the page. Press the Return key twice and add the words, "TextEdit and more." Notice that the word, "TextEdit" has again been highlighted. Click on it and confirm that VoodooPad takes you to the same TextEdit page that was created by linking from your second page where you added your name.
Of course, not all links in VoodooPad are links to pages within the VoodooPad document. VoodooPad can distinguish real web links and will act appropriately.
To see this, go back to the Home page and scroll to the bottom where you will see a link to the VoodooPad web site ( http://www.flyingmeat.com/ ) in the second to last paragraph. When you click on that link, your browser will open and take you to the Flying Meat home page, the makers of this and other useful desktop tools for your Mac.
VoodooPad can be very intelligent about links and recognize them as they are typed in. As a final exercise in this topic, again go to the bottom of the text in the Home page and click on the TextEdit link. Add a space and the following after your name on the page: "http://www.apple.com". Notice that as soon as you type it in, it becomes a link. Click on the link and your browser will once again open and take you to the Apple home page.
We won't be using the document you just modified, so you're welcome to close it either by clicking the red Close button in the top left corner of the window or by choosing the File->Close or its keyboard equivalent, Cmd-w.
Doing so should display a sheet indicating that you've made changes to the document and asking what you would like to do. We would suggest clicking the Don't Save button.
Go to Links and New Pages. VoodooPad: VoodooPad Tutorialurn:uuid:f4399428-cca3-01da-043f-c0cbe4c49399:72006-06-05T13:31:57Z2006-04-15T10:19:11Zh2. VoodooPad Tutorial
VoodooPad is a simple and elegant Mac application that extends the concept behind a wiki to your desktop and puts you in control. That's a great explanation if you've actively contributed to a wiki, but if you haven't or don't know what a wiki is, then use this tutorial to get you started and comfortable with VoodooPad's features.
If you have contributed to a wiki, you might still want to skim through this tutorial to discover the many ways in which having a wiki on your desktop can help you painlessly organize your mind!
If you are familiar with a wiki, feel free to click on any of the following topics to review that material. Otherwise, it's probably wise to take the topics in order. There's a link at the end of each topic to the next topic.
Before we get lost, however, let's take a look at VoodooPad's navigation. Notice the 9 blue button icons in the toolbar at the top of the page. If you don't see any blue buttons, click the grey button in the upper right corner of the window once. Click it again, if they just disappeared.
VoodooPad can display pages very much like a web browser. The Back and Forward buttons shown at the left edge of the toolbar are to take you back or move you forward through the pages you've already explored. Similarly, the Home button near the center of the ToolBar will take you to the first page of a VoodooPad's document.
Now let's explore VoodooPad by clicking on the "Tutorial Introduction" link below:
Tutorial Introduction
Links and New Pages
Files and Documents
Importing and Exporting
Editing Text
Advanced Text Editing
p{color: #fff;}. Here are some future topics:
Getting Content Information
Automating with Scripts
Using ~Plugins
Adding ~Plugins
VoodooPad: Page Templatesurn:uuid:ea844ef8-efec-01d9-1a55-c0cbe4c4b030:92006-06-03T16:23:51Z2005-07-08T13:14:41Zh2. Customize the look of new pages with page templates.
Tired of the way all your new pages look? Wish you could center your text, add newlines, or just bold something? Help is on the way!
Create a page named "NewPageTemplate" and new page will come up with the content "Describe $title$ here." This new page now represents a template for your document when making new pages. Whenever we make changes to this page, all new pages will reflect those changes. For example- select the text "Describe" and bold it. Add some newlines to the page and type "$date$. Now make a new page. You'll see the new page created based off of the template we just modified. You can even insert images in the "NewPageTemplate" and they will show up on all your new pages.
What are some good uses of this?
* Making a default footer or header with links to new pages- a sort of built in navigation system.
* Setting a default background that might be easier on your eyes.
Note: This setting (per document) will override the setting you have in the preferences.
<br/>
h3. Mini-FAQ:
*Q. Is CSS usable ?*
A. No. VoodooPad uses OS X's native text format, RTFD as the format of its pages. Since CSS is based off HTML it is not used for page templates.VoodooPad: Lua Plugin Enablerurn:uuid:753b8d4e-ee03-01da-0caf-c0cbe4c4beb9:32006-05-28T20:31:36Z2006-05-27T21:35:58Zh2. Lua Plugin Enabler
Download for VoodooPad 2.5: http://flyingmeat.com/download/plugin/LuaPluginEnabler.vpplugin.zip (universal binary)
If you are using VoodooPad 3.0 and up, it's included by default so there's nothing for you to download.
The Lua Plugin Enabler lets your write simple VoodooPad plugins in the Lua programming language. If you are looking for a super easy way to extend VoodooPad, this is it.
We also provide a tutorial for writing your own Lua plugins: Hello World in Lua
As well there is a page of useful VoodooPad/Lua snippets for you to take advantage of: Lua Plugin SnippetsVoodooPad: Page Metaurn:uuid:520fdc5a-ee01-01da-105a-c0cbe4c48f7e:62006-05-28T20:21:21Z2006-05-27T21:20:40Zh2. Page Meta
VoodooPad Pro has a feature that lets you set arbitrary keys and values on a page, which can the be used later on in script plugins or triggers.
To add meta values for a page, bring up the Page and Document Inspector and select the "Page Meta" tab.
p=. !$imagesDir$/voodoopad/edit_meta_value.png!
h2. Scripts and Triggers
Meta values will be useful for you when combined with triggers or script plugins. Here's an example of a script plugin that uses a meta value named "todo" given to certain pages. It searches through all the pages in a document, finds the ones with the "todo" meta value set, and inserts those names in the current page.
<carea class="textareaCode">textView = windowController:textView()
list = "My todo pages list:\n"
for key in objc.values(document:keys()) do
page = document:pageForKey(key)
if (page:metaValueForKey("todo") ~= nil) then
list = list .. page:displayName() .. "\n"
end
end
textView:insertText(list)</carea>VoodooPad: Tipsurn:uuid:45fb1e4c-d0d0-01d9-1bf4-c0cbe4c48b7b:152006-05-28T13:22:48Z2005-05-29T23:01:33Zh3. Paste and Match Style
Sometimes you've got some text on the clipboard, and you want to paste it in to your page. But you know that since you copied it from Safari or Word that the text styling is just <em>not</em> going to match what you've set up on your page. And what a bummer that is. But wait- we've got that problem solved! Under the Edit menu, right next to the Paste command is another command labeled "Paste and Match Style". This will take what's on the clipboard and paste it into your page without any funky formatting. Just nice clean text the way you like it.
h3. Custom URLs
Did you know you can have a word or phrase link directly to a URL, so when clicked on it will open up in Safari? Choose the Edit->New URL... menu item, and enter the address (such as "http://flyingmeat.com/") and then the phrase you want to link to (like "Flying Meat" or something). Now whenever you type "Flying Meat" (or whatever) it will highlight and open up in your browser when clicked on.
To delete a custom URL, bring up the document info panel, and delete it from the table named "Files and URLs".
h3. Following Links with the Keyboard
If the insertion point happens to be on a link in VoodooPad and you want to open it, you don't have to reach for the mouse. Just type command-L and VoodooPad will do the right thing. Instead of creating a new page it'll just open up the link that you are on. It even works for multi-word links so you don't need to worry about selecting it first.
h3. VoodooPad & LaunchBar:
You can directly open a page by name with launchbar (in 10.4). Find out more from http://flyingmeat.com/board/viewtopic.php?t=205
h3. Quicksilver, too
The Launchbar tip works in Quicksilver. Just add the same folder to the index.
h3. Including the output of scripts in from your clippings folder.
If you create a unix shell script, and place it in VoodooPad's clippings folder, it will be run when selected from the insert menu, and then the output created from the script will be inserted where you have the cursor.
h3. Setting $PATH or other variables for scripts run from VoodooPad
If you want to set environment variables for your shell scripts, have a look at this Technical Q&A from apple:
http://developer.apple.com/qa/qa2001/qa1067.htmlVoodooPad: Lua Plugin Enablerurn:uuid:402f3ace-ee03-01da-0a4b-c0cbe4c4ff62:32006-05-27T21:36:12Z2006-05-27T21:34:29Zh2. Lua Plugin Enabler
The Lua Plugin Enabler lets your write simple VoodooPad plugins in the Lua programming language. If you are looking for a super easy way to extend VoodooPad, this is it.
VoodooPad 3.0 and later has this plugin bundled by default.
We also provide a tutorial for writing your own Lua plugins: Hello World in Lua
As well there is a page of useful VoodooPad/Lua snippets for you to take advantage of: Lua Plugin Snippets
For more information on Lua, visit http://www.lua.org/VoodooPad: Web Serverurn:uuid:8e7e9680-de58-01da-0286-c0cbe4c4b944:42006-05-27T17:57:19Z2006-05-07T23:04:48Zh2. VoodooPad Pro's Web Server
One of the advanced features of VoodooPad Pro is a built in web server to share your document on the internet or your local network. The web server also lets your network neighbors know about the service by broadcasting its availability via "Bonjour":http://www.apple.com/macosx/features/bonjour/ , making the ability to connect to it super easy.
h3. Starting up the web server:
VoodooPad Pro ships with the web server turned off by default, so to turn it on open up the preferences and choose the toolbar button labeled "Web Server", and click the button labeled "start".
When the server starts up correctly you may click the web address that appears above the stop button. Doing so will open up your web browser and allow you to pick from an open document to browse.
If no documents are listed, read on to learn how to turn on access to a document.
h3. Setting up a document to appear in the web server
By default all documents have the option to appear in the web server turned off. This is to keep you from accidentally sharing sensitive data over the internet.
To turn on web access for a document, bring up the Inspector (via the "View->Item and Document Inspector" menu) and flip on the "Show in local web access" setting under the Document tab.
h3. Problems?
*I can view my documents in the web browser, but nobody else can!*
It may be that you have a firewall running on your computer. To see if this is the case, open up the System Preferences and look under the "Sharing" preferences.
The tab marked "Firewall" should have the firewall turned off. If it is running, you may create a new setting to allow connections on port 8080 (which is the default port that VoodooPad's webserver runs on). Simply press the "New..." button, choose "Other" for the port name and enter 8080 for the port numbers. For the description enter "VoodooPad Web Server". Now your network neighbors should be able to connect. VoodooPad: AppleScripturn:uuid:6073cece-d0b5-01d9-13d8-c0cbe4c4a707:272006-05-27T17:29:26Z2005-05-29T19:49:01Zh2. AppleScript
* Simple AppleScript Examples
Whet your appetite.
* "Poor Man's AppleScript HTML Export":$scriptName$/42444f08-3610-01da-10f7-c0cbe4c4e0d3
An example that loops through all the pages, and writes out the contents between pre tags in html files.
* Copy Backlinks
Copies out a list of backlinks to the current page.
* Copy Pages List
Copies out a list of page titles of the current document.
* Get Random Paragraph
A fun little utility that prompts you with a random snippet
from your document, and lets you do various things with it.
* Export Current Page
This script will export the current page to HTML.
* Export Selection
This VP/Tex-Edit Plus script generates simplified HTML code.
* Add Style Tags To Selection
This VP/Tex-Edit Plus script adds HTML tags for bold and italics to the current selection.
* Open Exported Page
Opens an exported HTML version of the current page.
* Collect Prefixed Lines
Locates all the lines with a given prefix in your entire document and copies them to your clipboard. Useful, for example, if you wanted to extract all the lines beginning with "TODO: " from various project pages and place them in a single "To Do" page. (Requires VP 2.5+)
* Quicksilver Append to VoodooPad
Allows appending from Quicksilver to any of a number of VoodooPad pages based upon keywords.VoodooPad: Make this the Start Pageurn:uuid:5af55478-f7dd-01d9-0886-c0cbe4c4ac29:72006-05-27T17:29:15Z2005-07-18T15:43:27Z*Note: This script no longer works in Voodoopad 3.0*
Due to interface issues, it can sometimes be difficult to quickly set your "Index Page" aka "Home Page" aka "Start Page" in VoodooPad. This GUI AppleScript aids the process by setting the start page to the currently open page of your active VoodooPad Document.
Note that this GUI script was tested in 2.1.2, and that the GUI might change in future versions.
<carea class="textareaCodeLarge">set VPinfo to getVPinfo()
set theDoc to item 1 of VPinfo
set thePage to item 2 of VPinfo
set thePropWindow to theDoc & " Properties" as string
tell application "VoodooPad" to activate
tell application "System Events" to tell process "VoodooPad"
if (exists of window thePropWindow) is false then
click menu item "Document Info" of menu 1 of menu bar item "Page" of menu bar 1
repeat until (window thePropWindow exists)
delay 0.5
end repeat
end if
tell window thePropWindow
tell pop up button 1
click
click menu item thePage of menu 1
end tell
click button 1 -- close property window
end tell
end tell
on getVPinfo()
tell application "VoodooPad"
set oldDelims to AppleScript's text item delimiters
set theNames to ""
set theNames to name of window 1
if theNames is "" then set theNames to name of window 2
set AppleScript's text item delimiters to ".vdoc:"
set theNames to theNames's text items as list
set AppleScript's text item delimiters to oldDelims
end tell
return theNames
end getVPinfo</carea>
Submitted by – mike [dot] com [at] mac [dot] comVoodooPad: Collect Prefixed Linesurn:uuid:b1519ab8-4bf0-01da-1aac-c0cbe4c4bcae:72006-05-27T17:26:36Z2005-11-02T14:33:30Zh2. Collect Prefixed Lines.
<carea class="textareaCodeLarge">tell application "VoodooPad"
set linePrefix to text returned of (display dialog "What prefix should I look for when gathering lines?" default answer "TODO: ")
set foundItems to {}
repeat with myPage in pages of document 1
set pageParagraphs to paragraphs of text of myPage
repeat with myParagraph in pageParagraphs
set lineText to myParagraph as text
set AppleScript's text item delimiters to the linePrefix
set linePieces to every text item of lineText
if (count of linePieces) is greater than 1 then
set foundItem to the last item of linePieces
set the end of foundItems to "From " & (display name of myPage) & ": " & foundItem
end if
end repeat
end repeat
set AppleScript's text item delimiters to return
set the clipboard to foundItems as string
display alert "Finished" message "You may now paste the collected lines into any page."
end tell</carea>
Submitted by chiznibitz at yahooVoodooPad: Open Exported Pageurn:uuid:67086cda-d28c-01d9-04f2-c0cbe4c49adb:62006-05-27T17:25:40Z2005-06-01T04:00:45ZDo you regularly export your wiki to HTML? Do you ever wonder what a particular page looks like after it has been exported? Are you frustrated by the formatted filenames VP uses to make its URLs work? Then this script is for you!
This AppleScript takes the currently visible VoodooPad page and looks for its corresponding HTML document on either the web or your local disk. Please note that you must actually export your .vdoc document somewhere first, or at least the individual page you're looking for. (to find out how to export just the current page with a proper filename, see Export Current Page )
<carea class="textareaCodeLarge">
set thePath to "http://homepage.mac.com/MYUSERNAME/wiki/"
-- set this to the path of the server (or file:/// location)
-- of your wiki's html export.
-- Don't forget the trailing "/"
tell application "VoodooPad"
set thePage to ""
set thePage to the name of window 1 as text
if thePage = "" then set thePage to the name of window 2 as text
set theDoc to the name of document 1 as text
set theDoc to theDoc & ":"
end tell
set x to the length of theDoc
repeat while thePage begins with the theDoc
set thePage to characters (x + 1) thru -1 of thePage as string
end repeat
set the comparison_string to "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
set the source_string to "abcdefghijklmnopqrstuvwxyz"
set the newFile to ""
repeat with thisChar in thePage
set x to the offset of thisChar in the comparison_string
if x is not 0 then
set the newFile to (the newFile & character x of the source_string) as string
else
set the newFile to (the newFile & thisChar) as string
end if
end repeat
set AppleScript's text item delimiters to " "
set newFile to (text items of newFile)
set AppleScript's text item delimiters to "_20"
set newFile to newFile as text
set AppleScript's text item delimiters to ""
try
set newFile to (characters 1 thru 23 of newFile)
end try
set newFile to (thePath & newFile & ".html") as text
tell application "Safari"
make new document at end of documents
set URL of document 1 to newFile
end tell
</carea>
Submitted by - mike [dot] com [at] mac [dot] comVoodooPad: Add Style Tags To Selectionurn:uuid:77954688-ffa8-01d9-1af9-c0cbe4c4a457:72006-05-27T17:23:54Z2005-07-28T13:45:01ZThis AppleScript requires Tex-Edit Plus to work and is based on the "Export Selection" script. The purpose of the script is to insert the HTML tags for bold, italics, and strikethrough into VoodooPad's currently selected text. That's all it does; links are untouched and the underlining is ignored. This is useful for pasting into some bulletin boards and blogs.
Notes:
* For some reason this script seems to take >30 seconds to run, and ActivityMonitor shows the hard drive is not busy. I'm not sure why this is. If anyone knows, I'd appreciate an email to alangenh [at] excite [dot] com. Thanks!
* I seem to have to copy the the clipboard manually before calling the script. Don't know why.
<carea class="textareaCodeLarge">
--script to convert text styles in the selection to html tags using Tex-Edit Plus
tell application "VoodooPad"
activate
tell application "System Events" to keystroke "c" using command down
end tell
tell application "Tex-Edit Plus"
activate
make new document at front
tell application "System Events" to keystroke "v" using command down
set temporaryWin to name of front window
tell window temporaryWin
replace looking for "^*" looking for styles {style:{bold, italic, underline}} replacing with "&lt;b>&lt;i>^*&lt;/i>&lt;/b>"
replace looking for "^*" looking for styles {style:{bold, italic}} replacing with "&lt;b>&lt;i>^*&lt;/i>&lt;/b>"
replace looking for "^*" looking for styles {style:{bold, underline}} replacing with "&lt;b>^*&lt;/b>"
replace looking for "^*" looking for styles {style:{italic, underline}} replacing with "&lt;i>^*&lt;/i>"
replace looking for "^*" looking for styles {style:bold} replacing with "&lt;b>^*&lt;/b>"
replace looking for "^*" looking for styles {style:italic} replacing with "&lt;i>^*&lt;/i>"
replace looking for "^*" looking for styles {style:outline} replacing with "&lt;strike>^*&lt;/strike>"
replace looking for "^*" looking for styles {style:strikethrough} replacing with "&lt;strike>^*&lt;/strike>"
end tell
end tell</carea>VoodooPad: Export Selectionurn:uuid:068321d0-dcc7-01d9-0b38-c0cbe4c4e017:82006-05-27T17:23:11Z2005-06-14T04:25:35ZThis AppleScript requires Tex-Edit Plus to work. The purpose of the script is to convert VoodooPad's currently selected text into a highly simplified block of HTML code. The entire selection is rendered as plain text, except for the links. The links are wrapped in a properly formatted HTML link tag, either with or without a path to the location of your HTML export.
Note that external URL links are handled appropriately, but External URL aliases will end up linking to a non-existent page. If you manually associate external links to individual words (aliases) in your VoodooPad document, this script probably won't help you.
Please note that this script uses the odd characters "µ" and "Ω" which should look like a horseshoe turned up, and one turned down. (they are the greek letters mu & omega) If this doesn't appear correctly in your browser, you'll need to replace them with two unique characters that you don't typically use in your VoodooPad document.
<carea class="textareaCodeLarge">on trim(theSource)
set thePath to "http://homepage.mac.com/USERNAME/wiki/"
(*
Change the preceding line to the path (either local or remote) of your
VoodooPad HTML Export (Don't forget the trailing "/"). If the selection and
HTML will be used in the same directory, you can change this to "" (blank).
*)
set the comparison_string to "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
set the source_string to "abcdefghijklmnopqrstuvwxyz"
set newFile to ""
repeat with thisChar in theSource
set x to the offset of thisChar in the comparison_string
if x is not 0 then
set the newFile to (the newFile & character x of the source_string) as string
else
set the newFile to (the newFile & thisChar) as string
end if
end repeat
set AppleScript's text item delimiters to " "
set newFile to (text items of newFile)
set AppleScript's text item delimiters to "_20"
set newFile to newFile as text
set AppleScript's text item delimiters to ""
try
set newFile to (characters 1 thru 23 of newFile)
end try
set newFile to "<a href=\"" & (thePath & newFile & ".html") & "\">" as text
end trim
tell application "VoodooPad"
activate
tell application "System Events" to keystroke "c" using command down
end tell
set AppleScript's text item delimiters to "Ω"
tell application "Tex-Edit Plus"
activate
make new document at front
tell application "System Events" to keystroke "v" using command down
tell document 1
replace looking for "^*" looking for styles {style:underline} replacing with "Ωµ^*Ω"
set thebin to contents as text
end tell
end tell
set thebin to text items of thebin
set thebin to thebin as list
repeat with x from (count of text items of thebin) to 1 by -1
if item x of thebin starts with "µ" then
if item x of thebin starts with "µhttp://" then
set item x of thebin to "<a href=\"" & (item x of thebin) & "\">" & item x of thebin & "</a>"
else
set item x of thebin to trim(item x of thebin) & item x of thebin & "</a>"
end if
end if
end repeat
set AppleScript's text item delimiters to ""
tell application "Tex-Edit Plus"
tell document 1
set contents of document 1 to thebin as text
replace looking for "µ" replacing with ""
set style of contents to plain
set color of contents to black
set size of contents to 10
set font of contents to "Monaco"
end tell
end tell</carea> VoodooPad: Export Current Pageurn:uuid:268fede8-d1c1-01d9-0b51-c0cbe4c4a9af:202006-05-27T17:22:04Z2005-05-31T03:45:49ZThis AppleScript is intended to replicate VoodooPad's default HTML export behavior for the currently visible page. Its critical feature is the ability to correctly name the exported file so that other pages in your wiki will link to it properly.
<carea class="textareaCodeLarge">
set thePath to "/testwiki/"
-- it's important to set this path to the folder where
-- you'd like the resulting file to be saved, and don't
-- forget the trailing "/"
tell application "VoodooPad"
set thePage to ""
set thePage to the name of window 1 as text
if thePage = "" then set thePage to the name of window 2 as text
set theDoc to the name of document 1 as text
set theDoc to theDoc & ":"
end tell
set x to the length of theDoc
repeat while thePage begins with the theDoc
set thePage to characters (x + 1) thru -1 of thePage as string
end repeat
set the comparison_string to "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
set the source_string to "abcdefghijklmnopqrstuvwxyz"
set the newFile to ""
repeat with thisChar in thePage
set x to the offset of thisChar in the comparison_string
if x is not 0 then
set the newFile to (the newFile & character x of the source_string) as string
else
set the newFile to (the newFile & thisChar) as string
end if
end repeat
set AppleScript's text item delimiters to " "
set newFile to (text items of newFile)
set AppleScript's text item delimiters to "_20"
set newFile to newFile as text
set AppleScript's text item delimiters to ""
try
set newFile to (characters 1 thru 23 of newFile)
end try
set newFile to (thePath & newFile & ".html") as text
tell application "VoodooPad"
activate
tell document 1
export the page named thePage to newFile as HTML
end tell
end tell
</carea>
Script submitted by - mike [dot] com [at] mac [dot] com VoodooPad: Get Random Paragraphurn:uuid:eb3bb9c0-eef8-01d9-1072-c0cbe4c4d753:72006-05-27T17:20:14Z2005-07-07T08:08:05ZThis AppleScript will find a random paragraph on a random page of your wiki, and then display it in a window. It also has some neat features built into it, such as:
* Open the quoted VoodooPad page
* Put the quote on your clipboard
* automatically find all URLs in a quote, and open any or all of them in your default client.
* Set preferences while the script is running:
- the minimum paragraph word length to find
- the maximum number of times to try and find a suitable paragraph on each random page.
- the maximum number of random pages to look for a suitable paragraph in before giving up. (might increase the wait time)
Note that preferences will only be saved between runs if you use the system-wide script
menu, save the script as an application, or use a script launcher that supports persistent properties. As of version 2.1.1, VoodooPad's built-in script menu does not support this. As a work-around, you can change the default values directly in the script.
<carea class="textareaCodeLarge">property minWords : 10
property maxPageTries : 10
property maxDocTries : 10
(*
July 7, 2005
100% original code written by Michael Henley (mike.com@mac.com)
http://silvermeteors.com
-
This is Emailware, ergo, if you use this script regularly, or if you
use any part of it in your own scripts, you must send me a nice
email telling me how great I am. Thank you.
*)
set theCommand to "Try Again"
repeat while theCommand is "Try Again"
set randomResult to getRandomText()
set vpPage to (item 1 of randomResult)
set randomText to (item 2 of randomResult)
set randomMessage to "[" & vpPage & "]" & return & randomText
set theCommand to button returned of ¬
(display dialog randomMessage buttons {"Cancel", "Options", "Try Again"} default button 3)
repeat while theCommand is not "Try Again"
if theCommand is "Less Options" then
set theCommand to button returned of ¬
(display dialog randomMessage buttons {"Cancel", "Options", "Try Again"} default button 3)
else if theCommand is "Options" then
set theCommand to button returned of ¬
(display dialog randomMessage buttons {"More Options", "Copy Clip", "Open Page"} default button 3)
else if theCommand is "More Options" then
set theCommand to button returned of ¬
(display dialog randomMessage buttons {"Less Options", "Open URLs", "Configure"} default button 3)
else if theCommand is "Copy Clip" then
set the clipboard to vpPage & ": " & randomText
set theCommand to "Less Options"
else if theCommand is "Open Page" then
tell application "VoodooPad" to tell document 1 to open page with title vpPage
set theCommand to "Less Options"
else if theCommand is "Open URLs" then
try
set theURLs to getURLs(randomText) as list
if length of theURLs is 1 then
set theURL to theURLs as string
else
set theURL to choose from list theURLs
end if
open location theURL
tell me to activate
set theCommand to "Less Options"
on error
set URLerror to return & return & "Error! Couldn't find any URLs. Please select another option."
set theCommand to button returned of ¬
(display dialog randomMessage & URLerror buttons {"More Options", "Copy Clip", "Open Page"} default button 3)
end try
else if theCommand is "Configure" then
set minWords to text returned of ¬
(display dialog "Only find paragraphs longer than
this number of words:" default answer minWords)
set maxPageTries to text returned of ¬
(display dialog "Maximum attempts per page:" default answer maxPageTries)
set maxDocTries to text returned of ¬
(display dialog "Maximum attempts per document:" default answer maxDocTries)
set theCommand to "Less Options"
end if
end repeat
end repeat
on getRandomText()
(*
July 7, 2005
100% original code written by Michael Henley (mike.com@mac.com)
http://silvermeteors.com
-
This is Emailware, ergo, if you use this script regularly, or if you
use any part of it in your own scripts, you must send me a nice
email telling me how great I am. Thank you.
*)
tell application "VoodooPad"
set randomRange to the count of pages of document 1
repeat maxDocTries times
set randomPage to (random number randomRange)
set randomParaRange to count of paragraphs of (text of page randomPage of document 1)
set randomPage to name of page randomPage of document 1
repeat maxPageTries times
set randomPara to (random number randomParaRange)
set randomText to (paragraph randomPara of text of page randomPage of document 1) as text
if (count of words of randomText) is greater than or equal to minWords then
return {randomPage, randomText}
end if
end repeat
end repeat
return {randomPage, "Couldn't find a paragraph longer than " & minWords ¬
& " words after " & maxPageTries & " attempts on " & maxDocTries & " pages."}
end tell
end getRandomText
on getURLs(sourceText)
(*
July 7, 2005
100% original code written by Michael Henley (mike.com@mac.com)
http://silvermeteors.com
-
This is Emailware, ergo, if you use this script regularly, or if you
use any part of it in your own scripts, you must send me a nice
email telling me how great I am. Thank you.
*)
set endDelim to " " (* change this value if you're looking for
something other than a space at the end of your URLs *)
set URLList to {}
set oldDelims to AppleScript's text item delimiters
set AppleScript's text item delimiters to "
" -- strip carriage returns
set sourceText to text items of sourceText
set AppleScript's text item delimiters to endDelim
set sourceText to sourceText & endDelim as string
set URISchemes to {"http:", "https:", "file:", "ftp:", "mailto:", "aim:", "telnet:", "news:", "rtsp:", "afp:", "eppc:", "rss:"}
repeat with delim from 1 to length of URISchemes
set delim to item delim of URISchemes as string
set AppleScript's text item delimiters to delim
set trimText to {}
repeat with x from 2 to length of sourceText's text items
set trimText to trimText & (text item x of sourceText) as list
end repeat
set AppleScript's text item delimiters to endDelim
repeat with x from 1 to length of trimText
set URLList to URLList & (delim & text item 1 of item x of trimText) as list
end repeat
end repeat
set AppleScript's text item delimiters to oldDelims
return URLList
end getURLs
</carea>
Script submitted by – mike [dot] com [at] mac [dot] com VoodooPad: Copy Pages Listurn:uuid:bfffa03e-da06-01d9-0970-c0cbe4c4e290:52006-05-27T17:18:56Z2005-06-10T16:24:11ZThis AppleScript finds the complete titles of every page in the currently active VoodooPad document, and copies them to the clipboard in an alphabetized list. This script could take a few minutes to run depending on your system specs and the size of your .vdoc. Be sure to save (or backup) your .vdoc before running this script for the first time.
<carea class="textareaCode">tell application "VoodooPad"
set AppleScript's text item delimiters to ""
set theCount to the number of pages of document 1
set thePages to {}
repeat with i from theCount to 1 by -1
set the beginning of thePages to name of page i of document 1 as text
end repeat
set AppleScript's text item delimiters to return
set the clipboard to thePages as string
end tell</carea>
Script submitted by - mike [dot] com [at] mac [dot] comVoodooPad: Copy Backlinksurn:uuid:343844b4-da03-01d9-0340-c0cbe4c4f2af:102006-05-27T17:05:47Z2005-06-10T15:58:48ZThis AppleScript will copy all currently visible backlinks to the clipboard. To load the backlinks for a particular page, open the page and hit Shift-Command-B. It may take Voodoopad a few moments to find all of the backlinks for your page. Wait for the progress
indicator to disappear before using this script.
<carea class="textareaCode">
tell application "System Events"
set theBacklinks to value of text field of every row of table of scroll area of tab group of drawer of window of process "VoodooPad" as list
set AppleScript's text item delimiters to return
set the clipboard to theBacklinks as text
set AppleScript's text item delimiters to ""
end tell
</carea>
Script submitted by - mike [dot] com [at] mac [dot] comVoodooPad: Glossaryurn:uuid:a0fff7fe-c08a-01da-099f-c0cbe4c4af7f:122006-05-27T14:46:23Z2006-03-30T23:47:40Zh2. The Glossary
*Alias*: An alias is a word/link that goes to a page with a different title. For example, a page named "Apple Computer" might have an alias of "AAPL" which will link to the "Apple Computer" page. Find out more about aliases by reading it's topic page.
*Backlinks*: The pages that link to the page you are currently viewing. To view the backlinks for a given page, choose the "View->Palettes->Backlinks" menu item.
*Item*: An "item" is a chunk of data inside your VoodooPad document. Pages are items, but so are file links and custom url links. It's just a way to group together the things you put in VoodooPad.
*Orphan*: A page in a VoodooPad document that isn't linked to from any other pages in the document.
*Pad*: Another word for "VoodooPad Document". This was used way back for version 1.x, but the preferred term for the stuff you stick all your pages and items in is "Document".
*Triggers*: A Pro only feature- triggers are a handy way to script VoodooPad when certain events occur, such as a new page being created or deleted, documents opening or closing, files being written on web export and more.FlySketch: The Toolbarurn:uuid:2bb04e8a-fb15-01d9-0a29-c0cbe4c4eafb:182006-04-15T23:39:33Z2005-07-22T18:00:33Zh2. The FlySketch Toolbar
The toolbar is packed with a bunch of really useful buttons to press- and it's best to know what each one does first. Find out all about them below.
<br/>
!/fs/images/flysketch/toolbar-select.png!
The *Selection Tool* can be used to grab images and shapes for resizing or moving around the canvas. This is the basic tool you will use to get around the canvas.
*Key Shortcut:* V
<br/>
!/fs/images/flysketch/toolbar-oval.png!
The *Oval Tool* can be used to construct ovals or circles on the canvas. Simply select the tool and drag the mouse around to create your shape. Holding down the shift key while doing this will create a perfectly round circle for you.
*Key Shortcut:* C
*Tip:* Hold down the shift key to scale proportionally when resizing.
<br/>
!/fs/images/flysketch/toolbar-line.png!
The *Line Tool* can be used to make straight lines on the canvas. You also have the option of placing arrows on either end of the line.
Adding arrows is as simple as opening the inspector drawer in the box labeled “Arrow” use the checkboxs to mark which end(s) you want an arrow to appear.
*Key Shortcut:* L
*Tip:* Place arrows on the ends of your line with the arrow pallet to help with drawing diagrams.
<br/>
!/fs/images/flysketch/toolbar-rect.png!
The *Rectangle Tool* can be used to make rectangles or squares. Holding down the shift key while drawing this shape conforms it to a square.
*Key Shortcut:* R
*Tip:* Hold down the shift key to make your rectangle scale proportionally when resizing.
<br/>
!/fs/images/flysketch/toolbar-roundrect.png!
The *Round Rectangle Tool* can be used to make rectangles or squares with rounded edges. Holding down the shift key while drawing this shape conforms it to a square.
*Key Shortcut:* E
<br/>
!/fs/images/flysketch/toolbar-text.png!
The *Text Tool* is used to add text to the canvas. Choose the Text Tool and drag the mouse to create a rectangle where you want text to appear. Type away to add your text to the canvas. Change fonts using the font panel, which is brought up with the key combo Command-T.
*Key Shortcut:* T
<br/>
!/fs/images/flysketch/toolbar-freehand.png!
The *Freehand Tool* allows you to sketch anywhere in the canvas with freeform lines. Once freehand objects are created, you can only move them around- resizing them is not possible after creation.
Use this tool when you feel like being messy. Or, if you have a tablet attached, FlySketch will sense the pressure you are drawing with and adjust the width of your line.
*Key Shortcut:* F
<br/>
!/fs/images/flysketch/toolbar-highlight.png!
The *Highlighter Tool* is useful when you have a screen capture on the canvas, and you would like to highlight certain pieces such as text, or maybe images. If you fancy a color other than yellow, you may change the color (and transparency) of the Highlighter Tool in the preferences.
*Key Shortcut:* H
<br/>
!/fs/images/flysketch/toolbar-transparency.png!
The *Transparency Slider* is used when you want to make the canvas see-through, making it easier to see what you want to take a screen capture of. It’s also just neat to use- show it to your windows-using friends and make them jealous.
*Key Shortcuts:* 1-9, 0 (zero) to make the canvas opaque.
<br/>
!/fs/images/flysketch/toolbar-workflow.png!
*Workflow Actions* are used to perform actions against the images you create. Click on the script icon and you will be presented with a list of actions to use against the graphics current canvas. You can create a new action by opening up the Workflow Scripts folder, and dragging an alias of an application or folder in. To open up the Workflow Scripts folder choose “Open Workflow Scripts folder” from the actions menu.
When an action is run against an application alias (Like Mail, Photoshop, or Microsoft Entourage), FlySketch will open the image up just like you were dragging it to the applications’ icon. When an action is run against a folder alias, FlySketch will copy in the image.
*Tip:* If you are up to the challenge, with a little bit of scripting know-how, you can create and add your own unix shell scripts as actions by placing them in your “~/Library/Application Support/FlySketch/Workflow Scripts” folder. FlySketch recognizes the following list as files that are meant to be run as shell scripts: “py", "pl", “sh", "rb", “as", and "applescript”.
<br/>
!/fs/images/flysketch/toolbar-clear.png!
The *Clear Canvas* tool does just what its name implies- it clears the canvas of any objects. Deleting them forever. Gone, poof, no more.
...
Ok, you can always choose undo if you did this by accident.
<br/>
!/fs/images/flysketch/toolbar-screenshot.png!
The *Screen Shot* tool takes a picture of whatever is currently behind the canvas, and adds it as an image object. This is perfect for taking little shots of webpages, and then marking them up with the highlighter.
If you would like to have these images locked or unlocked, check out the option “Lock screen capture backgrounds” in the Preferences window.
FlySketch: New in FlySketch 1.6urn:uuid:b2e841c6-53e6-01da-01a8-c0cbe4c4ffb8:62006-04-07T22:14:00Z2005-11-12T17:42:07Zh2. What's New in FlySketch 1.6?
* <b>Full Screen Captures.</b>
New full screen shots, which will also take pictures of menus. Invoked via holding down the command key when hitting the camera button, or cmd-shift-5 (which may be changeable in the prefs if you don't like that). Find out more on the <!-- it's a bug, dont' ask.. --> Full Screen Capture page.
* <b>App Service Improvements</b>
FlySketch will now put pdf and tiffs on the pasteboard for use in the application services menu.
<b>Bug Fixes!!</b>
* Fixed a bug on export where the file extension of .png was given when no file extension was given in the export panel.
* Fixed a bug where the stroke size was lost when switching to the highlighter and back.
* Fixed a bug where a single click with the freehand tool would not draw a single dot. FlySketch: Be Creativeurn:uuid:cd0be2d4-fc88-01d9-142f-c0cbe4c4d867:102006-04-04T22:42:12Z2005-07-24T14:20:47Zh2. Be Creative with FlySketch
<br/>
h3=. Use FlySketch as digital tracing paper.
p=. !/fs/images/flysketch/creative-trace.png!
Since the FlySketch window supports multiple values of transparency, you can make the canvas act as tracing paper. Combined with the freehand tool, you can have your own virtual scratchpad.
Do you own a "Wacom":http://www.wacom.com/ tablet? The FlySketch Freehand tool is pressure sensitive- meaning the harder you press your tablet pen, the thicker the lines it draws. Combined with the "Darker" compositing mode, you get the feel of a real color pencil.
<br/><br/><br/>
h3=. Trace the human form with ease.
p=. !/fs/images/flysketch/creative-handtrace.png!
Maybe you have something more noble in mind than defacing websites. What about practicing your drawing? Place FlySketch over a masters' work, and start drawing and learning from the best.
<br/><br/><br/>
h3=. Smooth curves are a piece of cake.
p=. !/fs/images/flysketch/creative-smooth.png!
Built into FlySketch's freehand tool is the ability to have the lines that you draw come out smooth and beautiful. Move your mouse as fast as you can- you won't see any jagged edges here.FlyStash & Boomerang: Start Pageurn:uuid:3ec82d22-c72a-01d9-1a6f-c0cbe4c4de81:92006-03-16T10:28:30Z2005-05-17T16:20:24Zh2. FlyStash & Boomerang
*NOTE: There is currently no ongoing development with this project, and it's not supported. But feel free to play with it if you'd like.*
FlyStash is a server side wiki written in python which works along with Boomerang, which is a desktop application for Mac OS X. It's a research project of Gus's - so it is very likely to change alot before it is done. So don't put any important information in it, because you are sure to lose it at some point.
The official website is located at: http://flyingmeat.com/flystash/
* Backing up FlyStash
A must read if you use FlyStash.
* The Birth of Boomerang
How this little project came about.FlySketch: Entering Registration Informationurn:uuid:834ed0aa-2615-01da-076a-c0cbe4c4ae13:52006-02-22T23:26:52Z2005-09-15T11:21:20Zh2. Entering Registration Information
Once you've purchased a license for FlySketch, you are going to want to enter that information into the application so you no longer see the watermark telling you to go register. To do that, follow these simple steps:
1) Activate FlySketch by clicking on it's icon in the dock, or just by launching it.
2) Choose "Enter Serial Number…" from the Purchase menu in the menu bar.
3) Enter your registration name and serial number exactly as you received it when you purchased FlySketch.
4) Press the "Register" button.
And that's it. If you get an error message, double check that the information you entered is correct and try again. If for some reason a problem persists, contact support@flyingmeat.com , and we'll get it all sorted out.FlySketch: Compositing Modesurn:uuid:0f3ae094-ef71-01d9-0d3c-c0cbe4c4c1ec:92006-02-22T23:25:49Z2005-07-07T22:28:05Zh2. FlySketch Graphic Compositing Modes
If you are running FlySketch 1.5 on Mac OS X 10.4 or later, you will notice an extra pallet with various "Compositing modes". What the heck are those?
Well, direct from Apple, here's what you get:
* Clear
Transparent.
* Copy
Source image.
* Destination Atop
Destination image wherever both images are opaque, source image wherever source image is opaque but destination image is transparent, and transparent elsewhere.
* Destination In
Destination image wherever both images are opaque, and transparent elsewhere.
* Destination Out
Destination image wherever destination image is opaque but source image is transparent, and transparent elsewhere.
* Destination Over
Destination image wherever destination image is opaque, and source image elsewhere.
* Plus Darker
Sum of source and destination images, with color values approaching 0 as a limit.
* Plus Lighter
Sum of source and destination images, with color values approaching 1 as a limit.
* Source Atop
Source image wherever both images are opaque, destination image wherever destination image is opaque but source image is transparent, and transparent elsewhere.
* Source In
Source image wherever both images are opaque, and transparent elsewhere.
* Source Out
Source image wherever source image is opaque but destination image is transparent, and transparent elsewhere.
* Source Over
Source image wherever source image is opaque, and destination image elsewhere.
* XOR
Exclusive OR of source and destination images. Works only with black and white images and is not recommended for color contexts.
*Don't use PDF for copy and paste.*
A problem arises when you use PDF as the format for copying between applications. If you have compositing modes set on your graphics (such as darker/lighter drawing), then that information is lost when sent to PDF. Using the command below, you can skip the copying of PDF to the clipboard, and only rely on the TIFF data being there.
Quit FlySketch, paste that in the terminal, and you should be good to go. VoodooPad: Lua Pluginsurn:uuid:97eae072-6877-01da-1347-c0cbe4c4ccae:62005-12-08T23:27:00Z2005-12-08T21:49:42Zh2. Extending VoodooPad with Lua "Script ~Plugins"
* Hello World in Lua
* Lua Plugin Snippets
* Lua's Homepage: http://www.lua.org/FlySketch: The Palettesurn:uuid:5e187842-fb2a-01d9-1520-c0cbe4c48175:82005-12-08T15:19:29Z2005-07-22T20:32:17Zh2. FlySketch's Palettes
FlySketch 1.5 adds a new feature- side palettes. Using these palettes, you can perform various operations on your selected graphics, like apply drop shadows, align graphics, change color and compositing modes, and more.
!/fs/images/flysketch/palette-color.png!
The *Color Palette* can is used to change the fill and stroke colors of the selected graphic.
The filled in color well is used to control the fill color of the selected graphic. The stroked color well is used to control the stroke color of the selected graphic. Use the button with the arrows on either end to swap the fill and stroke colors.
The button with the slash is used to remove the selected graphics' stroke or fill value. When the fill color well is on top, pressing the slashed button will set the selected graphic to have no fill. Pressing it again will give the graphic back it's fill value. The same works for stroke values when the stroke color well is on top.
<br/>
!/fs/images/flysketch/palette-info.png!
The *Info Palette* displays coordinate and size information about the selected graphic.
<br/>
!/fs/images/flysketch/palette-stroke.png!
The *Stroke / Line Arrow Palette* allows you to change the stroke value for a selected graphic. In addition, if you have a line graphic selected, you can choose to have the lines capped with various shapes, and alter the sizes of those shapes.
<br/>
!/fs/images/flysketch/palette-align.png!
The *Align / Position Palette* is used to align selected graphics, or to move a single graphic to the front or back of the canvas. Left, right, top, bottom, vertical and horizontal center align options are available.
<br/>
!/fs/images/flysketch/palette-shadow.png!
The *Shadow Palette* is used to apply a drop shadow to a selected graphic. Use the widgets to vary the size of the shadow radius, and the offset of the shadow from the graphic.
<br/>
!/fs/images/flysketch/palette-composite.png!
The *Compositing Mode Palette* is used to alter the way the graphic is drawn on the canvas. (This option is available for 10.4+ only). Find out about the various options on the compositing modes page. VoodooPad: New in 2.5urn:uuid:e977c19e-36ae-01da-1e44-c0cbe4c498a6:122005-12-06T11:59:09Z2005-10-06T14:19:43Zh2. New Features in VoodooPad 2.5
h3. Web Export
The HTML export has been completely redone, supporting exporting your pages as Markdown, Textile, plain text, or using Apple's RTF to HTML conversion (10.4 only) for high fidelity markup.
And that's not all. Web Export also allows you to choose from various plugins which will give your pages a distinct look and feel to them.
h3. Multi-alias Support
Now your pages can have more than one alias! Make "Augie", "August", "Gustav", and "Gusser" all link to a page named "Gus".
h3. Automator Actions
VoodooPad 2.5 now comes with a handful of Automator actions.
h3. More AppleScript Support
New "display name" property for pages, and the ability to retrieve page keys from a document sorted by name, create date, and modified date.
h3. Option to turn off self referencing links.
No longer have the index page link to itself.
h3. Application Services "Drop Page"
Now in addition to "Make New Page" in the Application Services menu, we now have an "Append to Services Drop Page" menu item. So when you are in Safari and you see a snippet of text you'd like to snatch and catalog later one, you can select this menu item and it will be appended to a special page for later cataloging.
h3. The Smaller Things
* Pages now re-encrypt themselves when you leave them.
* New "Skip on export" option for pages in the info sheet.
* Improved AddressBook integration.
* Spotlight enhancements.
* New "Highlight" menu item under the Format menu to change the background of selected text.
* Rename categories by holding down the option key while double clicking on the name.
* New preference for for setting the external editor.
* Bug fixes! FlySketch: Full Screen Captureurn:uuid:9946fbc2-53e6-01da-1852-c0cbe4c4cc7d:32005-11-12T17:41:33Z2005-11-12T17:41:24Zh2. Full Screen Capture
FlySketch 1.6 includes a new feature that allows you to take full screen captures, including the ability to take pictures of menus in addition to the older ability to take snapshots of what is below the canvas.
By default you may use command-shift-5 to take full screen shots. FlySketch will at this point freeze everything on your screen and allow you to crop out a portion of the screen that you would like to use. Double click or press enter to accept what you have chosen, press esc to cancel.
Some shortcuts:
* Use the arrow keys to move the frame around.
* Use shift + the arrow keys to grow or shrink the frame left and down.
* Use command + the arrow keys to grow or shrink the frame right and up.
* Hold down the option key to move, grow, or shrink the frame in 5 pixel increments. VoodooPad: VPWindowMovieurn:uuid:65d2db28-e33c-01d9-0aea-c0cbe4c4f835:42005-11-01T15:34:16Z2005-06-22T09:40:53ZVPWindowMovie is a simple plugin that just makes a movie of what you are doing in a single window. Its prime purpose is to help Gus debug problems people are having in VoodooPad.
Currently, it has only been tested on 10.4.
Install: Just double click the plugin and VoodooPad should place it in the plugins folder.
Use: Go to the "Plugin->Miscellaneous->Start/Stop movie" menu item. Type type, click click away. When you are done, choose the same menu option, and save the movie.
You can download it from:
http://flyingmeat.com/fs/contrib/voodoopad/VPWindowMovie.dmgVoodooPad: Plugin Developmenturn:uuid:f9ca0dfe-4743-01da-0cd6-c0cbe4c4bb0e:32005-10-27T16:48:30Z2005-10-27T16:47:04Zh2. Plugin Development with VoodooPad
VoodooPad 2.0+ supports a plugin API, using loadable bundles written in Cocoa. Right now the documentation is located in VPPlugin.h, which can be download along with example code from here:
http://flyingmeat.com/download/plugin_latest.tgz
One word of caution- even though I don't plan on changing the API for future releases, it might end up happening anyway since this is the first crack at a plugin api for VoodooPad.
When you build your plugin in XCode, you'll need to link against VPPlugin.framework which is included along with source in the download. Sometimes paths get a little funny in XCode, so if you get errors building a stock plugin you might make sure this framework is reachable.
If you have any questions, comments, or ideas- please let me know at gus@flyingmeat.com. VoodooPad: Copy all pages to TextEdit AppleScripturn:uuid:03e528c8-3da8-01da-040e-c0cbe4c490ba:32005-10-15T11:19:24Z2005-10-15T11:17:59ZHere's an example AppleScript that loops through all the pages in the first VoodooPad document, and then creates a new document in TextEdit with the contents of all those pages.
<pre><code>set allText to ""
set pageMarker to "------------------------------------------"
tell application "VoodooPad"
tell document 1
repeat with i from 1 to number of items in pages
set pageText to text of page i
set pageName to name of page i
set allText to allText & return & pageMarker & return & pageName & return & pageText
end repeat
end tell
end tell
tell application "TextEdit"
tell application "TextEdit" to make new document at end of documents
tell application "TextEdit" to set text of document 1 to allText
activate
end tell
</pre></code> VoodooPad: How to register VoodooPadurn:uuid:f1c47344-309e-01da-1ada-c0cbe4c49d83:52005-10-10T11:41:13Z2005-09-28T21:10:18Zh3. How to register VoodooPad
Once you have your serial number for VoodooPad, you'll want to plug it in so VoodooPad knows you've done the good deed and you are allowed to have more than 15 pages.
To do this, choose "Enter Registration..." from the VoodooPad menu.
A panel will appear, with fields to enter your registration name and and serial number. Make sure when you enter them they are spelled exactly the same way as given to you when you completed your order (either via email or the web page). If it helps, you can cut and paste into these fields.
Then just press the "Register" button and you are good to go.
If you've already purchased VoodooPad and you don't now what your serial number is, visit our handy "serial number page":http://www.flyingmeat.com/voodoopad/serial/ and we'll send it to you via express email. VoodooPad: Contact Flying Meaturn:uuid:f89a48a2-368d-01da-135a-c0cbe4c497dc:32005-10-06T10:24:18Z2005-10-06T10:23:55Zh2. How to contact us
There are a couple of different ways to reach us, choose which one is best for your inquiry:
Our website: http://www.flyingmeat.com/
Bug reporting and feature requests: http://www.flyingmeat.com/pyr/
VoodooPad support email: voodoopad@flyingmeat.com
All other inquiries: info@flyingmeat.com VoodooPad: Formattingurn:uuid:a65928c4-368d-01da-07c9-c0cbe4c4e487:32005-10-06T10:23:08Z2005-10-06T10:21:37Zh2. Formatting Text in VoodooPad
h3. Changing the Font
VoodooPad supports the full range of text formatting that you have come to expect from a Mac OS X application. If you would like to change the current font, type Command-T to bring up the font panel. From here you can select from a list of styles and sizes.
h3. Changing the Background color
(Not available in VoodooPad Lite, 10.3 only)
VoodooPad will also let you change the background color of a page, as long as you are running Mac OS X 10.3 and above. Simply type Command-T from the page you wish to change the background color from, and select the button in the toolbar that looks like a piece of paper with a color box next to it. Save your document and you are set.
To change the color of a font, you must first make sure that the option "Allow manual underlining and font color changes" in the preferences options pane is turned on. This is turned off by default in VoodooPad because a blue and underlined word is what delimits a link.
Now if you would like to change the font color, bring up the font panel (Command-T) and select the appropriate color button to do so.
h3. New Page Text
You can change the default "Describe NewPage here" text when you create a new page.
Open up the prefrences, and alter the field "New page text" to your heart's content. Substitute $title$ for where the title of the page would go, $date$ where you would like an optional timestamp to go, and use \n to make where a newline should go.
h3. How to get a more stylized new page.
Tired of the way all your new pages look? Wish you could center your text, add newlines, or just bold something? Help is on the way!
Create a new page named "NewPageTemplate". You should get a page come up that says "Describe $title$ here." Now select the text "Describe" and bold it. Add some newlines to the page and type "$date$. Now make a new page.
Tada! Using this technique you can make your new pages look like you want to. You can even place images in by default.
Note: This setting (per document) will override the setting you have in the preferences. VoodooPad: Auto-bullets and stroke-outurn:uuid:43b35b46-368c-01da-07cd-c0cbe4c4c191:32005-10-06T10:19:16Z2005-10-06T10:11:42ZVoodooPad 2.0 has new support for inserting and maintaining bullet lists, and striking out paragraphs. To make a line into a bullet item, use the key-combo "Command-\". To remove the bullet type "Command-\" again. This will insert a bullet in the beginning of the line, and indent any line wraps below it that are part of the paragraph.
p=. !/fs/images/voodoopad/bullets.png!
To create another bullet, you can just hit enter at the end of your sentence, and when a new line is inserted it will place a bullet at the same position as the bullet in the previous line.
To end the bullet list, just hit enter twice at the end of your last bulleted line.
Hint: If you want to enter a bullet at any point in a paragraph, do so by using the key-combo "Option-8".
You may also indent and undent a line by using the key combos "Command-Option-]" and "Command-Option-[". Using this functionality you can create nice lists and outlines.
If you want to strike out some text, you can use the key-combo "Command-Option-K". This will draw a single line through the currently selected text, or for the whole paragraph if no word is selected. Use the key-combo again to remove the strike-out.VoodooPad: New in 2.1urn:uuid:b07a2602-368b-01da-0b22-c0cbe4c4a51d:32005-10-06T10:08:34Z2005-10-06T10:07:35Zh3. Category / Tag support
(Not available in VoodooPad Lite)
You can now assign a category (or tag as it is sometimes called) to a page in your document. A page can also belong to multiple categories.
To play with the categories choose "Show Categories" from the Page menu, and a drawer will pop open on the left side of your window. Create a new category by pressing the "+" button, delete an entry (or association to a page) by pressing the "-" button. The little green arrow will add the current page to the selected category, or you can hold down the option key when pressing the toolbar button to add the current page to the selected category.
h3. Spotlight support
VoodooPad comes with a plugin for 10.4 Tiger's Spotlight. Now you can search the contents of your VoodooPad documents (which can also be disabled in the document properties window).
h3. HTML export improvements
When exporting a page as HTML (not available in VoodooPad Lite) VoodooPad will now create CSS styles to reference for the markup of the page. Strikeouts in your text are now marked up for export as well.
h3. Inter-document links
You can now link to a specific page in another VoodooPad document. (Not available in VoodooPad Lite). Just drag and drop the document you want to link to onto your current VoodooPad page, and VoodooPad will give you the option to link to that document or to a specific page inside that document.
h3. Remote wiki editing removed
But it's not a bad thing!
The remote editing functionality now lives on in a separate application known as Boomerang, where it is enjoying life and happily connecting and synchronizing with its partner in crime, FlyStash (the cgi script formerly known as VPStash). It's free for VoodooPad 2.0 owners, and you can find out all about it at http://flyingmeat.com/flystash/.
h3. A new look for the Preferences
The preferences window has been updated, and it no longer looks like it was made by a drunk Microsoft Windows programmer. Now it looks more like a drunk Macintosh programmer designed it.
h3. Unlinking
Choose "Unlink" from the Edit menu while on a VoodooPad link, and the link will be gone.
h3. New AppleScript commands
New AppleScript command "current selection" for use on windows, and a new command to export a single page as HTML, RTFD, or plain text.VoodooPad: New in 2.0urn:uuid:89bbef6e-368b-01da-18cf-c0cbe4c4a1cc:32005-10-06T10:07:29Z2005-10-06T10:06:30Zh3. Encryption
(Not available in VoodooPad Lite)
VoodooPad now supports encrypting individual pages in a document. You can be sure that your documents are secure because VoodooPad uses an industry standard encryption algorithm named "Blowfish" ( see http://www.schneier.com/blowfish.html for more information ).
Too many passwords to remember? VoodooPad gives you the option to store your password on the KeyChain as well.
h3. Sketch
(Not available in VoodooPad Lite)
"Because sometimes a picture is worth one thousand words."
Feeling artistic? Bring down the Sketch sheet and draw what you can't express in words.
h3. Backlinks
(Not available in VoodooPad Lite)
One of the most requested features- backlinks open up in a drawer, and give you a list of pages that link to the one you are currently viewing.
h3. Saved Workspaces
Quit with all your windows open. Relaunch, and there they are again. Great for pickup up where you left off.
h3. New Search
(Not available in VoodooPad Lite)
VoodooPad's searching has improved by leaps and bounds. Search multiple documents and have the results return in a single list- double click a search result and be brought right to what you are looking for.
h3. New AppleScript commands
(Not available in VoodooPad Lite)
New commands to export to the iPod, open, create, delete, append to, and prepend to pages. See for more information.
h3. AddressBook Integration
(Not available in VoodooPad Lite)
Names in your AddressBook will now be highlighted, and when you can click on them you can open up the person in your address book, or be given the option to email them.
h3. Indentation, and bullets
VoodooPad now makes it really easy to create little outlines with new buttlet-item commands and text shifting.
h3. Rename pages
Do you not like the title you gave a page? No problem, in VoodooPad 2.0 you can now rename it.
h3. Improved URL and email address markup
We wrote a fancy new markup engine that's pretty darn fast had uses neat tricks to figure out just what is and is not a URL or email address. You just get to enjoy improved link recognition. Every one is happy.
h3. Threaded exporting
(Not available in VoodooPad Lite)
Do you have lots and lots of pages, and does it took a loooong time to export? Now VoodooPad will take those tasks and put them in the background so you can keep on working in your pages without being interrupted.VoodooPad: Introductionurn:uuid:9429bbb2-368a-01da-178e-c0cbe4c4e12a:32005-10-06T10:02:27Z2005-10-06T09:59:38Zh2. Introduction
VoodooPad is best described as a self contained website that runs on your computer. It's a little brain where you can put disparate bits of information in that you need to keep around for whatever reason may suit you. It's super easy to use as well, just type whatever you need to remember, and link when you want to branch a thought or start a new page.
Type in your notes, and highlight important words or phrases to create new pages; or drag and drop folders, images, applications, or URLs into VoodooPad - they're linked up whenever the word representing it is found.
When you create a new document, it starts with an "Index" page which you are free to add and change the contents of all you want. You build your document up from this page; your personal info-web grows organically as you add more to it.
h3. How Can I use VoodooPad?
Use it for bits information that you want tucked away where you can easily get to it when you need it.
VoodooPad is in use for such things as research projects, building quick and simple websites, storing directions to friend's houses, and documentation projects. It's uses are endless, and you will find yourself being productive with it right away.
h3. How does it work?
VoodooPad is based on a simple idea of linking pages of information that you write. It works just like you would browse on the internet, except you can edit any page. Drag and drop files into VoodooPad and they will become links as well. You can also type in common urls like http://www.apple.com/ and email addresses and they will be ready for you to click on them.
Type the word "Index" anywhere on a page, notice that it is a different color and underlined. Anywhere you type in the word "Index" (or index - it is not case sensitive), it will automatically highlight because a page entitled Index is already in your VoodooPad document. And any time you click on the Index link it will take you to that page. You can also highlight any other word, and choose "Make Link" from the Edit menu, or use Command-L to make your selected word link the same way.
You can create a new page in your document even if you aren't ready to link to it just yet- use Command-N and enter the title of it, and presto-magic, it's created for you.
You may notice that some words appear with underlines, but are not highlighted blue. These are words that are "potential links" (also known as wiki-words), but have not yet had a page created for them. Clicking on the link will create a new page, and change the color of the link to blue (unless you have changed the color in the preferences). VoodooPad: Web Export Notesurn:uuid:dbc5bb4a-3155-01da-1962-c0cbe4c48fd0:132005-09-30T18:34:02Z2005-09-29T18:59:39Z( check out Web Export for the official docs)
It seems that vphtmltemplate doesn't work with this new feature. I imagine that we will need to create our own _Web Export Plugins_?
You can create a page named “WebExportPageTemplate”, this is just like the vphtmltemplate page- only I didn’t want it to be tied up with the legacy stuff with the old html exporting. -Gus
...
I don't really mind trying to create my own _personalized Web Export Plugin_, I just need to know where to put images etc. -Andy
Images can be wherever you want if you are creating a plugin- the a postflight script would just need to copy it to the right location (like the gmdc plugin does with gmdc.css) -gus
For the record, it wasn't difficult. Besides it's a great place to store the css and images, etc. -Andy
...
I essentially copied lots of stuff to create a new _Web Export Plugin_. It works, but I need more info on the new variables for these templates. -Andy
I’ll try and get those documented sometime soon. -Gus
...
$vptitle used to insert the page's alias. $title$ seems to insert the page's name. -Andy
I’ll see if I can add $alias$ to pull out the first alias. - gus
FlyGesture: Moviesurn:uuid:820673de-03dc-01da-16df-c0cbe4c4eac5:42005-08-26T14:59:51Z2005-08-02T22:07:37Zh2. Movies of FlyGesture in action.
Sometimes you just can't capture what an application is about in just words or screenshots. So we've put together some movies for you to watch to help get the point across. (Note: "QuickTime":http://www.apple.com/quicktime/ 7+ is required to watch these movies).
* Watch as simple mouse gestures control Safari, Exposé, and iTunes:
"itunes-safari.mp4":http://flyingmeat.com/fs/contrib/gesture/itunes-safari.mp4
* See how to configure multiple actions together in a single gesture.
"chain-actions.mp4":http://flyingmeat.com/fs/contrib/gesture/chain-actions.mp4FlyGesture: How it Worksurn:uuid:13e8c95e-05f5-01da-063c-c0cbe4c4ebff:52005-08-26T14:59:18Z2005-08-05T14:08:32Zh2. How FlyGesture Works.
The idea behind mouse gestures is very simple, but makes for a very powerful and elegant solution for performing specific actions on your computer. The way it works is you usually hit a modifier key (like F1 with gesture), and then draw on the screen with your mouse. The symbol that is made by your movements is mapped to a specific action (or actions) that will be then performed. Actions like "Create a new document", or "Start a new mail message", or "Close window".
FlyGesture does all this and more. FlyGesture provides "guides" on screen for you to move your mouse through and gives instant feedback to you so you know if you are on the right track to performing an action. When the guides you are moving through are blue, it means you are going down a good path to a gesture. When the guides turn red, that means that FlyGesture no longer knows of any actions to perform based on the gesture you are creating. Along with just giving feedback in the form of colors, when you come to the end of a path, the name of the gesture is displayed below the guides.
Here's an example- let's say we want to invoke the "*Hide All*" gesture
!/fs/images/gesture/how-it-works-step1.png!
The first thing to do is invoke FlyGesture by press and holding F1. FlyGesture automatically draws all the guides around your current mouse position, meaning you always start your gesture from the middle. Now, move your mouse to the guide right below your current position as shown in the picture above. Notice how the words "Page Down" appear below the guides- this indicates that if you were to release F1, the "Page Down" action would be invoked. But don't do that- let's keep on moving our mouse.
!/fs/images/gesture/how-it-works-step2.png!
Now move your mouse to the right as shown in the image above. The display now says "Hide All", and if we release F1 FlyGesture will tell all the running applications to "hide".
Piece of cake. Try looking through the FlyGesture catalog (opened by choosing "Open Catalog" from the menubar), and seeing what other gestures you can learn. You can even add your own.FlyGesture: AppleScripturn:uuid:e48fa318-c7eb-01d9-07aa-c0cbe4c4b542:82005-08-26T14:58:21Z2005-05-18T15:26:35ZAppleScript is a basic building block of FlyGesture. When you complete a gesture command, it looks up the gesture in it's catalog, finds the AppleScript associated with it, and executes it.
To learn move about AppleScript, visit http://www.apple.com/applescript/
Here are a couple of sample scripts that may be used in FlyGesture:
Simply tell the finder to activate:
@tell application "Finder" to activate@
Activate Safari, and create a new window:
<code>tell application "Safari"
activate
make new document
end tell</code>FlyGesture: Frequently Asked Questionsurn:uuid:f0f0e2fa-0528-01da-102d-c0cbe4c4c388:52005-08-26T14:56:26Z2005-08-04T13:47:16Zh2. Frequently Asked Questions (FAQ)
h3. How can I have gesture run my unix shell script?
The easiest way to do this is to wrap your shell script in a .command file for Terminal.app to open up. Then add a "Open File or Folder" action to your gesture, and select the .command script / file you just created.
h3. Why do the guides I've moved through turn from blue to red?
FlyGesture gives feedback in the form of changing the colors of the guides to let you know you are on the right track to finding your gesture. When it's blue, that means you are going down a good path to a gesture. When the guides turn red, that means that FlyGesture no longer knows of any actions to perform based on the gesture you are creating.VoodooPad: HTML Exportingurn:uuid:f0a6607e-0828-01da-1a1c-c0cbe4c496c9:42005-08-08T09:25:53Z2005-08-08T09:24:49Zh2. HTML Exporting
(This is just a stub page, to get this AppleScript in place).
<code><pre>
tell application "VoodooPad"
activate
set p to {fileExtension:"php", filePath:"/tmp"}
tell window 1 to use plugin named "Export as HTML..." with properties p
end tell
</pre></code>FlySketch: FTP Uploadurn:uuid:8435226a-05d8-01da-18b9-c0cbe4c495be:32005-08-05T10:50:25Z2005-08-05T10:44:05Z
h2. FTP Upload Script
As seen on the FM Board ( http://flyingmeat.com/board/viewtopic.php?p=946 ) by "dvancamp":
Most of the time when I take a screen shot it is to share it. I end up going right to the FTP anyway; so I added this little script to cut out the middleman. I have it automatically saving my shots to my server and placing the URL in my clipboard ready for pasting into my BaseCamp messages.
Currently it's encoding that space between the date and time so it's ready to paste. If you don't want the encoding delete | sed 's/ /%20/g'
Save it as "Send to FTP.sh" in your Workflow Scripts folder, update it with your server info, and set the permissions "chmod 755".
curl -T "$*" ftp://$USER:$PASS@$HOST
</code>FlyStash & Boomerang: Backing up FlyStashurn:uuid:ca56c33a-c7ed-01d9-1bca-c0cbe4c4809e:92005-08-04T11:06:26Z2005-05-18T15:40:10Zh2. Backing up FlyStash
Assuming you installed FlyStash the way it is recommended on Mac OS X, simply follow the instructions below to make an xml document containing your FlyStash data.
You will then have a copy of the data in your home directory, in a document named "flystashbackup.xml"FlyStash & Boomerang: The Birth of Boomerangurn:uuid:348c223e-0512-01da-1c41-c0cbe4c4fc75:32005-08-04T11:04:59Z2005-08-04T11:04:31Zh2. The Birth of Boomerang.
So here's the story on how Boomerang and FlyStash came to be, and the current state of things as of August 4, 2005.
A long, long time ago VoodooPad 1.1 introduced a new feature known as "Remote Editing". This feature would allow you to connect to a custom built wiki server known as "vpwiki", and allow you to click through the pages, edit, and save back to the server. These pages were also editable from the web.
However, there was one very large problem- VoodooPad uses rich text to store it's contents, but web-browsers have no way to view and edit this format- so when VoodooPad saved to the server it sent two versions of the page- one in rich text format, and one in plain text format (so web visitors could see the page). If someone edited a page from the web, then the rich text version was thrown away because it was now out of date. And there goes all the fancy bolding and highlighting, and embedded images, files, and the text layout you put together. Bummer.
Alot of work was put into VoodooPad 2.0 improve the situation. VoodooPad moved to using plugins to talk to the wiki server, so in theory a plugin could be made to talk to a Wikimedia wiki, Twiki, or any other wiki providing someone was willing to do the work to write the plugin. And now instead of sending two formats to the server, VoodooPad sent three- rich text, plain text, and a in-between format which could be thought of as "textile lite". VoodooPad (and now vpwiki) also supported the uploading of attachments- so if a VoodooPad page had an image displaying in it, you could now also see it from the web.
But some basic problems still remained. All the rich text formatting was still lost if edited from the web, multiple people working on the same page at the same time would be overwriting each other's work, and it just wasn't very a smooth experience.
Some major features that were missing were things like conflict resolution, having a local copy of the contents for offline editing and viewing, syncing, security, and basic account management.
And besides not having all the features it needed, the remote editing api was actually holding VoodooPad back from evolving on it's own. Since so much was shared in the code between the two editing modes (local vs. remote) design decisions were made that crippled the way VoodooPad worked when just editing on regular documents. That sucked.
So the (very hard) decision was made to split the remote editing out of VoodooPad 2.1, and put it in a separate application. And thus Boomerang was made, and vpwiki was redesigned and reborn as "flystash".
I'll be honest and say not as much work has gone into Boomerang as I'd like, which is why it isn't talked about much and why it is still considered a "research project" (but it's a project that I'm just dying to do.). In it's current state however, it is still much better than what was provided in VoodooPad for remote editing. Current features include authentication, http gzip compression, offline editing, syncing, and conflict resolution. It still obviously has a long way to go, but it's a start.FlySketch: New in FlySketch 1.5urn:uuid:99e78032-ff28-01d9-1ca2-c0cbe4c4fbfe:82005-07-28T08:04:44Z2005-07-27T22:29:43Zh2. What's New in FlySketch 1.5?
* <b>PDF Workflow support.</b>
Now part of the workflow menu, supporting all the system wide PDF Workflow scripts, including Automator support.
* <b>Fancy Pants Palettes.</b>
The drawer is gone, and now we have the palettes to stash all kinds of new features in.
* <b>Smooth Freehand Lines.</b>
FlySketch now makes those pesky straight lines in the freehand tool nice and smoooth.
* <b>Resize canvas to super small.</b>
You can now change the canvas size all the way down to 1x1. Also includes a new widget to let you know what size you are at as well.
* <b>New color picker.</b>
FlySketch mimics what the big boys do for selecting colors now.
* <b>Shadows on Graphics!</b>
Set a shadow on any selected graphic, even images. Control the offset and blur radius of the shadow as well.
* <b>Compositing modes.</b>
New for 10.4 users. Darker, Lighter, Source In, Source Out, etc.. See the compositing modes page for more information.
* <b>Grids!</b>
The canvas now has an optional grid, with snap to support.
* <b>New startup pref</b>
What's that? You just want FlySketch to disappear into the background when launched? No problem, we can do that.
* <b>Lots of new menu widget commands, including:</b>
** Import image.
** Resize canvas.
** Add border around canvas.
* <b>New "round rectangle" shape.</b>
By popular demand- rounded rectangles are our friends now.
* <b>New "configure sheet" for new shapes</b>
Invoked via a single click on the canvas while a tool is selected, it allows you to set dimensions and other properties of a new graphic.
* <b>New line end shapes in addition to arrow- circle and diamond.</b>
Stroked and filled varients as well.
* <b>Auto-detect new scripts</b>
The workflow scripts menu updates when new scripts are added/removed from the workflow directory. No more restarting to see new workflows!
*Various Bug fixes:*
* Window now stays transparent when resizing.
* Default stroke size is remembered between launches.
* Fixed a problem when resizing an image with the shift key held down.
* You can no longer set the fill color for a text box- this caused confusion when trying to set the color for a range of text.
* Lines with arrows now remember the side the arrow was on when resizing from the lower left corner
* Freehand lines now do left/right/top/bottom alignment.
* Straight lines with arrows on the end no longer freak out when doing multiple alignments.
* Fixed "Send to Mail" bug on 10.4
* If a screen capture is at the bottom of the graphics stack and it is locked, "send to back" will no longer place an image below it, instead it we be placed right above it. FlySketch: Upload to Flickrurn:uuid:23f23e28-ec2a-01d9-16df-c0cbe4c4b0d0:112005-07-23T20:18:06Z2005-07-03T18:22:52Zh2. Upload to Flickr Workflow
First- what is Flickr? http://flickr.com/ - "The best way to store, search, sort and share your photos."
Ok, so the idea is that you create something in FlySketch, and then choose "Upload to Flickr" from the workflow menu, and tada- the world gets to see your beautiful drawing / creation / screen grab / whatever.
To set this up, you are going to need an "Automator":http://www.apple.com/macosx/features/automator/ action (link provided below), you have to configure the action and then save it as an app in the FlySketch workflow folder. It's pretty simple, let's get started.
# Grab the "Automator action":http://fraserspeirs.livejournal.com/869471.html , lovingly provided by "Fraser Speirs":http://fraserspeirs.livejournal.com/ .
# Install the action in your ~/Library/Automator folder ( you might have to create the Automator folder first)
# Open up Automator and include your account information, and configure it as you may. Save the workflow as an action in your ~/Library/Application Support/FlySketch/Workflow Scripts folder. Call it "Upload to Flickr". You may have to quit and restart FlySketch to see the workflow action show up.
# Make sure your workflow settings are set to "png" in the preferences.
# Try it out by choosing "Upload to Flickr" from your workflow actions (the button with the script symbol on it).
*Troubleshooting:*
* It isn't working for me!
Are you sure you put in the right username (it's your email address) and password?
* I'm still on 10.3 - what are my options?
None right now- however it shouldn't be too hard for another script that works on 10.3 to come along and do the same thing. If one ever shows up we'll update this page.FlySketch: Feedback Linksurn:uuid:c1ed7348-fb27-01d9-03f2-c0cbe4c4c575:62005-07-23T18:16:41Z2005-07-22T20:13:36Zh2. Talk to us and let us know what you think
We are always wanting to hear from our customers or potential customers. So if you have a comment, question, or just want us to hear from you, send an email to info@flyingmeat.com.
You can also check us out on the web: http://www.flyingmeat.com/
For specific support questions with regards to FlySketch, email: flysketch@flyingmeat.com
For bugs and feature requests, please visit: http://www.flyingmeat.com/bugs FlyGesture: Key Codesurn:uuid:117afd02-f657-01d9-0fb0-c0cbe4c4edd6:42005-07-16T17:10:45Z2005-07-16T17:09:40ZHere's a big list of the keycodes you can use when telling System Events to type one.
keycode: keystroke
0: A
1: S
2: D
3: F
4: H
5: G
6: Z
7: X
8: C
9: V
10: $
11: B
12: Q
13: W
14: E
15: R
16: Y
17: T
18: 1
19: 2
20: 3
21: 4
22: 6
23: 5
24: =
25: 9
26: 7
27: -
28: 8
29: 0
30: ]
31: O
32: U
33: [
34: I
35: P
36: Return
37: L
38: J
39: '
40: K
41: ;
42: \
43: ,
44: \/
45: N
46: M
47: .
48: Tab
49: Space
50: `
51: Delete
53: Esc
55: Command
56: Shift
57: Caps Lock
58: Option
59: Control
65: Pad .
67: Pad *
69: Pad +
71: Clear
75: Pad /
76: Pad Enter
78: Pad -
81: Pad =
82: Pad 0
83: Pad 1
84: Pad 2
85: Pad 3
86: Pad 4
87: Pad 5
88: Pad 6
89: Pad 7
91: Pad 8
92: Pad 9
96: F5
97: F6
98: F7
99: F3
100: F8
101: F9
103: F11
105: F13
107: F14
109: F10
111: F12
113: F15
114: Ins
115: Home
116: Page Up
117: Del
118: F4
119: End
120: F2
121: Page Down
122: F1
123: Left Arrow
124: Right Arrow
125: Down Arrow
126: Up Arrow
Pad -: 78
Pad .: 65
Pad *: 67
Pad /: 75
Pad +: 69
Pad =: 81
Pad 0: 82
Pad 1: 83
Pad 2: 84
Pad 3: 85
Pad 4: 86
Pad 5: 87
Pad 6: 88
Pad 7: 89
Pad 8: 91
Pad 9: 92
Return: 36
Pad Enter: 76
Home: 115
End: 119
Page Up: 116
Page Down: 121
Del: 117
Delete: 51
Right Arrow: 124
Left Arrow: 123
Up Arrow: 126
Down Arrow: 125
Esc: 53
Caps Lock: 57
Clear: 71
Command: 55
Control: 59
Shift: 56
Space: 49
Tab: 48 VoodooPad: Export Pages Listurn:uuid:a1a0d5b4-d1b8-01d9-13ea-c0cbe4c4e4d9:112005-06-24T14:55:33Z2005-05-31T02:44:50ZThis AppleScript has been moved to Copy Pages List