Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commitdd4d635

Browse files
committed
Improve usetex and pgf troubleshooting docs.
- Merge "Troubleshooting" and "Possible hangups".- Don't list $PATH issues twice.- Remove mention of dvipng for pgf (which doesn't use dvipng).- Be more generic re: missing latex packages (this applies to all texlive installs, and the required list is given elsewhere).
1 parentde00c49 commitdd4d635

File tree

3 files changed

+17
-23
lines changed

3 files changed

+17
-23
lines changed

‎doc/install/dependencies.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -422,6 +422,8 @@ Python packages and must be installed separately.
422422
* a LaTeX distribution, e.g. `TeX Live<https://www.tug.org/texlive/>`_ or
423423
`MikTeX<https://miktex.org/>`_
424424

425+
.. _tex-dependencies:
426+
425427
LaTeX dependencies
426428
""""""""""""""""""
427429

‎galleries/users_explain/text/pgf.py

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -209,9 +209,10 @@
209209
Troubleshooting
210210
===============
211211
212-
* On Windows, the :envvar:`PATH` environment variable may need to be modified
213-
to include the directories containing the latex, dvipng and ghostscript
214-
executables. See :ref:`environment-variables` and
212+
* Make sure LaTeX is working and on your :envvar:`PATH` (for raster output,
213+
pdftocairo or ghostscript is also required). The :envvar:`PATH` environment
214+
variable may need to be modified (in particular on Windows) to include the
215+
directories containing the executable. See :ref:`environment-variables` and
215216
:ref:`setting-windows-environment-variables` for details.
216217
217218
* Sometimes the font rendering in figures that are saved to png images is

‎galleries/users_explain/text/usetex.py

Lines changed: 11 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -124,24 +124,6 @@
124124
produces PostScript without rasterizing text, so it scales properly, can be
125125
edited in Adobe Illustrator, and searched text in pdf documents.
126126
127-
.. _usetex-hangups:
128-
129-
Possible hangups
130-
================
131-
132-
* On Windows, the :envvar:`PATH` environment variable may need to be modified
133-
to include the directories containing the latex, dvipng and ghostscript
134-
executables. See :ref:`environment-variables` and
135-
:ref:`setting-windows-environment-variables` for details.
136-
137-
* Using MiKTeX with Computer Modern fonts, if you get odd \*Agg and PNG
138-
results, go to MiKTeX/Options and update your format files.
139-
140-
* On Ubuntu and Gentoo, the base texlive install does not ship with
141-
the type1cm package. You may need to install some of the extra
142-
packages to get all the goodies that come bundled with other LaTeX
143-
distributions.
144-
145127
.. _usetex-troubleshooting:
146128
147129
Troubleshooting
@@ -150,8 +132,11 @@
150132
* Try deleting your :file:`.matplotlib/tex.cache` directory. If you don't know
151133
where to find :file:`.matplotlib`, see :ref:`locating-matplotlib-config-dir`.
152134
153-
* Make sure LaTeX, dvipng and Ghostscript are each working and on your
154-
:envvar:`PATH`.
135+
* Make sure LaTeX, dvipng, and Ghostscript are each working and on your
136+
:envvar:`PATH`. The :envvar:`PATH` environment variable may need to
137+
be modified (in particular on Windows) to include the directories
138+
containing the executables. See :ref:`environment-variables` and
139+
:ref:`setting-windows-environment-variables` for details.
155140
156141
* Make sure what you are trying to do is possible in a LaTeX document,
157142
that your LaTeX syntax is valid and that you are using raw strings
@@ -161,6 +146,12 @@
161146
option provides lots of flexibility, and lots of ways to cause
162147
problems. Please disable this option before reporting problems.
163148
149+
* Using MiKTeX with Computer Modern fonts, if you get odd \*Agg and PNG
150+
results, go to MiKTeX/Options and update your format files.
151+
152+
* Some required LaTeX packages, such as type1cm, may be missing from minimalist
153+
TeX installs. Required packages are listed at :ref:`tex-dependencies`.
154+
164155
* If you still need help, please see :ref:`reporting-problems`.
165156
166157
.. _dvipng: http://www.nongnu.org/dvipng/

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp