This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

News

Easy documentation with Docsy

The Docsy Hugo theme lets project maintainers and contributors focus on content, not on reinventing a website infrastructure from scratch
By Patrice Chalin |

This is a typical blog post that includes images.

The front matter specifies the date of the blog post, its title, a short description that will be displayed on the blog landing page, and its author.

Including images

Here’s an image that includes a byline and a caption.

Image cropped to 500x300
Photo by Peter Xie from Pexels

The front matter of this post specifies properties to be assigned to all image resources:

resources:
  - src: '**.{png,jpg}'
    params:
      byline: Photo by Peter Xie from Pexels

To include the image in a page, specify its details like this:

{{< imgproc sunset Crop "500x300" >}}
Image cropped to 500x300
{{< /imgproc >}}

The image will be rendered at the size and byline specified in the front matter.

Second blog post

A short lead description about this content page. Text here can also be bold or italic and can even be split over multiple paragraphs.

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

Welcome to the Docsy theme user guide! This guide shows you how to get started creating technical documentation sites using Docsy, including site customization and how to use Docsy’s blocks and templates.

What is Docsy?

Docsy is a theme for the Hugo static site generator that’s specifically designed for technical documentation sets and has a lot of best practices built in. Use Docsy to get a working and reliable documentation site up and running fast, and then get back to focusing on great content for your users. Learn more about Docsy.