initial commit: index.md, hugo[-book], and github actions

Signed-off-by: Thilo Fromm <[email protected]>

Author: t-lo

.github/workflows/gh-pages.yml

@@ -0,0 +1,35 @@
+name: GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  deploy:
+    if: github.repository == 'uapi-group/uapi-group.github.io'
+    runs-on: ubuntu-22.04
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: true
+          fetch-depth: 0
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v2
+        with:
+          hugo-version: '0.104.3'
+          extended: true
+
+      - name: Build
+        run: hugo --minify -d ../public
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        if: ${{ github.ref == 'refs/heads/main' }}
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./public

.gitignore

@@ -0,0 +1,3 @@
+public
+.hugo_build.lock
+resources/_gen

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "themes/hugo-book"]
+	path = themes/hugo-book
+	url = https://github.com/alex-shpak/hugo-book

README.md

@@ -0,0 +1,26 @@
+# Static website generation for [www.]uapi-group.org
+
+This repository uses Hugo for static HTML generation.
+See https://gohugo.io/getting-started/quick-start/ for a brief intro.
+
+The website uses the [hugo-book](https://github.com/alex-shpak/hugo-book) theme; it is included in this repo as a git submodule.
+After cloning this repo please run `git submodule init; git submodule update`.
+If you check out a branch or tag, make sure the submodule is up to date by running `git submodule update`.
+
+## Website repo layout
+
+Content resides in the [content](content/) folder.
+The ([index](content/_index.md) page in that directory serves as central entry point to the org's website.
+
+## Making changes and testing
+
+You'll need [hugo installed](https://gohugo.io/getting-started/installing/) for rendering changes.
+
+First, make your edits.
+Then, start hugo locally (in the repo's `website` directory)to review your changes:
+
+```shell
+$ hugo server --minify --disableFastRender
+```
+
+Review your changes at http://localhost:1313/specifications/ .

archetypes/default.md

@@ -0,0 +1,6 @@
+---
+title: "{{ replace .Name "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+---
+

assets/_variables.scss

@@ -0,0 +1,5 @@
+$body-min-width: 20rem;
+$container-max-width: 110rem;
+
+$menu-width: 15rem;
+$toc-width: 15rem;

config.toml

@@ -0,0 +1,10 @@
+baseURL = "https://uapi-group.org"
+languageCode = "en-us"
+title = "The Linux Userspace API Group"
+theme = "hugo-book"
+
+[markup.goldmark.renderer]
+  unsafe = true # Allow HTML in md files
+
+[params]
+  BookSearch = false

content/_index.md

@@ -0,0 +1,26 @@
+---
+title: The Linux Userspace API (UAPI) group
+---
+
+# The Linux Userspace API (UAPI) group
+
+The userspace API ("uapi") group is a community for people with an interest in innovating how we build, deploy, and run modern Linux operating systems.
+It serves as a central gathering place for specs, documentation, and ideas.
+
+Follow [@uapi-group](https://twitter.com/uapi_group) on twitter to catch the latest news!
+
+## Generic documents, minutes, and glossary
+
+Please find generic documents like meeting / summit minutes and a glossary of terms used across uapi-group documents at https://uapi-group.org/docs.
+
+## UAPI Group Specifications
+
+Submitted specifications are available at https://uapi-group.org/specifications.
+
+See [open PRs on github](https://github.com/uapi-group/specifications/pulls) for work-in-progress specifications.
+
+Please use the [specifications issue tracker](https://github.com/uapi-group/specifications/issues) to engage with the project.
+
+## Kernel features wishlist
+
+A collection of kernel features that, if implemented, would improve inter-operation of kernel and early / "plumbing level" is maintained here: https://github.com/uapi-group/kernel/blob/main/README.md.