Esta página supõe que o WSAPI e o Orbit já foram instalados e configurados.

A instalação do rock orbit inclui vários exemplos de uso do Orbit. Estes exemplos ficam na pasta rocks/orbit/X.Y.Z-V/samples do seu sistema (onde X.Y.Z-V se refere à versão instalada do Orbit. Note que o rock do Orbit tem o tamanho que tem devido à presença dos exemplos, o módulo Orbit em si é bem pequeno).

Cada exemplo de aplicação Orbit está em um diretório próprio, para saber mais sobre o exemplo op.ws (uma alternativa para o disparo de aplicações Orbit Pages) que fica na raiz verifique o arquivo README.

Primeiro exemplo: Hello!

Este exemplo serve para apresentar a estrutura básica de uma aplicação Orbit, a configuração do roteamento de URLs (dispatching) e a geração de conteúdo em si (rendering).

Entre em seu browser e digite a URL do exemplo mais simples de aplicação Orbit:

http://localhost:8080/hello/hello.lua

Você deveria ver a seguinte resposta:

Hello World!

Segundo exemplo: Songs

Este exemplo apresenta o uso do módulo Cosmo para a geração de conteúdo utilizando templates. Para instalar o Cosmo digite o comando

luarocks install cosmo

Entre em seu browser e digite a URL do exemplo de músicas do Orbit:

http://localhost:8080/songs/songs.lua

O resultado deveria ser a apresentação de uma lista de músicas dos Beatles.

Terceiro exemplo: Blog

Este exemplo apresenta uma aplicação Orbit bem mais sofisticada. Nele podemos ver um uso do Orbit Model para gerenciar informações em um banco de dados, a utilização de um arquivo de configuração para o detalhamento do funcionamento da aplicação e vários exemplos de geração de conteúdo (incluindo formulários).

Entre em seu browser e digite a URL do exemplo de blog Orbit:

http://localhost:8080/blog/blog.lua

O resultado deveria ser a apresentação da página inicial de um blog. A partir dela você pode navegar pelos artigos, ler os comentários e adicionar novos comentários. O blog de exemplo não oferece a funcionalidade de criação de novos artigos.

Quarto exemplo: ToyCMS

Este exemplo é uma evolução natural do exemplo de Blog. Nele também vemos o uso do Orbit Model para o gerenciamento de uma base de dados, mas agora é possível criar conteúdo novo.

O exemplo utiliza o módulo Cosmo que pode ser instalado com o comando

luarocks install cosmo

Entre em seu browser e digite a URL do exemplo de blog Orbit:

http://localhost:8080/toycms/toycms.lua

Esta URL apresenta um resultado bastante parecido com o do exemplo do Blog (já que os dois exemplos compartilham o mesmo layout, CSS e dados iniciais da base de dados), porém ele oferece uma URL de administração do sistema:

http://localhost:8080/toycms/toycms.lua/admin

Esta URL apresenta um formulário de login e, utilizando o nome do usuário admin e senha admin, permite o acesso ao sistema de gerenciamento em si.

A partir daí você poderá gerenciar as seções no site, os usuários, os artigos e os comentários em si (que podem ser moderados pelo administrador).