# record_generators

id: curvenote
git_filename: src/site/generators/curvenote.md
format: md
field_title: Curvenote
field_repo: curvenote/curvenote
field_homepage: http://curvenote.com/docs/web
field_language: Javascript
field_license: MIT
field_templates: React
field_description: A website generator for scientific and technical articles
data:
{"title": "Curvenote", "repo": "curvenote/curvenote", "homepage": "http://curvenote.com/docs/web", "language": ["Javascript"], "license": ["MIT"], "templates": ["React"], "description": "A website generator for scientific and technical articles", "body": "Curvenote allows you to easily publish scientific content on the web as a\nfast, optimized website using Markdown (MyST) and Jupyter Notebooks.\n\n### Features\n\n- Write content in Markdown extended with [MyST directives](https://myst-parser.readthedocs.io/)\n- Create pages using Jupyter Notebooks\n- Latex based inline math and equations\n- Figures from images or Jupyter Notebook outputs, with captions and numbering\n- Include interactive plots using Altair, Ploty or Bokeh\n- Citations and References lists\n- numbering and cross referencing for equations, tables and figures\n- Optionally work in an [online visual editor](https://curvenote.com) and update local content from the command line\n- [Start from a GitHub repo](https://try.curvenote.com/)\n\n### Examples\n\n- [Technical Blogging](https://www.stevejpurves.com/blog)\n- [Climasoma Synthesis Report](https://climasoma.curve.space/)\n- [Transform 22 Conference](https://transform.softwareunderground.org/overview)\n- [SIMPEG Research Seminars](https://seminars.simpeg.xyz/)\n- [A PhD Thesis](https://phd.row1.ca/phd)\n- [La Palma Eruption Preprint](https://www.stevejpurves.com/la-palma-earthquakes)"}

field_body:
Curvenote allows you to easily publish scientific content on the web as a
fast, optimized website using Markdown (MyST) and Jupyter Notebooks.

### Features

- Write content in Markdown extended with [MyST directives](https://myst-parser.readthedocs.io/)
- Create pages using Jupyter Notebooks
- Latex based inline math and equations
- Figures from images or Jupyter Notebook outputs, with captions and numbering
- Include interactive plots using Altair, Ploty or Bokeh
- Citations and References lists
- numbering and cross referencing for equations, tables and figures
- Optionally work in an [online visual editor](https://curvenote.com) and update local content from the command line
- [Start from a GitHub repo](https://try.curvenote.com/)

### Examples

- [Technical Blogging](https://www.stevejpurves.com/blog)
- [Climasoma Synthesis Report](https://climasoma.curve.space/)
- [Transform 22 Conference](https://transform.softwareunderground.org/overview)
- [SIMPEG Research Seminars](https://seminars.simpeg.xyz/)
- [A PhD Thesis](https://phd.row1.ca/phd)
- [La Palma Eruption Preprint](https://www.stevejpurves.com/la-palma-earthquakes)


id: pollen
git_filename: src/site/generators/pollen.md
format: md
field_title: Pollen
field_repo: mbutterick/pollen
field_homepage: http://pollenpub.com
field_language: Racket
field_license: LGPL-3.0-only
field_description: A web book-publishing system written in Racket with static html as default output target.
data:
{"title": "Pollen", "repo": "mbutterick/pollen", "homepage": "http://pollenpub.com", "language": ["Racket"], "license": ["LGPL-3.0-only"], "templates": [], "description": "A web book-publishing system written in Racket with static html as default output target.", "body": "A book-publishing system written in [Racket](http://racket-lang.org). This is the software used to publish & maintain the web-based books [Practical Typography](http://practicaltypography.com), [Typography for Lawyers](http://typographyforlawyers.com), and the forthcoming [Beautiful Racket](http://beautifulracket.com).\n\nIf you think documents should be programmable, you\u2019ll love it.  \nIf not, you can move along.\n\nPollen gives you access to a full programming language (Racket) with a text-based syntax that makes it easy to embed code within your documents.\n\n- [Quick tour](http://pkg-build.racket-lang.org/doc/pollen/quick-tour.html)\n- [Pollen as a text preprocessor (for CSS, etc.)](http://pkg-build.racket-lang.org/doc/pollen/first-tutorial.html)\n- [Pollen for Markdown authoring](http://pkg-build.racket-lang.org/doc/pollen/second-tutorial.html)\n- [Pollen for free-form markup authoring](http://pkg-build.racket-lang.org/doc/pollen/third-tutorial.html)\n- [Pollen for multiple-output publishing](http://pkg-build.racket-lang.org/doc/pollen/fourth-tutorial.html)\n- [Full docs](http://pkg-build.racket-lang.org/doc/pollen)\n\nUsing Racket 6.0+, install from the command line:\n\n    raco pkg install pollen\n\nAnd update like so:\n\n    raco pkg update --update-deps pollen\n\nOfficial mailing list: http://groups.google.com/forum/#!forum/pollenpub"}

field_body:
A book-publishing system written in [Racket](http://racket-lang.org). This is the software used to publish & maintain the web-based books [Practical Typography](http://practicaltypography.com), [Typography for Lawyers](http://typographyforlawyers.com), and the forthcoming [Beautiful Racket](http://beautifulracket.com).

If you think documents should be programmable, you’ll love it.  
If not, you can move along.

Pollen gives you access to a full programming language (Racket) with a text-based syntax that makes it easy to embed code within your documents.

- [Quick tour](http://pkg-build.racket-lang.org/doc/pollen/quick-tour.html)
- [Pollen as a text preprocessor (for CSS, etc.)](http://pkg-build.racket-lang.org/doc/pollen/first-tutorial.html)
- [Pollen for Markdown authoring](http://pkg-build.racket-lang.org/doc/pollen/second-tutorial.html)
- [Pollen for free-form markup authoring](http://pkg-build.racket-lang.org/doc/pollen/third-tutorial.html)
- [Pollen for multiple-output publishing](http://pkg-build.racket-lang.org/doc/pollen/fourth-tutorial.html)
- [Full docs](http://pkg-build.racket-lang.org/doc/pollen)

Using Racket 6.0+, install from the command line:

    raco pkg install pollen

And update like so:

    raco pkg update --update-deps pollen

Official mailing list: http://groups.google.com/forum/#!forum/pollenpub


id: magnanimous
git_filename: src/site/generators/magnanimous.md
format: md
field_title: Magnanimous
field_repo: renatoathaydes/magnanimous
field_homepage: https://renatoathaydes.github.io/magnanimous/
field_language: Go
field_license: MIT
field_templates: Magnanimous
field_description: Magnanimous is a simple static website generator.
data:
{"title": "Magnanimous", "repo": "renatoathaydes/magnanimous", "homepage": "https://renatoathaydes.github.io/magnanimous/", "language": ["Go"], "license": ["MIT"], "templates": ["Magnanimous"], "description": "Magnanimous is a simple static website generator.", "body": "Magnanimous is a simple, fast static website generator made for programmers.\n\nIt has its own tiny template language to make it as easy as possible to include files or part of files into other files,\nre-use variables, use for loops over literals or collections (e.g. files in a directory), compose components and many other things.\n\nIt is written in Go, so it is distributed as a single binary in all platforms, runs extremely fast and integrates very well with other\nUnixy tools."}

field_body:
Magnanimous is a simple, fast static website generator made for programmers.

It has its own tiny template language to make it as easy as possible to include files or part of files into other files,
re-use variables, use for loops over literals or collections (e.g. files in a directory), compose components and many other things.

It is written in Go, so it is distributed as a single binary in all platforms, runs extremely fast and integrates very well with other
Unixy tools.


id: docsify
git_filename: src/site/generators/docsify.md
format: md
field_title: Docsify
field_repo: docsifyjs/docsify
field_homepage: https://docsify.js.org/
field_language: JavaScript
field_license: MIT
field_templates: Markdown, Vue
field_description: A magical documentation site generator.
data:
{"title": "Docsify", "repo": "docsifyjs/docsify", "homepage": "https://docsify.js.org/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Markdown", "Vue"], "description": "A magical documentation site generator.", "body": "docsify generates your documentation website on the fly. Unlike GitBook, it does not generate static html files. Instead, it smartly loads and parses your Markdown files and displays them as a website.\n\nSimple and lightweight (~21kB gzipped)\nNo statically built html files\nMultiple themes\n\n- [Documentation](https://docsify.js.org)\n- [CLI](https://github.com/docsifyjs/docsify-cli)\n- CDN: [UNPKG](https://unpkg.com/docsify/) | [jsDelivr](https://cdn.jsdelivr.net/npm/docsify/) | [cdnjs](https://cdnjs.com/libraries/docsify)\n- [Awesome docsify](https://github.com/docsifyjs/awesome-docsify)\n- [Community chat](https://discord.gg/3NwKFyR)"}

field_body:
docsify generates your documentation website on the fly. Unlike GitBook, it does not generate static html files. Instead, it smartly loads and parses your Markdown files and displays them as a website.

Simple and lightweight (~21kB gzipped)
No statically built html files
Multiple themes

- [Documentation](https://docsify.js.org)
- [CLI](https://github.com/docsifyjs/docsify-cli)
- CDN: [UNPKG](https://unpkg.com/docsify/) | [jsDelivr](https://cdn.jsdelivr.net/npm/docsify/) | [cdnjs](https://cdnjs.com/libraries/docsify)
- [Awesome docsify](https://github.com/docsifyjs/awesome-docsify)
- [Community chat](https://discord.gg/3NwKFyR)


id: roots
git_filename: src/site/generators/roots.md
format: md
field_title: Roots
field_repo: jescalan/roots
field_homepage: http://roots.netlify.com
field_language: CoffeeScript
field_license: MIT
field_templates: Jade
field_description: roots is a toolbox for building simple, beautiful, and efficient products for the web.
data:
{"title": "Roots", "repo": "jescalan/roots", "homepage": "http://roots.netlify.com", "language": ["CoffeeScript"], "license": ["MIT"], "templates": ["Jade"], "description": "roots is a toolbox for building simple, beautiful, and efficient products for the web.", "body": "Roots is a toolkit built on best practices for advanced front-end web development. It has a very large number of features, which I\u2019ll attempt to list below. Roots comes in the form of a static site build tool by default, but also includes templates and plugins for express and rails.\n\n- extremely simple installation\n- clean and minimal default project template\n- clean and intuitive app settings file\n- jade, stylus, and coffeescript default stack\n- easy to add languages with a simple and well-documented plugin interface\n- super fast live reload implementation\n- compile errors displayed as a flash message, doesn\u2019t break workflow\n- layouts and partials fully supported\n- coffeescript and markdown can be written directly in views\n- global variables and functions (view helpers)\n- extremely robust, modular, and powerful css helper library built in\n- single command deploy to heroku, nodejitsu, or github pages\n- intelligently minifies html, css, and js on deploy\n- efficient client-side js management through bower and require.js\n- automatically precompiles jade templates for use in client-side MVCs like backbone\n- use dynamic content to create collections, blogs, etc\n- compile a single file for multiple languages"}

field_body:
Roots is a toolkit built on best practices for advanced front-end web development. It has a very large number of features, which I’ll attempt to list below. Roots comes in the form of a static site build tool by default, but also includes templates and plugins for express and rails.

- extremely simple installation
- clean and minimal default project template
- clean and intuitive app settings file
- jade, stylus, and coffeescript default stack
- easy to add languages with a simple and well-documented plugin interface
- super fast live reload implementation
- compile errors displayed as a flash message, doesn’t break workflow
- layouts and partials fully supported
- coffeescript and markdown can be written directly in views
- global variables and functions (view helpers)
- extremely robust, modular, and powerful css helper library built in
- single command deploy to heroku, nodejitsu, or github pages
- intelligently minifies html, css, and js on deploy
- efficient client-side js management through bower and require.js
- automatically precompiles jade templates for use in client-side MVCs like backbone
- use dynamic content to create collections, blogs, etc
- compile a single file for multiple languages


id: tanstack-start
git_filename: src/site/generators/tanstack-start.md
format: md
field_title: TanStack Start
field_repo: tanstack
field_homepage: https://tanstack.com/
field_language: JavaScript
field_license: MIT
field_templates: React
field_description: Full-stack React framework powered by TanStack Router
data:
{"title": "TanStack Start", "repo": "tanstack", "homepage": "https://tanstack.com/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["React"], "description": "Full-stack React framework powered by TanStack Router", "body": "TanStack Start is a full-stack React framework powered by TanStack Router. It provides a full-document SSR, streaming, server functions, bundling, and more using tools like Nitro and Vite. It is ready to deploy to your favorite hosting provider!"}

field_body:
TanStack Start is a full-stack React framework powered by TanStack Router. It provides a full-document SSR, streaming, server functions, bundling, and more using tools like Nitro and Vite. It is ready to deploy to your favorite hosting provider!


id: wyam
git_filename: src/site/generators/wyam.md
format: md
field_title: Wyam
field_repo: Wyamio/Wyam
field_homepage: http://wyam.io
field_language: .Net
field_license: MIT
field_templates: Razor, Markdown
field_description: A simple to use, highly modular, and extremely configurable static content generator.
data:
{"title": "Wyam", "repo": "Wyamio/Wyam", "homepage": "http://wyam.io", "language": [".Net"], "license": ["MIT"], "templates": ["Razor", "Markdown"], "description": "A simple to use, highly modular, and extremely configurable static content generator.", "body": "Wyam is a static content generator and can be used to generate web sites, produce documentation, create ebooks, and much more. Since everything is configured by chaining together flexible modules (that you can even write yourself), the only limits to what it can create are your imagination.\n\n### Features\n\n- Written in .NET and [easily extensible](http://wyam.io/knowledgebase/writing-a-module)\n- [Low ceremony](http://wyam.io/getting-started/installation) - download a zip file, unzip, and run\n- Flexible [script-based configuration](http://wyam.io/getting-started/configuration) using the power of the .NET Compiler Platform (Roslyn)\n- Lots of [modules](http://wyam.io/modules) for things like [reading](http://wyam.io/modules/readfiles) and [writing](http://wyam.io/modules/writefiles) files, handling [frontmatter](http://wyam.io/modules/frontmatter), and manipulating [metadata](http://wyam.io/modules/metadata)\n- [YAML parser](http://wyam.io/modules/yaml)\n- [Less CSS compiler](http://wyam.io/modules/less)\n- Support for multiple templating languages including [Razor](http://wyam.io/modules/razor)\n- Integrated [web server](http://wyam.io/getting-started/usage) for previewing output\n- Integrated [file watching](http://wyam.io/getting-started/usage) and regeneration\n- Full [NuGet support](http://wyam.io/getting-started/configuration#nuget)\n- [Embeddable engine](http://wyam.io/knowledgebase/embedded-use)"}

field_body:
Wyam is a static content generator and can be used to generate web sites, produce documentation, create ebooks, and much more. Since everything is configured by chaining together flexible modules (that you can even write yourself), the only limits to what it can create are your imagination.

### Features

- Written in .NET and [easily extensible](http://wyam.io/knowledgebase/writing-a-module)
- [Low ceremony](http://wyam.io/getting-started/installation) - download a zip file, unzip, and run
- Flexible [script-based configuration](http://wyam.io/getting-started/configuration) using the power of the .NET Compiler Platform (Roslyn)
- Lots of [modules](http://wyam.io/modules) for things like [reading](http://wyam.io/modules/readfiles) and [writing](http://wyam.io/modules/writefiles) files, handling [frontmatter](http://wyam.io/modules/frontmatter), and manipulating [metadata](http://wyam.io/modules/metadata)
- [YAML parser](http://wyam.io/modules/yaml)
- [Less CSS compiler](http://wyam.io/modules/less)
- Support for multiple templating languages including [Razor](http://wyam.io/modules/razor)
- Integrated [web server](http://wyam.io/getting-started/usage) for previewing output
- Integrated [file watching](http://wyam.io/getting-started/usage) and regeneration
- Full [NuGet support](http://wyam.io/getting-started/configuration#nuget)
- [Embeddable engine](http://wyam.io/knowledgebase/embedded-use)


id: yasbe
git_filename: src/site/generators/yasbe.md
format: md
field_title: YASBE
field_repo: underr/yasbe
field_homepage: http://github.com/underr/yasbe
field_language: Python
field_license: WTFPL
field_templates: Mako
field_description: Yet Another Static Blog Engine
data:
{"title": "YASBE", "repo": "underr/yasbe", "homepage": "http://github.com/underr/yasbe", "language": ["Python"], "license": ["WTFPL"], "templates": ["Mako"], "description": "Yet Another Static Blog Engine", "body": "[(Demo)](http://yasbe.surge.sh/)\n\nUnlike others Static Blogs Generators like Pelican or Jekyll, this one was made to be modified,\nso don't expect to get cool themes, ready \"plugins\" or anything."}

field_body:
[(Demo)](http://yasbe.surge.sh/)

Unlike others Static Blogs Generators like Pelican or Jekyll, this one was made to be modified,
so don't expect to get cool themes, ready "plugins" or anything.


id: mini-site-generator
git_filename: src/site/generators/mini-site-generator.md
format: md
field_title: Mini Site Generator
field_repo: ijmccallum/Mini-Site-Generator
field_homepage: https://ijmccallum.github.io/Mini-Site-Generator/
field_language: JavaScript
field_license: MIT
field_templates: JavaScript
field_description: It's just javascript!
field_startertemplaterepo: https://github.com/ijmccallum/msg-starter
data:
{"title": "Mini Site Generator", "repo": "ijmccallum/Mini-Site-Generator", "homepage": "https://ijmccallum.github.io/Mini-Site-Generator/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["JavaScript"], "description": "It's just javascript!", "startertemplaterepo": "https://github.com/ijmccallum/msg-starter", "body": "MSG is used in the food industry as a flavor enhancer with an umami taste that intensifies the meaty, savory flavor of - jkjkjk! I kid. It's literally just JavaScript.\n\n## High level:\n\n\\_**\\_.page.js -> \\_\\_**.html\n\n## Low level:\n\n```js\n//Inside ___.page.js\nmodule.exports = function() {\n  return html`\n    <p>\n      I'm honestly not kidding,<br />\n      It's just JavaScript!\n    </p>\n  `\n}\n```"}

field_body:
MSG is used in the food industry as a flavor enhancer with an umami taste that intensifies the meaty, savory flavor of - jkjkjk! I kid. It's literally just JavaScript.

## High level:

\_**\_.page.js -> \_\_**.html

## Low level:

```js
//Inside ___.page.js
module.exports = function() {
  return html`
    <p>
      I'm honestly not kidding,<br />
      It's just JavaScript!
    </p>
  `
}
```


id: hastysite
git_filename: src/site/generators/hastysite.md
format: md
field_title: HastySite
field_repo: h3rald/hastysite
field_homepage: https://hastysite.h3rald.com/
field_language: Nim
field_license: MIT
field_templates: Mustache
field_description: HastySite is a minimalist, self-contained, and highly-extensible static site generator.
data:
{"title": "HastySite", "repo": "h3rald/hastysite", "homepage": "https://hastysite.h3rald.com/", "language": ["Nim"], "license": ["MIT"], "templates": ["Mustache"], "description": "HastySite is a minimalist, self-contained, and highly-extensible static site generator.", "body": "HastySite is a minimalist but powerful static site generator written in [Nim](https://nim-lang.org) which aims to be fast at processing content and highly configurable to suit your own needs.\n\n### Key Features\n\n- Built-in rich markdown support via [HastyScribe](https://h3rald.com/hastyscribe).\n- Built-in [mustache](https://mustache.github.io/) support for page templates.\n- Limited support for standard [CSS variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables).\n- Fully configurable content and asset processing pipeline, using the [min](https://min-lang.org) programming language.\n- Custom script definition, using the [min](https://min-lang.org) programming language.\n- Default stylesheet and fonts from [HastyScribe](https://h3rald.com/hastyscribe).\n- Default scripts and rules to get started quickly.\n- All packed in a single executable file, with no dependencies, available for the most common desktop platforms."}

field_body:
HastySite is a minimalist but powerful static site generator written in [Nim](https://nim-lang.org) which aims to be fast at processing content and highly configurable to suit your own needs.

### Key Features

- Built-in rich markdown support via [HastyScribe](https://h3rald.com/hastyscribe).
- Built-in [mustache](https://mustache.github.io/) support for page templates.
- Limited support for standard [CSS variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables).
- Fully configurable content and asset processing pipeline, using the [min](https://min-lang.org) programming language.
- Custom script definition, using the [min](https://min-lang.org) programming language.
- Default stylesheet and fonts from [HastyScribe](https://h3rald.com/hastyscribe).
- Default scripts and rules to get started quickly.
- All packed in a single executable file, with no dependencies, available for the most common desktop platforms.


id: skf
git_filename: src/site/generators/skf.md
format: md
field_title: SKF
field_repo: moebiuseye/skf
field_homepage: http://skf.jeannedhack.org/
field_language: Bash
field_license: GPL-3.0-only
field_templates: Custom
field_description: Plugin-based static website generator inspired by Suckless Web Framework.
data:
{"title": "SKF", "repo": "moebiuseye/skf", "homepage": "http://skf.jeannedhack.org/", "language": ["Bash"], "license": ["GPL-3.0-only"], "templates": ["Custom"], "description": "Plugin-based static website generator inspired by Suckless Web Framework.", "body": "## Goal\n\nStatiKiss Framework concentrates on performance and simplicity.\nPlugins can be created very easily.\n\nThe three themes (Default, Redish and Split) are responsive and\ntry to be as small as possible."}

field_body:
## Goal

StatiKiss Framework concentrates on performance and simplicity.
Plugins can be created very easily.

The three themes (Default, Redish and Split) are responsive and
try to be as small as possible.


id: bootdown
git_filename: src/site/generators/bootdown.md
format: md
field_title: BootDown
field_repo: interstar/bootdown
field_homepage: http://project.geekweaver.com/
field_language: Python
field_license: AGPL-3.0-only
field_templates: Markdown
field_description: Extremely simple static sites with Markdown and BootStrap.
data:
{"title": "BootDown", "repo": "interstar/bootdown", "homepage": "http://project.geekweaver.com/", "language": ["Python"], "license": ["AGPL-3.0-only"], "templates": ["Markdown"], "description": "Extremely simple static sites with Markdown and BootStrap.", "body": "Basically it's a Markdown to HTML processor, pre-packaged with BootStrap Bootswatches. And some extra tricks :\n\n- A header section that lets you define a menu, footer, projectname, bootswatch, head_extra (extra code to put in page headers)\n- A \"page-break\" option so that your single .md file becomes a number of HTML pages\n- A very light-weight markup for defining divs with classes and ids using &lbrack;.CLASSNAME#ID and .&rbrack;\n- A markup for including CSV files as tables.\n\nUnlike most static site systems that are built around templating engines, with BootDown you write both your page content, and the structure in a single source file. Using &lbrack;. .&rbrack; for divs. This gives you all the flexibility you need to layout your pages any way you like, within the BootStrap grid."}

field_body:
Basically it's a Markdown to HTML processor, pre-packaged with BootStrap Bootswatches. And some extra tricks :

- A header section that lets you define a menu, footer, projectname, bootswatch, head_extra (extra code to put in page headers)
- A "page-break" option so that your single .md file becomes a number of HTML pages
- A very light-weight markup for defining divs with classes and ids using &lbrack;.CLASSNAME#ID and .&rbrack;
- A markup for including CSV files as tables.

Unlike most static site systems that are built around templating engines, with BootDown you write both your page content, and the structure in a single source file. Using &lbrack;. .&rbrack; for divs. This gives you all the flexibility you need to layout your pages any way you like, within the BootStrap grid.


id: cobalt
git_filename: src/site/generators/cobalt.md
format: md
field_title: Cobalt
field_repo: cobalt-org/cobalt.rs
field_homepage: https://cobalt-org.github.io/
field_language: Rust
field_license: MIT
field_templates: Liquid
field_description: A static site generator written in Rust.
field_body: Cobalt is a static site generator written in Rust. It uses Liquid templates and markdown.
data:
{"title": "Cobalt", "repo": "cobalt-org/cobalt.rs", "homepage": "https://cobalt-org.github.io/", "language": ["Rust"], "license": ["MIT"], "templates": ["Liquid"], "description": "A static site generator written in Rust.", "body": "Cobalt is a static site generator written in Rust. It uses Liquid templates and markdown."}


id: pub-server
git_filename: src/site/generators/pub-server.md
format: md
field_title: pub-server
field_repo: jldec/pub-server
field_homepage: http://jldec.github.io/pub-doc/
field_language: JavaScript
field_license: MIT
field_templates: Handlebars
field_description: static HTML generator + editor with npm-based themes
data:
{"title": "pub-server", "repo": "jldec/pub-server", "homepage": "http://jldec.github.io/pub-doc/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Handlebars"], "description": "static HTML generator + editor with npm-based themes", "body": "## pub-server\n\n**pub-server**, or **pub** for short is an HTML generator+editor entirely written in javascript.\n\nThe generator+editor can run in-browser, providing a serverless-CMS for non-technical users to edit markdown _source_ text fragments, and instantly preview the generated HTML, without first having to install pub-server themselves.\n\nWhen you publish onto a static hosting service like [**netlify**](https://www.netlify.com/), you can include the generator+editor together with the published HTML.\n\nTo see this in action, check out the docs at http://jldec.github.io/pub-doc/. The editor appears when you click on the [edit](http://jldec.github.io/pub-doc/pub/?page=%2F) button at the top right.\nFeel free to play around - in this instance, your changes will not be recorded.\n\nOther examples include a [presentation theme](https://github.com/jldec/pub-sample-deck), a [flexbox design](https://github.com/jldec/pub-theme-brief), and a [blog](http://blog.pubblz.com/).\n\n### installation\n\nrunning **pub-server** locally requires node.js.\n\n```sh\nnpm install -g pub-server\n```\n\nOSX and Linux are working, Windows support is coming - PRs welcome.\n\n### usage\n\n- `pub` (with no options) serves `*.md` in the current directory or looks for a `pub-config.js`. The default theme is useful for previewing Github README.md files. The server will watch for changes and update http://localhost:3001/ whenever markdown files or CSS or other static files are saved.\n\n- `pub -O` generates .html and other static files (including generator + editor) to `./out`.\n\n- `pub -S <dir>` serves static files from any directory. It will mimic the behavior of Github Pages, looking for index.html files in folders, and redirecting from /folder-name to /folder-name/\n\n- `pub -h` shows usage summary."}

field_body:
## pub-server

**pub-server**, or **pub** for short is an HTML generator+editor entirely written in javascript.

The generator+editor can run in-browser, providing a serverless-CMS for non-technical users to edit markdown _source_ text fragments, and instantly preview the generated HTML, without first having to install pub-server themselves.

When you publish onto a static hosting service like [**netlify**](https://www.netlify.com/), you can include the generator+editor together with the published HTML.

To see this in action, check out the docs at http://jldec.github.io/pub-doc/. The editor appears when you click on the [edit](http://jldec.github.io/pub-doc/pub/?page=%2F) button at the top right.
Feel free to play around - in this instance, your changes will not be recorded.

Other examples include a [presentation theme](https://github.com/jldec/pub-sample-deck), a [flexbox design](https://github.com/jldec/pub-theme-brief), and a [blog](http://blog.pubblz.com/).

### installation

running **pub-server** locally requires node.js.

```sh
npm install -g pub-server
```

OSX and Linux are working, Windows support is coming - PRs welcome.

### usage

- `pub` (with no options) serves `*.md` in the current directory or looks for a `pub-config.js`. The default theme is useful for previewing Github README.md files. The server will watch for changes and update http://localhost:3001/ whenever markdown files or CSS or other static files are saved.

- `pub -O` generates .html and other static files (including generator + editor) to `./out`.

- `pub -S <dir>` serves static files from any directory. It will mimic the behavior of Github Pages, looking for index.html files in folders, and redirecting from /folder-name to /folder-name/

- `pub -h` shows usage summary.


id: webby
git_filename: src/site/generators/webby.md
format: md
field_title: Webby
field_repo: TwP/webby
field_homepage: http://webby.rubyforge.org/
field_language: Ruby
field_license: MIT
field_templates: ERB
field_description: Webby is a fantastic little website management system.
data:
{"title": "Webby", "repo": "TwP/webby", "homepage": "http://webby.rubyforge.org/", "language": ["Ruby"], "license": ["MIT"], "templates": ["ERB"], "description": "Webby is a fantastic little website management system.", "body": "Webby is a fantastic little website management system. It would be called a content management system if it were a bigger kid. But, it\u2019s just a runt with a special knack for transforming text. And that\u2019s really all it does \u2013 manages the legwork of turning text into something else, an ASCII Alchemist if you will.\n\nWebby works by combining the contents of a page with a layout to produce HTML. The layout contains everything common to all the pages \u2013 HTML headers, navigation menu, footer, etc. \u2013 and the page contains just the information for that page. You can use your favorite markup language to write your pages; Webby supports quite a few.\n\n### NO LONGER UNDER ACTIVE DEVELOPMENT"}

field_body:
Webby is a fantastic little website management system. It would be called a content management system if it were a bigger kid. But, it’s just a runt with a special knack for transforming text. And that’s really all it does – manages the legwork of turning text into something else, an ASCII Alchemist if you will.

Webby works by combining the contents of a page with a layout to produce HTML. The layout contains everything common to all the pages – HTML headers, navigation menu, footer, etc. – and the page contains just the information for that page. You can use your favorite markup language to write your pages; Webby supports quite a few.

### NO LONGER UNDER ACTIVE DEVELOPMENT


id: flatmarket
git_filename: src/site/generators/flatmarket.md
format: md
field_title: Flatmarket
field_repo: christophercliff/flatmarket
field_homepage: https://christophercliff.com/flatmarket/
field_language: JavaScript
field_license: MIT
field_templates: Any JS
field_description: A free, open source e-commerce platform for static websites.
data:
{"title": "Flatmarket", "repo": "christophercliff/flatmarket", "homepage": "https://christophercliff.com/flatmarket/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Any JS"], "description": "A free, open source e-commerce platform for static websites.", "body": "Flatmarket is a free, open source e-commerce platform for static websites. It is reliable, secure, and inexpensive to operate.\n\nThe platform uses Stripe for payment processing and is built on the latest web technologies like hapi, React, and Webpack.\n\nAt its core is a batteries-included CLI to help you get started quickly. Modules are also packaged individually so you can customize your rig."}

field_body:
Flatmarket is a free, open source e-commerce platform for static websites. It is reliable, secure, and inexpensive to operate.

The platform uses Stripe for payment processing and is built on the latest web technologies like hapi, React, and Webpack.

At its core is a batteries-included CLI to help you get started quickly. Modules are also packaged individually so you can customize your rig.


id: heckle
git_filename: src/site/generators/heckle.md
format: md
field_title: Heckle
field_repo: marijnh/heckle
field_homepage: https://github.com/marijnh/heckle
field_language: JavaScript
field_license: MIT
field_templates: Mold
field_description: A minimal Jekyll clone in node.js.
data:
{"title": "Heckle", "repo": "marijnh/heckle", "homepage": "https://github.com/marijnh/heckle", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Mold"], "description": "A minimal Jekyll clone in node.js.", "body": "### Why?\n\nI like the approach to managing a site taken by Jekyll. A lot.\n\nI don't like Ruby, and I don't like strict logic-less templates. Jekyll is Ruby with Liquid as the templating engine.\n\nHeckle is JavaScript with Mold (programmable template extravaganza) as the templating engine.\n\nDon't use Heckle at this point if you want something stable and finished. It's a work in progress, and may be radically changed or pitilessly abandoned at any time."}

field_body:
### Why?

I like the approach to managing a site taken by Jekyll. A lot.

I don't like Ruby, and I don't like strict logic-less templates. Jekyll is Ruby with Liquid as the templating engine.

Heckle is JavaScript with Mold (programmable template extravaganza) as the templating engine.

Don't use Heckle at this point if you want something stable and finished. It's a work in progress, and may be radically changed or pitilessly abandoned at any time.


id: docnado
git_filename: src/site/generators/docnado.md
format: md
field_title: docnado
field_repo: HEInventions/docnado
field_homepage: https://heinventions.github.io/docnado-site/
field_language: Python
field_license: MIT
field_templates: Jinja2
field_description: A rapid documentation tool to blow you away! Batteries and style included; you just need to type.
data:
{"title": "docnado", "repo": "HEInventions/docnado", "homepage": "https://heinventions.github.io/docnado-site/", "language": ["Python"], "license": ["MIT"], "templates": ["Jinja2"], "description": "A rapid documentation tool to blow you away!  Batteries and style included; you just need to type. ", "twitter": "heinventions", "body": "# Docnado\n\nA rapid documentation tool to blow you away!!!\n\nDocnado makes it easy to start and maintain a Markdown documentation project.\n\n### Features\n\nDocnado renders an adapted Markdown to provide:\n\n- Embed images, video, YouTube links, external CSV tables, and PDFs.\n- Code highlighting.\n- File download blocks.\n- Lists, checklists, tables, and glossaries.\n- Document defined template selection.\n- Document meta-data.\n- Auto-generated navigation sidebar.\n- Built in command line options to find broken links and orphan images in your documentation.\n\n### Accessing Options\n\n- Output documents as insecure HTML on a localhost.\n- Output documents as PDF files via the HTML server.\n- Create a static set of HTML files that contain the documentation and related resources.\n\n### Download\n\nMake sure you have Python 3.6 installed.\n\n```sh\npython3 -m pip install docnado --upgrade\t# install it\ndocnado\t\t\t\t\t\t\t\t\t\t# run it\n```\n\n### Getting Started\n\n```sh\n\npython docnado.py                       # start a server on localhost:5000\n\npython docnado.py --html                # freeze the server into a static site as a set of HTML files\n                                         # this will exit with -1 if there was a problem parsing any file\n\npython docnado.py --port                # specify a port for docnado to accept requests on\n\npython docnado.py --pdf                 # generate a set of pdf files for each .md file - won't pull through\n                                         # static resource files like with the --html command\n\npython docnado.py --new                 # copy default templates and sample docs into the working directory\n                                         # and update the config too, only if they don't already exist\n\npython docnado.py --new-force           # copy default templates and sample docs into the working directory\n                                         # and update the config too, this will overwrite any existing docs or\n                                         # configs.\n\n\npython docnado.py --dirs                # display all the different directories docnado will use to generate\n                                         # the documentation\n\npython docnado.py --find-orphans        # display unreferenced media assets in the documentation\npython docnado.py --find-broken-links   # display external broken links in the documentation\n```"}

field_body:
# Docnado

A rapid documentation tool to blow you away!!!

Docnado makes it easy to start and maintain a Markdown documentation project.

### Features

Docnado renders an adapted Markdown to provide:

- Embed images, video, YouTube links, external CSV tables, and PDFs.
- Code highlighting.
- File download blocks.
- Lists, checklists, tables, and glossaries.
- Document defined template selection.
- Document meta-data.
- Auto-generated navigation sidebar.
- Built in command line options to find broken links and orphan images in your documentation.

### Accessing Options

- Output documents as insecure HTML on a localhost.
- Output documents as PDF files via the HTML server.
- Create a static set of HTML files that contain the documentation and related resources.

### Download

Make sure you have Python 3.6 installed.

```sh
python3 -m pip install docnado --upgrade	# install it
docnado										# run it
```

### Getting Started

```sh

python docnado.py                       # start a server on localhost:5000

python docnado.py --html                # freeze the server into a static site as a set of HTML files
                                         # this will exit with -1 if there was a problem parsing any file

python docnado.py --port                # specify a port for docnado to accept requests on

python docnado.py --pdf                 # generate a set of pdf files for each .md file - won't pull through
                                         # static resource files like with the --html command

python docnado.py --new                 # copy default templates and sample docs into the working directory
                                         # and update the config too, only if they don't already exist

python docnado.py --new-force           # copy default templates and sample docs into the working directory
                                         # and update the config too, this will overwrite any existing docs or
                                         # configs.


python docnado.py --dirs                # display all the different directories docnado will use to generate
                                         # the documentation

python docnado.py --find-orphans        # display unreferenced media assets in the documentation
python docnado.py --find-broken-links   # display external broken links in the documentation
```


id: amagaki
git_filename: src/site/generators/amagaki.md
format: md
field_title: Amagaki
field_repo: blinkk/amagaki
field_homepage: https://amagaki.dev
field_language: TypeScript
field_license: MIT
field_templates: Nunjucks, React, Closure Templates
field_description: A TypeScript site generator for hand-coding interactive marketing sites.
field_startertemplaterepo: https://github.com/blinkk/amagaki-starter
data:
{"title": "Amagaki", "repo": "blinkk/amagaki", "homepage": "https://amagaki.dev", "language": ["TypeScript"], "license": ["MIT"], "templates": ["Nunjucks", "React", "Closure Templates"], "startertemplaterepo": "https://github.com/blinkk/amagaki-starter", "description": "A TypeScript site generator for hand-coding interactive marketing sites.", "body": "Amagaki is a TypeScript site generator specifically made for hand-coding high fidelity interactive marketing sites. It's smaller than Next.js or Gatsby, and offers more than Jekyll. It facilitates best practices for building content-heavy marketing sites, and it's fast.\n\n## Key concepts\n\n- TypeScript and Node\n- Minimal core dependencies\n- Inbuilt build metrics (memory usage, generated file size, routes, locales, translations)\n- A static site generator (not a frontend framework)\n- Renders pages at request time (unlike other static generators which watch and rebuild)\n- Localization is an inbuilt feature\n- Custom YAML types for extending the content layer\n- Benchmarking inbuilt\n- Separate your content (YAML, Markdown) from your templates with ease\n\n## Plugin system\n\n- Extensive hook system for adding steps throughout the lifecycle\n- Multiple template languages (Nunjucks as default, React, Closure Templates plugins available)\n- Supports CMS integration via dynamic routing\n- Google Sheets plugin for managing content within Google Sheets\n\n## Quick start\n\nAmagaki is distributed as an npm package. We recommend using our starter when building marketing websites from scratch.\n\n```shell\ngit clone https://github.com/blinkk/amagaki-starter\nnpm install\n\n# Start the dev server\nnpm run dev\n\n# Build the site\nnpm run build\n```\n\nIf you are integrating into an existing project, you can install Amagaki directly.\n\n```shell\n# Install Amagaki\nnpm install --save @amagaki/amagaki\n\n# Start the dev server\nnpx amagaki serve\n\n# Build the site\nnpx amagaki build\n```\n\nCheck out the full documentation at [amagaki.dev](https://amagaki.dev/)."}

field_body:
Amagaki is a TypeScript site generator specifically made for hand-coding high fidelity interactive marketing sites. It's smaller than Next.js or Gatsby, and offers more than Jekyll. It facilitates best practices for building content-heavy marketing sites, and it's fast.

## Key concepts

- TypeScript and Node
- Minimal core dependencies
- Inbuilt build metrics (memory usage, generated file size, routes, locales, translations)
- A static site generator (not a frontend framework)
- Renders pages at request time (unlike other static generators which watch and rebuild)
- Localization is an inbuilt feature
- Custom YAML types for extending the content layer
- Benchmarking inbuilt
- Separate your content (YAML, Markdown) from your templates with ease

## Plugin system

- Extensive hook system for adding steps throughout the lifecycle
- Multiple template languages (Nunjucks as default, React, Closure Templates plugins available)
- Supports CMS integration via dynamic routing
- Google Sheets plugin for managing content within Google Sheets

## Quick start

Amagaki is distributed as an npm package. We recommend using our starter when building marketing websites from scratch.

```shell
git clone https://github.com/blinkk/amagaki-starter
npm install

# Start the dev server
npm run dev

# Build the site
npm run build
```

If you are integrating into an existing project, you can install Amagaki directly.

```shell
# Install Amagaki
npm install --save @amagaki/amagaki

# Start the dev server
npx amagaki serve

# Build the site
npx amagaki build
```

Check out the full documentation at [amagaki.dev](https://amagaki.dev/).


id: pelican
git_filename: src/site/generators/pelican.md
format: md
field_title: Pelican
field_repo: getpelican/pelican
field_homepage: http://blog.getpelican.com/
field_language: Python
field_license: AGPL-3.0-only
field_templates: Jinja2
field_description: A static site generator, imports from Wordpress, multi-lang publishing.
data:
{"title": "Pelican", "repo": "getpelican/pelican", "homepage": "http://blog.getpelican.com/", "language": ["Python"], "license": ["AGPL-3.0-only"], "templates": ["Jinja2"], "description": "A static site generator, imports from Wordpress, multi-lang publishing.", "twitter": "getpelican", "body": "Pelican is a static site generator, written in Python.\n\n- Write your weblog entries directly with your editor of choice (vim!) in reStructuredText or Markdown\n- Includes a simple CLI tool to (re)generate the weblog\n- Easy to interface with DVCSes and web hooks\n- Completely static output is easy to host anywhere\n\n### Features\n\nPelican currently supports:\n\n- Blog articles and pages\n- Comments, via an external service (Disqus). (Please note that while useful, Disqus is an external service, and thus the comment data will be somewhat outside of your control and potentially subject to data loss.)\n- Theming support (themes are created using Jinja2 templates)\n- PDF generation of the articles/pages (optional)\n- Publication of articles in multiple languages\n- Atom/RSS feeds\n- Code syntax highlighting\n- Import from WordPress, Dotclear, or RSS feeds\n- Integration with external tools: Twitter, Google Analytics, etc. (optional)\n- Fast rebuild times thanks to content caching and selective output writing.\n\n### Why the name \"Pelican\"?\n\n\"Pelican\" is an anagram for calepin, which means \"notebook\" in French. ;)"}

field_body:
Pelican is a static site generator, written in Python.

- Write your weblog entries directly with your editor of choice (vim!) in reStructuredText or Markdown
- Includes a simple CLI tool to (re)generate the weblog
- Easy to interface with DVCSes and web hooks
- Completely static output is easy to host anywhere

### Features

Pelican currently supports:

- Blog articles and pages
- Comments, via an external service (Disqus). (Please note that while useful, Disqus is an external service, and thus the comment data will be somewhat outside of your control and potentially subject to data loss.)
- Theming support (themes are created using Jinja2 templates)
- PDF generation of the articles/pages (optional)
- Publication of articles in multiple languages
- Atom/RSS feeds
- Code syntax highlighting
- Import from WordPress, Dotclear, or RSS feeds
- Integration with external tools: Twitter, Google Analytics, etc. (optional)
- Fast rebuild times thanks to content caching and selective output writing.

### Why the name "Pelican"?

"Pelican" is an anagram for calepin, which means "notebook" in French. ;)


id: hakyll
git_filename: src/site/generators/hakyll.md
format: md
field_title: Hakyll
field_repo: jaspervdj/hakyll
field_homepage: http://jaspervdj.be/hakyll/
field_language: Haskell
field_license: BSD-3-Clause
field_templates: Hakyll
field_description: A configurable Haskell library, for small-to-medium sites.
data:
{"title": "Hakyll", "repo": "jaspervdj/hakyll", "homepage": "http://jaspervdj.be/hakyll/", "language": ["Haskell"], "license": ["BSD-3-Clause"], "templates": ["Hakyll"], "description": "A configurable Haskell library, for small-to-medium sites.", "body": "Static sites are fast, secure, easy to deploy, and manageable using version control.\n\nHakyll is a Haskell library for generating static sites, mostly aimed at small-to-medium sites and personal blogs. It is written in a very configurable way and uses an xmonad-like DSL for configuration.\n\nIntegration with pandoc gives us markdown and TeX support, including syntax highlighting and other goodies."}

field_body:
Static sites are fast, secure, easy to deploy, and manageable using version control.

Hakyll is a Haskell library for generating static sites, mostly aimed at small-to-medium sites and personal blogs. It is written in a very configurable way and uses an xmonad-like DSL for configuration.

Integration with pandoc gives us markdown and TeX support, including syntax highlighting and other goodies.


id: cactus
git_filename: src/site/generators/cactus.md
format: md
field_title: Cactus
field_repo: eudicots/Cactus
field_homepage: https://github.com/koenbok/Cactus/
field_language: Python
field_license: BSD-3-Clause
field_templates: Django
field_description: Static site generator for designers.
field_startertemplaterepo: https://github.com/netlify-templates/cactus-base
data:
{"title": "Cactus", "repo": "eudicots/Cactus", "homepage": "https://github.com/koenbok/Cactus/", "language": ["Python"], "license": ["BSD-3-Clause"], "templates": ["Django"], "description": "Static site generator for designers.", "startertemplaterepo": "https://github.com/netlify-templates/cactus-base", "body": "Cactus is a simple but powerful [static website generator](https://davidwalsh.name/introduction-static-site-generators) using Python and the [Django template system](http://docs.djangoproject.com/en/dev/topics/templates/). Cactus also makes it easy to develop locally and deploy your site to S3 directly. It works great for company, portfolio, personal, support websites and blogs.\n\nTo get a quick overview [watch this short video tutorial](https://vimeo.com/46999791).\n\nCactus is based on the idea that most dynamicness on websites these days can be done using Javascript while the actual site can stay static. Static websites are easy to host and typically very fast.\n\nI developed Cactus because I wanted a standard, easy system that designers at Sofa could use to build and deploy fast websites. So typical users would be designers that are tech-savvy, want to use templates, but don't like to mess with setting up django or S3.\n\nSince then it has evolved quite a bit with a plugin system that supports blogging, spriting, versioning and is extensible.\n\nYou can find more discussion about static site generators in this [Hacker News discussion](http://news.ycombinator.com/item?id=2233620)."}

field_body:
Cactus is a simple but powerful [static website generator](https://davidwalsh.name/introduction-static-site-generators) using Python and the [Django template system](http://docs.djangoproject.com/en/dev/topics/templates/). Cactus also makes it easy to develop locally and deploy your site to S3 directly. It works great for company, portfolio, personal, support websites and blogs.

To get a quick overview [watch this short video tutorial](https://vimeo.com/46999791).

Cactus is based on the idea that most dynamicness on websites these days can be done using Javascript while the actual site can stay static. Static websites are easy to host and typically very fast.

I developed Cactus because I wanted a standard, easy system that designers at Sofa could use to build and deploy fast websites. So typical users would be designers that are tech-savvy, want to use templates, but don't like to mess with setting up django or S3.

Since then it has evolved quite a bit with a plugin system that supports blogging, spriting, versioning and is extensible.

You can find more discussion about static site generators in this [Hacker News discussion](http://news.ycombinator.com/item?id=2233620).


id: metalsmith
git_filename: src/site/generators/metalsmith.md
format: md
field_title: Metalsmith
field_repo: metalsmith/metalsmith
field_homepage: http://www.metalsmith.io/
field_language: JavaScript
field_license: MIT
field_templates: Handlebars, Any JS
field_description: An extremely simple, pluggable static site generator.
field_startertemplaterepo: https://github.com/andreasvirkus/metalsmith-boilerplate
data:
{"title": "Metalsmith", "repo": "metalsmith/metalsmith", "homepage": "http://www.metalsmith.io/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Handlebars", "Any JS"], "description": "An extremely simple, pluggable static site generator.", "startertemplaterepo": "https://github.com/andreasvirkus/metalsmith-boilerplate", "body": "An extremely simple, _pluggable_ static site generator.\n\nIn Metalsmith, all of the logic is handled by plugins. You simply chain them together.\n\n### How does it work?\n\nMetalsmith works in three simple steps:\n\n1. Read all the files in a source directory.\n2. Invoke a series of plugins that manipulate the files.\n3. Write the results to a destination directory!\n\nEach plugin is invoked with the contents of the source directory, and each file can contain YAML front-matter that will be attached as metadata, so a simple file like...\n\n    ---\n    title: A Catchy Title\n    date: 2014-12-01\n    ---\n\n    An informative article.\n\n...would be parsed into...\n\n```js\n{\n  'path/to/my-file.md': {\n    title: 'A Catchy Title',\n    date: new Date('2014-12-01'),\n    contents: new Buffer('An informative article.')\n  }\n}\n```\n\n...which any of the plugins can then manipulate however they want. And writing the plugins is incredibly simple, just take a look at the [example drafts plugin](https://github.com/metalsmith/drafts/blob/master/lib/index.js).\n\nOf course they can get a lot more complicated too. That's what makes Metalsmith powerful; the plugins can do anything you want!\n\n### The secret...\n\nWe keep referring to Metalsmith as a \"static site generator\", but it's a lot more than that. Since everything is a plugin, the core library is actually just an abstraction for manipulating a directory of files."}

field_body:
An extremely simple, _pluggable_ static site generator.

In Metalsmith, all of the logic is handled by plugins. You simply chain them together.

### How does it work?

Metalsmith works in three simple steps:

1. Read all the files in a source directory.
2. Invoke a series of plugins that manipulate the files.
3. Write the results to a destination directory!

Each plugin is invoked with the contents of the source directory, and each file can contain YAML front-matter that will be attached as metadata, so a simple file like...

    ---
    title: A Catchy Title
    date: 2014-12-01
    ---

    An informative article.

...would be parsed into...

```js
{
  'path/to/my-file.md': {
    title: 'A Catchy Title',
    date: new Date('2014-12-01'),
    contents: new Buffer('An informative article.')
  }
}
```

...which any of the plugins can then manipulate however they want. And writing the plugins is incredibly simple, just take a look at the [example drafts plugin](https://github.com/metalsmith/drafts/blob/master/lib/index.js).

Of course they can get a lot more complicated too. That's what makes Metalsmith powerful; the plugins can do anything you want!

### The secret...

We keep referring to Metalsmith as a "static site generator", but it's a lot more than that. Since everything is a plugin, the core library is actually just an abstraction for manipulating a directory of files.


id: markdown-styles
git_filename: src/site/generators/markdown-styles.md
format: md
field_title: markdown-styles
field_repo: mixu/markdown-styles
field_homepage: https://github.com/mixu/markdown-styles
field_language: JavaScript
field_license: BSD-3-Clause
field_templates: Handlebars
field_description: Markdown to static HTML generator and multiple CSS themes for Markdown
data:
{"title": "markdown-styles", "repo": "mixu/markdown-styles", "homepage": "https://github.com/mixu/markdown-styles", "language": ["JavaScript"], "license": ["BSD-3-Clause"], "templates": ["Handlebars"], "description": "Markdown to static HTML generator and multiple CSS themes for Markdown", "body": "Converts Markdown files to HTML, with over a dozen builtin themes.\n\n## Features\n\n- Includes 15+ ready-made CSS stylesheets for Markdown, see the bottom of the readme for screenshots.\n- Reuse the stylesheets or use the `generate-md` tool to convert a folder of Markdown files to HTML using one of the built-in layouts or a custom layout.\n- Completely static output is easy to host anywhere.\n- Metadata support: Each file can include additional metadata in a header section, such as the page title and author name which can then be used in the layout.\n\n### Layout features\n\n- Built in support for code syntax highlighting via highlight.js; all layouts include a Github-style code highlighting theme by default.\n- Built in table of contents generation from Markdown headings, fully customizable by replacing the `{{> toc}}` partial in custom layout.\n- Built in header id and anchor generation for headings written in Markdown; all layouts support revealing the URL via header hover links.\n- Support for custom logic for rendering code blocks via `--highlight-*`; this can be used to implement custom blocks that render the content of the code block in some interesting way.\n- Automatically detects the document title from the first heading in the Markdown markup.\n- Create your own layout based on an existing layout via `--layout` with:\n  - Full [Handlebars](http://handlebarsjs.com/) support for layouts, helpers and partials\n  - Fully customizable table of contents template via the `toc` partial\n  - Support for relative path generation via the `{{asset 'path'}}` helper"}

field_body:
Converts Markdown files to HTML, with over a dozen builtin themes.

## Features

- Includes 15+ ready-made CSS stylesheets for Markdown, see the bottom of the readme for screenshots.
- Reuse the stylesheets or use the `generate-md` tool to convert a folder of Markdown files to HTML using one of the built-in layouts or a custom layout.
- Completely static output is easy to host anywhere.
- Metadata support: Each file can include additional metadata in a header section, such as the page title and author name which can then be used in the layout.

### Layout features

- Built in support for code syntax highlighting via highlight.js; all layouts include a Github-style code highlighting theme by default.
- Built in table of contents generation from Markdown headings, fully customizable by replacing the `{{> toc}}` partial in custom layout.
- Built in header id and anchor generation for headings written in Markdown; all layouts support revealing the URL via header hover links.
- Support for custom logic for rendering code blocks via `--highlight-*`; this can be used to implement custom blocks that render the content of the code block in some interesting way.
- Automatically detects the document title from the first heading in the Markdown markup.
- Create your own layout based on an existing layout via `--layout` with:
  - Full [Handlebars](http://handlebarsjs.com/) support for layouts, helpers and partials
  - Fully customizable table of contents template via the `toc` partial
  - Support for relative path generation via the `{{asset 'path'}}` helper


id: susi
git_filename: src/site/generators/susi.md
format: md
field_title: SuSi
field_repo: AVGP/susi
field_homepage: https://github.com/AVGP/susi
field_language: JavaScript
field_license: ISC
field_templates: HTML
field_description: The SUper SImple site generator.
data:
{"title": "SuSi", "repo": "AVGP/susi", "homepage": "https://github.com/AVGP/susi", "language": ["JavaScript"], "license": ["ISC"], "templates": ["HTML"], "description": "The SUper SImple site generator.", "body": "This is the Su\u200bper Si\u200bmple Si\u200bte generator.  \nYou give it markdown files and (if you fancy) an HTML layout to render them into - and it gives you static HTML.\n\nThat's it. No magic, no fancy build tools - Markdown and HTML. Now go and make that website!\n\n### Philosophy\n\nStatic site generation shouldn't be rocket science.\n\nThis is the **Su**&#8203;per **Si**&#8203;mple **Si**&#8203;te generator.\n\nYou give it markdown files and (if you fancy) an HTML layout to render them into - and it gives you static HTML.\n\nThat's it. No magic, no fancy build tools - Markdown and HTML. Now go and make that website!"}

field_body:
This is the Su​per Si​mple Si​te generator.  
You give it markdown files and (if you fancy) an HTML layout to render them into - and it gives you static HTML.

That's it. No magic, no fancy build tools - Markdown and HTML. Now go and make that website!

### Philosophy

Static site generation shouldn't be rocket science.

This is the **Su**&#8203;per **Si**&#8203;mple **Si**&#8203;te generator.

You give it markdown files and (if you fancy) an HTML layout to render them into - and it gives you static HTML.

That's it. No magic, no fancy build tools - Markdown and HTML. Now go and make that website!


id: vuepress
git_filename: src/site/generators/vuepress.md
format: md
field_title: VuePress
field_repo: vuejs/vuepress
field_homepage: https://vuepress.vuejs.org
field_language: JavaScript
field_license: MIT
field_templates: Vue
field_description: Vue-powered Static Site Generator
field_startertemplaterepo: https://github.com/capriosa/vuepress-deploy
data:
{"title": "VuePress", "repo": "vuejs/vuepress", "homepage": "https://vuepress.vuejs.org", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Vue"], "description": "Vue-powered Static Site Generator", "startertemplaterepo": "https://github.com/capriosa/vuepress-deploy", "twitter": "vuepress", "body": "# Simplicity First\n\nMinimal setup with markdown-centered project structure helps you focus on writing.\n\n# Vue-Powered\n\nEnjoy the dev experience of Vue + webpack, use Vue components in markdown, and develop custom themes with Vue.\n\n# Performant\n\nVuePress generates pre-rendered static HTML for each page, and runs as an SPA once a page is loaded.\n\n# As Easy as 1, 2, 3\n\n```bash\n# install\nnpm install -g vuepress\n\n# create a markdown file\necho \"# Hello VuePress\" > README.md\n\n# start writing\nvuepress dev\n\n# build to static files\nvuepress build\n```"}

field_body:
# Simplicity First

Minimal setup with markdown-centered project structure helps you focus on writing.

# Vue-Powered

Enjoy the dev experience of Vue + webpack, use Vue components in markdown, and develop custom themes with Vue.

# Performant

VuePress generates pre-rendered static HTML for each page, and runs as an SPA once a page is loaded.

# As Easy as 1, 2, 3

```bash
# install
npm install -g vuepress

# create a markdown file
echo "# Hello VuePress" > README.md

# start writing
vuepress dev

# build to static files
vuepress build
```


id: perun
git_filename: src/site/generators/perun.md
format: md
field_title: Perun
field_repo: hashobject/perun
field_homepage: https://perun.io/
field_language: Clojure
field_license: EPL-1.0
field_templates: Hiccup
field_description: Composable static site generator build with Clojure and Boot
data:
{"title": "Perun", "repo": "hashobject/perun", "homepage": "https://perun.io/", "language": ["Clojure"], "license": ["EPL-1.0"], "templates": ["Hiccup"], "description": "Composable static site generator build with Clojure and Boot", "body": "Simple, composable static site generator inspired by [Boot](http://boot-clj.com/) task model and [Metalsmith](http://www.metalsmith.io/).\nPerun is a collection of Boot tasks/plugins that you can chain together and build something custom that suits your needs.\n\n## Plugins system\n\nEverything in Perun is build like independent task. The simplest blog engine will look like:\n\n```clojure\n(deftask build\n  \"Build blog.\"\n  []\n  (comp (markdown)\n        (render :renderer renderer)))\n\n```\n\nBut if you want to make permalinks, generate sitemap and rss feed, hide unfinished posts, add time to read to each post then you will do:\n\n```clojure\n(deftask build\n  \"Build blog.\"\n  []\n  (comp (markdown)\n        (draft)\n        (ttr)\n        (slug)\n        (permalink)\n        (render :renderer renderer)\n        (sitemap :filename \"sitemap.xml\")\n        (rss :title \"Hashobject\" :description \"Hashobject blog\" :link \"http://blog.hashobject.com\")\n        (atom-feed :title \"Hashobject\" :subtitle \"Hashobject blog\" :link \"http://blog.hashobject.com\")\n        (notify)))\n```\n\n## 3d-party plugins\n\nThere are plenty of Boot plugins that can be useful in the when you are using perun:\n\n- [boot-http](https://github.com/pandeiro/boot-http) - serve generated site locally using web server\n- [boot-gzip](https://github.com/martinklepsch/boot-gzip) - gzip files\n- [boot-s3](https://github.com/hashobject/boot-s3) - sync generated site to the Amazon S3\n- [boot-less](https://github.com/Deraen/boot-less) - task to compile Less to CSS\n- [boot-sassc](https://github.com/mathias/boot-sassc) - task to compile Sass to CSS\n- [boot-garden](https://github.com/martinklepsch/boot-garden) - task to compile Garden stylesheets to CSS\n- [boot-autoprefixer](https://github.com/danielsz/boot-autoprefixer) - add vendor prefixes to your CSS\n- [boot-reload](https://github.com/adzerk-oss/boot-reload) - live-reload of browser css, images, etc."}

field_body:
Simple, composable static site generator inspired by [Boot](http://boot-clj.com/) task model and [Metalsmith](http://www.metalsmith.io/).
Perun is a collection of Boot tasks/plugins that you can chain together and build something custom that suits your needs.

## Plugins system

Everything in Perun is build like independent task. The simplest blog engine will look like:

```clojure
(deftask build
  "Build blog."
  []
  (comp (markdown)
        (render :renderer renderer)))

```

But if you want to make permalinks, generate sitemap and rss feed, hide unfinished posts, add time to read to each post then you will do:

```clojure
(deftask build
  "Build blog."
  []
  (comp (markdown)
        (draft)
        (ttr)
        (slug)
        (permalink)
        (render :renderer renderer)
        (sitemap :filename "sitemap.xml")
        (rss :title "Hashobject" :description "Hashobject blog" :link "http://blog.hashobject.com")
        (atom-feed :title "Hashobject" :subtitle "Hashobject blog" :link "http://blog.hashobject.com")
        (notify)))
```

## 3d-party plugins

There are plenty of Boot plugins that can be useful in the when you are using perun:

- [boot-http](https://github.com/pandeiro/boot-http) - serve generated site locally using web server
- [boot-gzip](https://github.com/martinklepsch/boot-gzip) - gzip files
- [boot-s3](https://github.com/hashobject/boot-s3) - sync generated site to the Amazon S3
- [boot-less](https://github.com/Deraen/boot-less) - task to compile Less to CSS
- [boot-sassc](https://github.com/mathias/boot-sassc) - task to compile Sass to CSS
- [boot-garden](https://github.com/martinklepsch/boot-garden) - task to compile Garden stylesheets to CSS
- [boot-autoprefixer](https://github.com/danielsz/boot-autoprefixer) - add vendor prefixes to your CSS
- [boot-reload](https://github.com/adzerk-oss/boot-reload) - live-reload of browser css, images, etc.


id: log4brains
git_filename: src/site/generators/log4brains.md
format: md
field_title: Log4brains
field_repo: thomvaill/log4brains
field_homepage: https://github.com/thomvaill/log4brains
field_language: JavaScript
field_license: Apache-2.0
field_templates: Markdown
data:
{"title": "Log4brains", "repo": "thomvaill/log4brains", "homepage": "https://github.com/thomvaill/log4brains", "language": ["JavaScript"], "license": ["Apache-2.0"], "templates": ["Markdown"], "description": "Docs-as-code knowledge base to manage Architecture Decision Records (ADR) for your project and publish them automatically as a static website", "body": "Log4brains is a docs-as-code knowledge base for your development and infrastructure projects.\nIt enables you to write and manage [Architecture Decision Records](https://adr.github.io/) (ADR) right from your IDE, and to publish them automatically as a static website.\n\nIt performs Static Site Generation from markdown files thanks to [Next.js](https://jamstack.org/generators/next/).\n\n## Install\n\nFrom your project's root directory:\n\n```sh\nnpm install -g log4brains\nlog4brains init\n```\n\n## Local preview\n\n```sh\nlog4brains preview\n```\n\n## Build and deploy\n\n```sh\nlog4brains build\n```\n\nSee [Log4brains documentation](https://github.com/thomvaill/log4brains) for more information.\n\n## Example\n\n[Log4brains' own architecture knowledge base](https://thomvaill.github.io/log4brains/adr/)"}

field_description:
Docs-as-code knowledge base to manage Architecture Decision Records (ADR) for your project and publish them automatically as a static website

field_body:
Log4brains is a docs-as-code knowledge base for your development and infrastructure projects.
It enables you to write and manage [Architecture Decision Records](https://adr.github.io/) (ADR) right from your IDE, and to publish them automatically as a static website.

It performs Static Site Generation from markdown files thanks to [Next.js](https://jamstack.org/generators/next/).

## Install

From your project's root directory:

```sh
npm install -g log4brains
log4brains init
```

## Local preview

```sh
log4brains preview
```

## Build and deploy

```sh
log4brains build
```

See [Log4brains documentation](https://github.com/thomvaill/log4brains) for more information.

## Example

[Log4brains' own architecture knowledge base](https://thomvaill.github.io/log4brains/adr/)


id: record-collector
git_filename: src/site/generators/record-collector.md
format: md
field_title: Record Collector
field_repo: krompaco/record-collector
field_homepage: https://record-collector.net/en/
field_language: .Net, C#
field_license: MIT
field_templates: Razor, Markdown, HTML
field_description: A modern .NET static site toolkit.
data:
{"title": "Record Collector", "repo": "krompaco/record-collector", "homepage": "https://record-collector.net/en/", "language": [".Net", "C#"], "license": ["MIT"], "templates": ["Razor", "Markdown", "HTML"], "description": "A modern .NET static site toolkit.", "twitter": "rcssgdotnet", "body": "This project is heavily inspired by Hugo and tries to be somewhat compatible with the same content structure and support parsing of TOML, YAML and JSON front matter.\n\nThe content file layer is converted to C# lists and objects and then used in a regular ASP.NET MVC project which is also where you can work live on both content preview and templating. This means you now can use your existing ASP.NET MVC and C# skills creating static site templates!\n\nIn this setup the generation process work using the WebApplicationFactory from the Microsoft.AspNetCore.Mvc.Testing package so it doesn't have to fall back to a console application or custom web servers for crunching the files and templates which is the norm for static site generation.\n\nEasy to deploy to Netlify and repo also has examples for various Docker Linux scenarios and GitHub Actions.\n\nIt can also run as a regular ASP.NET MVC application with real-time rendering and Hot Reload.\n\nRepo has ready-made frontend setups including Simple.css without any JS or Tailwind CSS with Hotwire (Turbo and Stimulus)."}

field_body:
This project is heavily inspired by Hugo and tries to be somewhat compatible with the same content structure and support parsing of TOML, YAML and JSON front matter.

The content file layer is converted to C# lists and objects and then used in a regular ASP.NET MVC project which is also where you can work live on both content preview and templating. This means you now can use your existing ASP.NET MVC and C# skills creating static site templates!

In this setup the generation process work using the WebApplicationFactory from the Microsoft.AspNetCore.Mvc.Testing package so it doesn't have to fall back to a console application or custom web servers for crunching the files and templates which is the norm for static site generation.

Easy to deploy to Netlify and repo also has examples for various Docker Linux scenarios and GitHub Actions.

It can also run as a regular ASP.NET MVC application with real-time rendering and Hot Reload.

Repo has ready-made frontend setups including Simple.css without any JS or Tailwind CSS with Hotwire (Turbo and Stimulus).


id: wok
git_filename: src/site/generators/wok.md
format: md
field_title: wok
field_repo: mythmon/wok
field_homepage: http://wok.mythmon.com/
field_language: Python
field_license: MIT
field_templates: Jinja2
field_description: Toss some content, templates, and media in a pan and fry it up!
data:
{"title": "wok", "repo": "mythmon/wok", "homepage": "http://wok.mythmon.com/", "language": ["Python"], "license": ["MIT"], "templates": ["Jinja2"], "description": "Toss some content, templates, and media in a pan and fry it up!", "body": "Wok is similar in concept to other static site generators, like Jekyll, Hyde,\nand nanoc, but different in a few ways, like a page/subpage category system,\nand a restricted focus of features. For example, instead of providing tools to\ngenerate RSS feeds directly, the tools that are needed to build a generic XML\ndocument are provided.\n\nWok offers:\n\n- Content and presentation are separated\n- Markdown, reStructuredText, and plain text renders\n- Jinja2-based templating system\n- Optional syntax highlighting via Pygments\n- Tagging and a hierarchical category system\n- Simple development server\n- Pagination support\n- Custom Python hooks that run during site generation"}

field_body:
Wok is similar in concept to other static site generators, like Jekyll, Hyde,
and nanoc, but different in a few ways, like a page/subpage category system,
and a restricted focus of features. For example, instead of providing tools to
generate RSS feeds directly, the tools that are needed to build a generic XML
document are provided.

Wok offers:

- Content and presentation are separated
- Markdown, reStructuredText, and plain text renders
- Jinja2-based templating system
- Optional syntax highlighting via Pygments
- Tagging and a hierarchical category system
- Simple development server
- Pagination support
- Custom Python hooks that run during site generation


id: onessg
git_filename: src/site/generators/onessg.md
format: md
field_title: onessg
field_repo: RyanZim/onessg
field_homepage: https://github.com/RyanZim/onessg
field_language: JavaScript
field_license: MIT
field_templates: Any JS
field_description: The Static Site Generator that does only one thing: compile your html and markdown.
data:
{"title": "onessg", "repo": "RyanZim/onessg", "homepage": "https://github.com/RyanZim/onessg", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Any JS"], "description": "The Static Site Generator that does only one thing: compile your html and markdown.", "body": "onessg (One Static Site Generator) is the Static Site Generator that does only one thing: compile your html and markdown. It won't minify your JS, concat your CSS, or optimize your images. Why? You most likely already have a favorite tool for doing that.\n\n> The Javascript pendulum has swung from restrictive, monolithic frameworks to modular, boilerplate-hindered libraries.\n>\n> -- [@ericclemmons](https://medium.com/@ericclemmons/javascript-fatigue-48d4011b6fc4#.7xcwmnave)\n\nonessg changes that. We believe in the unix philosophy: do one thing and do it well.\n\nWe also believe in setting useful, but overridable defaults. Because of this, onessg requires no configuration files to get started."}

field_body:
onessg (One Static Site Generator) is the Static Site Generator that does only one thing: compile your html and markdown. It won't minify your JS, concat your CSS, or optimize your images. Why? You most likely already have a favorite tool for doing that.

> The Javascript pendulum has swung from restrictive, monolithic frameworks to modular, boilerplate-hindered libraries.
>
> -- [@ericclemmons](https://medium.com/@ericclemmons/javascript-fatigue-48d4011b6fc4#.7xcwmnave)

onessg changes that. We believe in the unix philosophy: do one thing and do it well.

We also believe in setting useful, but overridable defaults. Because of this, onessg requires no configuration files to get started.


id: kaktos
git_filename: src/site/generators/kaktos.md
format: md
field_title: Kaktos
field_repo: paulocoutinhox/kaktos
field_homepage: https://kaktos.netlify.app/
field_language: Python
field_license: MIT
field_templates: Jinja2
field_description: Kaktos is a python static site generator
field_startertemplaterepo: https://github.com/paulocoutinhox/kaktos
data:
{"title": "Kaktos", "repo": "paulocoutinhox/kaktos", "homepage": "https://kaktos.netlify.app/", "language": ["Python"], "license": ["MIT"], "templates": ["Jinja2"], "startertemplaterepo": "https://github.com/paulocoutinhox/kaktos", "description": "Kaktos is a python static site generator", "body": "Kaktos is a python static site generator.\n\n- The idea is create a simple static site generator for people that don't need server-side languages.\n- Designers can use it too, since it don't need people that know a programming language.\n- Easy extendable to include new features.\n\n### Features\n\nKaktos currently supports:\n\n- Any css/javascript framework\n- Command line interface to execute everything\n- Easy deploy to Netlify\n- Easy deploy to AWS Amplify\n- Don't require any framework\n- Create any kind of site or blog"}

field_body:
Kaktos is a python static site generator.

- The idea is create a simple static site generator for people that don't need server-side languages.
- Designers can use it too, since it don't need people that know a programming language.
- Easy extendable to include new features.

### Features

Kaktos currently supports:

- Any css/javascript framework
- Command line interface to execute everything
- Easy deploy to Netlify
- Easy deploy to AWS Amplify
- Don't require any framework
- Create any kind of site or blog


id: hydephp
git_filename: src/site/generators/hydephp.md
format: md
field_title: HydePHP
field_repo: hydephp/hyde
field_homepage: https://hydephp.com
field_language: PHP
field_license: MIT
field_templates: Blade, Markdown
field_description: Elegant and Powerful Static Site Generator
data:
{"title": "HydePHP", "repo": "hydephp/hyde", "homepage": "https://hydephp.com", "language": ["PHP"], "license": ["MIT"], "templates": ["Blade, Markdown"], "description": "Elegant and Powerful Static Site Generator", "twitter": "HydeFramework", "body": "Create websites, blogs, documentation sites, and more, with the power of Laravel and the simplicity of Markdown. Your next website is minutes away from becoming a reality.\n\n### About HydePHP\n\nHydePHP is a content-first Laravel-powered console application that allows you to create static HTML pages, blog posts, and documentation sites,\nusing your choice of Markdown and/or Blade - the tools you already know and love.\n\nBuild sites in record-time with a full batteries-included TailwindCSS frontend that just works without any fuzz.\n\n### Speed & simplicity first, full control when you need it.\n\nHyde is all about letting you get started quickly by giving you a full-featured frontend starter kit, while also giving you the power and freedom of doing things the way you want to.\n\nMarkdown purist? That's all you need. Blade artisan? Go for it.\nHyde comes with hand-crafted frontend templates, so you can focus on your content.\nYou don't _need_ to customize anything. But you _can_ customize everything.\n\nSee the documentation and learn more at https://hydephp.com/docs\n\n\n## Features\n\n### Content Creation\n\n- Create blog posts using Markdown and Front Matter.\n- Create documentation pages from plain Markdown, no front matter needed!\n- Create simple pages using Markdown, or create advanced ones using Laravel Blade.\n- You can scaffold blog posts and Markdown pages to automatically fill in the front matter.\n- You can also scaffold Blade pages to automatically use the default layout.\n\n### Built-in Frontend\n\n- Hyde comes with a TailwindCSS starter kit, so you can start making content right away.\n- The starter kit is fully responsive, has a dark mode theme, and is customizable.\n- The frontend is accessible to screen-readers and rich with semantic HTML and microdata.\n- Hyde automatically chooses the right layout to use depending on the content being rendered.\n- Hyde also fills in and creates content like navigation menus and sidebars automatically.\n\n### Easy Asset Managing\n\n- The Hyde starter comes with [HydeFront](https://github.com/hydephp/hydefront) to serve the base stylesheet and JavaScript through the jsDelivr CDN.\n- Hyde ships with precompiled and minified TailwindCSS styles in the app.css file, you can also load them through the CDN.\n- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run dev` command to recompile the styles using the pre-configured Laravel Mix package.\n\n### Customization\n\n- You don't need to configure anything as Hyde is shipped with sensible defaults.\n- You can, however, customize nearly everything. Here are just a few out of many examples:\n- All frontend components and page layouts are created with Blade, so you\n  can publish the vendor views, just like in Laravel.\n- Override many of the dynamic content features like the menus and footer.\n\n\n## Getting Started - High-level overview\n\n> See [Installation Guide](https://hydephp.com/docs/1.x/installation) and [Getting Started](https://hydephp.com/docs/1.x/getting-started) for the full details.\n\nIt's a breeze to get started with Hyde. Create a new Hyde project using Composer:\n\n```bash\ncomposer create-project hyde/hyde\n```\n\nNext, place your Markdown files in one of the content directories:  `_posts`, `_docs`, and `_pages` which also accepts Blade files. You can also use the `hyde:make` commands to scaffold them.\n\nWhen you're ready, run the build command to compile your static site which will save your HTML files in the `_site` directory.\n\n```bash\nphp hyde build\n```"}

field_body:
Create websites, blogs, documentation sites, and more, with the power of Laravel and the simplicity of Markdown. Your next website is minutes away from becoming a reality.

### About HydePHP

HydePHP is a content-first Laravel-powered console application that allows you to create static HTML pages, blog posts, and documentation sites,
using your choice of Markdown and/or Blade - the tools you already know and love.

Build sites in record-time with a full batteries-included TailwindCSS frontend that just works without any fuzz.

### Speed & simplicity first, full control when you need it.

Hyde is all about letting you get started quickly by giving you a full-featured frontend starter kit, while also giving you the power and freedom of doing things the way you want to.

Markdown purist? That's all you need. Blade artisan? Go for it.
Hyde comes with hand-crafted frontend templates, so you can focus on your content.
You don't _need_ to customize anything. But you _can_ customize everything.

See the documentation and learn more at https://hydephp.com/docs


## Features

### Content Creation

- Create blog posts using Markdown and Front Matter.
- Create documentation pages from plain Markdown, no front matter needed!
- Create simple pages using Markdown, or create advanced ones using Laravel Blade.
- You can scaffold blog posts and Markdown pages to automatically fill in the front matter.
- You can also scaffold Blade pages to automatically use the default layout.

### Built-in Frontend

- Hyde comes with a TailwindCSS starter kit, so you can start making content right away.
- The starter kit is fully responsive, has a dark mode theme, and is customizable.
- The frontend is accessible to screen-readers and rich with semantic HTML and microdata.
- Hyde automatically chooses the right layout to use depending on the content being rendered.
- Hyde also fills in and creates content like navigation menus and sidebars automatically.

### Easy Asset Managing

- The Hyde starter comes with [HydeFront](https://github.com/hydephp/hydefront) to serve the base stylesheet and JavaScript through the jsDelivr CDN.
- Hyde ships with precompiled and minified TailwindCSS styles in the app.css file, you can also load them through the CDN.
- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run dev` command to recompile the styles using the pre-configured Laravel Mix package.

### Customization

- You don't need to configure anything as Hyde is shipped with sensible defaults.
- You can, however, customize nearly everything. Here are just a few out of many examples:
- All frontend components and page layouts are created with Blade, so you
  can publish the vendor views, just like in Laravel.
- Override many of the dynamic content features like the menus and footer.


## Getting Started - High-level overview

> See [Installation Guide](https://hydephp.com/docs/1.x/installation) and [Getting Started](https://hydephp.com/docs/1.x/getting-started) for the full details.

It's a breeze to get started with Hyde. Create a new Hyde project using Composer:

```bash
composer create-project hyde/hyde
```

Next, place your Markdown files in one of the content directories:  `_posts`, `_docs`, and `_pages` which also accepts Blade files. You can also use the `hyde:make` commands to scaffold them.

When you're ready, run the build command to compile your static site which will save your HTML files in the `_site` directory.

```bash
php hyde build
```


id: makestaticsite
git_filename: src/site/generators/makestaticsite.md
format: md
field_title: MakeStaticSite
field_repo: paultraf/makestaticsite
field_homepage: https://makestaticsite.sh/
field_language: Bash
field_license: AGPL-3.0-only
field_description: Generate and deploy static websites with Bash.
data:
{"title": "MakeStaticSite", "repo": "paultraf/makestaticsite", "homepage": "https://makestaticsite.sh/", "language": ["Bash"], "license": ["AGPL-3.0-only"], "templates": [], "description": "Generate and deploy static websites with Bash.", "body": "A set of Bash scripts to generate static snapshots of (dynamic) websites,\nrefine and deploy them using Wget and other open source tools.\n\nFeatures:\n\n- A straightforward command line interface\n- A setup script that guides users through the creation of a configuration file\nthrough a simple interactive dialogue; manual editing is not required\n- Support for multiple sites, each with custom settings defined in their own\nconfiguration file (multiple config files can also be used for any given site).\n- Suitable for batch processes, allowing operations to be scaled up so that any\nor all of the sites are updated in one process.\n- Support for CMS logins, which paves the way for converting your existing site\nwhilst maintaining the WordPress installation in situ.\n- Runtime options, such as verbosity, to configure the level of output; and\nwhether to archive each build\n- Option of providing a downloadable copy of the entire site as a zip file\nwhich can be used offline, e.g., off a memory stick, making your site portable.\n- Local and remote (server) deployment options, including rsync over ssh and\nNetlify.\n- For WordPress installations, WP-CLI is used to prepare the site for mirroring\nplus a drop-in search replacement (WP Offline Search plugin) that works\noffline.\n- Snippets \u2013 an experimental facility to tweak any page and provide offline\nvariants using chunks of HTML.\n- Support for custom attributes using post-processing \u2013 by creating a list of\nURLs unaccounted for and then re-running Wget on them\n- W3C standards compliance. Whilst this really depends on the source, pages may\nbe cleaned up by HTML Tidy. The system also generates a sitemap XML and\nrobots.txt file to match the outputted files."}

field_body:
A set of Bash scripts to generate static snapshots of (dynamic) websites,
refine and deploy them using Wget and other open source tools.

Features:

- A straightforward command line interface
- A setup script that guides users through the creation of a configuration file
through a simple interactive dialogue; manual editing is not required
- Support for multiple sites, each with custom settings defined in their own
configuration file (multiple config files can also be used for any given site).
- Suitable for batch processes, allowing operations to be scaled up so that any
or all of the sites are updated in one process.
- Support for CMS logins, which paves the way for converting your existing site
whilst maintaining the WordPress installation in situ.
- Runtime options, such as verbosity, to configure the level of output; and
whether to archive each build
- Option of providing a downloadable copy of the entire site as a zip file
which can be used offline, e.g., off a memory stick, making your site portable.
- Local and remote (server) deployment options, including rsync over ssh and
Netlify.
- For WordPress installations, WP-CLI is used to prepare the site for mirroring
plus a drop-in search replacement (WP Offline Search plugin) that works
offline.
- Snippets – an experimental facility to tweak any page and provide offline
variants using chunks of HTML.
- Support for custom attributes using post-processing – by creating a list of
URLs unaccounted for and then re-running Wget on them
- W3C standards compliance. Whilst this really depends on the source, pages may
be cleaned up by HTML Tidy. The system also generates a sitemap XML and
robots.txt file to match the outputted files.


id: rosid
git_filename: src/site/generators/rosid.md
format: md
field_title: Rosid
field_repo: electerious/Rosid
field_homepage: http://rosid.electerious.com/
field_language: JavaScript
field_license: MIT
field_templates: Any JS
field_description: Just-in-time development server and static site exporter.
data:
{"title": "Rosid", "repo": "electerious/Rosid", "homepage": "http://rosid.electerious.com/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Any JS"], "description": "Just-in-time development server and static site exporter.", "body": "Just-in-time development server and static site exporter written in Node.js. Rosid invokes functions before serving files to the browser. This allows you to pre-process anything on-the-fly, without saving it.\n\n### What is Rosid?\n\nRosid is a framework that focus on two features:\n\n1. A **development server with live-reloading**, which transforms files as soon as you request them.\n2. A **static site generator**, which transforms files using defined transform-functions.\n\n### Why Rosid?\n\n- It doesn't force you to use a defined directory structure\n- It's build on popular modules like [Browsersync](https://www.browsersync.io)\n- It integrates nicely with tools you are are already using to transform your files (e.g. [Gulp](http://gulpjs.com), [Grunt](http://gruntjs.com) or Vanilla JS)\n- It's lightweight and only includes what it really needs\n- Transformed files don't need to be saved along their source files\n- It lets you compile code to static files to host them anywhere\n\n### How does it work?\n\nRosid starts a server and compares requested URLs with user-defined patterns. A associated file handler will be executed when a pattern matches. The handler receives information about the request and can transform the file, which will be send to the browser."}

field_body:
Just-in-time development server and static site exporter written in Node.js. Rosid invokes functions before serving files to the browser. This allows you to pre-process anything on-the-fly, without saving it.

### What is Rosid?

Rosid is a framework that focus on two features:

1. A **development server with live-reloading**, which transforms files as soon as you request them.
2. A **static site generator**, which transforms files using defined transform-functions.

### Why Rosid?

- It doesn't force you to use a defined directory structure
- It's build on popular modules like [Browsersync](https://www.browsersync.io)
- It integrates nicely with tools you are are already using to transform your files (e.g. [Gulp](http://gulpjs.com), [Grunt](http://gruntjs.com) or Vanilla JS)
- It's lightweight and only includes what it really needs
- Transformed files don't need to be saved along their source files
- It lets you compile code to static files to host them anywhere

### How does it work?

Rosid starts a server and compares requested URLs with user-defined patterns. A associated file handler will be executed when a pattern matches. The handler receives information about the request and can transform the file, which will be send to the browser.


id: sveltekit
git_filename: src/site/generators/sveltekit.md
format: md
field_title: SvelteKit
field_repo: sveltejs/kit
field_homepage: https://kit.svelte.dev/
field_language: JavaScript
field_license: MIT
field_templates: Svelte
data:
{"title": "SvelteKit", "repo": "sveltejs/kit", "homepage": "https://kit.svelte.dev/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Svelte"], "description": "SvelteKit is an application framework powered by Svelte \u2014 build bigger apps with a smaller footprint.", "body": "SvelteKit is a framework for building web applications of all sizes, with a beautiful development experience and flexible filesystem-based routing. [Read the guide](https://kit.svelte.dev/docs) or the [introductory blog post](https://svelte.dev/blog/whats-the-deal-with-sveltekit) to learn more.\n\nAll the SEO and progressive enhancement of a server-rendered app, with the slick navigation of an SPA.\n\nIt's the successor to Sapper. It's like Next.js and Nuxt.js, but faster and smaller because it's powered by [Svelte](https://svelte.dev)."}

field_description:
SvelteKit is an application framework powered by Svelte — build bigger apps with a smaller footprint.

field_body:
SvelteKit is a framework for building web applications of all sizes, with a beautiful development experience and flexible filesystem-based routing. [Read the guide](https://kit.svelte.dev/docs) or the [introductory blog post](https://svelte.dev/blog/whats-the-deal-with-sveltekit) to learn more.

All the SEO and progressive enhancement of a server-rendered app, with the slick navigation of an SPA.

It's the successor to Sapper. It's like Next.js and Nuxt.js, but faster and smaller because it's powered by [Svelte](https://svelte.dev).


id: routify
git_filename: src/site/generators/routify.md
format: md
field_title: Routify
field_repo: roxiness/routify
field_homepage: https://routify.dev
field_language: JavaScript
field_license: MIT
field_templates: Svelte
field_description: Routes for Svelte, automated by your file structure.
field_startertemplaterepo: https://github.com/roxiness/routify-starter
data:
{"title": "Routify", "repo": "roxiness/routify", "homepage": "https://routify.dev", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Svelte"], "description": "Routes for Svelte, automated by your file structure.", "startertemplaterepo": "https://github.com/roxiness/routify-starter", "twitter": "routifyjs", "body": "Routify offers a great developer experience to build the routes for your Svelte app.\n\n# Hit the ground running\nNo need to configure a single route. Routes are generated from file structure.\n\n# Scoped everything\nLayouts, helpers, props, fallbacks, you name it. It's all scoped and context-aware.\n\n# Page transitions\nRoute-level page transitions for that native app feel.\n\n# Single source of truth\nIf `/recipes/cupcakes` doesn't exist in your browser, it doesn't exist in your project. That's easy debugging.\n\n# Resets\nSometimes you don't want everything to be scoped. Maybe you don't want `/restaurants/burger-queen` to inherit any layout.\n\n# And more...\nSSR, meta tags, code-splitting, real-time route generation... and more!."}

field_body:
Routify offers a great developer experience to build the routes for your Svelte app.

# Hit the ground running
No need to configure a single route. Routes are generated from file structure.

# Scoped everything
Layouts, helpers, props, fallbacks, you name it. It's all scoped and context-aware.

# Page transitions
Route-level page transitions for that native app feel.

# Single source of truth
If `/recipes/cupcakes` doesn't exist in your browser, it doesn't exist in your project. That's easy debugging.

# Resets
Sometimes you don't want everything to be scoped. Maybe you don't want `/restaurants/burger-queen` to inherit any layout.

# And more...
SSR, meta tags, code-splitting, real-time route generation... and more!.


id: octopress
git_filename: src/site/generators/octopress.md
format: md
field_title: Octopress
field_repo: octopress/octopress
field_homepage: http://octopress.org
field_language: Ruby
field_license: MIT
field_templates: Liquid
field_description: A blogging framework for hackers based on Jekyll.
data:
{"title": "Octopress", "repo": "octopress/octopress", "homepage": "http://octopress.org", "language": ["Ruby"], "license": ["MIT"], "templates": ["Liquid"], "description": "A blogging framework for hackers based on Jekyll.", "twitter": "octopress", "body": "Octopress is Jekyll blogging at its finest.\n\n- Octopress sports a clean responsive theme written in semantic HTML5, focused on readability and friendliness toward mobile devices.\n- Code blogging is easy and beautiful. Embed code (with Solarized styling) in your posts from gists, jsFiddle or from your filesystem.\n- Third party integration is simple with built-in support for Pinboard, Delicious, GitHub Repositories, Disqus Comments and Google Analytics.\n- It's easy to use. A collection of rake tasks simplifies development and makes deploying a cinch.\n- Ships with great plug-ins some original and others from the Jekyll community \u2014 tested and improved."}

field_body:
Octopress is Jekyll blogging at its finest.

- Octopress sports a clean responsive theme written in semantic HTML5, focused on readability and friendliness toward mobile devices.
- Code blogging is easy and beautiful. Embed code (with Solarized styling) in your posts from gists, jsFiddle or from your filesystem.
- Third party integration is simple with built-in support for Pinboard, Delicious, GitHub Repositories, Disqus Comments and Google Analytics.
- It's easy to use. A collection of rake tasks simplifies development and makes deploying a cinch.
- Ships with great plug-ins some original and others from the Jekyll community — tested and improved.


id: photish
git_filename: src/site/generators/photish.md
format: md
field_title: Photish
field_repo: henrylawson/photish
field_homepage: https://github.com/henrylawson/photish
field_language: Ruby
field_license: MIT
field_templates: Slim
field_description: Fast, simple, configurable photo portfolio website generator.
data:
{"title": "Photish", "repo": "henrylawson/photish", "homepage": "https://github.com/henrylawson/photish", "language": ["Ruby"], "license": ["MIT"], "templates": ["Slim"], "description": "Fast, simple, configurable photo portfolio website generator.", "body": "Photish is a simple, convention based (but configurable) static photo site generator. Photish allows you to group your photo collections by folder. Metadata can be written alongside the photo in a [YAML](http://yaml.org/) file with the same name as the photo.\n\nPhotish will crawl through your directory of photos and metadata, and render the information in your website templates. Photish supports all template engines implemented by [Tilt](https://github.com/rtomayko/tilt) (currently over 30 formats). It will also read your configuration and automatically convert your images to your configured size, dimensions, colourscheme, etc using [ImageMagick](http://www.imagemagick.org/script/index.php). Using this information, Photish creates a complete static website that can be hosted on an [NGINX](http://nginx.org/), [Apache HTTP Server](https://httpd.apache.org/), or even on [Github Pages](https://pages.github.com/).\n\nPhotish has been created with speed and efficiency in mind. Threads are used to parallelize image transcoding to achieve maximum utilization of your CPU during generation. A cache file is then used to ensure that unless the image has changed, it is not needlessly regenerated. This results in a responsive and fast local development environment, making it easy to perfect the design of your photo based website without having to wait for regeneration."}

field_body:
Photish is a simple, convention based (but configurable) static photo site generator. Photish allows you to group your photo collections by folder. Metadata can be written alongside the photo in a [YAML](http://yaml.org/) file with the same name as the photo.

Photish will crawl through your directory of photos and metadata, and render the information in your website templates. Photish supports all template engines implemented by [Tilt](https://github.com/rtomayko/tilt) (currently over 30 formats). It will also read your configuration and automatically convert your images to your configured size, dimensions, colourscheme, etc using [ImageMagick](http://www.imagemagick.org/script/index.php). Using this information, Photish creates a complete static website that can be hosted on an [NGINX](http://nginx.org/), [Apache HTTP Server](https://httpd.apache.org/), or even on [Github Pages](https://pages.github.com/).

Photish has been created with speed and efficiency in mind. Threads are used to parallelize image transcoding to achieve maximum utilization of your CPU during generation. A cache file is then used to ensure that unless the image has changed, it is not needlessly regenerated. This results in a responsive and fast local development environment, making it easy to perfect the design of your photo based website without having to wait for regeneration.


id: ago
git_filename: src/site/generators/ago.md
format: md
field_title: Ago
field_repo: dvwallin/ago
field_homepage: https://github.com/dvwallin/ago
field_language: Go
field_license: MIT
field_description: A static blog generator script without any fuzz
data:
{"title": "Ago", "repo": "dvwallin/ago", "homepage": "https://github.com/dvwallin/ago", "language": ["Go"], "license": ["MIT"], "templates": [], "description": "A static blog generator script without any fuzz", "body": "## What's Ago?\n\nAgo is a small static blog generator without any fuzz. It's stupidly simple, not at all built upon any of the fanciest algorithms or the most widely tested libraries. It's small, simple and works!\n\n### Features\n\n- Create and write new posts\n- Configure domain, name, author and a few more fields\n- Transpile markdown posts into html files\n- Atom and RSS -feeds are generated when running -transpile\n- Basic proper html5 semantics\n- 100/100 pagespeed results\n- No ability what so ever to affect the layout\n- You can modify the css file but it'll be overwritten on next transpile"}

field_body:
## What's Ago?

Ago is a small static blog generator without any fuzz. It's stupidly simple, not at all built upon any of the fanciest algorithms or the most widely tested libraries. It's small, simple and works!

### Features

- Create and write new posts
- Configure domain, name, author and a few more fields
- Transpile markdown posts into html files
- Atom and RSS -feeds are generated when running -transpile
- Basic proper html5 semantics
- 100/100 pagespeed results
- No ability what so ever to affect the layout
- You can modify the css file but it'll be overwritten on next transpile


id: stati
git_filename: src/site/generators/stati.md
format: md
field_title: Stati
field_repo: jfoucher/stati
field_homepage: https://stati.jfoucher.com
field_language: PHP
field_license: MIT
field_templates: Liquid
field_description: Stati is an extensible PHP static site generator that can work with existing Jekyll sites.
data:
{"title": "Stati", "repo": "jfoucher/stati", "homepage": "https://stati.jfoucher.com", "language": ["PHP"], "license": ["MIT"], "templates": ["Liquid"], "description": "Stati is an extensible PHP static site generator that can work with existing Jekyll sites.", "body": "Stati is an extensible PHP static site generator that can generate your existing Jekyll sites.\n\nJekyll is one of the most popular static site generator, but unfortunately for those of\nus not proficient in ruby, it cannot be extended that easily.\n\nStati solves that, with it's clear plugin architecture based on the Symfony Event Dispatcher component, your plugin can hook\nat various points in the site generation lifecycle to modify the output any way you can dream of.\n\nBuilt on Symfony components, it is robust, and while not as fast as Jekyll, it should be bearable for most purposes.\n\nThis is still at an early stage of develompent, but it should already be able to build most Jekyll sites."}

field_body:
Stati is an extensible PHP static site generator that can generate your existing Jekyll sites.

Jekyll is one of the most popular static site generator, but unfortunately for those of
us not proficient in ruby, it cannot be extended that easily.

Stati solves that, with it's clear plugin architecture based on the Symfony Event Dispatcher component, your plugin can hook
at various points in the site generation lifecycle to modify the output any way you can dream of.

Built on Symfony components, it is robust, and while not as fast as Jekyll, it should be bearable for most purposes.

This is still at an early stage of develompent, but it should already be able to build most Jekyll sites.


id: blacksmith
git_filename: src/site/generators/blacksmith.md
format: md
field_title: Blacksmith
field_repo: flatiron/blacksmith
field_homepage: https://github.com/flatiron/blacksmith
field_language: JavaScript
field_license: MIT
field_templates: Plates
field_description: A generic static site generator built using flatiron, plates, and marked.
data:
{"title": "Blacksmith", "repo": "flatiron/blacksmith", "homepage": "https://github.com/flatiron/blacksmith", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Plates"], "description": "A generic static site generator built using flatiron, plates, and marked.", "body": "A generic static site generator built using `flatiron`, `plates`, and `marked`.\n\nBlacksmith sites have a specific directory structure for storing the various parts of your site: settings, layout, partials, pages, and content. Content exists in two forms:\n\n- Markdown files that `blacksmith` will render.\n- Supporting content such as css and images.\n\nAll content will be rendered into `/public`. To render a blacksmith site:\n\n### Components\n\nEach `blacksmith` site defines a hierarchical set of components which can be composed **to create any type of site you want!** A couple of examples:\n\n- A Blog\n- A Documentation Site\n- A Custom Splash Page or Content Site"}

field_body:
A generic static site generator built using `flatiron`, `plates`, and `marked`.

Blacksmith sites have a specific directory structure for storing the various parts of your site: settings, layout, partials, pages, and content. Content exists in two forms:

- Markdown files that `blacksmith` will render.
- Supporting content such as css and images.

All content will be rendered into `/public`. To render a blacksmith site:

### Components

Each `blacksmith` site defines a hierarchical set of components which can be composed **to create any type of site you want!** A couple of examples:

- A Blog
- A Documentation Site
- A Custom Splash Page or Content Site


id: kart
git_filename: src/site/generators/kart.md
format: md
field_title: Kart
field_repo: giacomocaironi/Kart
field_homepage: https://github.com/giacomocaironi/Kart/
field_language: Python
field_license: MIT
field_templates: Jinja2
field_description: A very flexible static site generator written in python.
data:
{"title": "Kart", "repo": "giacomocaironi/Kart", "homepage": "https://github.com/giacomocaironi/Kart/", "language": ["Python"], "license": ["MIT"], "templates": ["Jinja2"], "description": "A very flexible static site generator written in python.", "body": "Kart is designed with flexibility in mind, allowing the user to modify and personalize every aspect of the site generation"}

field_body:
Kart is designed with flexibility in mind, allowing the user to modify and personalize every aspect of the site generation


id: statie
git_filename: src/site/generators/statie.md
format: md
field_title: Statie
field_repo: Symplify/Statie
field_homepage: https://www.statie.org
field_language: PHP
field_license: MIT
field_templates: Twig, Latte
field_description: Modern and Simple Static Site Generator in PHP
data:
{"title": "Statie", "repo": "Symplify/Statie", "homepage": "https://www.statie.org", "language": ["PHP"], "license": ["MIT"], "templates": ["Twig", "Latte"], "description": "Modern and Simple Static Site Generator in PHP", "body": "Modern and Simple Static Site Generator in PHP\n\nStatie takes HTML, Markdown and Twig or Latte files and generates static HTML page."}

field_body:
Modern and Simple Static Site Generator in PHP

Statie takes HTML, Markdown and Twig or Latte files and generates static HTML page.


id: bake
git_filename: src/site/generators/bake.md
format: md
field_title: Bake
field_repo: felipetavares/bake
field_homepage: http://ctrl-c.club/~philips/90s/
field_language: C++
field_license: WTFPL
field_templates: HTML
field_description: The blogging tool for minimalists & make lovers.
data:
{"title": "Bake", "repo": "felipetavares/bake", "homepage": "http://ctrl-c.club/~philips/90s/", "language": ["C++"], "license": ["WTFPL"], "templates": ["HTML"], "description": "The blogging tool for minimalists & make lovers.", "body": "Bake is a tool for generating blogs as if you were using make.\nCreate a template, a bakefile and your markdown posts and you are ready to bake!\n\n### Philosophy\n\nTo be as simple as:\n\n    vim post.markdown\n    bake"}

field_body:
Bake is a tool for generating blogs as if you were using make.
Create a template, a bakefile and your markdown posts and you are ready to bake!

### Philosophy

To be as simple as:

    vim post.markdown
    bake


id: remix
git_filename: src/site/generators/remix.md
format: md
field_title: Remix
field_repo: remix-run/remix
field_homepage: https://remix.run/
field_language: JavaScript
field_license: MIT
field_templates: React
field_description: Build Better Websites. Create modern, resilient user experiences with web fundamentals.
field_startertemplaterepo: https://github.com/netlify-templates/remix-admin-template
data:
{"title": "Remix", "repo": "remix-run/remix", "homepage": "https://remix.run/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["React"], "description": "Build Better Websites. Create modern, resilient user experiences with web fundamentals.", "startertemplaterepo": "https://github.com/netlify-templates/remix-admin-template", "twitter": "remix_run", "body": "[Remix](https://remix.run) is a full stack web framework that lets you focus on the user interface and work back through web fundamentals to deliver a fast, slick, and resilient user experience that deploys to any Node.js server and even non-Node.js environments at the edge like Cloudflare Workers.\n\nWant to know more? Read the [Technical Explanation of Remix](https://remix.run/discussion/introduction).\n\n## Documentation\n\n[Remix Documentation](https://remix.run/docs).\n\nRemix [community on Discord](https://rmx.as/discord).\n\n## Contributing\n\nIf you're interested in contributing code and/or documentation, please see [contributing guide](https://remix.run/guides/contributing)."}

field_body:
[Remix](https://remix.run) is a full stack web framework that lets you focus on the user interface and work back through web fundamentals to deliver a fast, slick, and resilient user experience that deploys to any Node.js server and even non-Node.js environments at the edge like Cloudflare Workers.

Want to know more? Read the [Technical Explanation of Remix](https://remix.run/discussion/introduction).

## Documentation

[Remix Documentation](https://remix.run/docs).

Remix [community on Discord](https://rmx.as/discord).

## Contributing

If you're interested in contributing code and/or documentation, please see [contributing guide](https://remix.run/guides/contributing).


id: tumblelog-py
git_filename: src/site/generators/tumblelog-py.md
format: md
field_title: tumblelog
field_repo: john-bokma/tumblelog
field_homepage: http://johnbokma.com/articles/tumblelog/
field_language: Python
field_license: MIT
field_templates: HTML
field_description: Simple static site generator with the focus on a tumbleblog
data:
{"title": "tumblelog", "repo": "john-bokma/tumblelog", "homepage": "http://johnbokma.com/articles/tumblelog/", "language": ["Python"], "license": ["MIT"], "templates": ["HTML"], "description": "Simple static site generator with the focus on a tumbleblog", "body": "`tumblelog` is a simple static site generator with the focus on generating a\nrich and complete tumblelog or micro blog with various ways to navigate to\narchived blog posts. `tumblelog` comes with several styles and it's easy to\neither modify an existing one or create your own.\n\nThe input is a single \"Markdown\" file divided into pages by starting a line with\na date followed by a title. Each date page can further be split up into multiple\narticles using a single % on a line by itself.\n\nParameters to control the blog are given via command line arguments. The program\ncreates the blog HTML5 pages and both a JSON and RSS feed.\n\nThe home page has extensive documentation on how to get started and how to have\nyour own blog or site up in a very short time."}

field_body:
`tumblelog` is a simple static site generator with the focus on generating a
rich and complete tumblelog or micro blog with various ways to navigate to
archived blog posts. `tumblelog` comes with several styles and it's easy to
either modify an existing one or create your own.

The input is a single "Markdown" file divided into pages by starting a line with
a date followed by a title. Each date page can further be split up into multiple
articles using a single % on a line by itself.

Parameters to control the blog are given via command line arguments. The program
creates the blog HTML5 pages and both a JSON and RSS feed.

The home page has extensive documentation on how to get started and how to have
your own blog or site up in a very short time.


id: frog
git_filename: src/site/generators/frog.md
format: md
field_title: Frog
field_repo: greghendershott/frog
field_homepage: https://github.com/greghendershott/frog
field_language: Racket
field_license: MIT
field_templates: Racket
field_description: Frog is a static web site generator implemented in Racket, targeting Bootstrap.
data:
{"title": "Frog", "repo": "greghendershott/frog", "homepage": "https://github.com/greghendershott/frog", "language": ["Racket"], "license": ["MIT"], "templates": ["Racket"], "description": "Frog is a static web site generator implemented in Racket, targeting Bootstrap.", "body": "Frog is a static web site generator written in [Racket](http://www.racket-lang.org/).\n\nYou write content in [Markdown](http://daringfireball.net/projects/markdown/syntax) or [Scribble](http://docs.racket-lang.org/scribble/index.html). You generate\nfiles. To deploy, you push them to a GitHub Pages repo (or copy them\nto Amazon S3, or whatever).\n\nPosts get a variety of automatic blog features.\n\nYou can also create non-post pages.\n\nThe generated site uses [Bootstrap](http://getbootstrap.com/), which is [responsive](https://en.wikipedia.org/wiki/Responsive_web_design),\nautomatically adapting to various screen sizes.\n\nYes, it's very much like Octopress and others. But Frog doesn't\nrequire installing Ruby. Installing Racket is typically waaaay\nsimpler and faster.\n\nThe only non-Racket part is optionally using [Pygments](http://pygments.org/) to do syntax\nhighlighting.\n\nQ: \"Frog\"?  \nA: Frozen blog."}

field_body:
Frog is a static web site generator written in [Racket](http://www.racket-lang.org/).

You write content in [Markdown](http://daringfireball.net/projects/markdown/syntax) or [Scribble](http://docs.racket-lang.org/scribble/index.html). 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.

The generated site uses [Bootstrap](http://getbootstrap.com/), which is [responsive](https://en.wikipedia.org/wiki/Responsive_web_design),
automatically adapting to various screen sizes.

Yes, it's very much like Octopress and others. But Frog doesn't
require installing Ruby. Installing Racket is typically waaaay
simpler and faster.

The only non-Racket part is optionally using [Pygments](http://pygments.org/) to do syntax
highlighting.

Q: "Frog"?  
A: Frozen blog.


id: gitbook
git_filename: src/site/generators/gitbook.md
format: md
field_title: GitBook
field_repo: GitbookIO/gitbook
field_homepage: https://www.gitbook.com/
field_language: JavaScript
field_license: Apache-2.0
field_templates: Jinja2
field_description: A modern publishing toolchain. Simply taking you from ideas to finished, polished books.
data:
{"title": "GitBook", "repo": "GitbookIO/gitbook", "homepage": "https://www.gitbook.com/", "language": ["JavaScript"], "license": ["Apache-2.0"], "templates": ["Jinja2"], "description": "A modern publishing toolchain. Simply taking you from ideas to finished, polished books.", "twitter": "GitBookIO", "body": "The easiest way to write a book.\n\n### Write & Publish with Markdown and Git\n\nBooks on GitBook are written using a beautiful editor and published using Git or GitHub.\n\n### Distribute & Sell everywhere\n\nSell your book at the price you want, GitBook can also distribute it on all main marketplaces.\n\n### Analyse & Engage your readers\n\nLearn from your readers using powerful analytics, and engage with them to improve your book's content."}

field_body:
The easiest way to write a book.

### Write & Publish with Markdown and Git

Books on GitBook are written using a beautiful editor and published using Git or GitHub.

### Distribute & Sell everywhere

Sell your book at the price you want, GitBook can also distribute it on all main marketplaces.

### Analyse & Engage your readers

Learn from your readers using powerful analytics, and engage with them to improve your book's content.


id: tapestry
git_filename: src/site/generators/tapestry.md
format: md
field_title: Tapestry
field_repo: tapestry-cloud/tapestry
field_homepage: https://www.tapestry.cloud/
field_language: PHP
field_license: MIT
field_templates: Plates
field_description: Static sites for PHP developers
data:
{"title": "Tapestry", "repo": "tapestry-cloud/tapestry", "homepage": "https://www.tapestry.cloud/", "language": ["PHP"], "license": ["MIT"], "templates": ["Plates"], "description": "Static sites for PHP developers", "body": "## About Tapestry\n\nTapestry is a static site generator that uses the [plates](http://platesphp.com/) template system by the league of extraordinary packages. Tapestry aims to be fast, easy to use and easy to extend. It has been inspired by similar generators [Sculpin](https://sculpin.io/) and [Jigsaw](http://jigsaw.tighten.co/). Tapestry is designed for developers who prefer to use native PHP templates over compiled template languages such as Twig or Blade.\n\n### Highlights\n\n- Native PHP templates with the use of the [plates](http://platesphp.com/) template system\n- [Blog aware](https://www.tapestry.cloud/documentation/your-content/) out of the box\n- Built to be extendable with [plugins](https://www.tapestry.cloud/documentation/working-examples/#plugins)\n\n## Learning Tapestry\n\nThe [Tapestry documentation](https://www.tapestry.cloud/documentation/) provides a thorough insight into the inner workings of Tapestry. Making it as easy as possible to get started generating your sites.\n\n## Installing Tapestry\n\nThe recommended method for installing Tapestry is to grab the latest [zipped release here](https://github.com/carbontwelve/tapestry/releases) and unzip the contents into your `$PATH` to make it globally available from your command line.\n\nFor Windows environments a `.bat` file is included so that you do not have to type `php tapestry.phar` to run Tapestry; for it to work ensure it is kept in the same folder as the `.phar`.\n\nFor alternative methods of installing Tapestry see the [install documentation here](https://www.tapestry.cloud/documentation/installation)."}

field_body:
## About Tapestry

Tapestry is a static site generator that uses the [plates](http://platesphp.com/) template system by the league of extraordinary packages. Tapestry aims to be fast, easy to use and easy to extend. It has been inspired by similar generators [Sculpin](https://sculpin.io/) and [Jigsaw](http://jigsaw.tighten.co/). Tapestry is designed for developers who prefer to use native PHP templates over compiled template languages such as Twig or Blade.

### Highlights

- Native PHP templates with the use of the [plates](http://platesphp.com/) template system
- [Blog aware](https://www.tapestry.cloud/documentation/your-content/) out of the box
- Built to be extendable with [plugins](https://www.tapestry.cloud/documentation/working-examples/#plugins)

## Learning Tapestry

The [Tapestry documentation](https://www.tapestry.cloud/documentation/) provides a thorough insight into the inner workings of Tapestry. Making it as easy as possible to get started generating your sites.

## Installing Tapestry

The recommended method for installing Tapestry is to grab the latest [zipped release here](https://github.com/carbontwelve/tapestry/releases) and unzip the contents into your `$PATH` to make it globally available from your command line.

For Windows environments a `.bat` file is included so that you do not have to type `php tapestry.phar` to run Tapestry; for it to work ensure it is kept in the same folder as the `.phar`.

For alternative methods of installing Tapestry see the [install documentation here](https://www.tapestry.cloud/documentation/installation).


id: docpress
git_filename: src/site/generators/docpress.md
format: md
field_title: Docpress
field_repo: docpress/docpress
field_homepage: http://docpress.github.io
field_language: JavaScript
field_license: MIT
field_templates: Markdown
field_description: Painless Markdown publishing
data:
{"title": "Docpress", "repo": "docpress/docpress", "homepage": "http://docpress.github.io", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Markdown"], "description": "Painless Markdown publishing", "body": "Docpress generates websites from your project's basic documentation; that is, at the very least, a README.md file.\nIt also supports multiple Markdown pages in `docs/`. Checkout our [Homepage](http://docpress.github.io) for a quick example.\n\n## Examples\n\nCheck out the [Docpress Showcase](https://github.com/docpress/docpress/blob/master/docs/showcase.md) to see how Docpress helped developers build great-looking websites.\n\n## Usage\n\nStill under heavy development, consider this a preview.\nSee the [Getting Started](http://docpress.github.io/getting-started/quickstart.html) guide for more details.\n\n```sh\n$ npm install -g docpress\n$ echo \"# My project\" > README.md\n$ echo \"Documented by Markdown files.\" >> README.md\n$ docpress serve\n\n  Docpress\n  starting development - ^C to exit\n\n  350ms \u2713   first build\n      on    watching changes\n      on    livereload\n      on    http://localhost:3000\n\n  Running\n```\n\n## Screenshot\n\n![Screenshot](https://i.imgur.com/eSXOeVw.png)\n\n## Support\n\n- [Documentation](http://docpress.github.io/)\n- [Gitter chat](https://gitter.im/docpress/Lobby)\n\nLet's build our first Docpress site.\n[Quickstart guide \u2192](http://docpress.github.io/getting-started/quickstart.html)\n\n## Thanks\n\n**docpress** \u00a9 2015+, Rico Sta. Cruz. Released under the [MIT] License.<br>\nAuthored and maintained by Rico Sta. Cruz with help from contributors ([list][contributors]).\n\n> [ricostacruz.com](http://ricostacruz.com) &nbsp;&middot;&nbsp;\n> GitHub [@rstacruz](https://github.com/rstacruz) &nbsp;&middot;&nbsp;\n> Twitter [@rstacruz](https://twitter.com/rstacruz)\n\n[mit]: http://mit-license.org/\n[contributors]: http://github.com/rstacruz/docpress/contributors"}

field_body:
Docpress generates websites from your project's basic documentation; that is, at the very least, a README.md file.
It also supports multiple Markdown pages in `docs/`. Checkout our [Homepage](http://docpress.github.io) for a quick example.

## Examples

Check out the [Docpress Showcase](https://github.com/docpress/docpress/blob/master/docs/showcase.md) to see how Docpress helped developers build great-looking websites.

## Usage

Still under heavy development, consider this a preview.
See the [Getting Started](http://docpress.github.io/getting-started/quickstart.html) guide for more details.

```sh
$ npm install -g docpress
$ echo "# My project" > README.md
$ echo "Documented by Markdown files." >> README.md
$ docpress serve

  Docpress
  starting development - ^C to exit

  350ms ✓   first build
      on    watching changes
      on    livereload
      on    http://localhost:3000

  Running
```

## Screenshot

![Screenshot](https://i.imgur.com/eSXOeVw.png)

## Support

- [Documentation](http://docpress.github.io/)
- [Gitter chat](https://gitter.im/docpress/Lobby)

Let's build our first Docpress site.
[Quickstart guide →](http://docpress.github.io/getting-started/quickstart.html)

## Thanks

**docpress** © 2015+, Rico Sta. Cruz. Released under the [MIT] License.<br>
Authored and maintained by Rico Sta. Cruz with help from contributors ([list][contributors]).

> [ricostacruz.com](http://ricostacruz.com) &nbsp;&middot;&nbsp;
> GitHub [@rstacruz](https://github.com/rstacruz) &nbsp;&middot;&nbsp;
> Twitter [@rstacruz](https://twitter.com/rstacruz)

[mit]: http://mit-license.org/
[contributors]: http://github.com/rstacruz/docpress/contributors


id: harp
git_filename: src/site/generators/harp.md
format: md
field_title: Harp
field_repo: sintaxi/harp
field_homepage: http://harpjs.com/
field_language: JavaScript
field_license: MIT
field_templates: EJS, Jade
field_description: Harp is a static web server that can also compile your project down to static assets.
data:
{"title": "Harp", "repo": "sintaxi/harp", "homepage": "http://harpjs.com/", "language": ["JavaScript"], "license": ["MIT"], "templates": ["EJS", "Jade"], "description": "Harp is a static web server that can also compile your project down to static assets.", "twitter": "HarpWebServer", "body": "Harp is a static web server that also serves Jade, Markdown, EJS, Less, Stylus, Sass, and CoffeeScript **as** HTML, CSS, and JavaScript without any configuration. It supports the beloved layout/partial paradigm and it has flexible metadata and global objects for traversing the file system and injecting custom data into templates. Optionally, Harp can also compile your project down to static assets for hosting behind any valid HTTP server.\n\n### Why?\n\nPre-compilers are becoming extremely powerful and shipping front-ends as static assets has many upsides. It's simple, it's easy to maintain, it's low risk, easy to scale, and requires low cognitive overhead. I wanted a lightweight web server that was powerful enough for me to abandon web frameworks for dead simple front-end publishing.\n\n### Features\n\n- easy installation, easy to use\n- fast and lightweight\n- robust (clean urls, intelligent path redirects)\n- built in pre-processing\n- first-class layout and partial support\n- built in LRU caching in production mode\n- can export assets to HTML/CSS/JS\n- does not require a build steps or grunt task\n- fun to use\n\n### Supported Pre-Processors\n\n|                | Language Superset                                                 | Whitespace Sensitive                                                                    |\n| -------------- | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------- |\n| **HTML**       | [EJS](http://embeddedjs.com/)                                     | [Jade](http://jade-lang.com/), [Markdown](http://daringfireball.net/projects/markdown/) |\n| **CSS**        | [LESS](http://lesscss.org/), [Sass (SCSS)](http://sass-lang.com/) | [Stylus](http://learnboost.github.io/stylus/)                                           |\n| **JavaScript** | (TBD)                                                             | [CoffeeScript](http://coffeescript.org/)                                                |\n\n### Resources\n\n- **Server Documentation** - [harpjs.com/docs/](http://harpjs.com/docs/)\n- **Platform Documentation** - [harp.io/docs](https://harp.io/docs)\n- **Source Code** - [github.com/sintaxi/harp](https://github.com/sintaxi/harp)"}

field_body:
Harp is a static web server that also serves Jade, Markdown, EJS, Less, Stylus, Sass, and CoffeeScript **as** HTML, CSS, and JavaScript without any configuration. It supports the beloved layout/partial paradigm and it has flexible metadata and global objects for traversing the file system and injecting custom data into templates. Optionally, Harp can also compile your project down to static assets for hosting behind any valid HTTP server.

### Why?

Pre-compilers are becoming extremely powerful and shipping front-ends as static assets has many upsides. It's simple, it's easy to maintain, it's low risk, easy to scale, and requires low cognitive overhead. I wanted a lightweight web server that was powerful enough for me to abandon web frameworks for dead simple front-end publishing.

### Features

- easy installation, easy to use
- fast and lightweight
- robust (clean urls, intelligent path redirects)
- built in pre-processing
- first-class layout and partial support
- built in LRU caching in production mode
- can export assets to HTML/CSS/JS
- does not require a build steps or grunt task
- fun to use

### Supported Pre-Processors

|                | Language Superset                                                 | Whitespace Sensitive                                                                    |
| -------------- | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **HTML**       | [EJS](http://embeddedjs.com/)                                     | [Jade](http://jade-lang.com/), [Markdown](http://daringfireball.net/projects/markdown/) |
| **CSS**        | [LESS](http://lesscss.org/), [Sass (SCSS)](http://sass-lang.com/) | [Stylus](http://learnboost.github.io/stylus/)                                           |
| **JavaScript** | (TBD)                                                             | [CoffeeScript](http://coffeescript.org/)                                                |

### Resources

- **Server Documentation** - [harpjs.com/docs/](http://harpjs.com/docs/)
- **Platform Documentation** - [harp.io/docs](https://harp.io/docs)
- **Source Code** - [github.com/sintaxi/harp](https://github.com/sintaxi/harp)


id: stog
git_filename: src/site/generators/stog.md
format: md
field_title: Stog
field_homepage: https://www.good-eris.net/stog/
field_language: OCaml
field_license: GPL-3.0-only
field_templates: XML
field_description: Stog is a static blog and website generator, like Jekyll but in OCaml.
data:
{"title": "Stog", "homepage": "https://www.good-eris.net/stog/", "language": ["OCaml"], "license": ["GPL-3.0-only"], "templates": ["XML"], "description": "Stog is a static blog and website generator, like Jekyll but in OCaml.", "body": "Stog is a static web site compiler. It is able to handle blog posts as well are regular pages. It can be seen as a kind of Jekyll developed in OCaml.\n\nThe main features are:\n\n- It is developed in OCaml and can be extended with OCaml plugins,\n- It is based on a XML engine allowing to apply substitutions (rewrite rules) on some tags. Some substitutions are pre-defined, and others can be d\u00e9fined in your documents or added by plugins,\n- It easily supports multi-language sites,\n- It features an online-editor, to be integrated with git,\n- It has an online previewer,\n- A lot of functions can be used to handle sectionning, table of contents, verified cross-references, ...,\n- OCaml code can be interpreted at compilation time and the result included in the generated documents,\n- Some plugins ease the inclusion of graphviz graphs, and pictures generated by Aysmptote or LaTeX,\n- A markdown plugin converts markdown sources."}

field_body:
Stog is a static web site compiler. It is able to handle blog posts as well are regular pages. It can be seen as a kind of Jekyll developed in OCaml.

The main features are:

- It is developed in OCaml and can be extended with OCaml plugins,
- It is based on a XML engine allowing to apply substitutions (rewrite rules) on some tags. Some substitutions are pre-defined, and others can be défined in your documents or added by plugins,
- It easily supports multi-language sites,
- It features an online-editor, to be integrated with git,
- It has an online previewer,
- A lot of functions can be used to handle sectionning, table of contents, verified cross-references, ...,
- OCaml code can be interpreted at compilation time and the result included in the generated documents,
- Some plugins ease the inclusion of graphviz graphs, and pictures generated by Aysmptote or LaTeX,
- A markdown plugin converts markdown sources.


id: elsa
git_filename: src/site/generators/elsa.md
format: md
field_title: Elsa
field_repo: pyvec/elsa
field_homepage: https://github.com/pyvec/elsa
field_language: Python
field_license: MIT
field_templates: Jinja2
field_description: Helper module for hosting Frozen-Flask-based websites on GitHub Pages
data:
{"title": "Elsa", "repo": "pyvec/elsa", "homepage": "https://github.com/pyvec/elsa", "language": ["Python"], "license": ["MIT"], "templates": ["Jinja2"], "description": "Helper module for hosting Frozen-Flask-based websites on GitHub Pages", "body": "Elsa helps you to build your [Frozen-Flask](https://pypi.org/project/Frozen-Flask/)-based website and to deploy it to [GitHub Pages](https://pages.github.com/).\n\nIt has convenient CLI to simplify your project chores and comes with out-of-the-box [Travis CI](https://www.travis-ci.org/) compatibility.\n\n```shell\npython foo.py serve   # serves the site, no freezing, so you can check the result\npython foo.py freeze  # freezes the site, i.e. makes an HTML snapshot\npython foo.py deploy  # deploys the frozen site to GitHub Pages\n```\n\nLearn more in the [Quickstart](https://github.com/pyvec/elsa/blob/master/QUICKSTART.rst)!"}

field_body:
Elsa helps you to build your [Frozen-Flask](https://pypi.org/project/Frozen-Flask/)-based website and to deploy it to [GitHub Pages](https://pages.github.com/).

It has convenient CLI to simplify your project chores and comes with out-of-the-box [Travis CI](https://www.travis-ci.org/) compatibility.

```shell
python foo.py serve   # serves the site, no freezing, so you can check the result
python foo.py freeze  # freezes the site, i.e. makes an HTML snapshot
python foo.py deploy  # deploys the frozen site to GitHub Pages
```

Learn more in the [Quickstart](https://github.com/pyvec/elsa/blob/master/QUICKSTART.rst)!


id: greenwood
git_filename: src/site/generators/greenwood.md
format: md
field_title: Greenwood
field_repo: ProjectEvergreen/greenwood
field_homepage: https://www.greenwoodjs.io
field_language: JavaScript
field_license: MIT
field_templates: HTML, Web Components
field_description: Your workbench for the web.
data:
{"title": "Greenwood", "repo": "ProjectEvergreen/greenwood", "homepage": "https://www.greenwoodjs.io", "language": ["JavaScript"], "license": ["MIT"], "templates": ["HTML", "Web Components"], "description": "Your workbench for the web.", "body": "Greenwood embraces web standards to keep the focus on your work, not the framework.  Unbundled local development, file based routing, and as simple to start as an index.html or markdown file.  From static to serverless, Greenwood is your workbench for the web.\n\nCheckout out our [Getting Started guide](https://www.greenwoodjs.io/getting-started/) to get started with Greenwood today!"}

field_body:
Greenwood embraces web standards to keep the focus on your work, not the framework.  Unbundled local development, file based routing, and as simple to start as an index.html or markdown file.  From static to serverless, Greenwood is your workbench for the web.

Checkout out our [Getting Started guide](https://www.greenwoodjs.io/getting-started/) to get started with Greenwood today!


id: saga
git_filename: src/site/generators/saga.md
format: md
field_title: Saga
field_repo: loopwerk/Saga
field_homepage: https://github.com/loopwerk/Saga
field_language: Swift
field_license: MIT
field_templates: Markdown
field_description: A static site generator written in Swift.
data:
{"title": "Saga", "repo": "loopwerk/Saga", "homepage": "https://github.com/loopwerk/Saga", "language": ["Swift"], "license": ["MIT"], "templates": ["Markdown"], "description": "A static site generator written in Swift.", "twitter": "kevinrenskers", "body": "Saga is a static site generator, written in Swift, allowing you to supply your own metadata types for your items. Saga uses a system of extensible readers, writers and renderers supporting things like Atom feeds, paginating and strongly typed HTML templates. It comes with a development server which watches for changes in your content, rebuilds your website and refreshes your browser."}

field_body:
Saga is a static site generator, written in Swift, allowing you to supply your own metadata types for your items. Saga uses a system of extensible readers, writers and renderers supporting things like Atom feeds, paginating and strongly typed HTML templates. It comes with a development server which watches for changes in your content, rebuilds your website and refreshes your browser.


id: harold
git_filename: src/site/generators/harold.md
format: md
field_title: Harold
field_repo: juliancwirko/create-harold-app
field_homepage: https://www.haroldjs.com
field_language: JavaScript
field_license: MIT
field_templates: Handlebars
data:
{"title": "Harold", "repo": "juliancwirko/create-harold-app", "homepage": "https://www.haroldjs.com", "language": ["JavaScript"], "license": ["MIT"], "templates": ["Handlebars"], "description": "Harold (create-harold-app) is a simple tool that provides ready-to-use templates for creating your static websites and blogs, equipped with search functionality.", "twitter": "juliancwirko", "body": "Harold (create-harold-app) is a simple tool that provides a ready-to-use template for creating your static websites and blogs. It is based on well-known Handlebars, Markdown and Scss to be simple to use and start.\n\nBy default, you have access to JSON data with all posts. It is useful when you want to do something dynamic using JavaScript. For example, 'load more' functionality or search. The search system is implemented already in the default template.\n\n```\nnpm init harold-app my-app\n```"}

field_description:
Harold (create-harold-app) is a simple tool that provides ready-to-use templates for creating your static websites and blogs, equipped with search functionality.

field_body:
Harold (create-harold-app) is a simple tool that provides a ready-to-use template for creating your static websites and blogs. It is based on well-known Handlebars, Markdown and Scss to be simple to use and start.

By default, you have access to JSON data with all posts. It is useful when you want to do something dynamic using JavaScript. For example, 'load more' functionality or search. The search system is implemented already in the default template.

```
npm init harold-app my-app
```


