# HuGe

A static site generator for GemText and HTML written in Ruby

## Introduction

This project has a few goals:

* Manage content in a lowest common denominator format (text/gemini)
* Generate markup idempotently for different formats
* Reduce the tedium of posting content with helpers

## Usage

Since this is for me to use I'm just going to set things up the way I intend to use it. That is, content is generated into:

* ~/public_gemini for text/gemini (*.gmi) files
* ~/public_html for text/html (*.html) files

I put all my pages in the current directory and all posts in ./posts. I add some YAML front matter to the posts that can be used when generating ATOM feeds, and to decorate generated pages.

If you have some content to prepend or append on every page in a folder, put it in `header.gmi` or `footer.gmi` in that folder. Using `.erb` on these will pass the relevant frontmatter data to the templates.

See the `example` folder for a sample project, and run `huge` from inside that folder to generate the site in `public_gemini`. It looks like this:

```
example
├── atom.xml.erb
├── index.gmi.erb
└── posts
    ├── footer.gmi.erb
    ├── header.gmi.erb
    └── hello-world.gmi

1 directory, 5 files
```

## Plans

This is a sort of test for generating reasonable content from gemtext. If the results are promising I want to start work on a framework of sorts to build applications with a similar premise.

## Suggestions or Contributions

Drop me a mail at exastencil@rawtext.club or send me a PR or patchset.