Create documentation workflow

Author: ethomson

.github/workflows/main.yml

@@ -0,0 +1,34 @@
+name: Generate Documentation
+
+on:
+  pull_request:
+    branches: [ main ]
+  repository_dispatch:
+    types: [ generate ]
+  workflow_dispatch:
+  schedule:
+  - cron: '15 5 * * *'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    # Only run scheduled workflows on the main repository; prevents people
+    # from using build minutes on their forks.
+    if: github.repository == 'libgit2/www.libgit2.org-docs'
+    name: "Generate documentation"
+    runs-on: "ubuntu-latest"
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v4
+      with:
+        path: docs
+        fetch-depth: 0
+    - name: Set up documentation generator
+      run: npm install
+    - name: Generate documentation
+      run: ./generate docs
+    - name: Examine repository
+      run: git status
+      path: docs