mpusz/mp-units
1
0
Fork 1
mirror of https://github.com/mpusz/mp-units.git synced 2025-06-25 01:01:33 +02:00
Code Issues Packages Projects Releases Wiki Activity

build: API Reference generation procedure simplified

Browse Source
This commit is contained in:
Mateusz Pusz
2024-09-25 12:39:37 +02:00
parent ab888aaecd
commit 1c31a2e7cb
3 changed files with 9 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
.github/workflows/documentation.yml vendored
View File

@ -55,12 +55,9 @@ jobs:
run: | run: |
sudo apt install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern sudo apt install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern
sudo apt install haskell-stack graphviz nodejs npm ghc cabal-install sudo apt install haskell-stack graphviz nodejs npm ghc cabal-install
npm install split mathjax-full mathjax-node-sre npm install split mathjax-full mathjax-node-sre mathjax-node-cli
cabal update cabal update
- name: Installing MathJax-Node-CLI echo "~/node_modules/.bin" >> $GITHUB_PATH
run: |
git clone https://github.com/mathjax/mathjax-node-cli --depth=1
echo "${{ github.workspace }}/mathjax-node-cli/bin" >> $GITHUB_PATH
- name: Get git repos with API reference tools - name: Get git repos with API reference tools
run: | run: |
git clone https://github.com/JohelEGP/jegp.cmake_modules.git --depth=1 git clone https://github.com/JohelEGP/jegp.cmake_modules.git --depth=1

7
.gitpod/Dockerfile
View File

@ -32,9 +32,6 @@ RUN sudo install-packages \
npm \ npm \
ghc \ ghc \
cabal-install cabal-install
RUN npm install split mathjax-full mathjax-node-sre RUN npm install split mathjax-full mathjax-node-sre mathjax-node-cli
RUN cabal update RUN cabal update
RUN echo "export PATH=\"~/node_modules/.bin:\$PATH\"" >> ~/.bashrc
# Install MathJax-Node-CLI
RUN git clone https://github.com/mathjax/mathjax-node-cli --depth=1
RUN echo "export PATH=\"$PWD/mathjax-node-cli/bin:\$PATH\"" >> ~/.bashrc

11
CONTRIBUTING.md
View File

@ -190,17 +190,16 @@ directory:
```bash ```bash
sudo apt install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern sudo apt install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern
sudo apt install haskell-stack graphviz nodejs npm ghc cabal-install sudo apt install haskell-stack graphviz nodejs npm ghc cabal-install
npm install split mathjax-full mathjax-node-sre npm install split mathjax-full mathjax-node-sre mathjax-node-cli
cabal update cabal update
``` ```
Also, installing `mathjax-node-cli` through npm does not help because `tex2html` is not called within On some platforms, installing `mathjax-node-cli` through `npm` does update the system's `PATH`
node.js. This is why we need to download `mathjax-node-cli` and add its `bin` folder to the `PATH` environment variable resulting in `tex2html` not found errors. In such cases we need to add
environment variable: the `.bin` folder to the `PATH` environment variable manually:
```bash ```bash
git clone https://github.com/mathjax/mathjax-node-cli echo "export PATH=\"~/node_modules/.bin:\$PATH\"" >> ~/.bashrc && source ~/.bashrc
echo "export PATH=\"$PWD/mathjax-node-cli/bin:\$PATH\"" >> ~/.bashrc && source ~/.bashrc
``` ```
Next, we need to clone the following git repositories: Next, we need to clone the following git repositories: