Skip to content

guacsec/guac-landing

Repository files navigation

guac.sh

This repository is the home of guac.sh.

Building the site

You must have Hugo installed.

To build the site, run hugo server -D. This will run a local webserver (defaults to port 1313) where you can verify your changes. If you are checking a future-dated blog post, add --buildFuture to the hugo command.

Contributing

The repository requires a Developer Certificate of Origin (use the -s flag on git commit). See contributing.md for more information about contributing to GUAC.

We do not have a style guide yet. Perhaps someday.

Adding a blog post

Blog posts come from files in content/blog. Use a filename of the format YYYY-MM-DD-WORDS_GO_HERE.md. The date encoded in the file name doesn't matter for publication, but it makes sorting in the repo easier.

The file must begin with a header that contains some pertinent information:

  • title: The title of the post.
  • date: The date (in YYYY-MM-DD format. Other formats might work, but why take chances?) This is the date used by Hugo to sort the posts. If you use a date in the future, it will not be listed on the blog page.
  • authors (optional): An array of names to list as the author. If you only have one author, it still needs to be quoted and in square brackets or in a yaml list format.
  • tags (optional): An array of tags to use for the post. Prefer existing tags whenever possible. When in doubt, don't add a tag. An incomplete list of tags we use is given below.

A complete header looks something like:

---
title: This is a great blog post
date: 2023-04-13
authors: ["Ben Cotton", "Jane Doe", "Blogger McBlogface"]
tags:
  - releases
  - events
---

Below the header, write the content. For ease of writing, use Markdown by default. You may use HTML when needed.

Tags

This is a partial list of tags we use on blog posts. If you use a new tag, add it here.

  • community: Posts about the community itself
  • docs: Posts about the documentation
  • events: Conferences, webinars,etc
  • guac-does-that: GUAC use cases
  • guac-visualizer: Posts about the experimental GUAC Visualizer
  • meetings: Community Meetings and Maintainers Meetings
  • releases: Release announcements

Layout

  • config.yml — Site configuration and main page content
  • content/blog/* — Blog posts
  • content/* — Other pages