restructure to multiple courses

.github/workflows/deploy.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Install quarto
         uses: quarto-dev/quarto-actions/setup@v2
         with:
-          version: "1.2.313"
+          version: "1.2.475"  # Note cant bump passed 1.2 until quarto_cli #3973 is fixed.
 
       - name: print quarto version
         run: |

README.md

@@ -1,7 +1,6 @@
 # OpenSourceCourse
 
-This is the website for OpenSourceCourse, a short course designed to help engineers and scientists contribute to
-the open-source scientific python ecosystem.
+This is the website for OpenSourceCourse, a collection of educational material designed to help engineers and scientists contribute to the open-source scientific python ecosystem.
 
 The course website is found [here](https://opensourcecourse.dev/).
 

_extensions/mcanouil/iconify/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Mickaël Canouil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

_extensions/mcanouil/iconify/_extension.yml

@@ -0,0 +1,7 @@
+title: Iconify support
+author: Mickaël Canouil
+version: 1.0.8
+quarto-required: ">=1.2.280"
+contributes:
+  shortcodes:
+    - iconify.lua

_extensions/mcanouil/iconify/iconify.lua

@@ -0,0 +1,138 @@
+--[[
+# MIT License
+#
+# Copyright (c) Mickaël Canouil
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+]]
+
+local function ensure_html_deps()
+  quarto.doc.add_html_dependency({
+    name = 'iconify',
+    version = '1.0.8',
+    scripts = {"iconify-icon.min.js"}
+  })
+end
+
+local function is_empty(s)
+  return s == nil or s == ''
+end
+
+local function is_valid_size(size)
+  if is_empty(size) then
+    return ''
+  end
+  local size_table = {
+    ["tiny"]         = "0.5em",
+    ["scriptsize"]   = "0.7em",
+    ["footnotesize"] = "0.8em",
+    ["small"]        = "0.9em",
+    ["normalsize"]   = "1em",
+    ["large"]        = "1.2em",
+    ["Large"]        = "1.5em",
+    ["LARGE"]        = "1.75em",
+    ["huge"]         = "2em",
+    ["Huge"]         = "2.5em",
+    ["1x"]           = "1em",
+    ["2x"]           = "2em",
+    ["3x"]           = "3em",
+    ["4x"]           = "4em",
+    ["5x"]           = "5em",
+    ["6x"]           = "6em",
+    ["7x"]           = "7em",
+    ["8x"]           = "8em",
+    ["9x"]           = "9em",
+    ["10x"]          = "10em",
+    ["2xs"]          = "0.625em",
+    ["xs"]           = "0.75em",
+    ["sm"]           = "0.875em",
+    ["lg"]           = "1.25em",
+    ["xl"]           = "1.5em",
+    ["2xl"]          = "2em"
+  }
+  for key, value in pairs(size_table) do
+    if key == size then
+      return 'font-size: ' .. value .. ';'
+    end
+  end
+  return 'font-size: ' .. size .. ';' 
+end
+
+return {
+  ["iconify"] = function(args, kwargs)
+    -- detect html (excluding epub which won't handle fa)
+    if quarto.doc.is_format("html:js") then
+      ensure_html_deps()
+      local set = "fluent-emoji"
+      local icon = pandoc.utils.stringify(args[1])
+      if #args > 1 then
+        set = icon
+        icon = pandoc.utils.stringify(args[2])
+      end
+
+      local attributes = ' icon="' .. set .. ':' .. icon .. '"'
+      local label = '"Icon ' .. icon .. ' from ' .. set .. ' Iconify.design set."'
+
+      local size = is_valid_size(pandoc.utils.stringify(kwargs["size"]))
+      if not is_empty(size) then
+        attributes = attributes .. ' style="' .. size .. '"'
+      end
+
+      local aria_label = pandoc.utils.stringify(kwargs["label"])
+      if is_empty(aria_label) then
+        aria_label =  ' aria-label="' .. label .. '"'
+      else 
+        attributes = attributes .. aria_label
+      end
+      local title = pandoc.utils.stringify(kwargs["title"])
+      if is_empty(title) then
+        title =  ' title="' .. label .. '"'
+      else 
+        attributes = attributes .. title
+      end
+      -- local style = pandoc.utils.stringify(kwargs["style"])
+      -- if not is_empty(style) then
+      --   local attributes = attributes .. ' style="' .. style .. '"'
+      -- end
+      local width = pandoc.utils.stringify(kwargs["width"])
+      if not is_empty(width) and is_empty(size) then
+        attributes = attributes .. ' width="' .. width .. '"'
+      end
+      local height = pandoc.utils.stringify(kwargs["height"])
+      if not is_empty(height) and is_empty(size)  then
+        attributes = attributes .. ' height="' .. height .. '"'
+      end
+      local flip = pandoc.utils.stringify(kwargs["flip"])
+      if not is_empty(flip) then
+        attributes = attributes .. ' flip="' .. flip.. '"'
+      end
+      local rotate = pandoc.utils.stringify(kwargs["rotate"])
+      if not is_empty(rotate) then
+        attributes = attributes .. ' rotate="' .. rotate .. '"'
+      end
+
+      return pandoc.RawInline(
+        'html',
+        '<iconify-icon inline' .. attributes .. '></iconify-icon>'
+      )
+    else
+      return pandoc.Null()
+    end
+  end
+}