@@ -12,7 +12,7 @@ Reduce formats you're building
12
12
13
13
You can change the formats of docs that you're building with our YAML file's :ref: `yaml-config:Formats ` option.
14
14
15
- In particular, the `htmlzip ` takes up a decent amount of memory and time,
15
+ In particular, the `` htmlzip ` ` takes up a decent amount of memory and time,
16
16
so disabling that format might solve your problem.
17
17
18
18
Reduce documentation build dependencies
@@ -27,8 +27,19 @@ as well as reduce your memory footprint.
27
27
Use pip when possible
28
28
---------------------
29
29
30
- In case you are using `conda ` to create your environment,
31
- you could consider using `pip ` instead since `conda ` could require too much memory to calculate the dependency tree.
30
+ If you don't need ``conda `` to create your *documentation * environment,
31
+ consider using ``pip `` instead since ``conda `` could `require too much memory `_ to calculate the dependency tree
32
+ when using multiple channels.
33
+
34
+ .. _require too much memory : https://github.com/conda/conda/issues/5003>
35
+
36
+
37
+ .. tip ::
38
+
39
+ Even though your *project * environment is created with ``conda ``, it may be not necessary for the *documentation * environment.
40
+ That is, to build the documentation is probably that you need fewer Python packages than to use your library itself.
41
+ So, in this case, you could use ``pip `` to install those fewer packages instead of creating a big environment with ``conda ``.
42
+
32
43
33
44
Use system site-packages for pre-installed libs
34
45
-----------------------------------------------
@@ -37,6 +48,6 @@ There are a few libraries that Read the Docs has already installed (scipy, numpy
37
48
in the Docker image used to build your docs. You can check the updated list of pre-installed libraries in the `Docker image repository `_.
38
49
39
50
To use these pre-installed libraries and avoid consuming time re-downloading/compiling them,
40
- you ca use the :ref: `yaml-config:Python-use-system-site-packages ` option to have access to them.
51
+ you can use the :ref: `yaml-config:python.use_system_site_packages ` option to have access to them.
41
52
42
53
.. _Docker image repository : https://github.com/rtfd/readthedocs-docker-images
0 commit comments