mirror of
https://github.com/wagtail/wagtail.git
synced 2024-12-01 11:41:20 +01:00
65 lines
3.6 KiB
ReStructuredText
65 lines
3.6 KiB
ReStructuredText
.. _inserting_images:
|
|
|
|
Inserting images and videos in a page
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
There will obviously be many instances in which you will want to add images to a page. There are two main ways to add images to pages, either via a specific image chooser field, or via the rich text field image button. Which of these you use will be dependent on the individual setup of your site.
|
|
|
|
Inserting images using the image chooser field
|
|
______________________________________________
|
|
|
|
Often a specific image field will be used for a main image on a page, or for an image to be used when sharing the page on social media. For the standard page on Torchbox.com, the former is used.
|
|
|
|
.. image:: ../../_static/images/screen14_add_main_image.png
|
|
|
|
* You insert an image by clicking the *Choose an image* button.
|
|
|
|
Choosing an image to insert
|
|
___________________________
|
|
|
|
You have two options when selecting an image to insert:
|
|
|
|
#. Selecting an image from the existing image library, or…
|
|
#. Uploading a new image to the CMS
|
|
|
|
When you click the *Choose an image* button you will be presented with a pop-up with two tabs at the top. The first, Search, allows you to search and select from the library. The second, *Upload*, allows you to upload a new image.
|
|
|
|
**Choosing an image from the image library**
|
|
|
|
The image below demonstrates finding and inserting an image that is already present in the CMS image library.
|
|
|
|
.. image:: ../../_static/images/screen16_selecting_image_from_library.png
|
|
|
|
#. Typing into the search box will automatically display the results below.
|
|
#. Clicking one of the Popular tags will filter the search results by that tag.
|
|
#. Clicking an image will take you to the Choose a format window (see image below).
|
|
|
|
**Uploading a new image to the CMS**
|
|
|
|
.. image:: ../../_static/images/screen17_upload_image.png
|
|
|
|
#. You must include an image title for your uploaded image
|
|
#. Click the *Choose file* button to choose an image from your computer.
|
|
#. *Tags* allows you to associate tags with the image you are uploading. This allows them to be more easily found when searching. Each tag should be separated by a space. Good practice for creating multiple word tags is to use an underscore between each word (e.g. western_yellow_wagtail).
|
|
#. Click *Upload* to insert the uploaded image into the carousel. The image will also be added to the main CMS image library for reuse in other content.
|
|
|
|
Inserting images using the rich text field
|
|
__________________________________________
|
|
|
|
Images can also be inserted into the body text of a page via the rich text editor. When working in a rich text field, click the Image control. You will then be presented with the same options as for inserting images into the main carousel.
|
|
|
|
In addition, Wagtail allows you to choose the format of your image.
|
|
|
|
.. image:: ../../_static/images/screen18_image_format.png
|
|
|
|
#. You can select how the image is displayed by selecting one of the format options.
|
|
#. You must provide specific `alt text <https://developer.mozilla.org/en-US/docs/Learn/HTML/Multimedia_and_embedding/Images_in_HTML#Alternative_text>`_ for your image.
|
|
|
|
The format options available are described below:
|
|
|
|
* **Full width:** Image will be inserted using the full width of the text area.
|
|
* **Half-width left/right aligned:** Inserts the image at half the width of the text area. If inserted in a block of text, the text will wrap around the image. If two half-width images are inserted together, they will display next to each other.
|
|
|
|
.. Note::
|
|
The display of images formatted in this way is dependent on your implementation of Wagtail, so you may get slightly different results.
|