[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: static site generators

• From: Shaun McCance <shaunm@gnome.org>
• To: Lucas Vogel <lucas.vogel@endpointsystems.com>, "xml-dev@l..." <xml-dev@l...>
• Date: Wed, 15 Feb 2017 11:07:44 -0500

On Sat, 2017-01-14 at 17:08 +0000, Lucas Vogel wrote:
> One thing I've noticed a big uptick in lately are static site
> generators, where you use a CLI app to create a site template and you
> use the tool features (typically the language features the CLI was
> written in) to put the site elements (themes, templates, content,
> etc.) together, and then use the tool to compile, deploy and host the
> site itself. You can find a list of them by popularity rankings here:
> https://www.staticgen.com/ If you look at the site generators, you
> see them written in Javascript, Go, .NET, PHP, Python; even bash and
> awk have a couple. But only one (Stog) have anything to do with XML. 
> 
> Does anyone know of any static site generators written around the XML
> format? I know of one on the .NET side for product documentation
> (Sandcastle) but it's increasingly becoming an obsolete framework
> (mainly because of the awful tags Microsoft put into its MAML markup
> language). Are there any others out there? 

I've been working on a static site generator called Pintail. It's
geared toward documentation sites, to replace various ad hoc shell
scripts used in GNOME and other projects, but it can be used to build
any sort of site. No web site yet, but here's the GitHub page:

https://github.com/projectmallard/pintail

It has native support for Mallard and DocBook and has plugins for
AsciiDoc and Ducktype (both lightweight syntaxes that get pushed
through a Mallard XML layer for processing). The orchestration layer is
written in Python, but all the templating and transformations use XSLT,
using the yelp-xsl stylesheets:

http://yelp.io/

Translations are handled with itstool, an implementation of the W3C
Internationalization Tag Set:

http://itstool.org/

Here are some sample sites being built with it right now:

https://github.com/projectmallard/projectmallard.org/
https://github.com/itstool/itstool.org
https://github.com/openhelp/conf.openhelp.cc

--
Shaun