Docs: Improve readme

This commit is contained in:
jtbx 2024-01-24 21:29:57 +01:00 committed by jtbx
parent 1f3b00ccf8
commit e20c15e490

View file

@ -11,8 +11,8 @@ All other information like details on groups, projects and recurring events shou
- start page (onepager) - start page (onepager)
* who we are * who we are
* announcements aka current blog entry (if in the future) * announcements aka current blog entry (if in the future)
* visit us -> open chaos + link to wiki for all recurring events
* event calendar * event calendar
* visit us -> open chaos + link to wiki for all recurring events
* groups, e.g. CTF team, CMS, freifunk, etc. * groups, e.g. CTF team, CMS, freifunk, etc.
* directions (map) * directions (map)
- blog, split into: - blog, split into:
@ -24,7 +24,7 @@ All other information like details on groups, projects and recurring events shou
### Build and Deploy ### Build and Deploy
To populate the calendar data, please run `fetch-calendar.sh` before running hugo. To populate the calendar data, please run `./fetch-calendar.sh` before running hugo.
Running the hugo command without and parameters will re-generate the site in the `public` directory. Running the hugo command without and parameters will re-generate the site in the `public` directory.
To deploy the website, just copy the whole folder to a directory which is servered by the webserver of your preference. To deploy the website, just copy the whole folder to a directory which is servered by the webserver of your preference.
@ -47,26 +47,47 @@ hugo server -D
#### Add an Event Announcement #### Add an Event Announcement
There are two basic types of posts: Events and articles. There are two basic types of posts: Events and articles.
Events will be shown on the home page from their publishing date until they have happened. Events will be shown on the home page from their publishing date until they have happened and shall be used for things which happen at a certain date.
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.
To create a new event blog post, run a command like this: To create a new event blog post, run a command like this:
```shell ```shell
hugo new content --kind event blog/your-event-title.md hugo new content --kind event blog/yyyy/yyyy-mm-dd-your-event-title/index.md
``` ```
#### Add a Blog Entry #### Add a Blog Entry
As mentioned before, you can also create blog posts for things which aren't events. As mentioned before, you can also create blog posts for things which aren't events.
They will only be shown in the "blog" section and posted to the RSS feeds. They will only be shown in the "blog" section and posted to the RSS feeds and shall be used for things which are relevant for a longer time.
As we have much more event announcements than articles, finding articles in all blog posts can be quite a challenge.
But using these two categories enables filtering, so that the history of articles is in one list.
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/your-article-title.md hugo new content --kind article blog/yyyy/yyyy-mm-dd-your-article-title/index.md
``` ```
#### Additional Notes on Events and Articles
By default the first 70 words are shown as a summary on list pages. By default the first 70 words are shown as a summary on list pages.
Please use `<!--more-->` to manually separate the summary from other post content. Please use `<!--more-->` to manually separate the summary from other post content.
Please prefix your folder name with a date to make browsing the content in the source code easier.
The date in the URL will be taken from the `date` field in the front matter.
Blog posts from before 2024-01-22 were imported from the previous website and have additional front matter data which is not usually needed (e.g. the lastmod value).
When using the commands above, the template shall have evenything you need.
#### Populate the Event Calendar
The event calendar table is filled from the Nextcloud iCal feed.
To add a link on the title text, just add some link to the event's description field.
The first link (something starting with `https://` or `http://`) from anywhere in the text will be taken.
(iCal has a link attribute, but that is not supported by the Nextcloud web UI. So we use the description instead.)
### Icons ### Icons
You can use solid and brand icons from https://fontawesome.com/icons version 6 in your posts like this: You can use solid and brand icons from https://fontawesome.com/icons version 6 in your posts like this: