Here’s a quick visual guide to the RapidWeaver interface.
The Page List
Any page that you add to your RapidWeaver project appears in the Page List, and the navigation menu for your website is based on the layout of the pages in the Page List.
You can drag-and-drop pages to reorder or drag pages onto other pages to create a nested page. You can also re-order the different groups (Pages, Resources, and Settings) in the Page List.
You’ll also notice a blue dot appearing to the right of each page: this signifies that there are changes that have yet to be published. When the changes to each page are published, the blue dot is hidden.
Right-clicking on a page in the Page List displays a contextual menu with some useful options, including to Duplicate a page or Mark As Unchanged (and the blue dot for the page will disappear).
Just like in other apps, you can edit the name of any Page List item by double-clicking it.
Finally, the Page List also supports multiple selections, both of pages and resources (which we’ll cover shortly). When the Page List has focus, you can use Cmd A to select all Pages (or resources, if a resource is selected), or Cmd Shift A to select All Pages and Resources.
So What Are Resources?
Every website is made up of content, first and foremost, but there’s always some additional files that need to be uploaded with the content - perhaps it’s a PDF that visitors can download (or view in their browser). That’s what Resources are for - the files that make up your site but aren’t tied to any individual page.
You can add your first resource by taking a file from the Finder and dragging it into the Resources sidebar item - or by clicking on the sidebar item itself.
Each resource you add to your project can be linked to from any page on your site, or depending on the file type (for example an image) you could take the resource and embed it in the content area of a particular page.
There are two incredibly useful ways to make use of resources. Firstly, when using RapidWeaver’s “Add Link” feature, when there are resources in your project file you can directly link to them (and RapidWeaver will automatically generate the correct link to the resource, no matter where in your project the page is located).
If you need to embed the image or have a use for the image’s address, instead of hardcoding the link you can use what’s known as a resource macro. Whenever a resource macro is found in your project, RapidWeaver will substitute it for a link to the resource.
%resource(image.jpg)% becomes a path to a resource called image.jpg. If the resource is inside a folder, be sure to include the name of the folder in your macro: %resource(folder-name/image.jpg)%.
Note: To save time, RapidWeaver can generate a macro for you. Hold Option while clicking on the link button to copy the resource’s macro to the clipboard.
Beneath pages and resources are the Settings area. It contains a number of useful options and allows you to configure everything from the site name, to publishing details and save notes with the project file.
The General area contains a number of site-wide options that relate to your published site: the name, website address, logo, banner image etc, they’re all handled here. Many of the options in the General view (with the exception of the Website address, favicon, logo, and WebClip icon) can be overwritten on a per-page basis in the Page Inspector.
The code area provides areas where you can insert code onto every page on your site. Site wide metatags, analytics code, and other advanced code snippets can be placed in the respective section and will be applied on every page in your project.
Using Master Styles, you’ll be able to lay out your site with just a few clicks.
If you’re working on a project and need to make notes as you go (perhaps for the next time you’re working on the site, or handing the project file to a co-worker), you can write in the Notes area using Markdown. This content remains in the project file and is never published.
When you’re ready to publish your RapidWeaver site, the Publishing view. You can configure RapidWeaver to publish your website to more than one location - for example, a preview server, and a live server.
RapidWeaver is infinitely expandable, with a range of themes, plugins (page types), and other add-ons available to customise your site. The Add-ons Manager allows you to view all the add-ons installed within RapidWeaver.
From here, you can remove add-ons from RapidWeaver using Right Click, place add-ons into collections (for example, all the add-ons in use for a particular project or client), and quickly visit the RapidWeaver Community.