diff options
| author | Louis Maddox <lmmx@users.noreply.github.com> | 2021-07-18 22:44:55 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-07-18 22:44:55 +0100 |
| commit | 3e55a4634b233fe1c8882c52e3a3eadbf4caacea (patch) | |
| tree | eb80f5f1a382801f913bd7751173c3bb15632b09 /sphinx/transforms | |
| parent | 1c2e461e0d0d4965071d192294b2de0ab59739d8 (diff) | |
| download | sphinx-git-3e55a4634b233fe1c8882c52e3a3eadbf4caacea.tar.gz | |
Improve sphinx.transforms.post_transforms.images docstrings
Diffstat (limited to 'sphinx/transforms')
| -rw-r--r-- | sphinx/transforms/post_transforms/images.py | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/sphinx/transforms/post_transforms/images.py b/sphinx/transforms/post_transforms/images.py index c9ed572b8..d243ea712 100644 --- a/sphinx/transforms/post_transforms/images.py +++ b/sphinx/transforms/post_transforms/images.py @@ -154,13 +154,13 @@ class ImageConverter(BaseImageConverter): """A base class for image converters. An image converter is kind of Docutils transform module. It is used to - convert image files which does not supported by builder to appropriate - format for that builder. + convert image files which are not supported by a builder to the + appropriate format for that builder. For example, :py:class:`LaTeX builder <.LaTeXBuilder>` supports PDF, PNG and JPEG as image formats. However it does not support SVG images. - For such case, to use image converters allows to embed these - unsupported images into the document. One of image converters; + For such case, using image converters allows to embed these + unsupported images into the document. One of the image converters; :ref:`sphinx.ext.imgconverter <sphinx.ext.imgconverter>` can convert a SVG image to PNG format using Imagemagick internally. @@ -258,10 +258,10 @@ class ImageConverter(BaseImageConverter): self.env.images.add_file(self.env.docname, destpath) def convert(self, _from: str, _to: str) -> bool: - """Convert a image file to expected format. + """Convert an image file to the expected format. - *_from* is a path for source image file, and *_to* is a path for - destination file. + *_from* is a path of the source image file, and *_to* is a path + of the destination file. """ raise NotImplementedError() |
