Blog Fable

blog-fable

krymtkts — Sun, 01 Oct 2023 09:00:00 +0900

This page generated with krymtkts/blog-fable.

blog-fable is a small Fable app project to generate static pages.

Samples

Default color scheme

krymtkts — Sat, 01 Apr 2023 09:00:00 +0900

Supports Solarized Light/Dark in default.

Solarized Light
Solarized Dark

Sample post - subtitle

krymtkts — Thu, 02 Mar 2023 09:00:00 +0900

Posts have front matter. Front matter written in YAML.

The front matter for this post is as follows.

---
title: Sample post
tags: [sample, yaml, t, tag, this-is-extreme-long-tag-name]
date: 2023-03-02
---

title is post title. render as h1
tags is list of tag. Tags page generation based on the content of the tags
date is update date. optional field. it overrides publication date.
- Define publication date of a post in the title of the Markdown file
  - ex) blog-fable/contents/posts/2023-02-01-this-is-sample-post.md

Use eemeli/yaml: YAML parser and stringifier for JavaScript for front matter parsing.

You can define a post without front matter if you want.

See sample-post-without-front-matter.md

About Markdown parser code sample

krymtkts — Wed, 01 Feb 2023 09:00:00 +0900

You can write posts or pages in Markdown. Markdown is parse by Marked.

The sample rendering is following.

plain

italic

bold

code

~~strikethrough~~

plain italic bold code ~~strikethrough~~

extreme long inline code ......................................................................

Recommends to start Markdown headings from h2 because it render the blog title as h1.

footnote like this¹ ²

blockquote

blockquote

blockquote blockquote

codeblock

module App

open StaticWebGenerator

render
    { stage = dev
      lang = "ja"
      siteName = "Blog Fable"
      description = "A small Fable app project to generate static pages"
      siteUrl = "https://krymtkts.github.io"
      pathRoot = "/blog-fable"
      copyright = "2023 krymtkts"
      favicon = "/img/favicon.ico"
      highlightStyle = "node_modules/highlight.js/styles/base16/solarized-dark.min.css"

      src = "contents"
      dst = "docs"

      posts = { root = "/posts"; title = "Posts" }
      pages = { root = "/pages"; title = "Pages" }
      tags = { root = "/tags"; title = "Tags" }
      archives =
        { root = "/archives"
          title = "Archives" }
      images = "/img"

      feedName = "feed"

      additionalNavs =
          [ { text = "About"
              path = "/pages/about.html" } ]

      timeZone = "Asia/Tokyo"

      sitemap =
          { index = 1.0
            archives = 0.8
            tags = 0.8
            posts = 0.9
            pages = 0.8 } }

list

bullet list item a
- level 2 task item 1
- level 2 task item 2
  - level 3
    - level 4

ordered list
1. level 2 task item
  1. level 3
  - level 4
2. level 2 item b
- level 3

composition
1. ordered item 1
  - ~~strikethrough~~
- unordered item 1 has extreme long label text ......................................
- unordered item 2 has extreme long label text ......................................
  - inline code
  1. italic
    - bold
      - italic bold
- blockquote
  
  multiline
- ```
module App

open StaticWebGenerator
```

table

col1	col2	col3	col4
1	2	3	4
one	two	three	four

link

krymtkts/blog-fable

footnote line requires blank line before. ↩
footnote with link ↩

2023-01-01-sample-post-without-front-matter.html

krymtkts — Sun, 01 Jan 2023 09:00:00 +0900

Sample post without front matter `code sample`

The post can omit front matter title, date and tags.

Recommend specifying the title in front matter.

If a post does not have a title, the generated link will look like this.

2023-01-01-sample-post-without-front-matter.md

Flatten posts in nested directory

krymtkts — Sat, 31 Dec 2022 09:00:00 +0900

Flatten posts in nested directory into posts directory. Intend the nested directories used for organizing source Markdown files.

source files.

\---contents
    \---posts
        \---2022
            \---12
                \---2022-12-31-nested-post.md

destination files.

\---docs
    \${path_root}
        \---posts
            \---2022-12-31-nested-post.md