Skip to content

Commit 98a88cd

Browse files
committed
Add PDF support to devcontainer, clean up doc deps, add VS Code task
- Dockerfile: install texlive-latex-recommended, texlive-fonts-recommended, texlive-latex-extra, latexmk so the devcontainer can generate PDFs - docs.yml: remove redundant 'pip install sphinx_design' from all jobs; sphinx_design is already declared in [project.optional-dependencies.docs] so 'pip install .[docs]' is sufficient - dfetch.code-workspace: add 'Build PDF Docs' task (make latexpdf) https://claude.ai/code/session_014hVQ5UrK1B4N9ar4UfYpm4
1 parent b1e41bb commit 98a88cd

3 files changed

Lines changed: 32 additions & 3 deletions

File tree

.devcontainer/Dockerfile

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,14 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
1515
subversion=1.14.5-3 && \
1616
rm -rf /var/lib/apt/lists/*
1717

18+
# Install LaTeX for PDF documentation generation
19+
RUN apt-get update && apt-get install --no-install-recommends -y \
20+
texlive-latex-recommended=2023.20240207-1 \
21+
texlive-fonts-recommended=2023.20240207-1 \
22+
texlive-latex-extra=2023.20240207-1 \
23+
latexmk=1:4.83-1 && \
24+
rm -rf /var/lib/apt/lists/*
25+
1826
# Install ruby gem FPM for packaging
1927
RUN apt-get update && apt-get install --no-install-recommends -y \
2028
ruby=1:3.3+b1 \

.github/workflows/docs.yml

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,6 @@ jobs:
3131
- name: Install documentation requirements
3232
run: |
3333
pip install .[docs]
34-
pip install sphinx_design
3534
3635
- name: Build docs
3736
run: "make -C doc html"
@@ -55,7 +54,6 @@ jobs:
5554
- name: Install dependencies
5655
run: |
5756
pip install .[docs]
58-
pip install sphinx_design
5957
6058
- name: Build landing-page
6159
run: "make -C doc/landing-page html"
@@ -90,7 +88,6 @@ jobs:
9088
- name: Install documentation requirements
9189
run: |
9290
pip install .[docs]
93-
pip install sphinx_design
9491
9592
- name: Install LaTeX
9693
run: |

dfetch.code-workspace

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,30 @@
9797
"panel": "shared"
9898
}
9999
},
100+
{
101+
"label": "Build PDF Docs",
102+
"type": "shell",
103+
"linux": {
104+
"command": "make"
105+
},
106+
"windows": {
107+
"command": "make.bat"
108+
},
109+
"args": [
110+
"latexpdf"
111+
],
112+
"options": {
113+
"cwd": "${workspaceFolder}/doc"
114+
},
115+
"group": {
116+
"kind": "build",
117+
"isDefault": false
118+
},
119+
"presentation": {
120+
"reveal": "always",
121+
"panel": "shared"
122+
}
123+
},
100124
{
101125
"label": "Build Landing page",
102126
"type": "shell",

0 commit comments

Comments
 (0)