You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
76 lines
2.7 KiB
76 lines
2.7 KiB
name: Tag Docs
|
|
|
|
on:
|
|
release:
|
|
types: [ "published" ]
|
|
|
|
jobs:
|
|
docs:
|
|
env:
|
|
ORIGIN_SITE: _origin_site
|
|
TAGS_DIR: tags
|
|
BRANCH_DIR: branch
|
|
name: Generate docs
|
|
runs-on: windows-latest
|
|
steps:
|
|
- name: Configure git
|
|
shell: powershell
|
|
run: |
|
|
git config --global core.autocrlf true
|
|
git config --global user.email (($env:GITHUB_ACTOR,"@users.noreply.github.com") -join "")
|
|
git config --global user.name $env:GITHUB_ACTOR
|
|
- name: Checkout branch
|
|
uses: actions/checkout@v2
|
|
- name: Checkout submodules
|
|
run: git submodule update --init --recursive
|
|
- name: Locate MSBuild
|
|
uses: microsoft/[email protected]
|
|
- name: Setup .NET Core
|
|
uses: actions/setup-dotnet@v1
|
|
with:
|
|
# As usual, obtained from: https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/5.0/releases.json
|
|
dotnet-version: "3.1.404" # since we now use this
|
|
- name: Clear Nuget Cache
|
|
run: dotnet nuget locals all --clear
|
|
- name: Nuget Restore
|
|
run: msbuild -t:Restore -m
|
|
- name: Install DocFX
|
|
uses: crazy-max/ghaction-chocolatey@v1
|
|
with:
|
|
args: install docfx -y
|
|
- name: Checkout current pages
|
|
uses: actions/checkout@v2
|
|
with:
|
|
ref: gh-pages
|
|
token: ${{ secrets.pagesCommitToken }}
|
|
path: docs/${{ env.ORIGIN_SITE }}
|
|
- name: Build docs
|
|
shell: powershell
|
|
working-directory: ./docs
|
|
run: |
|
|
Add-Content link_branch.json "{`"_gitContribute`":{`"sourceBranch`":`"$env:GITHUB_SHA`",`"apiSpecFolder`":`"docs/override`"}}"
|
|
powershell .\build.ps1
|
|
if ($lastexitcode -ne 0) {
|
|
throw [System.Exception] "docfx build failed with exit code $lastexitcode."
|
|
}
|
|
- name: Publish tag site to GitHub pages
|
|
shell: powershell
|
|
working-directory: ./docs
|
|
run: |
|
|
$ErrorActionPreference = "Continue"
|
|
$tagName = (git rev-parse --abbrev-ref=loose $env:GITHUB_REF) -join ""
|
|
cd $env:ORIGIN_SITE
|
|
if (-Not (Test-Path $env:TAGS_DIR)) {
|
|
New-Item -ItemType directory -Path $env:TAGS_DIR
|
|
}
|
|
$tagPath = "$env:TAGS_DIR/$tagName"
|
|
if (Test-Path $tagPath) {
|
|
# force remove it
|
|
Get-ChildItem -Path $tagPath -Recurse | Remove-Item -Force -Recurse
|
|
Remove-Item $tagPath -Force
|
|
}
|
|
# move generated into place
|
|
Move-Item ../_site $tagPath
|
|
git add -A 2>&1
|
|
git commit -q -a -m "Saved tag $tagName"
|
|
git push -q origin gh-pages
|