-
Notifications
You must be signed in to change notification settings - Fork 392
228 lines (194 loc) · 8.13 KB
/
build_documentation.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
name: Documentation
on:
push:
branches: [ develop ]
pull_request:
branches: [ develop ]
defaults:
run:
shell: bash
jobs:
build:
name: Build PDFs on ${{ matrix.pretty }}
strategy:
fail-fast: false
matrix:
include:
- os: ubuntu-24.04
generator: "Unix Makefiles"
pretty: 'Ubuntu 24.04'
- os: windows-2019
generator: "Visual Studio 16 2019"
pretty: "Windows"
runs-on: ${{ matrix.os }}
steps:
- name: Checkout EnergyPlus
uses: actions/checkout@v4
- name: Set up Python 3.12
uses: actions/setup-python@v5
with:
python-version: '3.12'
- name: Set up LaTeX on Linux
if: runner.os == 'Linux'
run: sudo apt update && sudo apt install -y texlive texlive-xetex texlive-science poppler-utils
- name: Set up LaTeX on Windows
if: runner.os == 'Windows'
run: |
set -x
echo "Downloading MiKTeX CLI installer"
# We download from a specific miror already # TODO: Should store this setup package somewhere ourselves
curl -L -O https://ctan.math.illinois.edu/systems/win32/miktex/setup/windows-x64/miktexsetup-5.5.0%2B1763023-x64.zip
unzip miktexsetup-5.5.0%2B1763023-x64.zip
echo "Setting up the local package directory via download"
./miktexsetup_standalone --verbose \
--local-package-repository=C:/MiKTeX-Repo \
--remote-package-repository="https://ctan.math.illinois.edu/systems/win32/miktex/tm/packages/" \
--package-set=essential \
download
echo "Installing from the local package directory previously set up"
./miktexsetup_standalone --verbose \
--local-package-repository=C:/MiKTeX-Repo \
--package-set=essential \
--shared=yes \
install
echo "Adding MiKTeX bin folder to PATH and to GITHUB_PATH"
echo "C:/Program Files/MiKTeX/miktex/bin/x64/" >> $GITHUB_PATH
export PATH="/c/Program Files/MiKTeX/miktex/bin/x64/:$PATH"
echo "Configuring MiKTeX to install missing packages on the fly"
initexmf --admin --verbose --set-config-value='[MPM]AutoInstall=1'
echo "Configure default mirror for packages"
mpm --admin --set-repository="https://ctan.math.illinois.edu/systems/win32/miktex/tm/packages/"
# If later we pre-package into a zip/tar.gz all the packages we need, we can preinstall them via
# mpm --admin --set-repository=C:/MiKTeX-Repo
# mpm --verbose --admin --repository=C:\MiKTeX-Repo --require=@C:\MiKTeX-Repo\energyplus_packages.lst
# Avoid annoying warning: "xelatex: major issue: So far, you have not checked for updates as a MiKTeX user."
mpm --find-updates
mpm --admin --find-updates
# initexmf --enable-installer --update-fndb
# initexmf --admin --enable-installer --update-fndb
# initexmf --enable-installer --dump-by-name=xelatex --engine=xetex
# This will install all required packages and does that in a single thread. So later in cmake we can safely run in parallel
- name: Preinstall Packages on Windows
if: runner.os == 'Windows'
working-directory: ./doc/
run: |
# It shaves about 1min40s to preinstall from the .lst so do it first
mpm --verbose --admin --require=@energyplus_packages_windows.lst
cd test/
xelatex dependencies.tex
nwords=$(pdftotext -f 2 -l 2 dependencies.pdf - | wc -w)
[ "$nwords" -lt "10" ] && echo "TOC isn't available for pass NO. 1 (as expected)" || echo "TOC IS available for pass NO. 1"
xelatex dependencies.tex
nwords=$(pdftotext -f 2 -l 2 dependencies.pdf - | wc -w)
if [ "$nwords" -lt "10" ]; then
echo "TOC isn't available for pass NO. 2"
exit 1
fi;
echo "TOC is available for pass NO.2"
- name: Create Build Environment
run: cmake -E make_directory ./doc/build
- name: Configure CMake
working-directory: ./doc/build
run: cmake -G "${{ matrix.generator }}" -DTEX_INTERACTION=batchmode -DDOCS_TESTING=ON ..
- name: Add problem matcher
run: echo "::add-matcher::.github/workflows/doc-problem-match.json"
- name: Build Docs
working-directory: ./doc/build
run: cmake --build . -j 4
- name: Upload Acknowledgments
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: Acknowledgments
path: ${{ github.workspace }}/doc/build/pdf/Acknowledgments.pdf
- name: Upload AuxiliaryPrograms
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: AuxiliaryPrograms
path: ${{ github.workspace }}/doc/build/pdf/AuxiliaryPrograms.pdf
- name: Upload EMSApplicationGuide
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: EMSApplicationGuide
path: ${{ github.workspace }}/doc/build/pdf/EMSApplicationGuide.pdf
- name: Upload EnergyPlusEssentials
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: EnergyPlusEssentials
path: ${{ github.workspace }}/doc/build/pdf/EnergyPlusEssentials.pdf
- name: Upload EngineeringReference
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: EngineeringReference
path: ${{ github.workspace }}/doc/build/pdf/EngineeringReference.pdf
- name: Upload ExternalInterfacesApplicationGuide
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: ExternalInterfacesApplicationGuide
path: ${{ github.workspace }}/doc/build/pdf/ExternalInterfacesApplicationGuide.pdf
- name: Upload GettingStarted
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: GettingStarted
path: ${{ github.workspace }}/doc/build/pdf/GettingStarted.pdf
- name: Upload InputOutputReference
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: InputOutputReference
path: ${{ github.workspace }}/doc/build/pdf/InputOutputReference.pdf
- name: Upload InterfaceDeveloper
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: InterfaceDeveloper
path: ${{ github.workspace }}/doc/build/pdf/InterfaceDeveloper.pdf
- name: Upload ModuleDeveloper
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: ModuleDeveloper
path: ${{ github.workspace }}/doc/build/pdf/ModuleDeveloper.pdf
- name: Upload OutputDetailsAndExamples
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: OutputDetailsAndExamples
path: ${{ github.workspace }}/doc/build/pdf/OutputDetailsAndExamples.pdf
- name: Upload PlantApplicationGuide
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: PlantApplicationGuide
path: ${{ github.workspace }}/doc/build/pdf/PlantApplicationGuide.pdf
- name: Upload UsingEnergyPlusForCompliance
uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-24.04'
with:
name: UsingEnergyPlusForCompliance
path: ${{ github.workspace }}/doc/build/pdf/UsingEnergyPlusForCompliance.pdf
- name: Upload entire pdf folder
uses: actions/upload-artifact@v4
if: always() && matrix.os == 'ubuntu-24.04'
with:
name: AllDocumentation
path: ${{ github.workspace }}/doc/build/pdf/
- name: Upload log folder upon failure
if: failure() && runner.os == 'Windows'
uses: actions/upload-artifact@v4
with:
name: Xelatex_Logs_after_all
path: C:\Users\runneradmin\AppData\Local\MiKTeX\miktex\log\
# - name: Test
# working-directory: ${{runner.workspace}}/build
# shell: bash
# # Execute tests defined by the CMake configuration.
# # See https://cmake.org/cmake/help/latest/manual/ctest.1.html for more detail
# # run: ctest -C $BUILD_TYPE
# run: ls