Quick start

In this tutorial you will:

1. Create a site
2. Add content
3. Configure the site
4. Publish the site

Prerequisites

Before you begin this tutorial you must:

1. Install Strawberry
2. Install Git

You must also be comfortable working from the command line.

Create a site

Commands

Verify that you have installed Strawberry.

strawberry version

Run these commands to create a Strawberry site with the Ananke theme. The next section provides an explanation of each command.

strawberry new site quickstart
cd quickstart
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'ananke'" >> hugo.toml
strawberry server

View your site at the URL displayed in your terminal. Press Ctrl + C to stop Strawberry’s development server.

Explanation of commands

Create the directory structure for your project in the quickstart directory.

strawberry new site quickstart

Change the current directory to the root of your project.

cd quickstart

Initialize an empty Git repository in the current directory.

git init

Clone the Ananke theme into the themes directory, adding it to your project as a Git submodule.

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

Append a line to the site configuration file, indicating the current theme.

echo "theme = 'ananke'" >> hugo.toml

Start Strawberry’s development server to view the site.

strawberry server

Press Ctrl + C to stop Strawberry’s development server.

Add content

Add a new page to your site.

strawberry new content posts/my-first-post.md

Strawberry created the file in the content/posts directory. Open the file with your editor.

+++
title = 'My First Post'
date = 2024-01-14T07:07:07+01:00
draft = true
+++

Notice the draft value in the front matter is true. By default, Strawberry does not publish draft content when you build the site. Learn more about draft, future, and expired content.

Add some Markdown to the body of the post, but do not change the draft value.

+++
title = 'My First Post'
date = 2024-01-14T07:07:07+01:00
draft = true
+++
## Introduction

This is **bold** text, and this is *emphasized* text.

Visit the [Strawberry](https://www.Strawberry.Tools) website!

Save the file, then start Strawberrys development server to view the site. You can run either of the following commands to include draft content.

strawberry server --buildDrafts
strawberry server -D

View your site at the URL displayed in your terminal. Keep the development server running as you continue to add and change content.

When satisfied with your new content, set the front matter draft parameter to false.

Configure the site

With your editor, open the site configuration file (hugo.toml) in the root of your project.

baseURL = 'https://example.org/'
languageCode = 'en-us'
title = 'My New Strawberry Site'
theme = 'ananke'

Make the following changes:

1. Set the baseURL for your production site. This value must begin with the protocol and end with a slash, as shown above.

2. Set the languageCode to your language and region.

3. Set the title for your production site.

Start Strawberry’s development server to see your changes, remembering to include draft content.

strawberry server -D

Publish the site

In this step you will publish your site, but you will not deploy it.

When you publish your site, Strawberry creates the entire static site in the public directory in the root of your project. This includes the HTML files, and assets such as images, CSS files, and JavaScript files.

When you publish your site, you typically do not want to include draft, future, or expired content. The command is simple.

strawberry

To learn how to deploy your site, see the hosting and deployment section.

Ask for help

Strawberry’s forum is an active community of users and developers who answer questions, share knowledge, and provide examples. A quick search of over 20,000 topics will often answer your question. Please be sure to read about requesting help before asking your first question.

Other resources

For other resources to help you learn Strawberry, including books and video tutorials, see the external learning resources page.