DN8RC1

.github/workflows/GithubActionsRelease.yml

@@ -5,13 +5,13 @@
 # The publishing actions in forked repositories were handled by the WIP workflow
 # An 'ExitWorkflow' action is sorely needed
 ############################################################################################################
-# NUGET_API_KEY is valid through 9/11/2021
+# NUGET_API_KEY is valid through 9/11/2022
 ############################################################################################################
 
 on:
   push:
     tags:
-      - 4.** # Push events to matching pattern, i.e. 4.0.0, 4.1.0
+      - 5.** # Push events to matching pattern, i.e. 5.0.0, 5.1.0
 
 env:
   buildPlatform: 'Any CPU'
@@ -51,13 +51,12 @@ jobs:
 
     steps:
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Use dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
 
     - name: Run the acceptance tests as the first build action and cancel out the rest if it fails
       run: dotnet test ${{env.projectTest}} --configuration ${{env.buildConfiguration}}
@@ -70,19 +69,25 @@ jobs:
 
     steps:
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Setup dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
 
-    - name: Get proper toc in place
-      run: copy tocMD2.yml toc.yml
+    - name: Setup docfx
+      run: |
+          copy Material.Blazor\docfx.json.MD2 docfx.json
+          copy Material.Blazor\index.md.MD2 index.md
+          copy Material.Blazor\toc.yml.MD2 toc.yml
+          dotnet tool update -g docfx
+
+    - name: Build Material.Blazor
+      run: dotnet build ${{env.projectMB}} --configuration ${{env.buildConfiguration}}
 
     - name: Create documentation 🔧
-      run: .\docfx\docfx docfx.json
+      run: docfx docfx.json
       env:
         DOCFX_SOURCE_BRANCH_NAME: main   
 
@@ -105,19 +110,21 @@ jobs:
       shell: bash
 
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Setup dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
-
-    - name: Install WASM tools
-      run: dotnet workload restore
 
     - name: Build and Publish Website 🔧
-      run: dotnet publish ${{env.projectWeb}} --configuration ${{env.buildConfiguration}} --output ${{env.outputWeb}} -p:Version=${{env.version}} -p:BlazorEnableCompression=false      
+      run: >
+        dotnet publish ${{env.projectWeb}}
+        --configuration ${{env.buildConfiguration}}
+        --output ${{env.outputWeb}}
+        -p:Version=${{env.version}}
+        -p:BlazorEnableCompression=false
+        --framework net8.0
 
     - name: Upload Website Artifacts 🔺 # The website is then uploaded as an artifact named 'siteWeb'.
       uses: actions/upload-artifact@v3
@@ -136,13 +143,12 @@ jobs:
 
     steps:
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Setup dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
 
     - name: Download Artifacts 🔻 # The documentation is downloaded into the 'siteDocFx' folder.
       uses: actions/download-artifact@v3
@@ -183,22 +189,30 @@ jobs:
       shell: bash
 
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Setup dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
 
     - name: Build Material.Blazor & Generate the NuGet package 🔧
-      run: dotnet pack ${{env.projectMB}} --configuration ${{env.buildConfiguration}} --output ${{env.outputMB}} -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg -p:Version=${{env.version}}
+      run: >
+        dotnet pack ${{env.projectMB}}
+        --configuration ${{env.buildConfiguration}}
+        --output ${{env.outputMB}}
+        -p:IncludeSymbols=true
+        -p:SymbolPackageFormat=snupkg
+        -p:Version=${{env.version}}
 
     - name: Display MaterialBlazor package output Ꙫ
       run: dir ${{env.outputMB}}
 
     - name: Upload Package 🚀
-      run: dotnet nuget push ${{env.outputMB}}\*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json
+      run: >
+        dotnet nuget push ${{env.outputMB}}\*.nupkg
+        -k ${{secrets.NUGET_API_KEY}}
+        -s https://api.nuget.org/v3/index.json
 
 ############################################################################################################
 # Create release
@@ -237,23 +251,24 @@ jobs:
 
     steps:
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Setup dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
 
-    - name: Get proper toc in place
-      run: copy tocMD3.yml toc.yml
+    - name: Setup docfx
+      run: |
+          copy Material.Blazor.MD3\docfx.json.MD3 docfx.json
+          copy Material.Blazor.MD3\index.md.MD3 index.md
+          copy Material.Blazor.MD3\toc.yml.MD3 toc.yml
+          dotnet tool update -g docfx
 
-    - name: Create documentation 🔧
-      run: .\docfx\docfx docfxMD3.json
-      env:
-        DOCFX_SOURCE_BRANCH_NAME: main   
+    - name: Build Material.Blazor
+      run: dotnet build ${{env.projectMBMD3}} --configuration ${{env.buildConfiguration}}
 
-    - name: Upload Documentation Artifacts 🔺 # The project is then uploaded as an artifact named 'siteDocFx'.
+    - name: Upload Documentation Artifacts 🔺
       uses: actions/upload-artifact@v3
       with:
         name: siteDocFxMD3
@@ -273,16 +288,21 @@ jobs:
       shell: bash
 
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Setup dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
 
     - name: Build and Publish Website 🔧
-      run: dotnet publish ${{env.projectWebMD3}} --configuration ${{env.buildConfiguration}} --output ${{env.outputWebMD3}} -p:Version=${{env.version}} -p:BlazorEnableCompression=false      
+      run: >
+        dotnet publish ${{env.projectWebMD3}}
+        --configuration ${{env.buildConfiguration}}
+        --output ${{env.outputWebMD3}}
+        -p:Version=${{env.version}}
+        -p:BlazorEnableCompression=false
+        --framework net8.0
 
     - name: Upload Website Artifacts 🔺 # The website is then uploaded as an artifact named 'siteWeb'.
       uses: actions/upload-artifact@v3
@@ -301,13 +321,12 @@ jobs:
 
     steps:
     - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Setup dotnet
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: '8.x'
-        dotnet-quality: 'preview'
 
     - name: Download Artifacts 🔻 # The built project is downloaded into the 'siteWeb' folder.
       uses: actions/download-artifact@v3
@@ -339,3 +358,44 @@ jobs:
         branch: gh-pages
         folder: 'deployroot'
         repository-name: Material-Blazor/Material.Blazor.MD3
+
+############################################################################################################
+# Build package and deploy MD3
+############################################################################################################
+  build-and-deploy-package-MD3:
+    name: Build nuget package & deploy to nuget
+    needs: [test, deployment-allowed-mb, deployghpages, deployghpages-MD3]
+
+    runs-on: windows-latest
+
+    steps:
+    - name: Get the version
+      run: echo "version=${GITHUB_REF/refs\/tags\//}" >> $GITHUB_ENV
+      shell: bash
+
+    - name: Checkout repository under $GITHUB_WORKSPACE so the job can access it 🛎️
+      uses: actions/checkout@v4
+
+    - name: Setup dotnet
+      uses: actions/setup-dotnet@v3
+      with:
+        dotnet-version: '8.x'
+
+    - name: Build Material.Blazor.MD3 & Generate the NuGet package 🔧
+      run: >
+        dotnet pack ${{env.projectMBMD3}}
+        --configuration ${{env.buildConfiguration}}
+        --output ${{env.outputMBMD3}}
+        -p:IncludeSymbols=true
+        -p:SymbolPackageFormat=snupkg
+        -p:Version=${{env.version}}
+
+    - name: Display MaterialBlazor package output Ꙫ
+      run: dir ${{env.outputMBMD3}}
+
+    - name: Upload Package 🚀
+      run: >
+        dotnet nuget push ${{env.outputMBMD3}}\*.nupkg
+        -k ${{secrets.NUGET_API_KEY}}
+        -s https://api.nuget.org/v3/index.json
+