瀏覽代碼

Introduce tags and filters as they are in user-guide docs (#12647)

Clifford Gama 3 月之前
父節點
當前提交
a1de5bdbd7
共有 3 個文件被更改,包括 5 次插入3 次删除
  1. 1 0
      CHANGELOG.txt
  2. 1 0
      docs/releases/6.4.md
  3. 3 3
      docs/topics/writing_templates.md

+ 1 - 0
CHANGELOG.txt

@@ -48,6 +48,7 @@ Changelog
  * Docs: Fix link to `HTTPMethod` in `Page.handle_options_request()` docs (Sage Abdullah)
  * Docs: Improve the Pages Theory page with added & more consistent section headings and admonitions to aid in readability (Clifford Gama)
  * Docs: Fix non-functional link to the community guidelines in the Your first contribution page (Ankit Kumar)
+ * Docs: Introduce tags and filters by name in "Writing templates" docs (Clifford Gama)
  * Maintenance: Close open files when reading within utils/setup.py (Ataf Fazledin Ahamed)
  * Maintenance: Avoid redundant `ALLOWED_HOSTS` check in `Site.find_for_request` (Jake Howard)
  * Maintenance: Update `CloneController` to ensure that `added`/`cleared` events are not dispatched as cancelable (LB (Ben) Johnston)

+ 1 - 0
docs/releases/6.4.md

@@ -64,6 +64,7 @@ depth: 1
  * Fix link to `HTTPMethod` in `Page.handle_options_request()` docs (Sage Abdullah)
  * Improve [](pages_theory) with added & more consistent section headings and admonitions to aid in readability (Clifford Gama)
  * Fix non-functional link to the community guidelines in the [Your first contribution](../contributing/first_contribution_guide.md) page (Ankit Kumar)
+ * Introduce tags and filters by name in "Writing templates" docs (Clifford Gama)
 
 ### Maintenance
 

+ 3 - 3
docs/topics/writing_templates.md

@@ -138,7 +138,7 @@ See [](responsive_images) for full documentation.
 
 ## Rich text (filter)
 
-This filter takes a chunk of HTML content and renders it as safe HTML on the page. Importantly, it also expands internal shorthand references to embedded images and links made in the Wagtail editor, into fully-baked HTML ready for display.
+The `richtext` filter takes a chunk of HTML content and renders it as safe HTML on the page. Importantly, it also expands internal shorthand references to embedded images and links made in the Wagtail editor, into fully-baked HTML ready for display.
 
 Only fields using `RichTextField` need this applied in the template.
 
@@ -241,7 +241,7 @@ Like `pageurl`, this will try to provide a relative link if possible but will de
 
 ## Static files (tag)
 
-Used to load anything from your static files directory. Use of this tag avoids rewriting all static paths if hosting arrangements change, such as when moving from development to a live environment.
+The `static` tag is used to load anything from your static files directory. Use of this tag avoids rewriting all static paths if hosting arrangements change, such as when moving from development to a live environment.
 
 ```html+django
 {% load static %}
@@ -269,7 +269,7 @@ Returns the Site object corresponding to the current request.
 
 ## Wagtail user bar
 
-This tag provides a contextual flyout menu for logged-in users. The menu gives editors the ability to edit the current page or add a child page, besides the options to show the page in the Wagtail page explorer or jump to the Wagtail admin dashboard. Moderators are also given the ability to accept or reject a page being previewed as part of content moderation.
+The `wagtailuserbar` tag provides a contextual flyout menu for logged-in users. The menu gives editors the ability to edit the current page or add a child page, besides the options to show the page in the Wagtail page explorer or jump to the Wagtail admin dashboard. Moderators are also given the ability to accept or reject a page being previewed as part of content moderation.
 
 This tag may be used on standard Django views, without page object. The user bar will contain one item pointing to the admin.