Bump Theme 5.18

Author: russfeld

.github/dependabot.yml

@@ -0,0 +1,12 @@
+version: 2
+updates:
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"
+  # Git Submosuldes
+  - package-ecosystem: "gitsubmodule"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/gh-pages.yml

@@ -0,0 +1,36 @@
+# https://github.com/peaceiris/actions-hugo
+
+name: GitHub Pages
+
+on:
+  push:
+    branches:
+      - master  # Set a branch to deploy
+  pull_request:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-20.04
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: true  # Fetch Hugo themes (true OR recursive)
+          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v2
+        with:
+          hugo-version: '0.117.0'
+          # extended: true
+
+      - name: Build
+        run: hugo -b "https://ksu-cs-textbooks.github.io/cis400/"
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        if: ${{ github.ref == 'refs/heads/master' }}
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./public

.gitlab-ci.yml

@@ -0,0 +1,50 @@
+# image: docker:20.10.11
+
+# variables:
+#   # When using dind service, you must instruct docker to talk with the
+#   # daemon started inside of the service. The daemon is available with
+#   # a network connection instead of the default /var/run/docker.sock socket.
+#   #
+#   # The 'docker' hostname is the alias of the service container as described at
+#   # https://docs.gitlab.com/ee/ci/docker/using_docker_images.html#accessing-the-services
+#   #
+#   # If you're using GitLab Runner 12.7 or earlier with the Kubernetes executor and Kubernetes 1.6 or earlier,
+#   # the variable must be set to tcp://localhost:2375 because of how the
+#   # Kubernetes executor connects services to the job container
+#   # DOCKER_HOST: tcp://localhost:2375
+#   #
+#   DOCKER_HOST: tcp://docker:2375
+#   #
+#   # This instructs Docker not to start over TLS.
+#   DOCKER_TLS_CERTDIR: ""
+#   # 
+#   # Checkout submodules recursively
+#   GIT_SUBMODULE_STRATEGY: recursive
+
+# services:
+#   - docker:20.10.11-dind
+
+# before_script:
+#   - docker info
+#   - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+
+# build-latest:
+#   stage: build
+#   only:
+#     - tags
+#   script:
+#     - docker pull $CI_REGISTRY_IMAGE:latest || true
+#     - docker build --cache-from $CI_REGISTRY_IMAGE:latest --tag $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA --tag $CI_REGISTRY_IMAGE:latest .
+#     - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
+#     - docker push $CI_REGISTRY_IMAGE:latest
+
+# build-branches:
+#   stage: build
+#   except:
+#     - master
+#     - main
+#   script:
+#     - docker pull $CI_REGISTRY_IMAGE:$CI_COMMIT_BRANCH || true
+#     - docker build --cache-from $CI_REGISTRY_IMAGE:latest --tag $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA --tag $CI_REGISTRY_IMAGE:$CI_COMMIT_BRANCH .
+#     - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
+#     - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_BRANCH

.gitmodules

@@ -1,6 +1,3 @@
-[submodule "themes/ksucs-hugo-theme"]
-	path = themes/ksucs-hugo-theme
-	url = https://github.com/russfeld/ksucs-hugo-theme.git
 [submodule "themes/hugo-theme-relearn"]
 	path = themes/hugo-theme-relearn
 	url = https://github.com/ksu-cs-textbooks/hugo-theme-relearn.git

.vscode/settings.json

@@ -4,5 +4,6 @@
         "codebehind",
         "liquified",
         "overreliance"
-    ]
+    ],
+    "explorer.sortOrder": "mixed"
 }

Dockerfile

@@ -0,0 +1,20 @@
+FROM nginx:alpine as build
+
+RUN apk add --update \
+    wget
+    
+ARG HUGO_VERSION="0.117.0"
+RUN wget --quiet "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_${HUGO_VERSION}_Linux-64bit.tar.gz" && \
+    tar xzf hugo_${HUGO_VERSION}_Linux-64bit.tar.gz && \
+    rm -r hugo_${HUGO_VERSION}_Linux-64bit.tar.gz && \
+    mv hugo /usr/bin
+
+COPY ./ /site
+WORKDIR /site
+RUN hugo -b https://cis400.textbooks.cs.ksu.edu/
+
+#Copy static files to Nginx
+FROM nginx:alpine
+COPY --from=build /site/public /usr/share/nginx/html
+
+WORKDIR /usr/share/nginx/html

a.out

@@ -1,59 +1,118 @@
+# Base URL where the site will be hosted
 baseURL = "https://textbooks.cs.ksu.edu/cis400"
+# Default language for the site
 languageCode = "en-us"
+# Site Title
 title = "K-State CIS 400 Textbook"
+# This will fix URLs to match baseURL (for hosting in subfolders)
 canonifyURLs = true
+# This displays last edited information at bottom of page
 enableGitInfo = true
 
 # Change the default theme to be use when building the site with Hugo
-theme = ["hugo-theme-relearn"]
+theme = "hugo-theme-relearn"
 
-# For search functionality
+# Output Types
+# HTML - default page
+# RSS - for RSS feeds
+# PRINT - printable output
+# JSON - enables Lunr search engine
+# TELE - Teleprompter
+# EMBED - Embeddable Version
 [outputs]
-  home = ["HTML", "RSS", "PRINT", "JSON"]
+  home = ["HTML", "RSS", "PRINT", "SEARCH", "SEARCHPAGE"]
   section = ["HTML", "RSS", "PRINT", "TELE", "EMBED"]
   page = ["HTML", "RSS", "PRINT", "TELE", "EMBED"]
 
 [params]
-  alwaysopen = false
   textbookURL = "https://textbooks.cs.ksu.edu/cis400"
-  editURL = "https://gitlab.cs.ksu.edu/nhbean/ksucs-hugo/tree/master/cis400-textbook/"
+  # This controls whether submenus will be expanded (true), or collapsed (false) in the
+  # menu; if no setting is given, the first menu level is set to false, all others to true;
+  # this can be overridden in the pages frontmatter
+  alwaysopen = false
+  # Prefix URL to edit current page. Will display an "Edit" button on top right hand corner of every page.
+  # Useful to give opportunity to people to create merge request for your doc.
+  # See the config.toml file from this documentation site to have an example.
+  editURL = "https://gitlab.cs.ksu.edu/-/ide/project/cs-textbooks/cis400-textbook/edit/master/-/content/"
+  # Author of the site, will be used in meta information
   author = "Nathan Bean"
+  # Description of the site, will be used in meta information
   description = "K-State CIS 400 Textbook"
+  # Shows a checkmark for visited pages on the menu
   showVisitedLinks = false
-  disableSearch = false 
-  disableSeoHiddenPages = true 
+  # Disable search function. It will hide search bar
+  disableSearch = false
+  # Disable search in hidden pages, otherwise they will be shown in search box
+  disableSearchHiddenPages = true
+  # Disables hidden pages from showing up in the sitemap and on Google (et all), otherwise they may be indexed by search engines
+  disableSeoHiddenPages = true
+  # Disables hidden pages from showing up on the tags page although the tag term will be displayed even if all pages are hidden
   disableTagHiddenPages = true
-  disableAssetBusting = true
-  disableInlineCopyToClipboard = true
-  disableShortcutsTitle = false 
-  disableLandingPageButton = true 
+  # Javascript and CSS cache are automatically busted when new version of site is generated.
+  # Set this to true to disable this behavior (some proxies don't handle well this optimization)
+  disableAssetsBusting = false
+  # Set this to true to disable copy-to-clipboard button for inline code.
+  disableInlineCopyToClipBoard = true
+  # A title for shortcuts in menu is set by default. Set this to true to disable it.
+  disableShortcutsTitle = false
+  # If set to false, a Home button will appear below the search bar on the menu.
+  # It is redirecting to the landing page of the current language if specified. (Default is "/")
+  disableLandingPageButton = true
+  # When using mulitlingual website, disable the switch language button.
   disableLanguageSwitchingButton = false
-  disableBreadcrumbs = false
-  disableToc = false 
-  disableMathJax = true 
-  disableMermaid = true 
-  disableSwagger = true 
-  disableNextPrev = false 
-  themeVariant = ["light-theme", "dark-theme"]
-  collapsibleMenu = true 
-  additionalContentLanguage = ["en"]
-
-  #landingPageURL = "/cis642-643"
-  #textbookURL = "https://textbooks.cs.ksu.edu/cis642-643"
-  
-  linenumbers = true
+  # Hide breadcrumbs in the header and only show the current page title
+  disableBreadcrumb = false
+  # If set to true, hide table of contents menu in the header of all pages
+  disableToc = false
+  # If set to false, load the MathJax module on every page regardless if a MathJax shortcode is present
+  disableMathJax = true
+  # Specifies the remote location of the MathJax js
+  # customMathJaxURL = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
+  # Initialization parameter for MathJax, see MathJax documentation
+  # mathJaxInitialize = "{}"
+  # If set to false, load the Mermaid module on every page regardless if a Mermaid shortcode or Mermaid codefence is present
+  disableMermaid = true
+  # Specifies the remote location of the Mermaid js
+  # customMermaidURL = "https://unpkg.com/mermaid/dist/mermaid.min.js"
+  # Initialization parameter for Mermaid, see Mermaid documentation
+  # mermaidInitialize = "{ \"theme\": \"default\" }"
+  # If set to false, load the Swagger module on every page regardless if a Swagger shortcode is present
+  disableSwagger = true
+  # Specifies the remote location of the RapiDoc js
+  # customSwaggerURL = "https://unpkg.com/rapidoc/dist/rapidoc-min.js"
+  # Initialization parameter for Swagger, see RapiDoc documentation
+  # swaggerInitialize = "{ \"theme\": \"light\" }"
+  # Hide Next and Previous page buttons normally displayed full height beside content
+  disableNextPrev = false
+  # Order sections in menu by "weight" or "title". Default to "weight";
+  # this can be overridden in the pages frontmatter
+  ordersectionsby = "weight"
+  # Change default color scheme with a variant one. Eg. can be "red", "blue", "green" or an array like [ "blue", "green" ].
+  themeVariant = ["auto", "light-theme", "dark-theme"]
+  # The first element is the variant for light mode, the second for dark mode
+  themeVariantAuto = ["light-theme", "dark-theme"]
+  # Change the title separator. Default to "::".
+  # titleSeparator = "-"
+  # If set to true, the menu in the sidebar will be displayed in a collapsible tree view.
+  collapsibleMenu = true
+  # If a single page can contain content in multiple languages, add those here
+  additionalContentLanguage = [ "en" ]
 
-[blackfriday]
-  plainIDAnchors = true
-  hrefTargetBlank = true
+  # [x] russfeld
+  # Custom parameters
+  commitURL = "https://gitlab.cs.ksu.edu/cs-textbooks/cis400-textbook/-/commit/"
 
 [markup]
   [markup.highlight]
     # if set to `guessSyntax = true`, there will be no unstyled code even if no language
     # was given BUT mermaid code fences will not work anymore! So this is a mandatory
     # setting for your site
     guessSyntax = false
+
+    # choose a color theme or create your own
     style = "monokai"
   [markup.goldmark]
     [markup.goldmark.renderer]
+      # Render raw HTML
       unsafe = true
+

config.bak.toml

@@ -24,6 +24,7 @@ The course is organized into modules focused on a specific topic, accessible fro
 Most non-exam weeks will consist of _two_ video-guided tutorials and the weekly milestone.  The first module will be due by Monday, the second Tuesday, and the milestone on Friday. Each regular tutorial will take several hours to complete, and milestones can often take ten hours or more. You should plan your learning schedule accordingly.
 
 The modules, and all of their associated assignments, are available through Canvas.  You must complete each module item _in order_, and the prior week's module must be finished before you can move on to those in the next week. Be aware that if you procrastinate and don't start until Friday, it is unlikely that you will finish. Which means you will fall behind.  You can very quickly find yourself in a hole you cannot climb out of.  So time management is a _critical_ skill you need to be developing.  
+{{% /notice %}}
 
 {{% notice warning %}}
 Remember that in the CS Professional Program, a grade of **less than C** in a professional program course (like CIS 400) results in a "**Warning of Unsatisfactory Progress**."  This warning sticks with you the rest of your time in Computer Science at K-State. If you earn a second, similar grade, you will be dismissed from the CS Professional Program!