diff --git a/doc/guide/author/overview.xml b/doc/guide/author/overview.xml index 9311f374c..efb6255ce 100644 --- a/doc/guide/author/overview.xml +++ b/doc/guide/author/overview.xml @@ -102,7 +102,7 @@ Images image -

You can include an image via the imageimage tag, using the source attribute to provide a filename, likely prefixed by a relative path from the top-level of the appropriate directory. Read for details on how to set these directories correctly. If you are starting a new project, using the -CLI (with the command pretext new book, for example), then most of the setup portion is done for you and the top-level directory for images that are created external to the project is called assests, and it is a sibling of the source directory. It is your responsibility to locate that file properly relative to this directory, and that the file format is compatible. So, for example, suppose your source contained <image source="images/butterflies.jpg"/>. Then you would want to have a directory named images below wherever you set the external top-level directory, and you would place the butterflies.jpg file inside of the images directory.

+

You can include an image via the imageimage tag, using the source attribute to provide a filename, likely prefixed by a relative path from the top-level of the appropriate directory. Read for details on how to set these directories correctly. If you are starting a new project, using the -CLI (with the command pretext new book, for example), then most of the setup portion is done for you and the top-level directory for images that are created external to the project is called assets, and it is a sibling of the source directory. It is your responsibility to locate that file properly relative to this directory, and that the file format is compatible. So, for example, suppose your source contained <image source="images/butterflies.jpg"/>. Then you would want to have a directory named images below wherever you set the external top-level directory, and you would place the butterflies.jpg file inside of the images directory.

The width attribute can be used to control the size of the image. Widths are expressed as a percentage of the available width, such as width="60%". Instead of a width, you can also specify margins and the width will be deduced.