structure++

Author: vindarel

content/building-blocks/_index.md

@@ -4,11 +4,11 @@ title = "Building blocks"
 weight = 1
 +++
 
-In this chapter we'll start by creating our first route, we'll serve
+In this chapter we'll create routes, we'll serve
 local files and we'll run more than one web app in the same running
 image.
 
-Let's install the libraries we'll use:
+We'll use those libraries:
 
 ~~~lisp
 (ql:quickload '("hunchentoot" "easy-routes" "djula" "spinneret"))

content/building-blocks/building-binaries.md

@@ -0,0 +1,5 @@
++++
+title = "Building a binary"
+weight = 150
++++
+

content/building-blocks/database.md

@@ -1,7 +1,7 @@
 
 +++
 title = "Connecting to a database"
-weight = 170
+weight = 120
 +++
 
 Please see the [databases section](databases.html). The Mito ORM

content/building-blocks/error-handling.md

@@ -1,6 +1,6 @@
 +++
 title = "Error handling"
-weight = 150
+weight = 100
 +++
 
 In all frameworks, we can choose the level of interactivity. The web

content/building-blocks/headers.md

@@ -0,0 +1,9 @@
+
++++
+title = "Headers"
+weight = 40
++++
+
+~~~lisp
+(setf (hunchentoot:header-out "HX-Trigger") "myEvent")
+~~~

content/building-blocks/routing.md

@@ -3,12 +3,11 @@ title = "Routing"
 weight = 15
 +++
 
+I prefer the easy-routes library than pure Hunchentoot to define
+routes, as we did in the tutorial, so skip to its section below if you
+want. However, it can only be benificial to know the built-in
+Hunchentoot ways.
 
-{{% notice info %}}
-
-I prefer the easy-routes library than pure Hunchentoot to define routes, skip to its section if you want.
-
-{{% /notice %}}
 
 ## Hunchentoot
 
@@ -171,7 +170,7 @@ You probably have nothing to do to get the value of those parameters: if you def
 
 However, here's how to interact more with URL parameters. In particular, we can define the default type of a parameter: they are strings by default, but we can ask to receive an integer.
 
-### Hunchentoot
+### Hunchentoot URL parameters
 
 First of all, note that we can access query parameters anytime with
 
@@ -192,15 +191,15 @@ We defined the following handler:
 ~~~lisp
 (hunchentoot:define-easy-handler (say-yo :uri "/yo") (name)
   (setf (hunchentoot:content-type*) "text/plain")
-  (format nil "Hey~@[ ~A~]!" name))
+  (format nil "Hey ~a!" name))
 ~~~
 
 The variable `name` is a string by default. Let's check it out:
 
 ~~~lisp
 (hunchentoot:define-easy-handler (say-yo :uri "/yo") (name)
   (setf (hunchentoot:content-type*) "text/plain")
-  (format nil "Hey~@[ ~A~] you are of type ~a" name (type-of name)))
+  (format nil "Hey ~a you are of type ~a" name (type-of name)))
 ~~~
 
 Going to [http://localhost:4242/yo?name=Alice](http://localhost:4242/yo?name=Alice) returns

content/building-blocks/simple-web-server.md

@@ -8,7 +8,7 @@ Before dwelving into web development, we might want to do something simple: serv
 
 ### Serve local files
 
-Create and start a webserver like this:
+If you followed the tutorial you know that we can create and start a webserver like this:
 
 ~~~lisp
 (defvar *acceptor* (make-instance 'hunchentoot:easy-acceptor :port 4242))

content/building-blocks/templates.md

@@ -7,7 +7,7 @@ weight = 30
 ### Djula - HTML markup
 
 [Djula](https://github.com/mmontone/djula) is a port of Python's
-Django template engine to Common Lisp. It has [excellent documentation](https://mmontone.github.io/djula/doc/build/html/index.html).
+Django template engine to Common Lisp. It has [excellent documentation](https://mmontone.github.io/djula/djula/).
 
 Install it if you didn't already do it:
 
@@ -61,13 +61,13 @@ the most downloaded libraries of Quicklisp.
 #### Djula filters
 
 Filters allow to modify how a variable is displayed. Djula comes with
-a good set of built-in filters and they are [well documented](https://mmontone.github.io/djula/doc/build/html/filters.html). They are not to be confused with [tags](https://mmontone.github.io/djula/doc/build/html/tags.html).
+a good set of built-in filters and they are [well documented](https://mmontone.github.io/djula/djula/Filters.html#Filters). They are not to be confused with [tags](https://mmontone.github.io/djula/djula/Tags.html#Tags).
 
-They look like this: `{{ name | lower }}`, where `lower` is an
+They look like this: `{{ var | lower }}`, where `lower` is an
 existing filter, which renders the text into lowercase.
 
-Filters sometimes take arguments. For example: `{{ value | add:2 }}` calls
-the `add` filter with arguments `value` and 2.
+Filters sometimes take arguments. For example: `{{ var | add:2 }}` calls
+the `add` filter with arguments `var` and 2.
 
 Moreover, it is very easy to define custom filters. All we have to do
 is to use the `def-filter` macro, which takes the variable as first
@@ -76,11 +76,11 @@ argument, and which can take more optional arguments.
 Its general form is:
 
 ~~~lisp
-(def-filter :myfilter-name (value arg) ;; arg is optional
+(def-filter :myfilter-name (var arg) ;; arg is optional
    (body))
 ~~~
 
-and it is used like this: `{{ value | myfilter-name }}`.
+and it is used like this: `{{ var | myfilter-name }}`.
 
 Here's how the `add` filter is defined:
 
@@ -112,9 +112,10 @@ HTML5 generator. It looks like this:
   (:footer ("Last login: ~A" *last-login*)))
 ~~~
 
-The author finds it is easier to compose the HTML in separate
-functions and macros than with the more famous cl-who. But it
-has more features under it sleeves:
+I find it is easier to compose the HTML than with the more famous
+cl-who, but I personnally prefer to use HTML templates.
+
+Spinneret has nice features under it sleeves:
 
 - it warns on invalid tags and attributes
 - it can automatically number headers, given their depth