14 Commits

Author SHA1 Message Date
Unai Martinez-Corral
31204023b6 Makefile: use sphinx-build -M 2023-03-28 19:34:39 +02:00
Unai Martinez-Corral
d37aceedeb Makefile: fix check condition 2023-03-28 17:44:54 +02:00
Yuri Sizov
e7c7cf1510 Allow specifying a list of files for the make command
This allows doing targetted rebuilds to cut down on the build time significantly,
if you know that you don't need to regenerate every page.

Usage: make html SPHINXOPTS=-j12 FILELIST=index.rst
2023-02-24 19:21:36 +01:00
Jason Yundt
f3d1dff63b Minor English improvements for Makefile
This commit rewords some messages in the makefile to make them simpler
and more natural sounding. It also corrects a minor grammatical mistake
where the word “a” was used before a vowel sound.
2022-09-16 12:57:20 -04:00
Rémi Verschelde
c58ed951a1 Drop LaTeX dependency via usage of sphinx.ext.imgmath in Vector Math tutorial
It's the only tutorial where we used the extension for *3* formulas which anyway
ended up as fairly low res static images generated by sphinx.ext.imgmath, so
requiring ~1 GB of LaTeX setup for it is overkill.

The replacement pictures are the ones generated by sphinx.ext.imgmath, we could
replace them by higher resolution ones.
2020-07-15 09:58:21 +02:00
Max Hilbrunner
e596fc8aa8 Improve CI
Improve CI build times by using a dummy builder for (empty) output, dropping LaTeX, and disabling some Sphinx extensions when building for CI (GDScript lexing, creating a search index, and generating HTML description tags).

In my tests, this improves Travis CI build times: from up to 30 minutes down to 2 minutes.
2020-06-03 17:44:47 +02:00
Hugo Locurcio
c60abb849e Revert "Default to parallel builds in Sphinx for faster builds"
This reverts commit 309a4382c9.

Per #3239, it turns out parallel builds use too much RAM for the
average PC out there.

This closes #3239.
2020-03-04 09:41:32 +01:00
Hugo Locurcio
309a4382c9 Default to parallel builds in Sphinx for faster builds
`-j auto` detects the number of CPU threads automatically.

This partially addresses #2779.
2019-09-22 18:55:45 +02:00
Rémi Verschelde
ddc35b0d6e Config i18n for submodule usage 2018-04-10 10:45:32 +02:00
Todd Ross
bd6d57392f update Sphinx build instructions 2018-01-10 13:54:47 -06:00
Chris Bradfield
e8f709e650 Change latex error to warning 2017-12-08 11:26:12 -08:00
Chris Bradfield
81fb05ae07 Add Makefile check for latex deps 2017-12-03 09:23:33 -08:00
Rémi Verschelde
86563cc374 Import first batch of pages 2016-02-08 18:24:54 +01:00
Rémi Verschelde
33fe0bbde6 Initial Sphinx configuration 2015-12-12 16:58:18 +01:00