Merge branch 'master' into self-hosted

Author: philwareham

_includes/head.html

@@ -2,14 +2,14 @@
 <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
 <link rel="preload" href="https://textpattern.com/assets/fonts/pt-serif-v12-latin-regular.woff2" as="font" type="font/woff2" crossorigin>
 <link rel="preload" href="https://textpattern.com/assets/fonts/pt-serif-v12-latin-700.woff2" as="font" type="font/woff2" crossorigin>
-<script>document.documentElement.className='js'</script>
-<link rel="stylesheet" href="https://textpattern.com/assets/css/style.css">
+<script src="https://textpattern.com/assets/js/detect.js"></script>
+<link rel="stylesheet" media="screen"href="https://textpattern.com/assets/css/screen.css">
+<link rel="stylesheet" media="print" href="https://textpattern.com/assets/css/print.css">
 <link rel="icon" href="/favicon.ico">
 <link rel="icon" href="/icon.svg" type="image/svg+xml">
 <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>

tags/article.md

@@ -96,7 +96,7 @@ Tag will accept content/behaviour and presentation attributes (**case-sensitive*
 : **Default:** `0`.
 
 `searchall="boolean"`
-: When outputting search results, include only those articles with 'Include in site search' set on the Sections panel. If set to `0`, only articles in the current section are displayed. See @@Fixing search results@@ for more.
+: When outputting search results, include only those articles with 'Include in site search' set on the Sections panel. If set to `0`, only articles in the current section are displayed.
 : **Values:** `0` (no) or `1` (yes).
 : **Default:** `1`.
 

tags/hide.md

@@ -18,10 +18,18 @@ tags:
 ## Syntax
 
 ~~~ html
-<txp:hide />
+<txp:hide>
+~~~
+
+The **hide** tag is a *conditional* tag and always used as an opening and closing pair, like this…
+
+~~~ html
+<txp:hide>
+    …conditional statement…
+</txp:hide>
 ~~~
 
-The **hide** tag is a *container* tag which is used to suppress or postpone the interpretation of all enclosed contents. Use it for comments, temporary concealment of article text parts or non-destructive form changes.
+The **hide** tag is used to suppress or postpone the interpretation of all enclosed contents. Use it for comments, temporary concealment of article text parts or non-destructive form changes.
 
 ## Attributes
 

tags/shortcodes/index.md

@@ -3,7 +3,7 @@ layout: landing
 category: Shortcodes
 published: true
 title: Shortcode examples
-description: A collection of useful shortcodes that are ready to use
+description: A collection of useful shortcodes that are ready to use.
 ---
 
 # Shortcode examples

tags/tag-basics/index.md

@@ -0,0 +1,26 @@
+---
+layout: landing
+category: Tag basics
+published: true
+title: Tag basics
+description: The fundamentals of the Textpattern tag syntax explained. How to structure your tags and how they are parsed by the CMS.
+---
+
+# Learning Textpattern tags
+
+Textpattern tags are an indispensable feature of Textpattern. They provide a markup-like approach to working with Textpattern's core functionality without having to know any PHP. The functions themselves represent content components, their sources, and a means of displaying them.
+
+The tags may be added to Page templates and/or Form templates in a variety of ways depending on what you are trying to do. The tags are replaced with the content output they fetch, as users move from one page to another in your site.
+
+Below are a series of tag fundamentals, which will get you up and running with Textpattern tags. To learn precise details about the tags themselves, see the [Tags Reference](/tags/).
+
+## Tag basics topics
+
+1. [Self-closed versus container tags](/tags/tag-basics/self-closed-versus-container-tags)
+2. [Conditional tags](/tags/tag-basics/conditional-tags)
+3. [Tag nesting](/tags/tag-basics/tag-nesting)
+4. [Parsing tag attributes](/tags/tag-basics/parsing-tag-attributes)
+5. [Parser and passes](/tags/tag-basics/parser-and-passes)
+6. [Incorrect tag contexts](/tags/tag-basics/incorrect-tag-contexts)
+7. [Integrated tag notation](/tags/tag-basics/integrated-tag-notation)
+8. [Core short-tags](/tags/tag-basics/core-short-tags)