Des­de ha­ce unos mi­nu­to­s, el co­man­do "ins­ta­ll_­the­me" de Niko­la gi­thub mas­ter saca los te­mas de http://­the­me­s.­niko­la.­ral­si­na.­me

Así que de gol­pe, en vez de 2 te­mas pa­ra ba­ja­r, hay 65 (aun­que la ma­yo­ría son va­ria­cio­nes via bootswa­tch de 2 te­ma­s, jin­ja-­de­fault es iden­ti­co a de­faul­t, y or­phan no sir­ve pa­ra na­da ;-)

¡Y aho­ra po­dés con­tri­buir te­ma­s! ¿Có­mo?

1. Da­­me un pu­­ll re­­quest en http­s://­­gi­­thu­­b.­­co­­­m/­­ra­l­­si­­na/­­niko­­­la-­­the­­mes

   Po­­­né tu te­­ma en the­­me­s/ y man­­dá el pu­­ll re­­quest

2. Man­­dá­­me un zip de tu te­­ma y yo lo agre­­go

Los te­mas con­tri­bui­dos van a tar­dar un ra­to en apa­re­cer por­que hay que re­vi­sar­los pa­ra sa­ber que no tie­nen có­di­go ma­li­cio­so, pe­ro los voy a pro­ce­s­ar, len­to pe­ro se­gu­ro. Si ya me man­das­te un te­ma y nun­ca lo pu­se en nin­gún la­do, te pi­do dis­cul­pas y que en­cuen­tres las ga­nas de in­ten­tar de nue­vo :-)

El si­tio de te­mas en sí no es exac­ta­men­te her­mo­so, pe­ro es fun­cio­na­l, y po­dés ba­jar los te­mas de ahí, ver si­tios de de­mo pa­ra ca­da te­ma, y has­ta hay screens­ho­ts au­to­ge­ne­ra­dos (que la­men­ta­ble­men­te no mues­tran los we­bfon­ts)

I had this is­sue open in the bug tra­cker for Niko­la (my sta­tic si­te ge­ne­ra­to­r) for a long ti­me: "A­dd min­css su­ppor­t".

We­ll, no, it does­n't ha­ve it ye­t, but I did so­me re­sear­ch on whe­ther it would be wor­th addin­g. And bo­y, min­css im­press­ed the he­ck out of me.

You see, Niko­la's the­mes tend to use una­dul­te­red boots­tra­p, whi­ch means they ca­rry a lar­ge num­ber of things that are not us­ed in their CSS. Be­si­des, it uses se­ve­ral sty­les­hee­ts from do­cu­til­s, pyg­men­ts, and mo­re.

What min­css does is exa­mi­ne your HT­ML and your CSS, and re­mo­ve all the unu­s­ed CSS. So, I wro­te a script that exa­mi­nes the Niko­la ou­tput and ove­rw­ri­tes the CSS fi­les wi­th the mi­ni­mal things that are ac­tua­lly nee­ded the­re.

And the re­sul­t?

He­re is the be­fo­re/a­fter for ea­ch CSS fi­le in Niko­la's de­mo si­te:

bootstrap-responsive.min.css  16849  3251
bootstrap.min.css            106059 14737
code.css                       3670  2114
colorbox.css                   6457   774
rst.css                        6559  2581
theme.css                      1287  1061
-----------------------------------------
                             140881 24518

But wai­t, Niko­la su­ppor­ts bund­ling all tho­se fi­les in­to a sin­gle lar­ge CSS fi­le to avoid ne­two­rk re­ques­ts (u­sing we­ba­sse­ts). Does it wo­rk in that ca­se too?

We­ll ye­s:

all-nocdn.css                167457 29496

But that is not all. The min­css fi­les are not mi­ni­fie­d. Pa­s­sing all-­no­cd­n.­css th­rou­gh Yui-­com­pres­sor sh­ri­nks it fur­ther to 20599 by­tes. Whi­ch, gzi­ppe­d, is a pal­try 4801 by­tes. That means the com­ple­te sty­ling of the who­le si­te is a sin­gle CSS fi­le le­ss than 5KB in si­ze.

Tha­t, is im­pres­si­ve.

Over a year ago (ti­me flie­s!) I pos­ted so­me­thing about a pro­ject ca­lled Al­va. Let me quo­te mysel­f:

Al­va is al­most the oppo­si­te of Niko­la. If Niko­la is about making sta­tic si­tes, Al­va is a dy­na­mic si­te. Ho­we­ve­r, as He­gel su­gges­ts, from the the­sis and the an­ti­the­sis co­mes the syn­the­sis.

So, Al­va is about dy­na­mi­ca­lly crea­ting sta­tic si­tes. If you want to ha­ve Niko­la in your ser­ver ins­tead of in your own com­pu­te­r, and ha­ve the con­ve­nien­ce of an on­li­ne tool, tha­t's the ni­che Al­va tries to fi­ll.

So, you would ins­ta­ll Al­va, and use it like any other we­b-­ba­sed blo­gging tool. Ye­t, be­hind the sce­nes, you would ha­ve Niko­la, and all the per­for­man­ce and se­cu­ri­ty be­ne­fi­ts of sta­tic si­tes.

And ma­y­be so­me­da­y, I (or so­meo­ne) wi­ll put up a mul­ti-u­ser ver­sion of Al­va, and you wi­ll be able to get hos­ted blogs, kno­wing all the da­ta is yours and you can lea­ve an­y­ti­me and do your own thin­g.

The appro­ach I was taking at the ti­me pro­ved to be un­suc­ce­ss­fu­l, and the­re we­re a few other fai­lu­res along the wa­y. Of cour­se, the pro­blem was in how I was appro­aching the ta­sk. So I did the ri­ght thin­g, and lear­ned how to do it "ri­gh­t".

Sti­ll not usa­ble, sti­ll not hos­ted an­ywhe­re, but al­ready se­mi-­func­tio­na­l: Al­va li­ves now

The­re's a lot of wo­rk sti­ll to be do­ne. But I now know how to do it. To pre­vent the usual ar­gu­men­ts, he­re is a li­ttle ex­pla­na­tion of mo­ti­va­tio­n, toolin­g, etc.

I am a ve­ry big pro­po­nent of sta­tic si­te ge­ne­ra­tor­s. I would not ha­ve bo­the­red wri­ting Niko­la othe­rwi­se. But the­re is alwa­ys that fee­ling that ma­y­be the­re is so­me li­ttle thing whi­ch is hard to im­ple­men­t, like a con­tact for­m.

And le­t's fa­ce it, the ea­siest way to sol­ve so­me of tho­se things is by sti­cking a few li­nes of PHP in your HT­M­L.

So, if you rea­lly want to, you can do it. I thi­nk Niko­la (gi­thub mas­te­r) is the first sta­tic si­te ge­ne­ra­tor that su­ppor­ts php co­de. He­re's ho­w:

1. Add php to your pa­ge_­com­pi­lers (be­cau­se I wi­ll ne­ver put it the­re by de­faul­t):

   post_compilers = {
       "rest": ('.txt', '.rst'),
       "markdown": ('.md', '.mdown', '.markdown'),
       "textile": ('.textile',),
       "txt2tags": ('.t2t',),
       "bbcode": ('.bb',),
       "wiki": ('.wiki',),
       "ipynb": ('.ipynb',),
       "html": ('.html', '.htm'),
       "php": ('.php'),
   }

2. Add php pos­ts or pa­ges to your pos­t_­pa­ges:

   post_pages = (
       ("posts/*.txt", "posts", "post.tmpl", True),
       ("posts/*.php", "posts", "post.tmpl", True),
       ("stories/*.txt", "stories", "story.tmpl", False),
       ("stories/*.php", "stories", "story.tmpl", False),
   )

3. Crea­te a php pos­t:

   nikola new_post posts/foo.php

4. Put php in the­re:

   <!--
   .. date: 2013/04/16 09:57:09
   .. title: php test
   .. slug: foo
   -->
   
   <?php
   Print "Hello, World!";
   ?>

Build the si­te as usua­l, and you should end up wi­th a pa­ge wi­th PHP ex­ten­sio­n, that has that PHP in the "con­ten­t" area, so it wi­ll fo­llow your si­te's the­me. Of cour­se you can't do things like add HTTP hea­ders and su­ch, but he­y, read the ti­tle.

Ye­s, ver­sion 5.4.4 of Niko­la, my sta­tic si­te/­blog ge­ne­ra­tor is just pu­blis­hed at the usual pla­ce, in­clu­ding the fo­llo­wing im­pro­ve­men­ts: