This tour will walk you through setting up your first site in Forestry. It demonstrates the primary features and editing functionality of the CMS.
- Click “Take our demo site out for a spin!”
- Select your Git Provider from the list of options.
- A window will open asking you to give Forestry access to your repositories. If you are not already logged in, your provider will prompt you for login credentials first.
- Click “Authorize application” and wait a few seconds for the window to close.
- Give the new repository a name, or keep the default:
- Click “Create Site”
- After a moment you will be redirected to the Forestry CMS
Congrats, your first site is being created!
This process may take a couple minutes. Forestry will create a new repository with your git provider, push a copy of our Belkirk Jekyll Demo site, and then start the import process. Once the import is complete, the CMS will load in all of your content and you can move on to the next section.
In Forestry, all of your content is sorted into Collections under Content in the sidebar. In the demo, these are:
- Pages: any content this is not part of a collection
- People: a Jekyll collection of “staff members”
- Posts: a Jekyll collection of blog posts
- Projects: a Jekyll collection of projects
When you first enter the CMS, you will be dropped into the Pages collection. Take a look at the different collections by selecting them from the sidebar.
The Belkirk Demo Site is hosted by GitHub pages. Feel free to open it up and navigate around to get an understanding of how the built site looks and feels.
Select the Posts collection in the sidebar, then open up the editor by selecting the post First Draft Post.
On the left is the post’s front matter (custom metadata for the post, like its title and thumbnail), and on the right is the markdown content body of the post. The editor provides a visual, rich-text editor that is friendly for non-technical users and saves to markdown.
Make you first edit by updating the post’s title, and then click the preview button in the top right. This will open new tab and begin generating a preview with your content changes.
You can leave this tab open and return to the editor in the CMS and make changes. Any time you click the preview button the preview will updated with any new content changes you’ve made.
Next, set the post as published so that it will be included when the site is deployed. Click the “…” icon, and click Set as Published. You’ll see the Save Draft button now says Publish.
Click the Publish button to save your changes to back to your repository.
Data files allow you to set up metadata that isn’t associated with a specific page, like your company’s contact information. Under Data in the sidebar, select Information to pull up the demo site’s company information.
Update the Twitter option from “forestryio” to “twitter”, and then click the preview button in the top right.
Once the preview has loaded, you’ll see that the Twitter feed on the homepage has updated.
Previewing data files and menus will always redirect you to the homepage of your site, because they don’t have a permalink!
Return to the data file and click the Unsaved changes indicator at the top of the page. Click “Discard changes” to remove the changes you just made from the page.
Forestry stores unsaved changes in the cloud. This enables collaboration between multiple editors, and prevents editors from losing their changes.
The Media Library allows content editors to easily upload and manage media files throughout your site. It supports images, videos, PDFs, and much more.
Under Site in the sidebar, select Media Library. You’ll see all of the already uploaded images in the demo site.
By default, the Media Library uploads media to
uploads/:year:/:month:/:day:/. This can be changed in your site’s Settings.
You can upload media by clicking the placeholder in top right, or by dragging images into the Media Library from your desktop. Next, select the Projects collection, and open up Portable EEG Monitoring Device. In this project’s front matter, try updating the Banner Image by clicking Replace, and choosing another image from the Media Library.
Feel free to hit Publish to save your changes.
Menus allow your content editors to manage your site’s navigation and other types of menus easily.
Under Site in the sidebar, select Menus. Try re-arranging the menu with drag-and-drop, and then preview your changes by clicking the preview button in the top right.
This tour only covers the basics of what Forestry offers. Now that you’ve set up your first site in Forestry, you can begin exploring all of Forestry’s features at your own pace through this documentation:
Forestry has many more features for content editors:
- Create great content with the powerful Markdown Editor and with Data Files
- Learn more about the Media Library
- Learn how to create Menus for navigation and site links
- Add structured metadata with Front Matter
- Access the CMS from your own domain with the Remote Admin
Forestry can handle building and deploying your static site for you, or can integrate with third-party services that handle deployment.
You have many hosting options!
Caught a mistake or want to contribute to the docs? Edit this page on Github!