GitHub - AlexanderRichey/yagss: 🐐 Yet another generator of static sites

git clone git@github.com:AlexanderRichey/yagss.git
cd yagss
make install
yagss version

Usage:
  yagss [command]

Available Commands:
  build       Build the current yagss site
  help        Help about any command
  new         Create a new yagss site
  serve       Serve the current yagss site and auto build when files change
  version     Print yagss version

Flags:
  -h, --help   help for yagss

Use "yagss [command] --help" for more information about a command.

$ yagss new demo
Creaing new yagss project in "demo"
==> Creating "demo" directory
==> Creating "demo/config.toml"
==> Creating "demo/posts" directory
...
==> Creating "demo/build" directory
Done in 1.694679ms
$ cd demo
$ yagss serve
----> Initial build
[builder] Starting build...
[builder] ==> Processing "public/favicon.ico"
[builder] ==> Processing "public/styles.css"
[builder] ==> Processing "posts/first-post.md"
[builder] ==> Processing "posts/forth-post.md"
[builder] ==> Processing "posts/second-post.md"
[builder] ==> Processing "posts/third-post.md"
[builder] ==> Processing "pages/about.md"
[builder] ==> Processing "pages/index.html"
[builder] ==> Processing "rss.xml"
[builder] Processed 9 files in 7.760285ms
----> Starting server and watcher
[watcher] Watching "pages" directory
[watcher] Watching "posts" directory
[watcher] Watching "public" directory
[watcher] Watching "includes" directory
[server] Listening on port :3000
# Now browse to http://localhost:3000

$ tree
.
├── build
├── config.toml
│   # config.toml allows for controlling various build settings.
├── pages
│   # The pages directory contains pages that can be in markdown or
│   # html format. Pages can also use template directives and they
│   # are compiled to the site's output directory.
│   ├── about.md
│   └── index.html
├── posts
│   # The posts directory contains markdown blog posts. Its usage is  
│   # optional.
│   ├── first-post.md
│   ├── forth-post.md
│   ├── second-post.md
│   └── third-post.md
├── public
│   # Files and sub-directories in this directory are moved to the root of  
│   # the output directory. Files that end with .html, .css, .js, .jsx,
│   # .svg, .xml, or .json are automatically minified. If a file ends in a
│   # extension specified in the build.hash array, then a hash will
│   # be included in the outputted file's name.
│   ├── favicon.ico
│   └── styles.css
└── includes
    # The includes directory contains templates and partials. Unlike
    # pages, they are not compiled on their own. In other words,
    # if a "includes/index.html" file exists, but no file in "pages"
    # refers to it, then it will not be included in the site's
    # output. In contrast, "pages/index.html" will be included.
    ├── base.html
    ├── page.html
    ├── pagination.html
    └── post.html

5 directories, 13 files

$ yagss build
Starting build...
==> Processing "public/favicon.ico"
==> Processing "public/styles.css"
==> Processing "posts/first-post.md"
==> Processing "posts/forth-post.md"
==> Processing "posts/second-post.md"
==> Processing "posts/third-post.md"
==> Processing "pages/about.md"
==> Processing "pages/index.html"
==> Processing "rss.xml"
Processed 9 files in 15.806605ms

$ tree build
build/
├── about.html
├── favicon.ico
├── index.html
├── page2
│   └── index.html
├── posts
│   ├── first-post.html
│   ├── forth-post.html
│   ├── second-post.html
│   └── third-post.html
├── rss.xml
└── styles.df1b98dd.css

$ cat includes/base.html | grep assets
    <link rel="icon" href="{{ assets|key:'favicon.ico' }}" />
    <link rel="stylesheet" href="{{ assets|key:'styles.css' }}" />

---
title: About
description: Optional description
template: "my-special-template.html" # Optional template override.
---
I am me--or am I?

{% extends 'base.html' %}
{% block content %}
  <img src="{{ assets|key:'images/me.jpg' }}" alt="special image in this template">
  <h2>{{ title }}</h2>
  {{ content|safe }}
{% endblock %}

---
title: First post!
date: 2021-01-01
description: Optional description
---
![fireworks]({{ assets|key:'fireworks.jpg' }})

Hello world.

{% extends 'base.html' %}
{% block content %}
  <h2>{{ title }}</h2>
  <time datetime="{{ date }}">{{ date|date:"2 Jan 2006" }}</time>
  {{ content|safe }}
{% endblock %}

{% extends 'base.html' %}
{% block content %}
  <!-- Iterate through all posts -->
  {% for post in posts %}
    <article>
      <h2>
        <a href="{{ post.Path }}">{{ post.Title }}</a>
      </h2>
      <time datetime="{{ post.Date }}">{{ post.Date|date:"2 Jan 2006" }}</time>
    </article>
  {% endfor %}

  <!-- Add links to next and prev pages, if there are any -->
  {% if prev %}
    <span>
      <a href="{{ prev }}">Newer</a>
    </span>
  {% endif %}

  {% if next %}
    <span>
      <a href="{{ next }}">Older</a>
    </span>
  {% endif %}
{% endblock %}