While Alloy's mainstay is blogging, we've also incorporated an easy-to-use set of tools to allow you to embed content within your RapidWeaver projects. That embedded content can then be edited directly from your website using the same Alloy Editor we use for our Blog Posts.
In this section we'll explore the Embed tool and what it can do. We'll look at how we insert our embeddable content into our project as well as look at what each part of the Embed editor does. In addition we have a tutorial video above that will walk you through using Alloy's Embeds for your site.
Note: To follow along with the tutorial video you'll want to have already setup and published your Editor. This is covered in the Quick Start section of the documentation.
Much like the Posts List view for Blog Posts, the Embeds section has a list view of its own. This is where you'll find all of your site's Embeds.
Your Embeds are sorted by two criteria -- Firstly they're sorted alphabetically, but in addition they're also put into groups, which we call Pages. These Pages can be named whatever you like however. In fact they don't even need to be the names of pages on your site. You can name them whatever you like to help in your own organization of your Embed content. We'll look at these Pages later on when we look at adding and editing an Embed. We also discuss Pages in the tutorial video above.
Each item in the Embeds List has a button for that allows to Edit the embedded content. This can be used to edit the contents of an Embed whether it is live and embedded on your site or not.
Our drag-and-drop system makes embedding content in RapidWeaver a breeze.
The Embeds List view also provides us a very important tool. In the list view we have a draggable item in the Stack column -- a small cube icon. This icon is what we use to embed our content into our RapidWeaver project file.
You'll drag this cube icon directly onto your Stacks page and drop it where you want your Embed to appear on your site. Once dropped it will magically turn into an Alloy Embed stack with a preset link to your Embedded content.
We cover how to insert Embeds into your project in the tutorial video above.
Similarly to Blog Posts you can also delete Embeds from this list view. When you click the Delete button it will prompt you to confirm the deletion of the Embed. Deleting an Embed CAN NOT BE UNDONE. Be sure you want to delete it before confirming.
Much like Blog Posts, Embeds can be in a sort of Draft mode. If an Embed is disabled a small icon on an eye with a slash through it will be displayed to the left of the Embed's title in the list view, as well as the title will be greyed out.
While Embeds might be easy setup and use, they're also quite powerful. Embeds consist of just a few fields, but can make managing our page's content simple and easy.
To get started we have an "Add New Embed" button in the top right of our Embeds List View that allows us to add a new Embed to the Editor for use in our site.
Let's take a look at the fields we'll use to create an Embed, below. Don't forget we also have a tutorial video above that walks you through creating and managing your Embeds as well.
Each Embed has an Active toggle at the top right. When enabled the Embed is active and its content will be shown on the page where it has been embedded. If at any point you'd like to disable the content and hide it from view on your live page just disable the Embed using this toggle and the Embed contents will not show up on the live page.
This field is used for our own organizational purposes. This title won't be displayed on our live site with the Embed. It is only meant for use in the Embeds list, and in Stacks Edit Mode, so that we know what kind of content is contained within the Embed.
The filename for your Embed will be created based off of your Title when initially adding your Embed in the Editor. You can however change this file name when editing an Embed.
IMPORTANT: We highly suggest that you change the filename before you insert the Embed into your RapidWeaver project file. Changing the filename after it has been added to your Stacks page will break the link and you'll have to re-embed the stack.
The Filename field is only shown when editing existing Embeds. To edit a filename first click the lock button to unlock the existing Embed's filename.
The Page field is yet another organizational tool for the Embeds List view. This allows us to categorize our Embeds so we know where they show up within our site. By default we call this organizational tool "Pages" but you can use this to sort your Embeds into any sort of category system you like.
When creating an Embed you can select from an existing Page or select "New Page" to create a new Page category. When you select "New Page" you'll be given a field to add your page name as well.
This section is where the magic happens. This field is a lot like the main content area of our Blog Posts. In fact just about anything you can add and do in a Blog Post's main content area you can do here as well. Add headers, lists, images, and more.
Just like with Blog Posts the Content section of the Embed uses Markdown. This provides a quick, smooth writing workflow. If you're not familiar with Markdown we provide a Markdown Cheatsheet here on the Alloy site as well as an extensive Markdown reference tool right from the Editor's toolbar.
The Editor toolbar provides quick access to Markdown formatting, and more.
While the editor uses Markdown for its content, we also offer a powerful toolbar to make things simple and easy for everyone. The toolbar creates the Markdown for you. If you new to Markdown this is a great was to start to learn the basics.
The toolbar allows us to format text, upload images, create YouTube embeds and so much more! It also allows you the ability to preview your Embed's contents right in the editor. You're also able to write in side-by-side or full-screen mode -- whatever makes things easiest for you.
The toolbar's contents are configurable within the Editor stack's settings in RapidWeaver. Customize what buttons will be seen in the toolbar and republish to get the tools you want.