Improve source formatting
All checks were successful
/ build (pull_request) Successful in 43s

A single sentence per line
This commit is contained in:
Stefan Bethke 2026-06-13 21:17:03 +02:00
commit bfde817bc6

View file

@ -46,22 +46,31 @@ hugo server -D
### Adding Content ### Adding Content
There are two basic types of posts: Events and blog posts. Hugo and the template set distinguish between these two types based on frontmatter information. When manually creating content, you need to take extra care to use the correct frontmatter data. See the link to the Hugo archetypes below for details. If at all possible, use `hugo new content` with the appropriate parameters to create the new content file correctly. There are two basic types of posts: Events and blog posts.
Hugo and the template set distinguish between these two types based on frontmatter information.
When manually creating content, you need to take extra care to use the correct frontmatter data.
See the link to the Hugo archetypes below for details.
If at all possible, use `hugo new content` with the appropriate parameters to create the new content file correctly.
#### Add a Blog Entry #### Add a Blog Entry
Blog posts (the archetype is called `article`) should be used for information that will be relevant for a longer period, for example explanations about technical, political or cultural topics. Articles will be shown in chronological order on the [blog main page](https://hamburg.ccc.de/blog/), until newer posts push them down. In addition, the `tags:` can be used to find blog posts about certain topics. Blog posts (the archetype is called `article`) should be used for information that will be relevant for a longer period, for example explanations about technical, political or cultural topics.
Articles will be shown in chronological order on the [blog main page](https://hamburg.ccc.de/blog/), until newer posts push them down.
In addition, the `tags:` can be used to find blog posts about certain topics.
To create a new general blog post, run a command like this: To create a new general blog post, run a command like this:
```shell ```shell
hugo new content --kind article blog/yyyy/yyyy-mm-dd-your-article-title/index.md hugo new content --kind article blog/yyyy/yyyy-mm-dd-your-article-title/index.md
``` ```
If you want to create a blog post from scratch, or convert an event into a blog post, see the frontmatter data in [themes/ccchh/archetypes/article.md](themes/ccchh/archetypes/article.md). In particular, you need to set `categories: article` and remove any `date:` or `location:`. Note that `publishDate:` is fine, as it determines when the content will start appearing on the the site. If you want to create a blog post from scratch, or convert an event into a blog post, see the frontmatter data in [themes/ccchh/archetypes/article.md](themes/ccchh/archetypes/article.md).
In particular, you need to set `categories: article` and remove any `date:` or `location:`.
Note that `publishDate:` is fine, as it determines when the content will start appearing on the the site.
#### Add an Event Announcement #### Add an Event Announcement
Events will be shown on the home page from the frontmatter `publishDate` until the `date:`. Use them for information that is relevant for a specific event, like a talk or a meeting. Events will be shown on the home page from the frontmatter `publishDate` until the `date:`.
Use them for information that is relevant for a specific event, like a talk or a meeting.
This is not limited to events organized by the CCCHH, but can also be a hint to other events which we think are related to our activities. This is not limited to events organized by the CCCHH, but can also be a hint to other events which we think are related to our activities.
@ -70,7 +79,8 @@ To create a new event blog post, run a command like this:
hugo new content --kind event blog/yyyy/yyyy-mm-dd-your-event-title/index.md hugo new content --kind event blog/yyyy/yyyy-mm-dd-your-event-title/index.md
``` ```
If you want to create an event from scratch, or convert a blog post into an event, see the frontmatter data in [themes/ccchh/archetypes/event.md](themes/ccchh/archetypes/event.md). In particular, you need to set `categories: event`, `date:` for the date of the event, and `location: Z9` (or whereever your event takes place). If you want to create an event from scratch, or convert a blog post into an event, see the frontmatter data in [themes/ccchh/archetypes/event.md](themes/ccchh/archetypes/event.md).
In particular, you need to set `categories: event`, `date:` for the date of the event, and `location: Z9` (or whereever your event takes place).
#### Additional Notes on Events and Articles #### Additional Notes on Events and Articles