Init pages

.github/workflows/publish-pages-on-forks.yml

@@ -0,0 +1,58 @@
+---
+name: marp-and-mkdocs-to-pages
+concurrency: marp-and-mkdocs-to-pages
+on:
+  push:
+    branches: [ '**' ]
+    paths:
+    - slides/**
+    - docs/**
+    - mkdocs.yml
+    - img/**
+    - .github/workflows/publish-pages-on-forks.yml
+    # also trigger if lab archives changed
+    - demos/**
+    - .devcontainer/**
+  workflow_dispatch:
+    branches: [ '**' ]
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+jobs:
+  build:
+    if: github.repository != 'aristanetworks/aclabs'
+    runs-on: ubuntu-22.04
+    steps:
+
+      - name: Checkout code ✅
+        uses: actions/checkout@v4
+
+      - name: find-branch
+        id: find_branch
+        run: |
+          echo "branch=${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" >> $GITHUB_OUTPUT
+
+      - name: Setup Python3 🐍
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build MkDocs Site
+        run: |
+          pip install mkdocs-material
+          pip install mkdocs-macros-plugin
+          pip install mdx_truly_sane_lists
+          mkdocs build
+
+      - name: Setup Pages 📖
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact 🔼
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./site/
+
+      - name: Deploy to GitHub Pages 🚀
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/publish-pages.yml

@@ -0,0 +1,53 @@
+---
+name: marp-and-mkdocs-to-pages
+concurrency: marp-and-mkdocs-to-pages
+on:
+  push:
+    branches: [ main ]
+    paths:
+    - slides/**
+    - docs/**
+    - mkdocs.yml
+    - img/**
+    - .github/workflows/publish-pages.yml
+    # also trigger if lab archives changed
+    - demos/**
+    - .devcontainer/**
+  workflow_dispatch:
+    branches: [main]
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+jobs:
+  build:
+    if: github.repository == 'aristanetworks/aclabs'
+    runs-on: ubuntu-22.04
+    steps:
+
+      - name: Checkout code ✅
+        uses: actions/checkout@v4
+
+      - name: Setup Python3 🐍
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build MkDocs Site
+        run: |
+          pip install mkdocs-material
+          pip install mkdocs-macros-plugin
+          pip install mdx_truly_sane_lists
+          mkdocs build
+
+      - name: Setup Pages 📖
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact 🔼
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./site/
+
+      - name: Deploy to GitHub Pages 🚀
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -8,3 +8,6 @@
 
 # license files
 *license*.json
+
+# ignore mkdocs serve privacy cache
+.cache

docs/index.md

@@ -0,0 +1,5 @@
+# Arista Community Labs
+
+!!! Warning "WARNING!"
+
+    Under construction!

mkdocs.yml

@@ -0,0 +1,81 @@
+---
+site_name: Arista Community Labs
+site_url: https://aclabs.arista.com
+repo_name: Arista Community Labs
+repo_url: https://github.com/aristanetworks/aclabs
+
+# extra_css:
+#   - assets/stylesheets/extra.css
+
+theme:
+  name: material
+  features:
+    - announce.dismiss
+    - content.code.annotate
+    - content.code.copy
+    # - content.code.select
+    - content.footnote.tooltips
+    # - content.tabs.link
+    - content.tooltips
+    - header.autohide
+    # - navigation.expand
+    - navigation.indexes
+    # - navigation.instant
+    # - navigation.instant.prefetch
+    # - navigation.instant.progress
+    # - navigation.prune
+    # - navigation.sections
+    - navigation.tabs
+    # enabling prune for testing only, to check if it's stable
+    #   it's not making any difference with current site setup
+    - navigation.prune
+    # - navigation.tabs.sticky
+    - navigation.top
+    - navigation.tracking
+    - search.highlight
+    - search.share
+    - search.suggest
+    - toc.follow
+    # - toc.integrate
+
+  font:
+    text: Roboto
+    code: Roboto Mono
+  favicon: assets/favicon.png
+  icon:
+    repo: fontawesome/brands/github
+    logo: fontawesome/solid/gears
+
+markdown_extensions:
+  - attr_list
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - pymdownx.critic
+  - pymdownx.caret
+  - pymdownx.keys
+  - pymdownx.mark
+  - pymdownx.tilde
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  # allows list ident with 2 spaces
+  - mdx_truly_sane_lists
+
+copyright: >
+  &nbsp;&#x1F36A;&nbsp;<a href="#__consent">Change cookie settings</a>
+
+plugins:
+  - privacy
+  - search
+
+nav:
+  - Home:
+    - Home: index.md