MyST Infrastructure Updates

.github/workflows/nightly-build.yaml

@@ -9,14 +9,11 @@ jobs:
   build:
     if: ${{ github.repository_owner == 'ProjectPythia' }}
     uses: ProjectPythia/cookbook-actions/.github/workflows/build-book.yaml@main
-    with:
-      environment_file: 'environment.yml'
-      environment_name: pythia
-      path_to_notebooks: 'portal'
-      build_command: 'make -j4 html'
+
+  deploy:
+    needs: build
+    uses: ProjectPythia/cookbook-actions/.github/workflows/deploy-book.yaml@main
 
   link-check:
     if: ${{ github.repository_owner == 'ProjectPythia' }}
-    uses: ./.github/workflows/sphinx-link-checker.yaml
-    with:
-      path_to_source: 'portal'
+    uses: ProjectPythia/cookbook-actions/.github/workflows/link-checker.yaml@main

.github/workflows/trigger-site-build.yaml

@@ -6,9 +6,8 @@ jobs:
   build:
     uses: ProjectPythia/cookbook-actions/.github/workflows/build-book.yaml@main
     with:
-      environment_file: 'environment.yml'
       environment_name: pythia
       artifact_name: book-zip-${{ github.event.number }}
       path_to_notebooks: 'portal'
-      build_command: 'make -j4 html'
+      base_url: '/${{ github.event.repository.name }}/_preview/${{ github.event.number }}'
       # Other input options are possible, see ProjectPythia/cookbook-actions/.github/workflows/build-book.yaml

CONTRIBUTING.md

@@ -7,17 +7,14 @@ contribution guidelines (such as detailed description of Project
 Pythia structure, forking, repository cloning, branching, etc.).
 
 ## Instructions for adding a blog post
-
-We use [Sphinx ABblog](https://ablog.readthedocs.io/en/stable/) to add blog posts to our site.
-
 Within the `portal/posts/` folder add your `.md` blog file with the following heading:
 
 ```
 ---
-blogpost: true
-date: MON DD, YYYY
+
+date: YYYY-MM-DD
 author: First Last
-tags: sample-tag
+tags: [sample-tag]
 ---
 ```
 

README.md

@@ -3,6 +3,6 @@
 [![nightly-build](https://github.com/ProjectPythia/projectpythia.github.io/actions/workflows/nightly-build.yaml/badge.svg)](https://github.com/ProjectPythia/projectpythia.github.io/actions/workflows/nightly-build.yaml)
 
 This is the source repository for the [Project Pythia portal](https://projectpythia.org).
-The portal site is built with [sphinx](https://www.sphinx-doc.org/).
+The portal site is built with [MyST-MD](https://mystmd.org/).
 
 Information on contributing is available [here](CONTRIBUTING.md)

environment.yml

@@ -3,12 +3,8 @@ channels:
 - conda-forge
 - nodefaults
 dependencies:
-- ablog
 - matplotlib
-- myst-nb
 - pandas
 - pre-commit
 - pyyaml
-- sphinx-pythia-theme
-- sphinx-design
-- sphinx-copybutton
+- mystmd

myst.yml

@@ -0,0 +1,29 @@
+# See docs at: https://mystmd.org/guide/frontmatter
+version: 1
+extends:
+  - https://raw.githubusercontent.com/projectpythia/pythia-config/main/pythia.yml
+project:
+  id: 770e49e5-344a-4c46-adaa-3afb060b2085
+  # title:
+  # description:
+  keywords: []
+  authors: []
+  github: https://github.com/projectpythia/projectpythia.github.io
+  # bibliography: []
+
+  toc:
+    - file: portal/index.md
+    - file: portal/about.md
+    - title: Blog
+      children:
+        - pattern: portal/posts/*.md
+    - file: portal/contributing.md
+    - file: portal/cookbook-guide.md
+    - file: portal/metrics.md
+site:
+  actions:
+    - title: Learn More
+      url: https://mystmd.org/guide
+  domains: []
+  options:
+    style: style.css