Managing your weblog's blogroll
From pixyWiki
We make it easy for you to maintain a blogroll, that is, a list of bookmarks of your favorite weblogs and web sites that is displayed in the sidebar of your weblog.
Contents |
Adding new links to your blogroll
Individual blogroll items are known as bookmarks. Use the Create & Edit:Bookmarks page to add, edit and delete bookmarks and bookmark folders in your blogroll.
Here are some notes about the bookmarks page:
- The Add bookmark link takes you to the Add bookmark form, see below.
- The Add folder link talks you to the Add folder form, see below.
- The check-box allows you to select a bookmark for deletion or for moving to another folder.
- The Edit icon allows you to edit a bookmark using the Edit bookmark form, see below.
- The Visit icon allows you to visit the link.
Adding new links to your blogroll
The Add/Edit bookmark form allows you to enter information about one bookmark. Here's an explanation of the fields:
- Name: Text to be displayed on the link
- Description: Description, displayed when viewer hovers over link
- Bookmark URL: The URL of the bookmark
- Newsfeed URL: The URL of the newsfeed associated with the bookmark (if any)
- Sort priority: Lower numbered bookmarks displayed first in blogroll
- Display weight: Higher numbered bookmarks displayed bolder/larger
Adding new bookmark folders
If you'd like to display a separate list of links somewhere on your weblog, or you'd like to store links in pixyBlog for some other reason, you can use the Add folder form to do that.
Displaying new bookmark folders
You can use the #showBookmarks() macro to display your bookmarks on your website pages. The macro will display all of the bookmarks in one of your bookmark folders. The arguments are String folderName, boolean showFolderName, and boolean expandingFolder. The expanding folder feature is implemented using Javascript so, it will only work if the Roller Javascript file is included on the page where the macro is used.
For example, let's say that you want to display a folder named "News", you want to display the folder name, and you want to display it as an expanding folder. First, near the top and inside the <head> tag of your page, include the Roller Javascript page roller.js, as shown below:
<html> <head> <title>My badass blog</title> <script type="text/javascript" src="/theme/scripts/roller.js"></script> </head> <body>
Later in your page, include the #showBookmarks() macro to display your bookmarks:
#showBookmarks( "News" true true )
Bookmark import and export via OPML
pixyBlog makes it easy to import bookmarks and build your blogroll by importing bookmarks in OPML format. XBEL might be a better bookmarks format, but OPML is more popular in the world of weblogs.
How to import OPML into pixyBlog
- download bookmarks in OPML format from a site such as Scripting.COM and save them as a file on your hard disk.
- Login to pixyBlog and choose the Bookmarks:Import menu option.
- Use the file-upload capability to upload the OPML file into your blog. The bookmarks will be imported into a folder called "unfiled".
You can use pixyBlog to organize the bookmarks as you wish.
How to export OPML from pixyBlog
Your bookmarks are automatically made available in OPML form via a URL of the form:
http://www.pixyblog.com/flavor/webloghandle?flavor=opml
You can also export one specific folder by using the path parameter. For example, if you have a folder called News, export it like so:
http://www.pixyblog.com/flavor/webloghandle?flavor=opml&path=/News
NOTE: For OPML export, bookmarks must have at least a name and an HTML url; the name is taken from the text attribute (or if that is absent, the title attribute) of the OPML element, and the HTML url is taken from the htmlUrl attribute (or if that is absent, the url attribute) of the OPML element; if this forms a bookmark lacking a name or HTML URL then that entry will be silently skipped during import.