Website implementation

Website implementation

[Luis Felipe López Acevedo]

Hi,

I just wanted to let you know that I started implementing the website 
mockup rev2[1] in HTML/CSS—just the basic templates. The progress can be 
found at http://sirgazil.bitbucket.org/guixsd/ for now.

By the way, where should I put the source?

Regarding the Guilish tool(s) to generate the site statically, I have 
these to compare

     - Artanis <http://www.gnu.org/s/artanis/> (GNU Project)
     - Hyde <http://wiki.call-cc.org/eggref/4/hyde>
     - Skribilo <http://www.nongnu.org/skribilo/>
     - tylan's html simple <https://gitorious.org/taylan-guile/html/>

I still need to get familiar with the fundamentals of Scheme/Guile to 
decide what tool to use. Personally, I'd like to find a way to write 
HTML templates and let a program build the final site. Template context 
and inheritance would be nice to have. Maybe this can be done with 
Artanis' template system?

Best,


[1] https://lists.gnu.org/archive/html/guix-devel/2015-02/msg00573.html

-- 
Luis Felipe López Acevedo
http://sirgazil.bitbucket.org/

Re: Website implementation

[David Thompson]

Luis Felipe López Acevedo <felipe.lopez@openmailbox.org> writes:

> Regarding the Guilish tool(s) to generate the site statically, I have
> these to compare
>
>      - Artanis <http://www.gnu.org/s/artanis/> (GNU Project)

Artanis is intended for dynamic web applications, so I don't think it
would be particularly useful in this instance.

>      - Hyde <http://wiki.call-cc.org/eggref/4/hyde>

Maybe it's too much work, but it would be best to stick with Guile.  I
think the work on this project could be used to extract our own static
site generator for Guile.

>      - Skribilo <http://www.nongnu.org/skribilo/>

I haven't used Skribilo enough to know if it should be used for this
purpose.  Ludo?

>      - tylan's html simple <https://gitorious.org/taylan-guile/html/>

I also have an SXML -> HTML converter in guix-web. [0]

> I still need to get familiar with the fundamentals of Scheme/Guile to
> decide what tool to use. Personally, I'd like to find a way to write
> HTML templates and let a program build the final site. Template context
> and inheritance would be nice to have. Maybe this can be done with
> Artanis' template system?

Lisps have built-in templating via quasiqoute, so you can do any
transformations you'd like on the resulting s-expression.  SXML is a
popular way of writing XML/HTML templates in Lisp.  See guix-web for
examples. [1]

Does this help or have I just muddied the waters even more?

[0] https://gitorious.org/guix-web/guix-web/source/guix/web/sxml.scm
[1] https://gitorious.org/guix-web/guix-web/source/guix/web/view/html.scm#L74

--
David Thompson
Web Developer - Free Software Foundation - http://fsf.org
GPG Key: 0FF1D807
Support the FSF: https://fsf.org/donate

Re: Website implementation

[Luis Felipe López Acevedo]

On 2015-03-07 17:01, David Thompson wrote:
> Luis Felipe López Acevedo <felipe.lopez@openmailbox.org> writes:
> 
>> Regarding the Guilish tool(s) to generate the site statically, I have
>> these to compare
>> 
>>      - Artanis <http://www.gnu.org/s/artanis/> (GNU Project)
> 
> Artanis is intended for dynamic web applications, so I don't think it
> would be particularly useful in this instance.

I thought that its template mechanism could be used independently as I 
use Django's to generate my blog statically...

[...]


>>      - tylan's html simple <https://gitorious.org/taylan-guile/html/>
> 
> I also have an SXML -> HTML converter in guix-web. [0]
> 
>> I still need to get familiar with the fundamentals of Scheme/Guile to
>> decide what tool to use. Personally, I'd like to find a way to write
>> HTML templates and let a program build the final site. Template 
>> context
>> and inheritance would be nice to have. Maybe this can be done with
>> Artanis' template system?
> 
> Lisps have built-in templating via quasiqoute, so you can do any
> transformations you'd like on the resulting s-expression.  SXML is a
> popular way of writing XML/HTML templates in Lisp.  See guix-web for
> examples. [1]
> 
> Does this help or have I just muddied the waters even more?

The Guile world is a completely new world for me, but I'll check 
guix-web to see how templating works.

thanks.


> [0] https://gitorious.org/guix-web/guix-web/source/guix/web/sxml.scm
> [1] 
> https://gitorious.org/guix-web/guix-web/source/guix/web/view/html.scm#L74
> 
> --
> David Thompson
> Web Developer - Free Software Foundation - http://fsf.org
> GPG Key: 0FF1D807
> Support the FSF: https://fsf.org/donate

-- 
Luis Felipe López Acevedo
http://sirgazil.bitbucket.org/

Re: Website implementation

[David Thompson]

Luis Felipe López Acevedo <felipe.lopez@openmailbox.org> writes:

> On 2015-03-07 17:01, David Thompson wrote:
>> Luis Felipe López Acevedo <felipe.lopez@openmailbox.org> writes:
>> 
>>> Regarding the Guilish tool(s) to generate the site statically, I have
>>> these to compare
>>> 
>>>      - Artanis <http://www.gnu.org/s/artanis/> (GNU Project)
>> 
>> Artanis is intended for dynamic web applications, so I don't think it
>> would be particularly useful in this instance.
>
> I thought that its template mechanism could be used independently as I 
> use Django's to generate my blog statically...

Yes, it could, that's true.  But, IIRC, Artanis came up with it's own
templating system that is more like the templating systems of other
languages.  I don't like that approach and prefer using s-expressions
and quasiquote.  Feel free to disagree, of course. :)

-- 
David Thompson
Web Developer - Free Software Foundation - http://fsf.org
GPG Key: 0FF1D807
Support the FSF: https://fsf.org/donate

Re: Website implementation

[Ludovic Courtès]

David Thompson <dthompson2@worcester.edu> skribis:

> Luis Felipe López Acevedo <felipe.lopez@openmailbox.org> writes:

[...]

>>      - Skribilo <http://www.nongnu.org/skribilo/>
>
> I haven't used Skribilo enough to know if it should be used for this
> purpose.  Ludo?

The “Example” section of the web page can give you a feel of what it’s
like.  Basically, you write a ‘document’ form:

  (document :title [My Stuff]

    (chapter :title [Foo]
      (p [This is some text.])))

Then run:

  skribilo -t html -o foo.html foo.skb

And you’re done.

Then there are “customs” that can be set to specify whether to use
separate HTML pages for chapters, what CSS file to use, etc.

> Lisps have built-in templating via quasiqoute, so you can do any
> transformations you'd like on the resulting s-expression.  SXML is a
> popular way of writing XML/HTML templates in Lisp.  See guix-web for
> examples. [1]

Another simple example is the build-aux/list-packages.scm program in the
Guix source tree, which is used to generate
<https://www.gnu.org/software/guix/package-list.html>.

HTH,
Ludo’.

Re: Website implementation

[Taylan Ulrich Bayırlı/Kammer]

Luis Felipe López Acevedo <felipe.lopez@openmailbox.org> writes:

>     - tylan's html simple <https://gitorious.org/taylan-guile/html/>

Note that this is a rudimentary library; I just thought someone might
use it as a starting point for something more serious.

Taylan