Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/greghendershott/frog

Frog is a static blog generator implemented in Racket, targeting Bootstrap and able to use Pygments.
https://github.com/greghendershott/frog

blog-engine racket static-blog

Last synced: about 1 month ago
JSON representation

Frog is a static blog generator implemented in Racket, targeting Bootstrap and able to use Pygments.

Awesome Lists containing this project

README

        

# Frog

Happy Green frog

Frog image by @Goug8888, used under Creative Commons license Attribution-NonCommercial-ShareAlike 2.0 Generic.

[![CI](https://github.com/greghendershott/frog/workflows/CI/badge.svg)](https://github.com/greghendershott/frog/actions)
[![raco pkg install frog](https://img.shields.io/badge/raco_pkg_install-frog-aa00ff.svg)](http://pkgs.racket-lang.org/package/frog)
[![MIT License](https://img.shields.io/badge/license-MIT-118811.svg)](frog/LICENSE)
[![Documentation](https://img.shields.io/badge/Docs-Documentation-blue.svg)](http://docs.racket-lang.org/frog/index.html)

Frog is a static web site generator written in [Racket][].

You write content in [Markdown][] or [Scribble][]. You generate
files. To deploy, you push them to a GitHub Pages repo (or copy them
to Amazon S3, or whatever).

Posts get a variety of automatic blog features.

You can also create non-post pages.

[Pygments][] handles syntax highlighting for code blocks.

The generated site uses [Bootstrap][], which is [responsive][],
automatically adapting to various screen sizes.

[Full documentation](http://docs.racket-lang.org/frog/index.html).

[Racket]: http://www.racket-lang.org
[Markdown]: http://daringfireball.net/projects/markdown/syntax
[Scribble]: http://docs.racket-lang.org/scribble/index.html
[Pygments]: http://pygments.org/
[Bootstrap]: http://getbootstrap.com/
[responsive]: https://en.wikipedia.org/wiki/Responsive_web_design

# What to expect in the future

TL;DR: This project is in low-maintenance mode.

I have enjoyed working on Frog for many years. In the beginning, it
was intended to be a "just-works", "any color you want, so long as
it's black" simple application.

I envisioned it as an _application_ that happened to be written in
Racket -- which some people might use even if they weren't Racket
programmers. That didn't happen. At the same time, it evolved to be
more configurable. And finally to use a `#lang` for configuration. At
which point it felt more like what is really was: A tool for Racket
programmers to do a static blog.

Eventually I felt even that was too complicated, and [my own blog
should simply be a Makefile driving a few pieces of code inherited
from Frog][explode]. In other words, I no longer use Frog for my own
blog.

As a result, although you're welcome to open issues about new features
or off-label uses, please don't expect much. I expect I will still try
to fix bugs, at least as/when I have time and I believe a fix would
not result in more and/or worse bugs.

As I write this in July 2019, I think the situation has already been
clear from the repo activity for a long time. Even so, I want to be
super up-front about where the project is headed, or not. That way
people can make an informed choice how to spend their limited time and
energy.

Finally a big thank you to people who contributed things over the
years.

[explode]: https://www.greghendershott.com/2019/04/exploding-frog.html