Steve Dower | 5767509 | 2018-09-24 07:44:50 -0400 | [diff] [blame] | 1 | parameters: |
| 2 | latex: false |
| 3 | upload: false |
| 4 | |
| 5 | steps: |
| 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 | |
Julien Palard | 7f4ba4a | 2018-11-24 11:35:21 +0100 | [diff] [blame] | 15 | - script: python -m pip install sphinx==1.8.2 blurb python-docs-theme |
Steve Dower | 5767509 | 2018-09-24 07:44:50 -0400 | [diff] [blame] | 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 |