OPML Editor for Windows 0.56 User's Manual
About the OPML Editor
The OPML editor is an application designed to allow you to write and edit outlines that use OPML (Outliner Processing Markup Language). The tool can publish these outlines as an "OPML blog," make standalone OPML outlines. OPML outlines have also been used to allow many people to collaborate on lightweight, distributed directories, such as the iPodder.org directory of podcasts. The OPML Editor is developed by Dave Winer.
About this Manual
This manual is being written by Lisa Williams. You can see Lisa's OPML weblog, OPML Fan, here and her personal weblog here. Feel free to drop me a note at lisa AT cadence90 dot com. I'd like to thank the users of OPML Newbies, OPML Support, and Dave for putting together so many great questions and tips. This manual is intended to be a User's Manual, and not a Developer's Manual. The OPML Editor is eminently hackable and extensible and over time, there will undoubtedly be a rich collection of tips and tricks for developers to tweak and add onto the OPML editor. However, this manual is intended largely as a User's Manual, not a Developer's Manual. Of course, that may change if I accumulate mad skillz.
You can find the latest version of this manual, in OPML format, at http://hosting.opml.org/thisislisa/opmleditormanual.opml. With the OPML editor open, choose File>Open URL and paste in the URL to get the latest manual.
This manual is unfinished and being built now -- many sections are empty. I make this manual available in its draft state to remain open to the OPML Editor user community, who will be able to see changes as I make them, and suggest new directions and corrections at any time.
Finding Out More About the OPML Editor
Read and subscribe to OPML Support.
Dave's collection of docs and howtos is at http://docs.opml.org. Link. This collection is essential. Read them.
Join the OPML Newbies mailing list. This is an active list where users trade tips and try to answer questions.
Tom Simpson has set up a wiki for users of the OPML Editor to collect workarounds, wishlists, and tips at http://opml.pbwiki.com/ Link.
Installing the OPML Editor
Download the OPML editor from http://support.opml.org/download/
Requirements
Using the OPML Editor for The First Time
Publishing Your OPML Blog
Customizing Your Blogroll
Customizing the Look of Your OPML Blog Using Stylesheets
Displaying More Than One Day on Your OPML Blog
The default setting for your OPML blog is to display only one day's worth of posts on the main page of your blog. You can change this by choosing Community>Your OPML Weblog>Days On Main Page. Be sure that this number of days is not more than the number you've had your blog! Doing so will cause an error. Of course, if this happens you can always change it back.
Instant Outlining
Editing Tips: Keyboard Commands, Contextual Menus, and Handling Nodes
OPML Editor Menus and Commands
File Menu
New (Ctrl+N): Opens a new window in the OPML editor for you to make a fresh OPML Outline.
Open (Ctrl+o): Allows you to browse to an OPML file on your system and open it in the OPML editor.
Open URL: Opens a dialog box that allows you to enter the URL of an OPML file and view it in the OPML editor. By default, the dialog box has a URL that goes to a "Show Note" written by Dave, showing information and updates about the OPML editor. You can enter another URL at any time.
Close (Ctrl+W): Closes current OPML editor window.
Save (Ctrl+S): Allows you to save OPML outlines locally as a file. Note that if you navigate to My Documents/OPML/www, the outline you save will be saved to the http://hosting.opml.org server at http://hosting.opml.org/yourusername/filename
Save As: Allows you to save the current outline with a new name or different file extension.
Revert:
View In Browser: Allows you to view the current outline in a browser. Note that current browsers such as Firefox and Internet Explorer do not render OPML into HTML, so you will see "raw" OPML -- text surrounded by OPML markup tags.
Update OPML.root
Work Offline
Exit (Ctrl+Q)
Edit Menu
Undo (Ctrl+Z): Undoes last action. If unavailable, will read "Can't Undo."
Cut: (Ctrl+X) Cuts highlighted text or highlighted node. Will delete an unwanted node (for instance if you have a blank node between two you want to keep).
Copy: (Ctrl+C) Copies highlighted material to clipboard.
Paste (Ctrl+V) Pastes contents of clipboard where cursor is located.
Clear: Clears the content of selected text or nodes, but does not remove the node (the wedge to the right of an outline item)
Select All (Ctrl+A) Selects all material in current window.
Find and Replace
Find (Ctrl+F): Opens dialog box that allows you to type in a text string to find in the current outliner document.
Replace
Find Next (Ctrl+G): Finds the next instance of text you entered in Find dialog.
Replace & Find Next (Ctrl+H) Replaces text and finds next instance of text you entered in Find dialog.
Common Styles
Arial 10 (Ctrl+9)
Arial 12 (Ctrl+2)
Times New Roman 12 (Ctrl+7)
Arial 18 (Ctrl+8)
Font
Displays list of fonts installed on your computer for you to choose.
Size
Displays list of common font sizes
Larger (F10)
Smaller (F9)
Custom: Opens dialog box which allows you to type in a font size (in points).
Insert Date/Time (Ctrl+4): Inserts date and time.
Outliner Menu:
Community Menu
HTML Menu
Tools Menu
Window Menu
Help Menu
FAQ
Q: Uninstalling: "I want to do a fresh install from scratch, but when I try to delete the OPML folder, I get an "access denied" message that says parts of the program are in use. What gives?
A: The OPML editor has a System Tray icon that you may not have noticed. Right click on it and choose "Exit OPML Editor." Now when you try to delete the folder the OPML editor is in, it should work.
Q: When I try to post an item that has more than three indents to my weblog, only the top two levels show up. What gives?
A: As of today (7/28/2005), only the top two levels in an outline show up. (Luyi Chen has done some more documentation of this phenomenon, complete with screenshots). It's unclear whether this is a bug or an opening for future features (such as tucking away lower level indents on pages that are one click away from the main page of your blog).