geoinfo-smdu / geosampa-mais-livre

GeoSampa+livre é um complemento para browser que adiciona algumas funcionalidades ao site do GeoSampa
GNU General Public License v3.0
2 stars 0 forks source link

GeoSampa+livre

GeoSampa+livre é uma extensão para browser que adiciona algumas funcionalidades ao site do GeoSampa

Motivação

Recebemos sempre várias sugestões de novas funcionalidades para o site do GeoSampa e nem sempre é possível atender com a agilidade a todas as solicitações. O que nos motiva criar uma extensão para o GeoSampa é justamente mostrar que é possível, de maneira relativamente simples, propor novas funcionalidades, e até ajustar o site para um propósito mais específico.

Sobretudo com essa iniciativa queremos estimular a cidadania entendendo que cada munícipe tem autonomia de usar um recurso público, como um site, da maneira que considerar melhor, um dos princípios de um governo aberto.

Portanto, usando esse projeto como inspiração, motivação para aprender como fazer uma extensão, ou mesmo colaborando com novas funcionalidades para esta extensão queremos levar os dados abertos, sobretudo os geográficos, para mais pessoas e de forma mais simples.

Como contribuir

Utilizando o plugin

Essa é a principal forma de contribuir, quanto mais cidadãs e cidadões utilizarem o plugin é um estimulo para novas funcionalidades, para mais pessoas utilizarem, contribuirem, documentarem. Portanto esse é o primeiro passo para contribuir.

Documentando e ensinando outros a usarem

Documentar é o uma forma de contribuir também, principalmente nas mais diversas formas: manuais, screencasts, podcasts, trabalhos acadêmicos, cursos presenciais, enfim qualquer forma de ensinar ou indicar um determinado uso.

Propondo novas funcionalidades

Quem programa, as vezes, não tem a dimensão real do uso, nem das possibilidades de uso. Em contrapartida quem usa nem sempre sabe da viabilidade técnica da implantação de determinada funcionalidade. Propor e discutir novas funcionalidades é um exercício democrático dos mais importantes aqui.

Descrevendo e identificando bugs

As vezes as coisas não saem como o previsto, mesmo nas versões em produção. Identificou algum bug, informe-nos aqui.

Programando

Essa é sem dúvida a parte mais fácil, depois de tudo documentado, a funcionalidade estabelecida por consenso, ou o bug bem descrito. Programar é o que temos de mais fácil para fazer :) Não sabe programar, essa é uma ótima forma de aprender, contribuindo com um projeto livre, sobretudo esse que contribui com a cidade.

Como usar

O Plugin do GeoSampa, o GeoSampa+Livre está disponível nas lojas dos Browser Firefox e Google Chrome. Basta fazer uma pesquisa por GeoSampa em qualquer uma das duas lojas de aplicativo, os links diretos estão abaixo:

Para desenvolver

Pré-requisitos

Instruções

  1. Clone este repositório.
git clone https://github.com/geoinfo-smdu/geosampa-mais-livre.git
  1. Instale as dependências do projeto

    cd geosampa-mais-livre
    npm install
  2. Inicie o ambiente de desenvolvimento

    npm run dev
  3. Abra o chrome. Utilizando a barra de navegação vá para

chrome://extensions
  1. Habilite o modo de desenvolvedor
  2. Selecione "Carregar sem compactação"
  3. Procure e selecione o diretório dist gerado pelo run dev
  4. Vá para o site do geosampa. Se tudo der certo você deverá ver o ícone colorido da extensão icone na barra do navegador.

Para publicar

Rode o comando para criar o pacote da publicação

npm run build

O comando irá criar um diretório dist. Publique o conteúdo deste diretório.