FAQ / Using AI

Bliptown does not implement any AI features, but this does not stop you from using AI to help build your site. All formats Bliptown uses are open standards, which allows AI to use existing knowledge to respond accurately without needing access to the server.

LLM Prompt

The easiest way to use AI is to use the LLM prompt below. It contains the essential details of how Bliptown works. Paste it into a prompt and it should provide enough context to help with most tasks and questions.

Expand prompt
# Bliptown

Bliptown is a flat-file CMS using Markdown files with YAML metadata,
custom CSS, and a subset of Mustache templating.

## Markdown File Structure

Page files begin with YAML metadata between two `---`, followed by the
Markdown content and Mustache tags.

    ---
    title: My Page
    layout: one-column center
    date 2026-01-22 Thu
    ---
    # {{ title }}

    *Hello world!*

Each page can have one or more CSS classes as the `layout` value. The
page content is rendered in HTML as:

    <section class="LAYOUT_1 LAYOUT_2">CONTENT</section>

## Mustache

The only Mustache tag types implemented are: variables (without `&`),
partials and sections. Sections reference files by glob expression,
not variables.

Pages can include other pages with double curly braces containing a
greater-than symbol followed by the filename, with or without
extension. Only Markdown files are supported.

    {{ > filename }}

An included page can have a different layout, which is rendered as a
child HTML element of the containing page:

    <section class="LAYOUT_1 LAYOUT_2">
        CONTENT
        <section class="LAYOUT_3 LAYOUT_4">
            CONTENT
        </section>
    </section>

File named with a leading underscore `_` are ignored.

Multiple pages can be included using glob expressions to match
multiple files. These files need to have a `date` metadata value in
order to sort them (the current file, and files with a leading `_` are
ignored):

    {{ > blog/* }}

Mustache loops can reference the metadata of multiple pages using the
same glob expressions:

    {{ # blog/* }}
    - [{{ title }}]({{ url }})
    {{ / }}

An included page inherits all its parent's metadata values (except for
`layout`), and Mustache tags are evaluated after file inclusion,
allowing a file to function as a page template.

The special Mustache tag `prettydate` will render the ISO 8601 `date`
value in the user's preferred date format (in Settings).

The special Mustache tag `url` will render that file's URL.

## HTML

Below is the HTML structure of a page.

    <!DOCTYPE html>
    <html>
        <head>
            ...
            <title>CONTENT OF _title.txt</title>
            <meta name="description" content="CONTENT OF _description.txt">
            <meta name="author" content="CONTENT OF _author.txt">
            <meta name="generator" content="Bliptown">
            <link href="/main.css" NOT USER EDITABLE rel="stylesheet">
            <link href="/style.css" USER EDITABLE rel="stylesheet" sandbox>
            <link href="/favicon.png" USER EDITABLE rel="icon" type="image/png" sizes="128x128" />
            <link href="/favicon.ico" USER EDITABLE rel="icon" type="image/x-icon" sizes="32x32" />
            <style>CSS TO TRIGGER ANALYTICS</style>
            <script src="/main.js" NOT USER EDITABLE defer></script>
        </head>
        <body>
            BELOW IS NOT INTENDED FOR USER STYLING
            ...
            <div id="viewport">
                ...
                BELOW IS INTENDED FOR USER STYLING
                <nav>
                    <header>CONTENT OF _header.md</header>
                    <menu>CONTENT OF _menu.md</menu>
                    <footer>CONTENT OF _footer.md</footer>
                </nav>
                <main>
                    <section class="LAYOUT_1 LAYOUT_2">
                        CONTENT OF CURRENT PAGE
                        <section class="LAYOUT_3 LAYOUT_4">
                            CONTENT OF INCLUDED PAGE
                        </section>
                        CONTENT OF CURRENT PAGE
                    </section>
                </main>
            </div>
            <div id="analytics"></div>
        </body>
    </html>

## CSS

Below is the CSS intended for user customization for global variables,
semantic elements and layout classes:

    /* Global User Styles */

    :root {
        --text-color: rgb(64,64,64);
        --secondary-text-color: rgb(128,128,128);
        --link-color: black;
        --bg-color: white;
        --code-bg-color: rgb(240,240,240);
        --border-color: rgb(140,140,140);
    }

    body {
        font-family: sans-serif;
        font-size: 16px;
        color: var(--text-color);
        background-color: var(--bg-color);
        line-height: 1.5;
        tab-size: 4;
    }

    /* Structural Semantic Styles */

    nav {
        position: sticky;
        top: 0;
        z-index: 80;
        width: 24rem;
        height: 100vh;
        display: flex;
        flex-direction: column;
        overflow-y: scroll;
        background-color: inherit;
        transition: top 0.3s ease;
        scrollbar-width: none;
    }

    nav header, nav menu, nav footer {
        padding: 2rem;
    }

    nav header {
        height: 5rem;
    }

    nav footer {
        margin-top: auto;
    }

    main {
        width: 100%;
        padding: 2rem;
        padding-right: 4rem;
        background-color: inherit;
        scrollbar-width: none;
        overflow: auto;
    }

    /* Generic Semantic Styles */

    p {
        margin-bottom: 1em;
    }

    a {
        color: var(--link-color);
        text-decoration: none;
    }

    pre, code {
        font-size: 0.9rem;
        white-space: pre;
        background-color: var(--code-bg-color);
    }

    pre {
        margin-bottom: 1em;
        padding: 1em;
        overflow-x: auto;
    }

    img {
        display: block;
        max-width: 100%;
    }

    label {
        cursor: pointer;
    }

    ul, ol {
        margin-bottom: 1em;
    }

    ul ul {
        margin: 0;
        padding-left: 1em;
    }

    blockquote {
        margin: 1em 0;
        padding: 0 2em;
        border-left: 1px solid var(--border-color);
    }

    details summary:hover {
        cursor: pointer;
    }

    hr {
        margin: 1em 0;
        border: none;
        border-top: 1px solid currentcolor;
    }

    table {
        text-align: left;
        margin-bottom: 1em;
    }

    table td {
        padding: 2px;
    }

    table tbody tr:hover {
        background-color: var(--row-hover-color);
    }

    iframe {
        max-width: 100%;
    }

    h1 {
        font-size: 1em;
        margin-bottom: 1em;
    }

    h2 {
        font-size: 1em;
        margin: 3em 0 1em;
    }

    h3 {
        font-size: 1em;
        font-weight: initial;
        margin-bottom: 1em;
        color: var(--secondary-text-color);
    }

    nav ul {
        margin: 0;
        list-style: none;
    }

    nav details ul {
        padding-left: 1em;
    }

    nav details summary::before {
        content: none;
    }

    main a {
        border-bottom: 1px solid var(--link-color);
    }

    main a:has(img) {
        border: none;
    }

    main ul {
        list-style: circle;
    }

    main ul, main ol {
        padding-left: 2em;
    }

    /* Layouts */

    section {
        background-color: inherit;
        margin-bottom: 1em;
    }

    main:has(.cover) {
        padding: 0;
    }

    .pad {
        padding: 2em;
    }

    .left {
        margin-right: auto;
    }

    .right {
        margin-left: auto;
    }

    .center {
        margin: auto;
    }

    .one-column {
        max-width: 46em;
    }

    .two-columns {
        column-count: 2;
        column-gap: 1em;
    }

    .wide {
        max-width: 100%;
    }

    .wide-table table {
        width: 100%;
    }

    .gallery-grid {
        display: grid;
        grid-template-columns: repeat(auto-fill, minmax(18em, max-content));
        gap: 1em;
    }

    .gallery-grid > p {
        margin: 0;
    }

    .gallery-horizontal {
        display: flex;
        align-items: center;
        overflow-x: scroll;
        gap: 1em;
    }

    .gallery-horizontal > p {
        flex-grow: 0;
        flex-shrink: 0;
        max-width: 90%;
        margin: 0;
    }

    .gallery-2-columns,
    .gallery-two-columns {
        display: grid;
        grid-template-columns: repeat(2, 1fr);
        gap: 1em;
    }

    .gallery-columns,
    .gallery-3-columns,
    .gallery-three-columns {
        display: grid;
        grid-template-columns: repeat(3, 1fr);
        gap: 1em;
    }

    .gallery-4-columns,
    .gallery-four-columns {
        display: grid;
        grid-template-columns: repeat(4, 1fr);
        gap: 1em;
    }

    .gallery-columns > p,
    .gallery-2-columns > p,
    .gallery-3-columns > p,
    .gallery-4-columns > p,
    .gallery-two-columns > p,
    .gallery-three-columns > p,
    .gallery-four-columns > p {
        margin: 0;
    }

    .ratio-3x2 img,
    .ratio-2x3 img,
    .ratio-8x10 img,
    .ratio-10x8 img,
    .ratio-16x9 img,
    .ratio-cinema img,
    .ratio-1x1 img {
        width: 100%;
        object-fit: cover;
    }

    .ratio-3x2 img { aspect-ratio: 3 / 2; }
    .ratio-2x3 img { aspect-ratio: 2 / 3; }
    .ratio-8x10 img { aspect-ratio: 8 / 10; }
    .ratio-10x8 img { aspect-ratio: 10 / 8; }
    .ratio-16x9 img { aspect-ratio: 16 / 9; }
    .ratio-cinema img { aspect-ratio: 2.35 / 1; }
    .ratio-1x1 img { aspect-ratio: 1 / 1; }

    .parallax {
        perspective: 1px;
        overflow-y: auto;
        height: calc(100vh - 4rem);
        background-color: inherit;
    }

    .parallax.cover {
        height: 100vh;
    }

    .parallax-bg {
        transform: translateZ(-1px) scale(2);
        position: absolute;
        inset: 0;
    }

    .parallax-fg {
        transform: translateZ(0);
        background-color: inherit;
    }


Cloning the Bliptown Project

The underlying code is open source. If you’re not getting good enough results from the LLM prompt, or you want to dig a bit deeper, you can clone the git repository:

git clone https://codeberg.org/bliptown/bliptown.git

From there you can use an AI agent on your local machine to explore every aspect of the Bliptown project.

← Previous | Source | Next →