Skip to content

Commit aaa5b46

Browse files
author
Matthias Koeppe
committed
src/doc/en/installation/source.rst: Merge section on texlive etc. into system package section
1 parent f858db5 commit aaa5b46

File tree

1 file changed

+10
-55
lines changed

1 file changed

+10
-55
lines changed

src/doc/en/installation/source.rst

+10-55
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,16 @@ install the following:
138138

139139
.. literalinclude:: void-develop.txt
140140

141-
For all users, we recommend that you install the following system packages,
142-
which provide additional functionality and cannot be installed by Sage:
141+
For all users, we recommend that you install the following system
142+
packages, which provide additional functionality and cannot be
143+
installed by Sage. In particular, this includes :wikipedia:`LaTeX
144+
<LaTeX>` and related tools. In addition to a base install of :ref:`TeX
145+
Live <spkg_texlive>`, our lists of system packages below include
146+
everything that is needed for generating the Sage documentation in PDF
147+
format. For converting Jupyter notebooks to PDF, also the document
148+
converter :ref:`pandoc <spkg_pandoc>` is needed. For making
149+
animations, Sage needs to use one of the packages :ref:`FFmpeg
150+
<spkg_ffmpeg>` and :ref:`ImageMagick <spkg_imagemagick>`.
143151

144152
.. tab:: Debian/Ubuntu
145153

@@ -1052,56 +1060,3 @@ a single copy of Sage in a multi-user computer network.
10521060
the installation by yourself::
10531061

10541062
$ sudo chown -R root SAGE_LOCAL
1055-
1056-
1057-
Additional software
1058-
-------------------
1059-
1060-
The following programs are not strictly required at build time or at run time,
1061-
but provide additional capabilities to Sage. We highly recommend a Sage user to
1062-
install them.
1063-
1064-
LaTeX
1065-
^^^^^
1066-
1067-
It is highly recommended that you have :wikipedia:`LaTeX <LaTeX>` installed,
1068-
but it is not required. The most popular packaging is `TeX Live
1069-
<https://www.tug.org/texlive/>`_, which can be installed following the
1070-
directions on their web site. On Linux systems you can alternatively install
1071-
your distribution's texlive packages::
1072-
1073-
$ sudo apt-get install texlive # debian
1074-
$ sudo yum install texlive # redhat
1075-
1076-
or similar commands. In addition to the base TeX Live install, you may
1077-
need some optional TeX Live packages, for example
1078-
country-specific Babel packages for the localized Sage
1079-
documentation.
1080-
1081-
Additionally, the following system packages are recommended on Debian/Ubuntu:
1082-
1083-
- ``texlive-generic-extra`` (to generate pdf documentation)
1084-
1085-
- ``texlive-xetex`` (to convert Jupyter notebooks to pdf)
1086-
1087-
- ``latexmk`` (to generate pdf documentation)
1088-
1089-
- ``dvipng`` (to render text with LaTeX in Matplotlib)
1090-
1091-
pandoc
1092-
^^^^^^
1093-
1094-
This is useful to convert Jupyter notebooks to pdf.
1095-
1096-
ffmpeg, ImageMagick
1097-
^^^^^^^^^^^^^^^^^^^
1098-
1099-
If you don't have either ImageMagick or ffmpeg, you won't be able to view
1100-
animations. ffmpeg can produce animations in more different formats than
1101-
ImageMagick, and seems to be faster than ImageMagick when creating animated
1102-
GIFs.
1103-
1104-
``libavdevice-dev`` is a component of ffmpeg to produce animations, and
1105-
recommended to install on Debian/Ubuntu.
1106-
1107-

0 commit comments

Comments
 (0)