Até onde chega a cultura?

O projeto

Estamos a criar um mapa dos equipamentos culturais em Portugal:

Este é um projeto comunitário do Interruptor inspirado na série Até onde chega a cultura?, que explora a distribuição geográfica de diversos equipamentos no nosso território para tentar perceber o alcance da cultura. Foi iniciado durante o Hacktoberfest 2020.

Os contribuidores iniciais incluem membros de várias comunidades locais ligadas aos movimentos de cultura e software livres, nomeadamente: Flutter, Python, Ubuntu e Wikimedia.

É possível ter acesso ao mapa por meio deste link.

O que queremos mapear?

• bibliotecas
• teatros
• cinemas
• museus
• recintos de espectáculo
• galerias de arte
• monumentos

Contribuir

Qualquer pessoa pode contribuir para este repositório. Contribuições para o projeto pressupõem a aceitação da licença associada e do nosso Código de Conduta.

Como contribuir?

1. Faz um fork do repositório.
2. Verifica se há algum issue aberto em que possas começar a ajudar.
3. Faz um pull request.

Se ainda estás a dar os primeiros passos no Github, eis alguma documentação útil:

• Como fazer fork de um repositório
• Como fazer um pull request

Como adicionar novas localizações ao mapa?

A informação apresentada no mapa é recolhida a partir de entradas existentes no Wikidata.

Adicionar uma nova entrada

1. É provável que algumas localizações já existam no Wikidata, mas apenas não estejam associadas às categorias acima indicadas, pelo que convém procurar se as mesmas existem e editá-las.
   • NOTA: Mesmo que seja criada uma entrada duplicada não haverá problema, pois as mesmas podem ser fundidas posteriormente.
2. No menu lateral do Wikidata, escolher "Criar um objecto novo" e acrecentar a informação nos campos obrigatórios.
   • NOTA: A língua tem de ser pt ou en.
3. Depois de criar o objecto, é preciso adicionar propriedades que correspondam aos filtros usados para popular o mapa. Escolher adicionar declaração e depois procurar as propriedades relevantes. As seguintes são as mandatórias:
   1. país - Portugal
   2. coordenadas geográficas - introduzir as coordenadas do local
   3. instância de - define a categoria do local. Escolher para as categorias do mapa:
      1. Bibliotecas - biblioteca OU biblioteca municipal
      2. Cinemas - sala de cinema
      3. Galerias - galeria de arte
      4. Monumentos - monumento
      5. Museus - museu
      6. Recintos - casa de shows
      7. Teatros - teatro
   4. Quando escolher o valor para cada propriedade, clicar em publicar.
   5. Pode-se enriquecer os dados do local adicionado com outras categorias que sejam relevantes.

Editar uma entrada existente

1. Procurar a entrada que se quer editar, no ficheiro correspondente da pasta static-data/;
2. Aceder ao Wikidata com o link associado, e fazer as edições necessárias como indicado no screenshot abaixo:

Ver no mapa

Os dados do mapa são actualizados automaticamente todos os dias, através do script de Python update_static_data.py, que extrai a informação a partir do Wikidata, e atualiza o repositório (se necessário) com os dados novos. Este processo automático é executado por meio de uma GitHub Action que está configurada em update_static_data.yml.

Licença

O código desenvolvido e partilhado neste repositório é disponibilizado sob uma licença GNU-GPL3.0. Esta é uma licença de software livre que garante quatro liberdades fundamentais ao utilizador:

• Liberdade para utilizar o código para qualquer finalidade;
• Liberdade para estudar o código-fonte e para adaptá-lo conforme necessário;
• Liberdade para copiar e redistribuir o código;
• Liberdade para melhorar o código e redistribuir versões modificadas.

O código pode ser usado com fins comerciais. Contudo, novas versões devem garantir que o código-fonte continua público e acessível. Podes consultar uma tradução não oficial da licença para português aqui.