Each of your blog posts are represented by a markdown file (file with the .md extension). Your blog posts can have the following frontmatter associated with them:

---
title: Your Title Here
date: Date
description: Your description here.
published: false # Change to true to include this blog-post.
---

To create a new blog post, run the following command.

dbs --new-post -t "Your Title" -d "Your description."

💡 You can pass your title and description as well, but they are not required.

The rest of the contents of the blog-post file are written in Markdown.

import { newPost } from "https://deno.land/x/dbs/mod.ts";
const title = "Your Title",
  description = "Your description.";
await newPost(title, description);

To generate the files for your static blog, run the following command:

dbs --build -s "chosen_stylesheet"

You can pass the name of your chosen stylesheet. You may choose between air, modest, retro, or splendor. The modest stylesheet is chosen by default. Or you may create a custom stylesheet.

import { build } from "https://deno.land/x/dbs/mod.ts";
const stylesheetTitle = "modest"; // Replace `modest` with your chosen stylesheet's title.
await build(stylesheetTitle);

To preview your blog on your machine, run the following command:

dbs --serve

💡 Visit http://localhost:8000/ to preview your blog.

💡 To see your latest changes, remember to re-generate the site.

import { serve } from "https://deno.land/x/dbs/mod.ts";
await serve();

This operation currently only works when you are using this project as a template.

To add a custom stylesheet, run the following command:

dbs --new-style -t "YOUR_STYLE_TITLE"

💡 You may pass the title of your custom stylesheet as well.

💡 To integrate your custom stylesheet, update the styles/YOUR_STYLE_TITLE.ts file.

import { newStyle } from "https://deno.land/x/dbs/mod.ts";
const title = "new_stylesheet_title";
await newStyle(undefined, title);