Initial commit

Author: goerz

.github/workflows/ExportPluto.yaml

@@ -0,0 +1,70 @@
+name: Export Pluto notebooks
+on:
+    push:
+        branches:
+            - main
+            - master
+    workflow_dispatch:
+
+# When two jobs run in parallel, cancel the older ones, to make sure that the website is generated from the most recent commit.
+concurrency:
+    group: pluto-export
+    cancel-in-progress: true
+
+# This action needs permission to write the exported HTML file to the gh-pages branch.
+permissions:
+    contents: write
+    # (all other permission fields default to "none")
+
+jobs:
+    build-and-deploy:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout this repository
+              uses: actions/checkout@v4
+
+            - name: Install Julia
+              uses: julia-actions/setup-julia@v2
+              with:
+                  version: "1" # This will automatically pick the latest Julia version
+
+            - name: Cache Julia artifacts & such
+              uses: julia-actions/cache@v2
+              with:
+                cache-registries: "true"
+
+            # We set up a folder that Pluto can use to cache exported notebooks. If the notebook file did not change, then Pluto can take the exported file from cache instead of running the notebook.
+            - name: Set up notebook state cache
+              uses: actions/cache@v4
+              with:
+                  path: pluto_state_cache
+                  key: ${{ runner.os }}-pluto_state_cache-v2-${{ hashFiles('**/Project.toml', '**/Manifest.toml', '.github/workflows/*' ) }}-${{ hashFiles('**/*jl') }}
+                  restore-keys: |
+                      ${{ runner.os }}-pluto_state_cache-v2-${{ hashFiles('**/Project.toml', '**/Manifest.toml', '.github/workflows/*' ) }}
+
+
+            - name: Run & export Pluto notebooks
+              run: |
+                julia -e 'using Pkg
+                  Pkg.activate(mktempdir())
+                  Pkg.add([
+                    Pkg.PackageSpec(name="PlutoSliderServer", version="0.3.2-0.3"),
+                  ])
+
+                  import PlutoSliderServer
+
+                  PlutoSliderServer.github_action(".";
+                    Export_cache_dir="pluto_state_cache",
+                    Export_baked_notebookfile=false,
+                    Export_baked_state=false,
+                    # more parameters can go here
+                  )'
+
+
+            - name: Deploy to gh-pages
+              uses: JamesIves/github-pages-deploy-action@releases/v4
+              with:
+                  token: ${{ secrets.GITHUB_TOKEN }}
+                  branch: gh-pages
+                  folder: .
+                  single-commit: true

Notebooks.jl

@@ -0,0 +1,64 @@
+### A Pluto.jl notebook ###
+# v0.20.5
+
+using Markdown
+using InteractiveUtils
+
+# ╔═╡ a8e07fb5-9671-471e-8f00-fe572dc5704d
+begin
+	using HypertextLiteral: @htl
+end
+
+# ╔═╡ 4e470eb8-6a34-4ba4-8037-ed11cbf9e4e3
+md"""
+# Tutorials
+"""
+
+# ╔═╡ a3ca4555-6c63-4933-ba2f-84e585c35941
+@htl("""<script src="https://juliaquantumcontrol.github.io/QuantumControl.jl/dev/assets/topbar/topbar.js"></script>""")
+
+# ╔═╡ 821cf12f-afdf-481e-9f06-9ae9b34d0f20
+md"""
+This is a test
+"""
+
+# ╔═╡ cfcf868a-7254-4fb5-a096-89780f275322
+
+
+# ╔═╡ 00000000-0000-0000-0000-000000000001
+PLUTO_PROJECT_TOML_CONTENTS = """
+[deps]
+HypertextLiteral = "ac1192a8-f4b3-4bfe-ba22-af5b92cd3ab2"
+
+[compat]
+HypertextLiteral = "~0.9.5"
+"""
+
+# ╔═╡ 00000000-0000-0000-0000-000000000002
+PLUTO_MANIFEST_TOML_CONTENTS = """
+# This file is machine-generated - editing it directly is not advised
+
+julia_version = "1.11.4"
+manifest_format = "2.0"
+project_hash = "60bb17116de90af65672383384a5610ccd921125"
+
+[[deps.HypertextLiteral]]
+deps = ["Tricks"]
+git-tree-sha1 = "7134810b1afce04bbc1045ca1985fbe81ce17653"
+uuid = "ac1192a8-f4b3-4bfe-ba22-af5b92cd3ab2"
+version = "0.9.5"
+
+[[deps.Tricks]]
+git-tree-sha1 = "6cae795a5a9313bbb4f60683f7263318fc7d1505"
+uuid = "410a4b4d-49e4-4fbc-ab6d-cb71b17b3775"
+version = "0.1.10"
+"""
+
+# ╔═╡ Cell order:
+# ╠═4e470eb8-6a34-4ba4-8037-ed11cbf9e4e3
+# ╠═a8e07fb5-9671-471e-8f00-fe572dc5704d
+# ╠═a3ca4555-6c63-4933-ba2f-84e585c35941
+# ╟─821cf12f-afdf-481e-9f06-9ae9b34d0f20
+# ╟─cfcf868a-7254-4fb5-a096-89780f275322
+# ╟─00000000-0000-0000-0000-000000000001
+# ╟─00000000-0000-0000-0000-000000000002

README.md

@@ -0,0 +1,3 @@
+# Tutorials for the JuliaQuantumControl Organization
+
+This is a repository containing [Pluto](https://github.com/fonsp/Pluto.jl) notebook that is **automatically converted to HTML** by a GitHub action, and published to GitHub pages!