Merge branch 'master' into self-hosted

Author: philwareham

_includes/head.html

@@ -9,6 +9,7 @@
 <link rel="apple-touch-icon" href="/apple-touch-icon.png">
 <link rel="manifest" href="/site.webmanifest">
 <meta name="color-scheme" content="dark light">
+<meta name="theme-color" content="#ffda44">
 <meta name="author" content="{{ site.author }}">
 <meta name="application-name" content="Textpattern CMS Documentation">
 <script defer src="https://textpattern.com/assets/js/app.js"></script>

site.webmanifest

@@ -2,11 +2,12 @@
   "short_name": "Textpattern Docs",
   "name": "Textpattern CMS Documentation",
   "start_url": "https://docs.textpattern.com",
+  "scope": "https://docs.textpattern.com",
   "icons": [
-    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
-    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
+    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "maskable any" },
+    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable any" }
   ],
   "background_color": "#ffffff",
   "theme_color": "#ffda44",
-  "display": "browser"
+  "display": "minimal-ui"
 }

tags/header.md

@@ -32,16 +32,16 @@ Tag will accept the following attributes (**case-sensitive**) as well as the {%
 
 `name="string"`
 : Header name/type.
-: **Default:** `Content-Type`.
+: **Default:** unset.
 
 `replace="boolean"`
-: Whether the existing HTTP header must be replaced entirely, or added to.
-: **Values:** `0` (no) or `1` (yes).
+: Whether the existing HTTP header must be preserved, replaced entirely, or added to.
+: **Values:** `0` (preserve) or `1` (replace) or other (add).
 : **Default:** `1`.
 
 `value="string"`
 : Header value.
-: **Default:** `text/html; charset=utf-8`.
+: **Default:** unset.
 
 ## Examples
 
@@ -58,7 +58,7 @@ If you don't want an article to be cached by the browser, then the corresponding
 If you need to output the articles from a section as a JSON document, the corresponding page template could be:
 
 ~~~ html
-<txp:header value="application/json; charset=utf-8" />
+<txp:header name="Content-Type" value="application/json; charset=utf-8" />
 [<txp:article break=",">
 {
   "title": "<txp:title escape="json" />",
@@ -73,6 +73,10 @@ Other tags used: [article](/tags/article), [title](/tags/title).
 
 ## Genealogy
 
+### Version 4.8.5
+
+Default attribute values modified.
+
 ### Version 4.7.0
 
 Tag support added.

tags/index.md

@@ -220,7 +220,6 @@ Each Textpattern tag is described in detail on its respective reference page. Se
 * [image_list](/tags/image_list) <span class="footnote error">**Deprecated**</span>
 * [image_url](/tags/image_url)
 * [images](/tags/images)
-* [item](/tags/item) <span class="footnote warning">**New v4.8.0**</span>
 {: .list--no-bullets}
 
 </div>

tags/item.md

@@ -36,13 +36,9 @@ Tag will accept the following attributes (**case-sensitive**) as well as the {%
 : **Default:** unset (no button is created).
 
 `form="form name"`
-: Use specified form template to build a customized HTML form.
+: Use the specified form template to build a customized HTML form.
 : **Default:** `search_input` (if no form template is specified and no other attributes are used), otherwise unset (uses a built-in HTML `<form>`).
 
-`html_id="id"` <span class="footnote warning">v4.0.7+</span>
-: The HTML `id` attribute assigned to the search form.
-: **Default:** unset.
-
 `match="match type"` <span class="footnote warning">v4.3.0+</span>
 : Set the search mode. Choose from: \\
 `exact`: search terms must exactly match the words in the article in the order given. This mode is also automatically selected if the search term is surrounded with double quotes. \\
@@ -51,7 +47,7 @@ Tag will accept the following attributes (**case-sensitive**) as well as the {%
 : Default `exact`.
 
 `placeholder="text"` <span class="footnote warning">v4.7.2+</span>
-: HTML `placeholder` attribute to be applied to search `input` field.
+: HTML `placeholder` attribute to be applied to the search `input` field.
 : **Default:** unset.
 
 `section="section name"`
@@ -62,22 +58,6 @@ Tag will accept the following attributes (**case-sensitive**) as well as the {%
 : Sets the `size` attribute of the search `input` field.
 : **Default:** `15`.
 
-### Common presentational attributes
-
-These attributes, which affect presentation, are shared by many tags. Note that default values can vary among tags.
-
-`class="class name"`
-: HTML `class` to apply to the `wraptag` attribute value.
-: **Default:** tag name or unset (see [class cross-reference](/tags/tag-attributes-cross-reference#class)).
-
-`label="text"`
-: Label prepended to item.
-: **Default:** unset (but see [label cross-reference](/tags/tag-attributes-cross-reference#label) for exceptions).
-
-`wraptag="element"`
-: HTML element to wrap markup, specified without brackets (e.g. `wraptag="div"`).
-: **Default:** unset (but see [wraptag cross-reference](/tags/tag-attributes-cross-reference#wraptag) for exceptions).
-
 ## Examples
 
 ### Example 1: Display a search input form
@@ -88,13 +68,13 @@ These attributes, which affect presentation, are shared by many tags. Note that
 
 ### Example 2: Elements required for building a customized HTML search form
 
-You can build your own custom search form by specifying `form="form-name"` inside the `<txp:search_input />` tag:
+Build your own custom search form by specifying `form="your-form-name"` inside the `<txp:search_input />` tag:
 
 ~~~ html
-<txp:search_input form="form-name" />
+<txp:search_input form="search_box" />
 ~~~
 
-You would then need to build your Form (i.e. `form-name`), and the absolute minimum Textpattern tags and attributes required would be:
+You would then need to build your Form called `search_box`. It could contain any fields and markup you wish to suit your site. The absolute minimum Textpattern tags and attributes required would be:
 
 ~~~ html
 <form action="<txp:site_url />">
@@ -106,10 +86,10 @@ When using a customized form template, Textpattern doesn't automatically wrap th
 
 Other tags used: [site_url](/tags/site_url).
 
-Note: Textpattern will use a user defined form named `search_results`, or an internally defined default form if no search result form is defined by you.
+Note: When displaying search results, Textpattern will use a user defined form named `search_results`, or an internally defined default form if no search result form is nominated/defined.
 {: .alert-block .information}
 
-### Example 3: Minimal search input form without label or button (but still accessible)
+### Example 3: Minimal search input form without label or button (yet still accessible)
 
 ~~~ html
 <txp:search_input aria_label="Search" placeholder="Search…" />