Build documentation using nix for CI

Author: afh

.github/workflows/build_and_deploy.yml

@@ -1,46 +1,63 @@
-name: Build and Deploy
+name: Build and Deploy static content to GitHub Pages
 
 on:
-  workflow_dispatch:
   push:
-    branches: [ "master" ]
+    branches: master
   pull_request:
-    branches: [ "master" ]
+    branches: master
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
 
 permissions:
   contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
 
 jobs:
-  build_and_deploy:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v3
-    - name: Install dependencies
-      run: |
-        sudo apt-get update;
-        sudo apt-get install --yes \
-          texinfo groff \
-          texlive-base texlive-fonts-recommended texlive-plain-generic
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: 2.7
-        bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-    - name: Build website
-      run: bundle exec middleman build
-    - name: Build documentation
-      run: make docs
-    - name: Deploy
-      if: ${{ github.ref == 'refs/heads/master' }}
-      env:
-        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      uses: reggionick/s3-deploy@v3
-      with:
-        folder: build
-        bucket: ${{ vars.AWS_S3_BUCKET }}
-        bucket-region: ${{ vars.AWS_S3_BUCKET_REGION }}
-        delete-removed: true
-        no-cache: true
-        private: true
-        filesToInclude: ".*/*,*/*,**"
+ build:
+   environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+   runs-on: ubuntu-latest
+   steps:
+   - uses: actions/checkout@v3
+   - name: Set up Ruby
+     uses: ruby/setup-ruby@v1
+     with:
+       ruby-version: 2.7
+       bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+   - name: Build website
+     run: bundle exec middleman build
+
+   - uses: cachix/install-nix-action@v20
+     with:
+       nix_path: nixpkgs=channel:nixos-unstable
+   - name: Build documentation
+     env:
+       OWNER: afh
+       REPO: ledger
+     run: |
+      # TODO: change ledger to ${OWNER} prior to merging
+      LATEST=$(curl -sqI -w '%{redirect_url}' -o /dev/null https://github.com/ledger/${REPO}/releases/latest | awk -F/ '{print $NF}')
+      # TODO: remove this override prior to merging
+      LATEST=web-docs
+      nix build github:${OWNER}/${REPO}/${LATEST}#web-docs
+      mkdir -p build/doc
+      cp result/share/doc/ledger/ledger* build/doc
+
+   - name: Setup Pages
+     uses: actions/configure-pages@v3
+   - name: Upload artifact
+     uses: actions/upload-pages-artifact@v1
+     with:
+       path: 'build'
+   - name: Deploy to GitHub Pages
+     id: deployment
+     uses: actions/deploy-pages@v1