update docs

[kennedymwavu]

there are several sections that need to be updated:

• error in setting response status: https://ambiorix.dev/docs/ambiorix/errors/#global , should be app$status <- 500L
• show how to use nested routers
• more explanations on middlewares: route/endpoint specific? router specific?

new sections:

• how port to use is resolved, following fix: resolve port following a specific order ambiorix#75
• separate parameters & query into individual sections, with more details.
• separate projects & templates

[kennedymwavu]

• add nginx + docker compose as a load balancing option, add nginx + docker compose as a load balancing option devOpifex/ambiorix-site#10

nginx distributes traffic to the services/containers spawned by docker compose

supported load distribution methods:

• round-robin: sequential
• least-connected: requests are sent to the container with the fewest active connections
• ip-hash: routes requests from the same IP address to the same container for session persistence

[kennedymwavu]

• no need for explicit html templates, reference

[kennedymwavu]

• how to set global pre & post-render hooks, reference

[kennedymwavu]

• how to set multiple static directories

with this file structure:

.
├── another
│   └── the-ring.jpeg
├── index.R
└── public
    └── gollum.jpeg

you can:

library(ambiorix)
library(htmltools)

home_get <- \(req, res){
  html <- tagList(
    tags$h3("One ring to rule them all"),
    tags$img(src = "/assets2/the-ring.jpeg", alt = "the one ring")
  )

  res$send(html)
}

about_get <- \(req, res) {
  html <- tagList(
    tags$h3("My precious!"),
    tags$img(src = "assets/gollum.jpeg")
  )

  res$send(html)
}

Ambiorix$new()$
  static("public", "assets")$
  static("another", "assets2")$
  get("/", home_get)$
  get("/about", about_get)$
  start()