plots2
v4.2 - Outreachy & Google Summer of Code Summer 2021
O sistema de gerenciamento de conteúdo para a comunidade de pesquisa de laboratório público, o aplicativo da Web plots2 é uma combinação de um blog de pesquisa em grupo -o que chamamos de "notas de pesquisa" -e um wiki. Leia mais sobre o modelo de dados aqui.
Comece a correr (e contribuir para) esta base de código imediatamente com o gitpod:
Ele mostra uma variedade de recursos que ajudam a comunidade pública de laboratório a colaborar em tecnologia ambiental, design, documentação e organização da comunidade. Originalmente um site Drupal, foi reescrito em 2012 com Ruby on Rails e, desde então, estendeu, mas ainda não substituiu completamente o modelo de dados DRUPAL e o design de banco de dados DRUPAL. Nós ❤ ❤ ❤ ❤ Open Source e participamos ativamente de vários programas de OSS, como Google Summer of Code (GSOC), Rails Girls Summer of Code (RGSOC), Extenção e Código do Google (GCI). Alguns recursos importantes incluem:
Estamos desenvolvendo um roteiro para plots2 e nossos projetos mais amplos de código de laboratório público; Leia mais e comente aqui.
Uma descrição completa dos recursos, públicos, inter-relações e metas de projetos de software de laboratório público pode ser encontrado aqui: https://publiclab.org/software-overview
As pessoas que criam nossa plataforma tomam decisões de design e tecnologia muito diferentes de outros projetos. Isso decorre de nossa profunda crença de que, para ver uma mudança no mundo, devemos construir e manter sistemas que reflitam nossos valores e princípios.
Do design à arquitetura do sistema aos padrões básicos de vocabulário e comunicação, nossos sistemas crescem organicamente desde 2010 para apoiar uma rede poderosa, diversa e cooperativa de pessoas capazes de enfrentar problemas ambientais que afetam as comunidades globalmente. A plataforma que construímos juntos fala dessa história compartilhada de várias maneiras, grande e pequena. Isso reflete a contribuição de pessoas que enfrentam sérios problemas de saúde, organizadores do solo, especialistas em políticas, hackers de hardware, educadores e funcionários públicos.
Essa ampla comunidade e a equipe de laboratório público facilitaram um espaço onde podemos discutir, quebrar, construir, protótipo e criticar projetos do mundo real. Juntos, moldamos uma plataforma que incorpora peças familiares, mas, finalmente, parece e parece bem diferente de qualquer outra coisa na internet. Apesar do crescimento de nossa plataforma, ele continua comprometido em ouvir as vozes de outras pessoas, respeito e apoio mútuos, consciência das barreiras e desafios apresentados por lacunas em especialização e conhecimento e uma sensibilidade às desigualdades e desequilíbrios de poder perpetuados por muitos modos convencionais de produção de conhecimento e desenvolvimento tecnológico e científico.
Nosso objetivo mútuo de democratizar as técnicas de doenças de fazer, barato e acessível, nos permitiu criar uma rede colaborativa de profissionais que re-imaginam ativamente o relacionamento humano com o meio ambiente. Nossos objetivos são apoiados e facilitados por um sistema que questiona e até desafia como o trabalho colaborativo pode acontecer.
(Acima: rascunho do nosso modelo de dados)
Congratulamo -nos com contribuições e estamos especialmente interessados em receber colaboradores iniciantes. Leia mais sobre como contribuir abaixo! Congratulamo-nos especialmente em contribuições de pessoas pertencentes a grupos sub-representados em software de código aberto e de código aberto!
Leia e cumpra nosso código de conduta; Nossa comunidade aspira a ser um lugar respeitoso durante as interações on-line e pessoal.
Para instalação, os pré -requisitos incluem SQLITE3 e RVM. Clique aqui para obter uma lista e instruções completas.
git clone https://github.com/your_username/plots2.git onde your_username é o seu nome de usuário do github.cd plots2 .git remote add upstream https://github.com/publiclab/plots2.gitbundle install se tiver gemas mais antigas em seu ambiente a partir do trabalho anterior do Rails. Se você receber uma mensagem de erro como Your Ruby version is 2.xx, but your Gemfile specified 2.7.3 , você precisará instalar o Ruby versão 2.7.3 usando rvm ou rbenv .rvm install 2.7.3 seguido pelo rvm use 2.7.3rbenv install 2.7.3 seguido pelo rbenv local 2.7.3bundle config set without 'production mysql' da pasta raiz do Rails para definir seu projeto para excluir bibliotecas necessárias apenas na produção.bundle install na pasta raiz do Rails.cp db/schema.rb.example db/schema.rb para fazer uma cópia de db/schema.rb.example em db/schema.rb .sqlite3 como seu banco de dados PLOTS2, pois alguns de nossos colaboradores relataram problemas ao usar mysql2 .cp config/database.yml.mysql.example config/database.yml para fazer uma cópia de config/database.yml.mysql.example em config/database.ymlcp config/database.yml.sqlite.example config/database.yml para fazer uma cópia de config/database.yml.sqlite.example em config/database.yml . Observe que, se você optar por usar o SQLite, alguns testes podem falhar. O projeto foi configurado inicialmente para usar o MySQL e alguns testes são adaptados para o MySQL DB. Não há necessidade de alarme, estamos trabalhando para corrigi -los e isso não interferirá no seu processo de desenvolvimentorake db:setup para configurar o banco de dadosyarn installrails webpacker:install && rails webpacker:install:react && rails generate react:install (para trabalho SSL local, consulte SSL abaixo)passenger start e navegue para http://localhost:3000/ no seu navegador.rails test para confirmar que sua instalação está funcionando corretamente. Você também pode executar rails test:system para testes do sistema. ( Nota: se você escolheu o SQLite como seu banco de dados, alguns testes podem falhar; ignore -os, estamos trabalhando para corrigir isso. Se o servidor iniciar corretamente, você estará pronto )Recomendamos que você trabalhe em um ambiente virtual ou em um sistema duplo para evitar problemas de dependências, pois os sistemas Unix tendem a trabalhar mais suavemente com rubi e trilhos. Isso não apenas o beneficiará agora para o Plots2, mas também no futuro, enquanto trabalha em outros projetos do Ruby, um sistema operacional baseado em Linux ou Mac facilitará seu desenvolvimento.
Antes de continuar com as etapas de instalação neste ReadMe, os usuários do Subsistema do Windows para Linux 2 (WSL 2) devem abrir o terminal WSL 2 e digitar os comandos abaixo.
sudo apt updatesudo apt install curl g++ gcc autoconf automake bison libc6-devsudo apt install libffi-dev libgdbm-dev libncurses5-dev libsqlite3-dev libtoolsudo apt install libyaml-dev make pkg-config sqlite3 zlib1g-dev libgmp-devsudo apt install libreadline-dev libssl-devsudo apt install gnupg2gpg2 --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDBcurl -sSL https://get.rvm.io | bash -s stablesource ~/.rvm/scripts/rvmrvm install ruby-xxx (this projects Ruby version)rvm --default use ruby-xxx (replace xxx with this project's Ruby version)O Public Lab usa o Redis e pode ser necessário para alguma funcionalidade ao executar o aplicativo localmente.
brew install redissudo yum -y install redissudo apt update && apt upgradesudo apt install Redis-serversudo nano /etc/redis/redis.confsudo service redis-server startredis-cliping & Response deve ser pongquitbrew services start redisredis-serverbundle exec sidekiqNo Public Lab, usamos o OpenSSL Gem para fornecer SSL (camada de soquetes seguros) para uma conexão segura (HTTPS) no modo de desenvolvimento. Você pode executar a conexão HTTPS no host nas etapas a seguir:
passenger start --ssl --ssl-certificate config/localhost.crt --ssl-certificate-key config/localhost.key --ssl-port 3001 .Depois de concluir a instalação, use qualquer uma dessas credenciais para fazer login no site do PL em seu ambiente de desenvolvimento/teste local para obter permissões adicionais apenas para usuários registrados. Cada um vem com seu próprio conjunto de permissões; No entanto, a experiência entre eles é praticamente a mesma.
Nome de usuário : admin , moderator ou user
Senha : password
Para saber mais sobre os sistemas de login, consulte esta página
Clique aqui para obter uma descrição abrangente dos testes e aqui para aprender sobre os testes do sistema.
whenever --update-crontab para atualizar os trabalhos CRON.crontab -l Para alguns, será necessário prender seus comandos relacionados ao GEM com bundle exec . Por exemplo, bundle exec passenger start . A adição de bundle exec garante que você esteja usando a versão do passageiro que acabou de instalar com o Bundler. bundle exec rake db:setup , bundle exec rake db:seed são outros exemplos de onde isso pode ser necessário.
O Public Lab agora suporta o recurso "Responder por e -mail para comentar". Para mais detalhes, vá para a documentação por e -mail
Para reportar bugs e solicitar recursos, use o rastreador de problemas do GitHub
Para obter suporte adicional, participe do site do Lab Public e da lista de discussão em http://publiclab.org/lists. Para solicitações urgentes, envie um email para [email protected]
Este aplicativo usa o Recaptcha através apenas da Gem Recaptcha apenas na produção. Para mais informações, clique aqui.
PublicLab.org agora apóia a internacionalização e a localização, embora estejamos nos estágios iniciais. Isso foi realizado com o Rails-I8N.
Para vê-lo em ação, clique no menu suspenso 'Idioma' localizado na seção Rodas da página. Todas as diretrizes e práticas recomendadas para i18n podem ser encontradas aqui.
As traduções são organizadas nos arquivos YAML aqui, que são definidos de maneira semelhante aos arquivos de exibição. Um exemplo para adicionar traduções pode ser encontrado aqui.
Desde a implementação de nosso novo sistema de tradução, agora usamos o auxiliar translation() , encontrado aqui. Isso fornece alguns recursos de tradução extras, como inserir um rápido visível para os visitantes do site, se ainda não existir tradução. Você pode aprender mais sobre nosso sistema de tradução lendo nossos documentos do sistema de tradução.
Para adicionar novos idiomas ou para suporte adicional, escreva para [email protected]
Para relatar vulnerabilidades de segurança ou para obter perguntas sobre segurança, entre em contato com [email protected]. Nosso grupo de trabalho da web avaliará e responderá prontamente.
Ajude a melhorar o software de laboratório público!
Novo para código aberto/software livre? Aqui está uma seleção de problemas que fizemos especialmente para iniciantes . Estamos aqui para ajudar, então pergunte se alguém parece interessante: https://code.publiclab.org
Aqui está um link para o nosso fluxo de trabalho Git.
Desejando contribuir com o PublicLab como parte da Hacktoberfest? Confira nossos documentos contribuintes com Hacktoberfest
