Merge pull request #11 from ARCTraining/maeve-fix

Maeve fix. So many improvements, additions and corrections it's impossible to mention them all!

Author: ollie-clark

.github/workflows/deploy-book.yml

@@ -0,0 +1,49 @@
+name: Build and Deploy Quarto Site
+
+on:
+  push:
+    branches: [ main, master ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+    
+    - name: Set up Quarto
+      uses: quarto-dev/quarto-actions/setup@v2
+    
+    - name: Render Quarto document
+      run: |
+        quarto render --output-dir docs
+    
+    - name: Setup Pages
+      uses: actions/configure-pages@v4
+    
+    - name: Upload to GitHub Pages
+      uses: actions/upload-pages-artifact@v3
+      with:
+        path: docs/
+    
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+    - name: Deploy to GitHub Pages
+      id: deployment
+      uses: actions/deploy-pages@v4

.github/workflows/publish.yml

@@ -1,7 +1,2 @@
-# gitignore for template-jb-docs
-
-# built book
-**/_build/*
-
-# vagrant stuff
-**/.vagrant/*
+_site/
+/.quarto/

.github/workflows/test-build.yml

@@ -1 +1,12 @@
-# hpc1
+# HPC1: Introduction to High Performance Computing
+
+This repo contains the course materials for HPC1.
+
+In general, the session pages are set up as follows:
+
+1. Session objectives/aims: these list what the learner should know by the end of the session.
+2. Slides: these will assist in delivering the content. Please feel free to supplement these with your own slides, or add images/etc. as you see fit
+    - If you want to add some flair for your presentation, but don't want to make permanent changes, you can deliver a local rendering of the slides.
+3. Notes: the rest of the page usually contains notes pertaining to the slideshow; these are intended to be used as reference material by the learners, and expand upon the content in the slides; they are not intended to be delivered/presented by the facilitator.
+4. Exercises: this section collects exercises based on the session. While there are also some small exercises within the presentation (you can decide whether you want to do a live demo while presenting), these collected exercises work well standalone, so if you run out of time, they can be "homework".
+5. Summary: this section lists key takeaways and related resources.

.gitignore

@@ -0,0 +1,33 @@
+project:
+  type: website
+  render:
+    - "*.qmd"
+    - "!book/"
+
+website:
+  title: "HPC1: Introduction to High Performance Computing"
+  sidebar:
+    style: "docked"
+    search: true
+    logo: "assets/img/logo/logo.png"
+    contents:
+      - section: "Course Content"
+        contents:
+          - what-is-hpc.qmd
+          - logging-on-and-linux-recap.qmd
+          - storage.qmd
+          - modules-software.qmd
+          - scheduling-submission.qmd
+          - best-practices-troubleshooting.qmd
+          - wrap-up.qmd
+
+format:
+  html:
+    theme: cosmo
+    css: styles.css
+    toc: true
+    code-fold: false
+    code-tools: true
+
+
+

README.md

@@ -0,0 +1,5 @@
+---
+title: "About"
+---
+
+About this site