kopia lustrzana https://github.com/wagtail/wagtail
Add alternative text for all documentation screenshots
Thibaud Colas
LB (Ben Johnston)
rodzic
db894a6457
commit
e8d67f778c
|
|
@ -8,11 +8,11 @@ In this interface you can see all of your users, their usernames, their 'level'
|
|||
|
||||
You can sort this listing either via Name or Username.
|
||||
|
||||
|
||||
|
||||
|
||||
- Select multiple users by checking the checkbox on the left of each row, then use the bulk actions bar at the bottom to perform an action on all selected users.
|
||||
|
||||
|
||||
|
||||
|
||||
Clicking on a user's name will open their profile details. From here you can then edit that users details.
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ before the workflow completes (by default, this results in the publication of th
|
|||
|
||||
The workflow management interface is accessed via the `Workflows` item in the `Settings` submenu, found in the left menu bar.
|
||||
|
||||
|
||||
|
||||
|
||||
In this interface you can see all of the workflows on your site, and the order of tasks in each. You can click on a workflow to edit it or to assign it
|
||||
to part of the page tree, or use the `Add a workflow` button to create a new workflow. The number of pages each workflow applies to is also shown, and can be
|
||||
|
|
@ -15,7 +15,7 @@ clicked for a complete listing.
|
|||
|
||||
## Editing workflows
|
||||
|
||||
|
||||
|
||||
|
||||
Under `Add tasks to your workflow`, you can add, remove, or reorder tasks in a workflow. When adding a task to a workflow, you will be given the
|
||||
option to create a new task, or reuse an existing one.
|
||||
|
|
@ -29,7 +29,7 @@ On a previously disabled workflow, there is also the option to enable it again.
|
|||
|
||||
## Creating and editing tasks
|
||||
|
||||
|
||||
|
||||
|
||||
In the tasks interface, accessible via the `Workflow Tasks` item in the `Settings` submenu, you can see a list of the tasks
|
||||
currently available, as well as which workflows use each task. Similarly to workflows, you can click an existing task to edit it, or the `Add a task` button to create a new task.
|
||||
|
|
@ -38,7 +38,7 @@ When creating a task, if you have multiple task types available, these will be o
|
|||
Creating a `group approval task`, you will be able to select one or multiple groups: members of any of these, as well as administrators, will be able to
|
||||
approve or reject moderation for this task.
|
||||
|
||||
|
||||
|
||||
|
||||
When editing a task, you may find that some fields - including the name - are uneditable. This is to ensure workflow history
|
||||
remains consistent - if you find yourself needing to change the name, it is recommended that you disable the old task, and create a new one with the name
|
||||
|
|
|
|||
|
|
@ -16,12 +16,12 @@ To set up the promoted search results, click on the 'Promoted search results' me
|
|||
|
||||
Add a new promoted result from the button in the top right of the resulting screen, or edit an existing promoted result by clicking on it.
|
||||
|
||||
|
||||
|
||||
|
||||
When adding a new promoted result, Wagtail provides you with a 'Choose from popular search terms' option. This will show you the most popular terms entered by users into your internal search. You can match this list against your existing promoted results to ensure that users are able to find what they are looking for.
|
||||
|
||||
|
||||
|
||||
|
||||
You then add a the result itself by clicking 'Add recommended page'. You can add multiple results, but be careful about adding too many, as you may end up hiding all of your organic results with promoted results, which may not be helpful for users who aren't really sure what they are looking for.
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -2,24 +2,24 @@
|
|||
|
||||
Access to specific sets of images and documents can be controlled by setting up ‘collections’. By default all images and documents belong to the ‘root’ collection, but users with appropriate permissions can create new collections through the **Settings -> Collections** area of the admin interface.
|
||||
|
||||
|
||||
|
||||
|
||||
## Add a collection
|
||||
|
||||
- Clicking the **add a collection** button will allow you to create a collection. Name your collection and click **save** .
|
||||
|
||||
|
||||
|
||||
|
||||
## Add images / documents to a collection
|
||||
|
||||
- Navigate to the **Images** or **Documents** section and select a collection from the dropdown menu.
|
||||
- You can also select a collection as part of uploading multiple images or documents.
|
||||
|
||||
|
||||
|
||||
|
||||
- You can also edit an image or document directly by clicking on it to assign it to a collection.
|
||||
|
||||
|
||||
|
||||
|
||||
(collection_privacy_settings)=
|
||||
|
||||
|
|
@ -27,11 +27,11 @@ Access to specific sets of images and documents can be controlled by setting up
|
|||
|
||||
- To set permissions determining who is able to view documents within a collection, navigate to **Settings > Collections** and select a collection. Then click the privacy button above the collection name.
|
||||
|
||||
|
||||
|
||||
|
||||
- Within the privacy settings overlay, select the level of privacy for the collection.
|
||||
|
||||
|
||||
|
||||
|
||||
Permissions set on a collection apply to that collection and all collections below it in the hierarchy. Therefore, if you make the 'root' collection private, all documents in the site will be private. Permissions set on other collections apply to that collection only.
|
||||
|
||||
|
|
|
|||
|
|
@ -2,18 +2,18 @@
|
|||
|
||||
Documents such as PDFs can be managed from the Documents interface, available in the left-hand menu. This interface allows you to add documents to and remove documents from the CMS.
|
||||
|
||||
|
||||
|
||||
|
||||
- Add documents by clicking the _Add document_ button in the top-right.
|
||||
- Search for documents in the CMS by entering your search term in the search bar. The results will be automatically updated as you type.
|
||||
- You can also filter the results by _Collection_ by selecting one from the collections dropdown above the documents list.
|
||||
|
||||
|
||||
|
||||
|
||||
- Select multiple documents by checking the checkbox on the left of each row, then use the bulk actions bar at the bottom to perform an action on all selected documents.
|
||||
- Edit the details of a document by clicking the document title.
|
||||
|
||||
|
||||
|
||||
|
||||
- When editing a document you can replace the file associated with that document record. This means you can update documents without having to update the pages on which they are placed. Changing the file will change it on all pages that use the document.
|
||||
- Change the document's collection using the collection dropdown.
|
||||
|
|
|
|||
|
|
@ -2,15 +2,15 @@
|
|||
|
||||
If you want to edit, add or remove images from the CMS outside of the individual pages you can do so from the Images interface. This is accessed from the left-hand menu.
|
||||
|
||||
|
||||
|
||||
|
||||
- Select multiple images by checking the checkbox on the top left of each image block, then use the bulk actions bar at the bottom to perform an action on all selected images.
|
||||
|
||||
|
||||
|
||||
|
||||
- Clicking an image will allow you to edit the data associated with it. This includes the title, the focal point of the image and much more.
|
||||
|
||||
|
||||
|
||||
|
||||
## Changing the image
|
||||
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ How snippets are used can vary widely between websites. Here are a few examples
|
|||
|
||||
## The Snippets menu
|
||||
|
||||
|
||||
|
||||
|
||||
- You can access the Snippets menu by clicking on the 'Snippets' link in the left-hand menu bar.
|
||||
- To add or edit a snippet, click on the snippet type you are interested in (often help text will be included to help you in selecting the right type)
|
||||
|
|
@ -22,7 +22,7 @@ How snippets are used can vary widely between websites. Here are a few examples
|
|||
Editing a snippet will change it on all of the pages on which it has been used. In the top-right of the Snippet edit screen you will see a label saying how many times the snippet has been used. Clicking this label will display a listing of all of these pages.
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
## Adding snippets whilst editing a page
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ Here is how you can access the edit screen of an existing page:
|
|||
- Clicking the _Edit_ link below the title in either of the situations above.
|
||||
- Clicking the _Edit_ icon for a page in the explorer menu.
|
||||
|
||||
|
||||
|
||||
|
||||
- When editing an existing page the title of the page being edited is displayed at the top of the page.
|
||||
- You can perform various actions (such as copy, move or delete a page) by opening the secondary menu at the right of the top breadcrumb.
|
||||
|
|
@ -22,7 +22,7 @@ Here is how you can access the edit screen of an existing page:
|
|||
If the page is currently in a workflow, you'll see an additional indicator in the Info side panel, showing the current workflow task. Clicking the "View details" button will
|
||||
show more information about the page's progress through the workflow, as well as any comments left by reviewers.
|
||||
|
||||
|
||||
|
||||
|
||||
If you can perform moderation actions (for example, approval or requesting changes) on the current task, you'll see additional options in the
|
||||
action menu at the bottom of the page.
|
||||
|
|
@ -36,27 +36,27 @@ of comments is shown alongside the icon.
|
|||
|
||||
When in commenting mode, hovering over a commentable field or block will reveal a comment button.
|
||||
|
||||
|
||||
|
||||
|
||||
If there is no pre-existing comment on the field, you can use this to create a new comment.
|
||||
|
||||
|
||||
|
||||
|
||||
If there is an existing comment, clicking either the field button or the comment will bring the comment thread into focus, allowing you to
|
||||
add new replies.
|
||||
|
||||
|
||||
|
||||
|
||||
Within a rich text field, you can highlight text and click the comment button to add an inline comment.
|
||||
|
||||
|
||||
|
||||
|
||||
All of these actions can also be performed using the comment shortcut, `Ctrl + Alt + M` / `⌘ + Alt + M`.
|
||||
|
||||
Clicking the three dots in the top right of an existing comment will open its menu. This allows you to
|
||||
resolve a comment, as well as to edit or delete any of your own comments.
|
||||
|
||||
|
||||
|
||||
|
||||
Any comments or changes to comments will only be saved when the page is saved.
|
||||
|
||||
|
|
@ -67,7 +67,7 @@ Currently, fields inside `InlinePanels` and `ListBlocks` are uncommentable.
|
|||
The arrow to the right of the comments icon shows the comment notifications
|
||||
panel, where you can enable or disable email notifications for other users' comments on the page.
|
||||
|
||||
|
||||
|
||||
|
||||
```{note}
|
||||
You will always receive email notifications for threads you are part of, unless you opt out of all comment notifications in your
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ The Dashboard provides information on:
|
|||
|
||||
You can return to the Dashboard at any time by clicking the Wagtail logo in the top-left of the screen.
|
||||
|
||||
|
||||
|
||||
|
||||
- Clicking the logo returns you to your Dashboard.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# The Explorer menu
|
||||
|
||||
|
||||
|
||||
|
||||
- Click the Pages button in the sidebar to open the explorer. This allows you to navigate through the sections of the site.
|
||||
- Clicking the name of a page will take you to the Explorer page for that section.
|
||||
|
|
|
|||
|
|
@ -2,22 +2,22 @@
|
|||
|
||||
The Explorer page allows you to view a page's children and perform actions on them. From here you can publish/unpublish pages, move pages to other sections, drill down further into the content tree, or reorder pages under the parent for the purposes of display in menus.
|
||||
|
||||
|
||||
|
||||
|
||||
- The name of the section you are looking at is displayed at the top. Each section is also itself a page (in this case the homepage). Clicking the title of the section takes you to the Edit screen for the section page.
|
||||
- As the heading suggests, below are the child pages of the section. Clicking the titles of each child page will take you to its Edit screen.
|
||||
- Clicking the arrows will display a further level of child pages.
|
||||
|
||||
|
||||
|
||||
|
||||
- As you drill down through the site, the breadcrumb (the row of pages beginning with the home icon) will display the path you have taken. Clicking on the page titles in the breadcrumb will take you to the Explorer screen for that page.
|
||||
|
||||
|
||||
|
||||
|
||||
- Clicking on the Actions dropdown will show a list of actions for the parent page, like Move, Copy, Delete, Unpublish, History. There will also be a Sort menu order button that will take you to the ordering page (see below)
|
||||
- To add further child pages press the Add child page button. You can view the parent page on the live site by pressing the View live button. The Edit button will take you to the page edit screen.
|
||||
|
||||
|
||||
|
||||
|
||||
- There is a checkbox on the left of each page row, hovering over the row will make it visible. There is also a checkbox at the top left of the header, used to select or deselect all other checkboxes.
|
||||
- Selecting at least one checkbox will popup an action bar at the bottom, which will list all the available bulk actions for pages.
|
||||
|
|
@ -26,7 +26,7 @@ The Explorer page allows you to view a page's children and perform actions on th
|
|||
|
||||
## Reordering pages
|
||||
|
||||
|
||||
|
||||
|
||||
- Clicking the “Sort menu order” button in the More dropdown will take you to a page with the reordering handles. This allows you to reorder the way that content displays in the main menu of your website.
|
||||
- Reorder by dragging the pages by the handles on the far left (the icon made up of 6 dots).
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# Using search
|
||||
|
||||
|
||||
|
||||
|
||||
- A very easy way to find the page that you want is to use the main search feature, accessible from the left-hand menu.
|
||||
- Simply type in part or all of the name of the page you are looking for, and the results below will automatically update as you type.
|
||||
|
|
|
|||
|
|
@ -12,4 +12,4 @@ For the purposes of this documentation we will be using the URL, **www.example.c
|
|||
- Access this by adding **/admin** onto the end of your root URL (for example `www.example.com/admin`).
|
||||
- Enter your username and password and click **Sign in**.
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -26,13 +26,13 @@ As a best practice Wagtail will check redirects as permanent by default, in orde
|
|||
|
||||
To configure redirects head over to 'Redirects', which can be found in the Settings menu, accessible via the left-hand menu bar.
|
||||
|
||||
|
||||
|
||||
|
||||
- Add a redirect by clicking the _Add redirect_ button in the top-right.
|
||||
- Search for redirects already configured by entering your search term in the search bar. The results will be automatically updated as you type.
|
||||
- Edit the details of a redirect by clicking the URL path in the listing.
|
||||
|
||||
|
||||
|
||||
|
||||
- Set _Redirect from_ to the URL pattern which is no longer available on your site.
|
||||
- Set the _From site_ if applicable (for eg: a multi-site environment).
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
A common feature of Wagtail is the ability to add more than one of a particular type of field or item. For example, you can add as many authors to a page as you wish.
|
||||
|
||||
|
||||
|
||||
|
||||
- Whenever you see the "+ Add" button illustrated here with "Add author(s)", it means you can add multiple objects or items to a page. Clicking the icon will display the fields required for that piece of content. The image below demonstrates this with a _Author(s)_ items.
|
||||
- You can delete an individual item by pressing the trash can in the top-right.
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ Wagtail supports a number of basic fields for creating content, as well as our u
|
|||
|
||||
StreamField allows you to create complex layouts of content on a page by combining a number of different arrangements of content, 'blocks', in any order.
|
||||
|
||||
|
||||
|
||||
|
||||
When you first edit a page, you will be presented with the empty StreamField area, with the option to choose one of several block types. The block types on your website may be different from the screenshot here, but the principles are the same.
|
||||
|
||||
|
|
@ -26,15 +26,15 @@ Basic text fields have no formatting options. How these display will be determin
|
|||
|
||||
Most of the time though, you need formatting options to create beautiful looking pages. Wagtail provides "rich text" fields, which have formatting options similar to those of word processors.
|
||||
|
||||
|
||||
|
||||
|
||||
Those fields present a set of tools which allow you to format and style your text. These tools also allow you to insert links, images, videos clips and links to documents. If you want to know more about a specific tool, hover your mouse on the corresponding button so the tooltip appears:
|
||||
|
||||
|
||||
|
||||
|
||||
This tooltip shows a longer description of the tool, and displays its keyboard shortcut if there is one. If the keyboard shortcut does not start with CTRL or ⌘, it's a [Markdown](https://en.wikipedia.org/wiki/Markdown) shortcut to type directly in the editor:
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -42,7 +42,7 @@ That’s the gist of it! If you want more information about the editor, please h
|
|||
|
||||
### Adding further blocks in StreamField
|
||||
|
||||
|
||||
|
||||
|
||||
- To add new blocks, click the '+' icons above or below the existing blocks.
|
||||
- You'll then be presented once again with the different blocks from which you may choose.
|
||||
|
|
@ -51,7 +51,7 @@ That’s the gist of it! If you want more information about the editor, please h
|
|||
|
||||
### Reordering and deleting content in StreamField
|
||||
|
||||
|
||||
|
||||
|
||||
- Click the arrows on the right-hand side of each block to move blocks up and down in the StreamField order of content.
|
||||
- The blocks will be displayed in the front-end in the order that they are placed in this interface.
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# Creating new pages
|
||||
|
||||
|
||||
|
||||
|
||||
Create new pages by clicking the **Add child page** button. This creates a child page of the section you are currently in. In this case a child page of the 'Breads' page.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,9 +1,9 @@
|
|||
# Inserting links to documents into body text
|
||||
|
||||
|
||||
|
||||
|
||||
It is possible to insert links to documents held in the CMS into the body text of a web page by clicking the button above in the rich text field.
|
||||
|
||||
The process for doing this is the same as when inserting an image. You are given the choice of either choosing a document from the CMS, or uploading a new document.
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ There will obviously be many instances in which you will want to add images to a
|
|||
|
||||
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 the bakerydemo site, the former is used.
|
||||
|
||||
|
||||
|
||||
|
||||
- You insert an image by clicking the _Choose an image_ button.
|
||||
|
||||
|
|
@ -25,7 +25,7 @@ When you click the _Choose an image_ button you will be presented with a pop-up
|
|||
|
||||
The image below demonstrates finding and inserting an image that is already present in the CMS image library.
|
||||
|
||||
|
||||
|
||||
|
||||
1. Typing into the search box will automatically display the results below.
|
||||
2. Clicking one of the Popular tags will filter the search results by that tag.
|
||||
|
|
@ -33,7 +33,7 @@ The image below demonstrates finding and inserting an image that is already pres
|
|||
|
||||
**Uploading a new image to the CMS**
|
||||
|
||||
|
||||
|
||||
|
||||
1. You must include an image title for your uploaded image
|
||||
2. Click the _Choose file_ button to choose an image from your computer.
|
||||
|
|
@ -46,7 +46,7 @@ Images can also be inserted into the body text of a page via the rich text edito
|
|||
|
||||
In addition, Wagtail allows you to choose the format of your image.
|
||||
|
||||
|
||||
|
||||
|
||||
1. You can select how the image is displayed by selecting one of the format options.
|
||||
2. You can choose if the image is [decorative](https://www.w3.org/WAI/tutorials/images/decorative/), in which case you will not need to enter alt text for your image.
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ Similar to images, there are a variety of points at which you will want to add l
|
|||
|
||||
Whichever way you insert a link, you will be presented with the form displayed below.
|
||||
|
||||
|
||||
|
||||
|
||||
- Search for an existing page to link to using the search bar at the top of the pop-up.
|
||||
|
||||
|
|
|
|||
|
|
@ -4,11 +4,11 @@
|
|||
|
||||
It is possible to embed media into the body text of a web page by clicking the _Embed_ button in rich text toolbar.
|
||||
|
||||
|
||||
|
||||
|
||||
- Copy and paste the web address for the media into the URL field and click Insert.
|
||||
|
||||
|
||||
|
||||
|
||||
- A placeholder of the media will be inserted into the text area.
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ The Save/Submit for moderation menu is always present at the bottom of the page
|
|||
- **Submit to Moderators approval:** Saves your current changes and submits the page for moderation. The page will then enter a moderation workflow: a set of tasks which, when all are approved, will publish the page (by default, depending on your site {ref}`settings<workflow_settings>`). This button may be missing if the site administrator has {ref}`disabled moderation<wagtail_moderation_enabled>`, or hasn't assigned a workflow to this part of the site. (all roles)
|
||||
- **Publish/Unpublish:** Clicking the _Publish_ button will publish this page. Clicking the _Unpublish_ button will take you to a confirmation screen asking you to confirm that you wish to unpublish this page. If a page is published it will be accessible from its specific URL and will also be displayed in site search results. (moderators and administrators only)
|
||||
|
||||
|
||||
|
||||
|
||||
Other common page actions are available in the **Actions** dropdown, at the top of the screen.
|
||||
|
||||
|
|
@ -14,4 +14,4 @@ Other common page actions are available in the **Actions** dropdown, at the top
|
|||
|
||||
To access Wagtail’s page preview, head over to the Preview side panel. A live-updating preview shows to the right of the page in Mobile mode, and it can be opened in a new tab displaying the page as it would look if published.
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -4,4 +4,4 @@
|
|||
- If you try to save/submit the page with some required fields not filled out, you will see the error displayed here.
|
||||
- The number of validation errors for each of the _Promote_ and _Content_ tabs will appear in a red circle, and the text, 'This field is required', will appear above each field that must be completed.
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,11 +1,11 @@
|
|||
# Selecting a page type
|
||||
|
||||
|
||||
|
||||
|
||||
- On the left of the page chooser screen are listed all the types of pages that you can create. Clicking the page type name will take you to the Create new page screen for that page type (see below).
|
||||
- Clicking the _Pages using … Page_ links on the right will display all the pages that exist on the website of this type. This is to help you judge what type of page you will need to complete your task.
|
||||
|
||||
|
||||
|
||||
|
||||
- Once you've selected a page type you will be presented with a blank New page screen.
|
||||
- Click into the areas below each field's heading to start entering content.
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@ The Promote tab is where you can configure a page's metadata, to help search eng
|
|||
|
||||
- **Show in menus:** Ticking this box will ensure that the page is included in automatically generated menus on your site. Note: A page will only display in menus if all of its parent pages also have _Show in menus_ ticked.
|
||||
|
||||
|
||||
|
||||
|
||||
```{note}
|
||||
You may see more fields than this in your promote tab. These are just the default fields, but you are free to add other fields to this section as necessary.
|
||||
|
|
|
|||
|
|
@ -115,11 +115,11 @@ $ python manage.py runserver
|
|||
|
||||
If everything worked, <http://127.0.0.1:8000> will show you a welcome page:
|
||||
|
||||
|
||||
|
||||
|
||||
You can now access the administrative area at <http://127.0.0.1:8000/admin>
|
||||
|
||||
|
||||
|
||||
|
||||
## Extend the HomePage model
|
||||
|
||||
|
|
@ -181,7 +181,7 @@ Edit `home/templates/home/home_page.html` to contain the following:
|
|||
|
||||
`wagtailcore_tags` must also be loaded at the top of the template and provide additional tags to those provided by Django.
|
||||
|
||||
|
||||
|
||||
|
||||
### Wagtail template tags
|
||||
|
||||
|
|
@ -332,22 +332,22 @@ URL of the blog this post is a part of.
|
|||
Now create a few blog posts as children of `BlogIndexPage`.
|
||||
Be sure to select type "Blog Page" when creating your posts.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Wagtail gives you full control over what kinds of content can be created under
|
||||
various parent content types. By default, any page type can be a child of any
|
||||
other page type.
|
||||
|
||||
|
||||
|
||||
|
||||
Publish each blog post when you are done editing.
|
||||
|
||||
You should now have the very beginnings of a working blog.
|
||||
Access the `/blog` URL and you should see something like this:
|
||||
|
||||
|
||||
|
||||
|
||||
Titles should link to post pages, and a link back to the blog's
|
||||
homepage should appear in the footer of each post page.
|
||||
|
|
@ -547,7 +547,7 @@ Adjust your blog page template to include the images:
|
|||
|
||||
Here we use the `{% image %}` tag (which exists in the `wagtailimages_tags` library, imported at the top of the template) to insert an `<img>` element, with a `fill-320x240` parameter to indicate that the image should be resized and cropped to fill a 320x240 rectangle. You can read more about using images in templates in the [docs](../topics/images).
|
||||
|
||||
|
||||
|
||||
|
||||
Since our gallery images are database objects in their own right, we can now query and re-use them independently of the blog post body. Let's define a `main_image` method, which returns the image from the first gallery item (or `None` if no gallery items exist):
|
||||
|
||||
|
|
@ -662,7 +662,7 @@ to group the date and tags fields together for readability.
|
|||
|
||||
Edit one of your `BlogPage` instances, and you should now be able to tag posts:
|
||||
|
||||
|
||||
|
||||
|
||||
To render tags on a `BlogPage`, add this to `blog_page.html`:
|
||||
|
||||
|
|
@ -751,7 +751,7 @@ a Profile model for authors - we'll leave those as an exercise for the reader.
|
|||
Clicking the tag button at the bottom of a BlogPost should now render a page
|
||||
something like this:
|
||||
|
||||
|
||||
|
||||
|
||||
(tutorial_categories)=
|
||||
|
||||
|
|
@ -848,7 +848,7 @@ Finally, we can update the `blog_page.html` template to display the categories:
|
|||
{% endwith %}
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
## Where next
|
||||
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
The TableBlock module provides an HTML table block type for StreamField. This module uses [handsontable 6.2.2](https://handsontable.com/) to provide users with the ability to create and edit HTML tables in Wagtail. Table blocks provides a caption field for accessibility.
|
||||
|
||||
|
||||
|
||||
|
||||
## Installation
|
||||
|
||||
|
|
|
|||
Ładowanie…
Reference in New Issue