cherniavskii / blitzjs.com

Website & docs

Blitzjs.com - Website & Docs

Installation

yarn

Local Development

yarn dev

This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.

Deployment

The main branch is automatically deployed to https://blitzjs.com

Language Translations

More info at blitzjs.com-translation!

Code Syntax Highlights

Code blocks are syntax highlighted using Prism. You can call attention to specific sections in a code block using comments to begin and end a block // highlight-start // highlight-end, or highlight a single line // highlight-line

const example = "not highlighted"
// highlight-start
const highlighted = true
// highlight-end
const notHighlighted = true
const alsoHighlighted = true // highlight-line

Handles

All H2 and H3 (or all titles that starts with ## or ###) needs a custom handle, the last part of the url:

                                     | This part |
https://blitzjs.com/docs/get-started#install-blitz

You add it in this way:

### Install Blitz {#install-blitz}

There are a few more rules:

• All titles smaller than H3 (or the ones with more than ### at the start) must not have a handle.
• The handles are entirely in lowercase and only the 26 letters of the English alphabet and numbers are allowed.
• Instead of a space, use -.
• There must not be two identical handles in the same document. If you have two identical titles, add a number at the end in order of appearance (not importance)

Example:

### Install Blitz {#install-blitz}

### Install Blitz {#install-blitz-1}

#### Install Blitz

## Install Blitz {#install-blitz-2}

If you aren't totally sure how the slug should look like, or just want to automate the process, run yarn english-slugify

Cards

You can use cards like this:

<Card type="info">
  Unlike Next.js, your `api/` folder should be a sibling of `pages/` instead
  of being nested inside. But `pages/api` is still supported for
  compatibility with Next.js.
</Card>

Properties:

• type: 'caution' | 'info' | 'note'
• title: string (optional)