Skip to main content

Ralsina.Me — Roberto Alsina's website

Why Use Something Else?

I wrote a stat­ic site gen­er­a­tor, called Niko­la a while ago, and it's start­ing to get some adop­tion and con­tri­bu­tion­s.

I think it's a fair­ly nice piece of code, to be hon­est, and it pret­ty much does ev­ery­thing I need. On the oth­er hand, it's fun to code with.

So, if you are us­ing an­oth­er stat­ic site gen­er­a­tor, or are re­search­ing in­to it, or just have opin­ions about it... what's miss­ing? What should it have that it does­n't have now?

No fea­ture too smal­l, no idea too crazy, please share! I prom­ise to make a good ef­fort to im­ple­ment any that seem like a good idea :-)

Guest / 2012-12-27 02:22:

clean urls (i.e. stripping .html):

Tshepang Lekhonkhobe / 2012-12-27 02:32:

category support:

schettino72 / 2012-12-27 09:23:

I think really needs improving is not features,
its documentation and making nikola more stable (more tests).
The documentation is in many places incomple or outdated.

Source layout targeting github-pages.
of course you can copy the "output" folder to a different branch
but I would prefer to have the output in the root folder.
This is possible today but the "clean" command is not reliable
to remove all generated content.

A more professional looking default template.
Sorry, I cant help on this :)

Roberto Alsina / 2012-12-27 12:43:

The github thing is interesting. Let's talk about that :-)

Yes, the docs are a bit behind the code, I plan on fixing that these next few days.

The template ... I may consider hiring a designer to work on one (really) but not quite now.

Amirouche / 2013-01-01 12:20:

I just started a new blog with pelican, and I think it also lakes this feature.

Kay Hayen / 2012-12-27 10:40:

I personally miss the tag cloud thing the most. At one time I had researched something, but then I forgot. That would be a visual eye candy it currently lags.

Then it doesn't display well on mobile does it. I find that critical. Being mostly text, there is no reason for it to display like a normal web page on mobile.

Sorry, me currently doesn't have the time to put effort into these, gotta work at this time of the year...

Roberto Alsina / 2012-12-27 12:44:

Yeah, the display on mobile is probably easy to fix, too, since bootstrap can do responsive layout, but I seem to suck at it :-(

Kay Hayen / 2012-12-27 13:19:

But you promised and now I look forward to it :)

Roberto Alsina / 2012-12-27 13:21:

Deal! ;-)

Roberto Alsina / 2012-12-28 01:54:
Roberto Alsina / 2013-01-02 01:43:

Turns out that, if I read the docs, I could make the site theme responsive ;-)

Anon / 2012-12-27 11:00:

I use Pelican because Nikola's codebase is not that good.

Roberto Alsina / 2012-12-27 12:42:

If that's your opinion, I'm cool with it.

dwhall256 / 2012-12-27 16:06:

I'm an embedded developer with a deep python history. That is to say I'd prefer not to do any web programming, so I want a simple static site generator like Nikola. Question 1: Can I make a fixed "front page" ( and put the blog portion on its own path ( ? Question 2: Is there a plugin for turning some form of math/latex markup into images (I did this once with the old rst2pdf / rst2html, but my configuration was fragile and is since broken) ?

Roberto Alsina / 2012-12-27 16:47:

Docutils 0.10 has a math directive, which should work, but I have not tried it myself. If it doesn't, I am sure I can make it work.

And yes, nikola allows you to do that. For example, here's nikola's own site, which has a static frontpage: and a blog:

Noe Nieto / 2012-12-27 16:32:

I'm using Tinkerer ( I'm very happy with it. I publish my blog on amazon S3 with almost no cost at all.

The only thing I'm missing from Tinkerer is RSS feeds by tag or category. Currently it only provides one big RSS for all the posts.

Do Nokola has this feature?

Roberto Alsina / 2012-12-27 16:45:

Yes it does, for example, here is my feed for things tagged nikola: http://lateral.netmanagers....

Chris Warrick / 2012-12-27 19:32:

I’m currently with Hyde. The only reason why I am not using Nikola yet is because I do not have time to do the transition. I might find some soon. I need easy RSS/Atom, documentation and user friendliness. And no need to run “sed s/%3A/:/ * -i” on every generation due to a bug that breaks media URLs containing colons (as in http:// for fuck’s sake)

Roberto Alsina / 2012-12-27 20:31:

Just in case, Nikola is not the one that breaks that way, is it? ;-)

I could consider a Hyde importer (or a Jekyll one, etc.)

Chris Warrick / 2012-12-28 09:31:

Hyde has this weird problem. Without a fix, probably.

PS. .. date: 2012/09/15 19:52:05 — am I obligated to use such wrong formats or does the proper 2012-09-15 still work? (if not, how to make it work?)

EDIT: `nikola new_post`

Is it mandatory or can I create the files by hand?

Roberto Alsina / 2012-12-28 14:34:

You can create the files manually, there is no trick there. You should be able to use most common date formats without a problem.

Chris Warrick / 2012-12-29 19:47:

BTW: I want speed. Real speed. 75 seconds for generating (from scratch, because hyde usually fucks up when you don’t remove stuff before a change) on a quite powerful server is WAAAAY too long.

Roberto Alsina / 2012-12-30 19:22:

A full regeneration of my blog (some 2000 posts) except image galleries (because that means passing a few thousand images via PIL, which is slow), takes about 3.5 minutes in my ultrabook.

A regular rebuild (say, a new post) is about 5 seconds.

And there's hardly any optimization done, so I am sure it can be brought down a bit, although it seems to be IO bound.

freax / 2012-12-28 19:48:

improved image galleries, but these seem to be on the list already.
A way of creating article series (with links to first/next/before/index), but one can simply use tags for that... -> not so important
Oh, and something all static site generators I know are missing: generation of .htaccess files! (add a tag/etc to a post, and the post and its images are password protected)
I would attempt to help, but university currently has me swamped, I can't even find the time to build my own homepage using nikola, let alone improve it. (And I probably should look somewhere else for my picture presenting needs, my ideas feel a lot like craming stuff into it to create some weird hybrid)

Roberto Alsina / 2012-12-29 02:10:

the .htaccess support and article series are interesting ideas, thanks!

dominiks / 2013-01-04 13:50:

I am currently evaluating several static site / blog generators and found the comments here very helpful as suggestions what else to check out ;)

Nikola looks like the easiest to start with at the moment but I agree with schettino72 that documentation should be your next focus.

Contents © 2000-2023 Roberto Alsina