https://github.com/guacsec/guac-landing
GUAC Landing page
https://github.com/guacsec/guac-landing
Last synced: 6 months ago
JSON representation
GUAC Landing page
- Host: GitHub
- URL: https://github.com/guacsec/guac-landing
- Owner: guacsec
- Created: 2023-04-17T17:54:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-06-12T17:06:12.000Z (about 1 year ago)
- Last Synced: 2025-06-15T03:15:34.091Z (about 1 year ago)
- Language: Sass
- Size: 8.28 MB
- Stars: 0
- Watchers: 8
- Forks: 10
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# guac.sh
This repository is the home of guac.sh.
## Building the site
You must have [Hugo](https://gohugo.io/) 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](https://developercertificate.org/) (use the `-s` flag on `git commit`).
See [contributing.md](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*: Weekly Maintainers Meetings and other meetings
* *releases*: Release announcements
## Layout
* config.yml — Site configuration and main page content
* content/blog/* — Blog posts
* content/* — Other pages