A cozinha
De onde vêm os eventos
Esta agenda não organiza nada: recolhe. Aqui está de onde, com que regras, o que ainda fica de fora — e como levar estes dados daqui para outro sítio.
0 fontes ligadas, 2 concelhos, uma recolha por noite. Cada evento recolhido guarda o endereço de onde veio e leva-o na ficha, no botão «Página oficial» — a agenda não se põe à frente de quem faz o trabalho. O que chega por email não tem página de origem para apontar: tem quem o enviou, e passa por uma pessoa antes de aparecer.
As agendas de cada concelho
Uma por município, mais as salas que publicam a sua própria programação com detalhe que a agenda da câmara não traz.
Sem fonte automática de momento: Vila da Charamela, Ponte do Bombo. O que houver nestes concelhos entra por email, e continua a aparecer na agenda como o resto.
O que ainda não entra
Agenda do Município da Ponte do Bombo
Ponte do Bombo
Agenda do Município da Vila da Charamela
Vila da Charamela
Cine-Teatro da Charamela — calendário
Vila da Charamela
Fonte de demonstração da montra: o endereço não existe e nunca será pedido. A linha regista o leitor de calendários iCalendar, por onde entra qualquer calendário público — do Google Calendar ao Outlook — com uma linha e sem código.
Sociedade Filarmónica da Ponte — agenda
Ponte do Bombo
Fonte de demonstração da montra: o endereço não existe e nunca será pedido. A linha regista o leitor de dados estruturados schema.org (JSON-LD), por onde entra qualquer página de agenda que os publique — a maioria dos plugins de eventos fá-lo sem que ninguém na casa saiba.
Há ainda 0 espaços com sítio próprio que não são lidos diretamente — coletividades, museus, bibliotecas, juntas. O que eles fazem só chega aqui se a câmara o publicar ou se alguém o enviar. Não é uma falha da recolha: é o mapa do que falta. A lista dos espaços está aqui.
Com que regras
- Só a fonte primária
- Lê-se de quem organiza ou de quem programa: a câmara, a sala, a rede intermunicipal. Nunca de agregadores nem de bilheteiras de terceiros — uma agenda feita da agenda dos outros não acrescenta nada a ninguém.
- Nunca contra um bloqueio
- Quando um servidor responde que não a quem o vem ler, pede-se autorização; não se dá a volta. Contornar um controlo de acesso sem autorização não é recolha.
- Devagar, e identificados
- Um pedido de cada vez por servidor, com um agente que diz quem é e onde nos encontrar. Do outro lado está quase sempre a máquina que também serve os balcões online do concelho.
- Nunca fabricar
- O que a fonte não diz fica por dizer. Um evento sem data não entra, um local que não vem escrito não se adivinha, uma hora que não está publicada não se inventa.
- O espaço tem de ficar no concelho
- Há nomes que se repetem na região — há um «Cine-Teatro São Pedro» em Abrantes e outro em Alcanena. Um nome que case com um espaço de outro concelho que não o do evento não casa: fica por resolver, à espera de quem o saiba desfazer. Um ponto a setenta quilómetros do sítio certo é pior do que ponto nenhum.
- Uma pessoa antes da publicação
- O que chega por email é lido por alguém antes de aparecer. E o que a recolha traz com pouca confiança vai para a mesma fila, em vez de entrar sozinho.
De madrugada, uma vez por noite, cada fonte é lida por sua vez. O que vem é normalizado — datas, horas, concelho, categoria — e comparado com o que já cá está, para não haver duplicados quando o mesmo evento aparece em duas fontes.
Uma recolha que traga muito menos do que o costume não escreve nada: é o sinal de que o site mudou de forma, e nesse caso é preferível manter o que se tinha ontem a esvaziar a página. Uma fonte que falhe 5 noites seguidas fica em pausa 24 horas e volta a ser tentada sozinha depois disso — o erro fica guardado, para quem for ver saber o que aconteceu.
Um evento que acontece não é apagado: é arquivado. Sai da agenda, dos feeds e do mapa, que são do que está para vir, e deixa de ter ficha própria. A excepção é a programação que pertence a um ciclo com nome — essa fica legível na página do ciclo, porque uma edição que já aconteceu é o melhor argumento para a próxima. O que for arquivado por estar errado, por ser duplicado ou por ter desaparecido da fonte não volta a ver-se.
Levar estes dados daqui
Os feeds, o calendário, a API e a caixa para colar no vosso sítio passaram a viver todos na mesma página, porque são a mesma pergunta: Levar a agenda.
Falta aqui uma fonte
Falta de certeza — sobretudo das coletividades, que são metade da programação desta região e quase nada dos portais oficiais. Se organiza, programa ou apenas sabe de uma agenda que devia ser lida, diga. Se um evento que aparece aqui estiver errado, o mais provável é que esteja errado também na origem — mas escreva na mesma: corrige-se aqui e avisa-se lá.