diff --git a/.github/workflows/build-docfx.yml b/.github/workflows/build-docfx.yml new file mode 100644 index 0000000000..00f7dd4dbf --- /dev/null +++ b/.github/workflows/build-docfx.yml @@ -0,0 +1,51 @@ +name: Build & Publish Docfx + +on: + push: + branches: [ master ] + paths: + - '**.cs' + - '**.csproj' + - '**.sln' + - '**.git**' + - '**.yml' + # no docs on which one of these is supposed to work, so + # why not just do both + - 'RobustToolbox' + - 'RobustToolbox/**' + +jobs: + docfx: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Setup submodule + run: | + git submodule update --init --recursive + - name: Pull engine updates + uses: space-wizards/submodule-dependency@v0.1.5 + - name: Update Engine Submodules + run: | + cd RobustToolbox/ + git submodule update --init --recursive + - name: Setup .NET Core + uses: actions/setup-dotnet@v1 + with: + dotnet-version: 6.0.x + + - name: Install dependencies + run: dotnet restore + + - name: Build Project + run: dotnet build --no-restore /p:WarningsAsErrors=nullable + + - name: Build DocFX + uses: nikeee/docfx-action@v1.0.0 + with: + args: Content.Docfx/docfx.json + + - name: Publish Docfx Documentation on GitHub Pages + uses: maxheld83/ghpages@master + env: + BUILD_DIR: Content.Docfx/_content-site + GH_PAT: ${{ secrets.GH_PAT }}