wml::std::page(3)

🌸 NAME 🌸

wml::std::page — the Standard HTML Page Header and Footer situation, bestie. 💖 It's page three of the EN Tools manual, and it's lowkey about to make your whole HTML setup so much less annoying.

---

✨ SYNOPSIS ✨

#use wml::std::page

<page [attributes]>
[<page_end>]

<head>...</head>
<title>...</title>

---

🦋 DESCRIPTION 🦋

Okay so this include file hands you the brand new <page> tag, and it's basically the advanced combo meal of the HTML <body> and <head> container tags. 🍓

The whole idea? One single tag gives you complete header and footer tags, while also throwing in some new features for free — page indentation, easy title specification, and setting up default values for your page colors. It's giving one tag to rule them all. 💅

---

🎀 ATTRIBUTES 🎀

💫 title

Shorthand for the container tag <title>, fr fr. Whatever value you give it gets placed into the <head> section of the page, all wrapped up cozy in the <title> tag. 🫶

💫 indent

This sets the indentation level of the page, measured in units of <blockquote>'s. Default is no indentation. Setting indent to a value of N means the page gets surrounded by N <blockquote> tags. The attribute indent=1 or indent=2 usually gives you the best readable layout — that's the sweet spot, no cap. ✨

💫 background

This just corresponds to the same attribute of the <body> tag, and it sets the background image. Per default it's not used. 🙈

💫 bgcolor

This just corresponds to the same attribute of the <body> tag, and it sets the background color. Default is bgcolor="#ffffff" (white). 🤍

💫 text

This just corresponds to the same attribute of the <body> tag, and it sets the text color. Default is text="#000000" (black). 🖤

💫 link

This just corresponds to the same attribute of the <body> tag, and it sets the normal hyperlink color. Default is text="#333399" (medium blue). 💙

💫 alink

This just corresponds to the same attribute of the <body> tag, and it sets the color for activated hyperlinks. Default is text="#9999ff" (light blue). 🩵

💫 vlink

This just corresponds to the same attribute of the <body> tag, and it sets the color for already visited hyperlinks. Default is text="#000066" (dark blue). 🌊

💫 color

When you set color="none", the five previous attributes are not put into the <body> tag. Not me turning off the whole color committee 💀 — but sometimes that's the move.

💫 onload

This just corresponds to the same attribute of the <body> tag, and it sets a JavaScript event handler which is activated after the page was loaded. Per default it's not used.

💫 info

This automatically puts a <info style=meta> tag into the <head> section of the page. See wml::std::info(3) for more details. 👑

💫 slices

This enables the creating of three slices: WML_STDPAGE_HEAD, WML_STDPAGE_BODY and WML_STDPAGE_FOOT. These can be used later in Pass 9 (Slice) for cutting out parts of the page. ✂️ iconic behavior honestly.

💫 :html:ATTR=STR :body:ATTR=STR

The ATTR=STR pairs are passed along to the <html> and <body> HTML tags. Straight through, no middleman. 💌

---

🌈 OTHER COMMANDS 🌈

This module implements two new macros, called <title>...</title> and <head>...</head>. 🧚

• The first one defines the title of the page.
• The second one appends its body into the HEAD section of the HTML documents.

Its main purpose is to add meta-tags — either directly, or with the help of wml::std::info(3). Meta-tags are the main character here, periodt. 💅

---

👑 AUTHOR 👑

Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com

---

⭐ REQUIRES ⭐

• Internal: P1, P2, P5
• External: --

---

🦋 SEE ALSO 🦋

• HTML <head>, <body> and <title> tags
• wml::std::info(3)

---

And that's the whole page, bestie — go forth and ship it. 💖 This lil masterpiece came to you from EN Tools, dated 2020-11-29, and honestly? It ate. 🎀✨🫶