ate-onde-chega-cultura
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?
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?
- Faz um fork do repositório.
- Verifica se há algum issue aberto em que possas começar a ajudar.
- Faz um pull request.
Se ainda estás a dar os primeiros passos no Github, eis alguma documentação útil:
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
- É 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.
- 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.
- 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:
- país - Portugal
- coordenadas geográficas - introduzir as coordenadas do local
- instância de - define a categoria do local. Escolher para as categorias do mapa:
- Bibliotecas - biblioteca OU biblioteca municipal
- Cinemas - sala de cinema
- Galerias - galeria de arte
- Monumentos - monumento
- Museus - museu
- Recintos - casa de shows
- Teatros - teatro
- Quando escolher o valor para cada propriedade, clicar em publicar.
- Pode-se enriquecer os dados do local adicionado com outras categorias que sejam relevantes.
Editar uma entrada existente
- Procurar a entrada que se quer editar, no ficheiro correspondente da pasta static-data/;
- 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.