Skip to main content

Ralsina.Me — Roberto Alsina's website

Welcome To Nikola

If you see this, you may no­tice some changes in the site.

So, here is a short ex­pla­na­tion:

  • I changed the soft­­ware and the tem­­plates for this blog.

  • Yes, it's a work in progress.

  • The new soft­­ware is called Niko­la.

  • Yes, it's pret­­ty cool.

Why change?

Are you kid­ding? My pre­vi­ous blog-­gen­er­a­tor (Son of Bartle­Blog) was not in good shape. The ar­chives on­ly cov­ered 2000-2010, the "pre­vi­ous post­s" links were a lot­tery, and the span­ish ver­sion of the site was miss­ing whole sec­tion­s.

So, what's Nikola?

Niko­la is a stat­ic web­site gen­er­a­tor. One thing about this site is that it is, and has al­ways been, just HTM­L. Ev­ery "dy­nam­ic" thing you see in it, like com­ments, is a third par­ty ser­vice. This site is just a bunch of HTML files sit­ting in a fold­er.

So, how does Nikola work?

Niko­la takes a fold­er full of txt files writ­ten in re­struc­tured text, and gen­er­ates HTML frag­ments.

Those frag­ments plus some light meta­da­ta (ti­tle, tags, de­sired out­put file­name, ex­ter­nal links to sources) and Some Mako Tem­plates cre­ate HTML pages.

Those HTML pages use boot­strap to not look com­plete­ly bro­ken (hey, I nev­er claimed to be a de­sign­er).

To make sure I don't do use­less work, doit makes sure on­ly the re­quired files are recre­at­ed.

Why not use <whatever>?

Be­cause, for di­verse rea­son­s, I want­ed to keep the ex­act URLs I have been us­ing:

  • If I move a page, keep­­ing the Dis­­qus com­­ments at­­tached gets tricky

  • Some peo­­ple may have book­­marked them

Al­so, I want­ed:

  • Mako tem­­plates (be­­cause I like Mako)

  • Re­struc­­tured text (Be­­cause I have over 1000 posts writ­ten in it)

  • Python (so I could hack it)

  • Easy to hack (cur­ren­t­­ly Niko­la is un­der 600 LOC, and is al­­most fea­­ture com­­plete)

  • Sup­­port for a mul­ti­lin­gual blog like this one.

And of course:

  • It sound­ed like a fun, short pro­jec­t. I had the sus­pi­­cion that with a bit of glue, ex­ist­ing tools did 90% of the work. Looks like I was right, since I wrote it in a few days.

Are you going to maintain it?

Sure, since I am us­ing it.

Is it useful for other people?

Prob­a­bly not right now, be­cause it makes a ton of as­sump­tions for my site. I need to clean it up a bit be­fore it's re­al­ly nice.

Can other people use it?

Of course. It will be avail­able some­where soon.

Missing features?

No tags yet. Some oth­er mi­nor miss­ing things.

claudio canepa / 2012-03-29 16:26:

El link de 'restructured text' está roto, le falta una 'o'

Me agrada el nuevo aspecto del sitio, especialmente que no haya un montón de widgets restandole espacio y atención al contenido.

+100 por fuente del contenido en reST


Roberto Alsina / 2012-03-29 16:34:

Gracias, ahí subí con el link corregido.

Vos decis agregar un link al codigo fuente en rst de cada post?

claudio canepa / 2012-03-29 18:30:

No, le daba unos hurras a la eleccion de reST como el markup source. 

Roberto Alsina / 2012-03-29 20:21:

Igual lo agregué, eran 5 líneas de python y una de template, y queda copado :-)

ironfroggy / 2012-04-01 23:59:


I'm working on my own blog generator tool, also called nikola!

Roberto Alsina / 2012-04-02 18:23:

I swear I tried not to step on other project's names. If you have published a version, then I will be happy (ok, not *happy*) to rename this one.

ironfroggy / 2012-04-09 01:35:

 I grabbed a name but you actually got work done. I wave the white flag and will be looking into your project.

Roberto Alsina / 2012-04-09 15:24:

Thanks! Hope you find it useful.

Contents © 2000-2023 Roberto Alsina