Astro Doc
Astro Doc lets you create document layouts with minimal markup in Astro.
You write this:
---
import Document from '@astropub/doc'
---
<Document title="Astro Doc" body-class="p-body">
<h1>
Astro Doc
</h1>
<p>
The HTML, HEAD, and BODY tags are all set.
</p>
</Document>You get this:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>Astro Doc</title>
<meta name="viewport" content="width=device-width" />
<meta name="disabled-adaptations" content="watch" />
<meta property="og:title" content="Astro Doc" />
</head>
<body class="p-body">
<h1>
Astro Doc
</h1>
<p>
The HTML, HEAD, and BODY tags are all set.
</p>
</body>
</html>Usage
Install Astro Doc to your project.
npm install @astropub/docUse Astro Doc components in your project.
---
import Document from '@astropub/doc'
---
<Document>
<p>
The HTML, HEAD, and BODY tags are all set.
</p>
</Document>You get this:
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width" />
<meta name="disabled-adaptations" content="watch" />
</head>
<body>
<p>
The HTML, HEAD, and BODY tags are all set.
</p>
</body>
</html>Features
Embedded Attributes
title
Defines the title of the document, without any additional taglines.
<meta property="og:title" content={title} />description
Defines the summary of the content of the current document.
<meta name="description" content={description} />sitetitle
Defines the title of the site, without any additional taglines.
<meta property="og:site_name" content={sitetitle} />tabtitle
Defines the title of the document used by the tab, which may include additional taglines.
<title>{title}</title>type
Defines the category or type of the current document. By default, this is webpage.
<meta property="og:type" content={type} />url
Defines the canonical URL of the current document. By default, this is the value of Astro.url. If the URL does not include a protocol or domain, it will be resolved against Astro.site.
<meta property="og:url" content={resolvedURL(url)} />imageurl
Defines the URL of the image representing the current document. If the URL does not include a protocol or domain, it will be resolved against Astro.site.
<meta property="og:image" content={resolvedURL(imageurl)} />imagealt
Defines the description for the image representing the current document.
<meta property="og:image:alt" content={imagealt} />twittercard
Defines the summary card used by Twitter. By default, this is summary_large_image if imageurl is defined.
<meta name="twitter:card" content={twittercard} />Note: This is the only embedded attribute not shared across social networks.
robots
How search engines should follow the current document.
<meta name="robots" content={robots} />Application Attributes
viewport
Defines the area through which the document is viewed.
<meta name="viewport" content={viewport} />disabledadaptations
Defines whether the website is compatible without adaptations smaller viewports.
<meta name="disabled-adaptations" content={disabledadaptations} />icon
Defines the image used by the website to represent the current document in some browser tabs, browser history views, toolbar apps, bookmarks dropdowns, search bars, and search bar recommendations. The type will be automatically detected.
<link rel="icon" href={icon} type={resolvedIconType(icon)} />touchicon
Defines the image used by common handheld devices, such as Apple or Android phones. Presently, the size is hard-coded to 180x180.
<link rel="apple-touch-icon" sizes="180x180" href={touchicon} />charset
Defines the character encoding for the document. By default, this is utf-8.
<meta charset={charset} />Head Slot
Additional elements may be placed in the <head> tag thru use of the head slot.
---
import Document from '@astropub/doc'
---
<Document title="Astro Doc" body-class="p-body">
<meta slot="head" name="twitter:creator" content="@jon_neal" />
<link slot="head" rel="alternate" type="application/rss+xml" title="Blog" href="/blog.xml" />
<h1>
Astro Doc
</h1>
<p>
The HTML, HEAD, and BODY tags are all set.
</p>
</Document>