I am hap­py to an­nounce the re­lease of ver­sion 5.3 of Niko­la a stat­ic blog/site gen­er­a­tor. It in­cludes some mi­nor fea­tures and a good amount of bug­fix­ing. Up­grad­ing to it should not cause you any trou­ble, as far as I know.

Here's the changel­og:

I am thrilled to an­nounce that you can now down­load Niko­la 5.2. a new ver­sion of my stat­ic blog/site gen­er­a­tor.

What's new in this ver­sion? A LOT. Don't let the mi­nor ver­sion tick fool you, this ver­sion is packed with good­ness. Let's start with fea­tures:

You can eas­i­ly em­bed more con­tent:

• New vimeo di­rec­­tive for re­struc­­tured tex­t.

• Cus­­tom "gist" di­rec­­tive pro­vid­ing re­Struc­­tured text sup­­port for GitHub gist­s.

You can write your con­tent in al­most any markup:

• Tex­tile markup sup­­port.

• Cre­ole Wi­­ki markup sup­­port.

• tx­t2­­tags markup sup­­port.

• bb­­code markup sup­­port.

• And of course, it still sup­­ports re­Struc­­tured tex­t, Mark­­down and HT­M­L.

More lan­guages:

• New Catalá tran­s­la­­tion

• New pol­ish tran­s­la­­tion.

• New Sim­­pli­­fied Chi­­nese tran­s­la­­tion.

• Use mul­ti­lin­gual Dis­­qus (although it does­n't seem to work)

You can im­port your data:

• New Blog­ger/Blogspot im­­porter

• Much im­proved Word­­press im­­porter

• Ex­­tract meta­­da­­ta from file­­name by us­ing reg­­exp (help­­ful for im­­port­ing from oc­­to­­press or oth­­er sys­tem­s).

You can do fanci­er and more con­fig­urable sites:

• One-­­page, dy­­nam­ic-load­­ing, clien­t-ren­dered site plug­in (task_­­mus­­tache)

• Re­cur­­sive post/s­­to­ry fold­ers

• New COM­­MENTS_IN_­­GAL­­LERIES and COM­­MENTS_IN_S­­TO­RIES op­­tion­s.

• Lo­­cal search based on Tipue (ex­­tra_­­plu­g­in­s/­­task_lo­­calsearch)

• Added com­­ments to im­age gal­­leries

• New op­­tion RSS_TEASERS

• New STO­RY_IN­DEX op­­tion to gen­er­ate in­­dex.html in sto­ry fold­er­s.

• Add mul­ti size fav­i­­con sup­­port.

You can use Python 2.6 or high­er ... in­clud­ing Python 3. The on­ly miss­ing bit for full Python 3 sup­port is Google sitemap gen­er­a­tion.

And of course, a lot of bugs got smashed:

• Added sane de­­faults for most op­­tion­s, so you can have a lean con­­fig file.

• Made lay­out of the site theme re­spon­­sive, with col­lap­s­ing navbar.

• Use time­­line in­­stead of pars­ing post_­­pages in gen­er­ic_­­page_ren­der­er and task_ren­der_­­pages.

• Up­­­dat­ed dis­­qus in­­te­­gra­­tion code, added iden­ti­­fiers so it works on any URL.

• Make sure fold­er links end in "/" in the gallery code.

• Re­­moved copy of PyRSS2­­Gen, made it a de­pen­­den­­cy.

• De­­tect "names­­pace" de­pen­­den­­cies for Mako tem­­plates.

• Use con­­sis­­tent en­­cod­ings in RSS feed­s.

• Refac­­tored dis­­qus code in­­­to sep­a­rate helpers

• Use the cor­rect ex­ten­­sion (or raise an er­ror) on new_­­post

• Fix ti­­tles that in­­­clude quotes

• Up­­­dat­ed to cur­rent CSS from do­cu­tils (was us­ing ver­­sion from 2005)

• Avoid need­­less re­­gen­er­a­­tion of gallery in­­dex­es.

• Al­ways en­­sure the fold­er for the new post ex­ist­s.

• Get ti­­tle from file­­name if not avail­able in meta­­da­­ta.

• Don't copy sources if they end in ".ht­m­l"

• Don't link to un­ex­ist­ing tran­s­la­­tion­s.

• Sort tags case in­­sen­si­­tive.

En­joy!

To­day at lunch, I added sup­port for im­port­ing blog­ger (maybe al­so blogspot? They seem to be the same nowa­days) blogs in­to Niko­la my stat­ic blog/site en­gine.

What works?

Well, the on­ly site I tried work­s, most­ly.

• Posts

• Pages

• Tags

• Drafts

• Blog Meta­­da­­ta (ex­­cept lan­guage)

• Redi­rects to keep URLs sta­ble (at least it tries re­al­­ly hard!)

• URL rewrit­ing in the posts (it tries!)

What's not there?

• Com­­ments im­­port (it makes more sense to im­­port them via Dis­­qus' im­­port tool)

• At­­tach­­ments (im­ages and such)

• Much test­ing

It's ba­si­cal­ly on par with the Word­press im­port, ex­cept noone has used it for re­al. So, feel free to try!

(It's niko­la im­port_blog­ger name_of_the_­dump.xm­l)

A while ago, I cre­at­ed a 2-­page PDF ver­sion of the re­struc­tured text quick­start meant to be print­ed, fold­ed in half and kept handy un­til you fi­nal­ly re­mem­ber how to do foot­notes (10 years and still wait­ing, in my case).

It was brought to my at­ten­tion that the github project did not men­tion how to build it. Then I no­ticed that not on­ly it did­n't ex­plain that, it was al­so miss­ing crit­i­cal files.

So, I added the files, fixed a cou­ple of things that were not work­ing per­fect­ly with the lat­est rst2pdf and there is now a fresh PDF ready for you!