Show HN: Gugodoc, my static web generator (for what it's worth )

http://gugodoc.free.fr

by MeyerDumont • 13 years ago

20 29 13 years ago

gugodoc.free.fr

L4mppu• 13 years ago

Pretty much impossible to read on phone with that floating shit blocking your view.

MeyerDumont10• 13 years ago

Thanks for the feedback, I will try to fix that ASAP.

rajeevk2• 13 years ago

How is this different from Octopress? In Octopress you can simply edit markdown files and then generate html.

MeyerDumont10• 13 years ago

I don't know Octopress, this is just my tool and it's probably worst than all the others but it fits my needs

chanux2• 13 years ago

Just for fun is a perfectly good reason for anything!

Also, I have saved a lot of time looking around for existing solutions than just doing it myself. :)

MeyerDumont10• 13 years ago

Just saw a little bit Octopress, it seems you need a local server to see your files, I don't like that, Gugodoc produces only static html files. you just need to open them with a browser and that's all

chanux2• 13 years ago

The server part in Octopress (and other static site generators are there just for convenience and to and see how it really works when you host the site I guess.)

aaren2• 13 years ago

where is the source code?

MeyerDumont10• 13 years ago

It's too ugly but I will probably try to clean it and put it on github soon.

aaren2• 13 years ago

I'm not going to run your binary if I can't see the source and compile it myself!

ponytech2• 13 years ago

What language do you use ?

roeme• 13 years ago

  I'm a big fan of minimalism.
  I love markdown
  I hate HTML

If you hate HTML, are you sure you should write something that outputs exactly that?

ama729• 13 years ago

If you hate HTML, are you sure you should write something that outputs exactly that?

He probably mean to write HTML.

MeyerDumont10• 13 years ago

ama729 is right. I hate writing HTML and that's why I try to automate this task as mush as possible

terhechte2• 13 years ago

Funny, I'm almost done with a fork of a Clojure static web generator and I really went into the opposite direction. What I wanted was to have one (or several) html files as templates that I do not need to break up into parts and that are not plastered with weird template tags. So I'm using Enlive to define selectors and the generator uses theses selectors to fill the content into the html structure. That makes it really really easy to edit the html for the blog without having to go the html -> haml/whatever -> break up -> ... route. I just relaunched my blog with this generator and it feels so liberating that I can just work in html without having to do any kind of conversation afterwards but the content is applied.

I'm currently extending the tests for the generator, and will release it then. If anyone is interested, drop me a note and I'll notify :)

MeyerDumont10• 13 years ago

your solution sounds really good.

terhechte2• 13 years ago

I just published the generator. You can see the relevant HN post here: https://news.ycombinator.com/item?id=7103742

prewett• 13 years ago

Is there something like this that operates at a higher level? Unlike the author, I'm ok with HTML (and I can't stand markdown), except that it's too low level. I want to break things up by title, author, date, summary, content, etc. and then generate the HTML by plugging it into a template, so that title, date, and author become part of the heading at the top of the page and so on. So something like

<title>...</title> (pretend this isn't already taken) <author>...</author> <date>...</date> <summary>...</summary> ...

It seems like XSLT is what I want, except that I have to deal with a bunch of XML nonsense. I could always write my own parser, but I keep hoping someone already wrote something like this.

girvo• 13 years ago

Funnily I have been building something similar, but using JSON as the data source with compilation step either AOT or at run time. It's quite fun though very rough, and I can see why XSLT is more complicated than you'd expect.

masklinn• 13 years ago

I could always write my own parser, but I keep hoping someone already wrote something like this.

Not the parser, just the transformation phases. Maybe something like the Haskell XML toolbox or Clojure data manipulations (XML -> clojure data structure -> munge[0] -> XML) would work for you.

[0] basic options: Enlive, or parse XML to Hiccup and manipulate Hiccup tree before serialising back.

cdr• 13 years ago

Not entirely sure I understand what you're after, but the Harp js framework can do just about anything. If your metadata is in json or just encoded by folder/file even, you can inject it into templates easily.

delluminatus• 13 years ago

What you're talking about can be pretty easily implemented with template inheritance that uses blocks/sections. Pretty much any templating language can do this for you (usually static site generators use templating languages, so by extension, static site generators will do this for you as well). For instance, jinja2 is a common one for Python that I use for my website.

You can read about jinja2 template inheritance in their docs [1]. The gist of it is that you can define a layout in HTML, with placeholders for specific things like the title, author, content, etc. Then your actual post is just a file that inherits from that layout template and only defines the relevant blocks. So in "template pseudocode" your page might look like this:

    {{ extends site_layout }}
    {{ block title }} Title here {{ endblock }}
    {{ block author }} delluminatus {{ endblock }}
    {{ block content }} 
        <p>Content!</p>
    {{ endblock }}

[1]: http://jinja.pocoo.org/docs/templates/#template-inheritance

simlevesque• 13 years ago

Dans la section HTML and Bootstrap, la phrase suivante contient au moins deux fautes : "But, of course, I discourage you fro doing this because, in my opinion, markdwon files must try to be as lisible/raw/text only as possible."

MeyerDumont10• 13 years ago

merci !

Show HN: Gugodoc, my static web generator (for what it's worth )

Related Stories