cURL / Mailing Lists / curl-library / Single Mail

curl-library

Re: Re: web site polish

From: Michael Osipov <1983-01-06_at_gmx.net>
Date: Mon, 8 Jun 2015 23:08:04 +0200

> On Mon, 8 Jun 2015, Michael Osipov wrote:
>
> > have you considered a completely different approach?
> >
> > People tend to use Jekyll, Awestruct or just Asciidoctor. While I have no
> > experience with Jekyll/Awestruct, I have quite happy with Asciidcotor for
> > documentation. This is what the shortcoming is all about in curl.
>
> Then please show us how the front page would look like with your tool.

If we stick with HTML, Asciidoctor has a standard HTML template, you can
create a custom one resembling the previous look.

Here are a few examples:
1. http://asciidoctor.org/docs/user-manual/
2. http://docs.spring.io/spring/docs/4.2.0.RC1/spring-framework-reference/htmlsingle/ with Docbook backend

For instance, AsciiDoc's front page is written with AsciiDoc itself:
http://www.methods.co.nz/asciidoc/

Just take 15 min and check whether this suit your needs.

Michael
-------------------------------------------------------------------
List admin: http://cool.haxx.se/list/listinfo/curl-library
Etiquette: http://curl.haxx.se/mail/etiquette.html
Received on 2015-06-08