A static site generator for GemText and HTML written in Ruby
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Exa Stencil aab558aa29 Bugfix final day of the month 11 months ago
example First pass at generating HTML 11 months ago
.gitignore Example site and first generator 12 months ago
README.gmi First pass at generating HTML 11 months ago
huge.rb Bugfix final day of the month 11 months ago

README.gmi

# 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.