• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 sphinx==1.8.2 blurb python-docs-theme
16  displayName: 'Install build dependencies'
17
18- ${{ if ne(parameters.latex, 'true') }}:
19  - script: make check suspicious html PYTHON=python
20    workingDirectory: '$(build.sourcesDirectory)/Doc'
21    displayName: 'Build documentation'
22
23- ${{ if eq(parameters.latex, 'true') }}:
24  - script: sudo apt-get update && sudo apt-get install -qy --force-yes texlive-full
25    displayName: 'Install LaTeX'
26
27  - script: make dist PYTHON=python SPHINXBUILD='python -m sphinx' BLURB='python -m blurb'
28    workingDirectory: '$(build.sourcesDirectory)/Doc'
29    displayName: 'Build documentation'
30
31- ${{ if eq(parameters.upload, 'true') }}:
32  - task: PublishBuildArtifacts@1
33    displayName: 'Publish docs'
34
35    inputs:
36      PathToPublish: '$(build.sourcesDirectory)/Doc/build'
37      ArtifactName: docs
38      publishLocation: Container
39
40  - ${{ if eq(parameters.latex, 'true') }}:
41    - task: PublishBuildArtifacts@1
42      displayName: 'Publish dist'
43      inputs:
44        PathToPublish: '$(build.sourcesDirectory)/Doc/dist'
45        ArtifactName: docs_dist
46        publishLocation: Container
47