diff --git a/.github/workflows/marp-to-pages.yml b/.github/workflows/publish-pages.yml similarity index 52% rename from .github/workflows/marp-to-pages.yml rename to .github/workflows/publish-pages.yml index a4f9074..f8ab176 100644 --- a/.github/workflows/marp-to-pages.yml +++ b/.github/workflows/publish-pages.yml @@ -1,38 +1,51 @@ -name: marp-to-pages -concurrency: marp-to-pages +name: marp-and-mkdocs-to-pages +concurrency: marp-and-mkdocs-to-pages on: push: branches: [ main ] paths: - slides/** + - docs/** + - mkdocs.yml - img/** - - .github/workflows/marp-to-pages.yml + - .github/workflows/publish-pages.yml permissions: contents: write jobs: build: - runs-on: ubuntu-latest + runs-on: ubuntu-22.04 steps: - name: Checkout code ✅ - uses: actions/checkout@v3 + uses: actions/checkout@v4 - - name: Copy images 🖼️ + - name: Setup Python3 🐍 + uses: actions/setup-python@v5 + with: + python-version: "3.11" + + - name: Build MkDocs Site + run: | + pip install mkdocs-material + mkdocs build + + - name: Build Directories and Copy images 🖼️ run: | - mkdir build \ - && cp -R img build/img + mkdir site/slides \ + && mkdir site/pdfs \ + && cp -R img site/slides/img - name: Build HTML from Marp 🔨 uses: docker://marpteam/marp-cli:v3.0.2 with: - args: --html slides/avd_cvaas.md -o build/avd_cvaas.html + args: --html slides/avd_cvaas.md -o site/slides/avd_cvaas.html env: MARP_USER: root:root - name: Build PDF from marp_slides.md 🔨 uses: docker://marpteam/marp-cli:v3.0.2 with: - args: --html --allow-local-files slides/avd_cvaas.md -o build/avd_cvaas.pdf + args: --html --allow-local-files slides/avd_cvaas.md -o site/pdfs/avd_cvaas.pdf env: MARP_USER: root:root diff --git a/docs/avd-cvaas/aa.md b/docs/avd-cvaas/aa.md new file mode 100644 index 0000000..dbf6fef --- /dev/null +++ b/docs/avd-cvaas/aa.md @@ -0,0 +1,4 @@ +# AVD CVaaS Active-Active Demo + +[Slides](https://arista-netdevops-community.github.io/one-click-se-demos/slides/avd_cvaas.html) +[PDF Slides](https://arista-netdevops-community.github.io/one-click-se-demos/pdfs/avd_cvaas.html) diff --git a/docs/avd-cvaas/mlag.md b/docs/avd-cvaas/mlag.md new file mode 100644 index 0000000..fc3c1a9 --- /dev/null +++ b/docs/avd-cvaas/mlag.md @@ -0,0 +1,4 @@ +# AVD CVaaS MLAG Demo + +[Slides](https://arista-netdevops-community.github.io/one-click-se-demos/slides/avd_cvaas.html) +[PDF Slides](https://arista-netdevops-community.github.io/one-click-se-demos/pdfs/avd_cvaas.html) diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..000ea34 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,17 @@ +# Welcome to MkDocs + +For full documentation visit [mkdocs.org](https://www.mkdocs.org). + +## Commands + +* `mkdocs new [dir-name]` - Create a new project. +* `mkdocs serve` - Start the live-reloading docs server. +* `mkdocs build` - Build the documentation site. +* `mkdocs -h` - Print help message and exit. + +## Project layout + + mkdocs.yml # The configuration file. + docs/ + index.md # The documentation homepage. + ... # Other markdown pages, images and other files. diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..85dd0f1 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,60 @@ +site_name: MKDOCs test + +theme: + name: material + features: + - announce.dismiss + - content.action.edit + - content.action.view + - content.code.annotate + - content.code.copy + # - content.code.select + # - content.footnote.tooltips + # - content.tabs.link + - content.tooltips + # - header.autohide + # - navigation.expand + - navigation.footer + - navigation.indexes + # - navigation.instant + # - navigation.instant.prefetch + # - navigation.instant.progress + # - navigation.prune + - navigation.sections + - navigation.tabs + # - navigation.tabs.sticky + - navigation.top + - navigation.tracking + - search.highlight + - search.share + - search.suggest + - toc.follow + # - toc.integrate + palette: + - media: "(prefers-color-scheme: light)" + scheme: default + primary: brown + accent: red + toggle: + icon: material/weather-sunny + name: Switch to dark mode + - media: "(prefers-color-scheme: dark)" + scheme: slate + primary: brown + accent: amber + toggle: + icon: material/weather-night + name: Switch to light mode + + font: + text: Roboto + code: Roboto Mono + favicon: assets/favicon.png + icon: + logo: logo + +nav: + - Home: index.md + - AVD CVaaS: + - MLAG: avd-cvaas/mlag.md + - Active-Active: avd-cvaas/aa.md