1parameters:
2  latex: false
3  upload: false
4
5steps:
6- checkout: self
7  clean: true
8  fetchDepth: 5
9
10- task: UsePythonVersion@0
11  displayName: 'Use Python 3.6 or later'
12  inputs:
13    versionSpec: '>=3.6'
14
15- script: python -m pip install -r requirements.txt
16  workingDirectory: '$(build.sourcesDirectory)/Doc'
17  displayName: 'Install build dependencies'
18
19- ${{ if ne(parameters.latex, 'true') }}:
20  - script: make check html PYTHON=python
21    workingDirectory: '$(build.sourcesDirectory)/Doc'
22    displayName: 'Build documentation'
23
24- ${{ if eq(parameters.latex, 'true') }}:
25  - script: sudo apt-get update && sudo apt-get install -qy --force-yes texlive-full
26    displayName: 'Install LaTeX'
27
28  - script: make dist PYTHON=python SPHINXBUILD='python -m sphinx' BLURB='python -m blurb'
29    workingDirectory: '$(build.sourcesDirectory)/Doc'
30    displayName: 'Build documentation'
31
32- ${{ if eq(parameters.upload, 'true') }}:
33  - task: PublishBuildArtifacts@1
34    displayName: 'Publish docs'
35
36    inputs:
37      PathToPublish: '$(build.sourcesDirectory)/Doc/build'
38      ArtifactName: docs
39      publishLocation: Container
40
41  - ${{ if eq(parameters.latex, 'true') }}:
42    - task: PublishBuildArtifacts@1
43      displayName: 'Publish dist'
44      inputs:
45        PathToPublish: '$(build.sourcesDirectory)/Doc/dist'
46        ArtifactName: docs_dist
47        publishLocation: Container
48