plots2
v4.2 - Outreachy & Google Summer of Code Summer 2021
Система управления контентом для сообщества общедоступных лабораторий, веб -приложение plots2 , представляет собой комбинацию группового исследовательского блога -что мы называем «заметками исследований» -и вики. Узнайте больше о модели данных здесь.
Начните запустить (и внести свой вклад) эту кодовую базу немедленно с Gitpod:
Он демонстрирует множество функций, которые помогают общественному лаборатории сотрудничать в области экологических технологий, дизайна, документации и организации сообщества. Первоначально сайт Drupal, он был переписан в 2012 году с Ruby on Rails и с тех пор расширил, но еще не полностью заменил модель Drupal Drupal и дизайн базы данных. Мы ❤ с открытым исходным кодом и активно участвуем в различных программах OSS, таких как Google Summer of Code (GSOC), Rails Girls Summer of Code (RGSOC), Outreachy и Google Code-In (GCI). Некоторые ключевые функции включают:
Мы разрабатываем проектную дорожную карту для plots2 и наши более широкие проекты общедоступного лабораторного кода; Подробнее и прокомментируйте здесь.
Полное описание функций, аудитории, взаимосвязи и целей проектов общественного программного обеспечения можно найти здесь: https://publiclab.org/software-overview
Люди, которые создают нашу платформу, принимают очень разные дизайнерские и технологические решения из других проектов. Это связано с нашей глубокой верой в то, что, чтобы увидеть изменения в мире, мы должны создавать и поддерживать системы, которые отражают наши ценности и принципы.
От проектирования до системной архитектуры до основных словарных и моделей связи, наши системы с 2010 года выросли органически для поддержки мощной, разнообразной и кооперативной сети людей, способных принять экологические проблемы, которые влияют на общины во всем мире. Платформа, которую мы создали вместе, говорит с этой общей историей во многих отношениях, большой и маленькой. Он отражает вклад людей, сталкивающихся с серьезными проблемами здоровья, организаторами на земле, специалистах по политике, аппаратным хакерам, педагогам и государственным служащим.
Это широкое сообщество и общественная лабораторная команда облегчили пространство, где мы можем обсудить, разрушать, строить, прототип и критиковать реальные проекты. Вместе мы сформировали платформу, которая включает знакомые произведения, но в конечном итоге выглядит и чувствует себя совершенно отличным от чего -либо еще в Интернете. Несмотря на рост нашей платформы, она по -прежнему привержена услышанию голосов других, взаимного уважения и поддержки, осознания барьеров и проблем, представленных пробелами в опыте и знаниях, а также чувствительности к неравенству и дисбалансу власти, увековеченными многими основными способами производства знаний и технологического и научного развития.
Наша взаимная цель-демократизировать недорогие и доступные методы самостоятельного самостоятельного. Наши цели поддерживаются и облегчаются системой, которая вопросы и даже бросает вызов, как может случиться совместная работа.
(Выше: черновик нашей модели данных)
Мы приветствуем взносы и особенно заинтересованы в приветствующей участниках. Узнайте больше о том, как внести ниже! Мы особенно приветствуем вклад людей, принадлежащих группам, недостаточно представленным в бесплатном и с открытым исходным программным обеспечением!
Пожалуйста, прочитайте и соблюдайте наш кодекс поведения; Наше сообщество стремится стать уважительным местом как во время онлайн, так и во время личных взаимодействий.
Для установки предпосылки включают SQLite3 и RVM. Нажмите здесь для полного списка и инструкций.
git clone https://github.com/your_username/plots2.git где your_username - ваше имя пользователя GitHub.cd plots2 .git remote add upstream https://github.com/publiclab/plots2.gitbundle install если у вас есть более старые драгоценные камни в вашей среде от предыдущей работы Rails. Если вы получите сообщение об ошибке, например, Your Ruby version is 2.xx, but your Gemfile specified 2.7.3 , вам необходимо установить Ruby версию 2.7.3, используя rvm или rbenv .rvm install 2.7.3 с последующим rvm use 2.7.3rbenv install 2.7.3 с последующим rbenv local 2.7.3bundle config set without 'production mysql' из корневой папки Rails, чтобы установить свой проект, чтобы исключить только библиотеки, необходимые для производства.bundle install из корневой папки Rails.cp db/schema.rb.example db/schema.rb , чтобы сделать копию db/schema.rb.example в db/schema.rb .sqlite3 в качестве базы данных DLOTS2, так как некоторые из наших участников сообщили о проблемах при использовании mysql2 .cp config/database.yml.mysql.example config/database.yml для создания копии config/database.yml.mysql.example в config/database.ymlcp config/database.yml.sqlite.example config/database.yml , чтобы создать копию config/database.yml.sqlite.example в config/database.yml . Пожалуйста, обратите внимание, если вы решите использовать SQLite, некоторые тесты могут провалиться. Первоначально проект был настроен на использование MySQL, а некоторые тесты предназначены для MySQL DB. Нет необходимости в тревоге, мы работаем над тем, чтобы исправить их, и это не мешает вашему процессу разработкиrake db:setup для настройки базы данныхyarn installrails webpacker:install && rails webpacker:install:react && rails generate react:install (для локальной работы SSL, см. SSL ниже)passenger start и перейдите по адресу http://localhost:3000/ в вашем браузере.rails test , чтобы подтвердить, что ваша установка работает должным образом. Вы также можете запустить rails test:system для системных тестов. ( Примечание: если вы выбрали SQLite в качестве базы данных, некоторые тесты могут сбой; Пожалуйста, игнорируйте их, мы работаем над тем, чтобы исправить это. Если ваш сервер запускается правильно, вы все настроены )Мы рекомендуем вам либо работать в виртуальной среде, либо с двойной загруженной системой, чтобы избежать проблем зависимостей, так как системы UNIX, как правило, работают более плавным с Ruby и Rails. Это не только принесет вам пользу сейчас для PLATS2, но и в будущем во время работы над другими проектами Ruby, ОС на основе Linux или Mac облегчит вашу разработку.
Прежде чем продолжить шаги установки в этой Readme, пользователи подсистемы Windows для Linux 2 (WSL 2) должны открыть терминал WSL 2 и ввести приведенные ниже команды.
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)Общественная лаборатория использует Redis и может потребоваться для некоторых функциональных возможностей при запуске приложения локально.
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 и ответ должен быть pongquitbrew services start redisredis-serverbundle exec sidekiqВ Public Lab мы используем Gem OpenSSL для предоставления SSL (уровень Secure Sockets) для безопасного соединения (HTTPS) в режиме разработки. Вы можете запустить HTTPS Connection на Localhost через следующие шаги:
passenger start --ssl --ssl-certificate config/localhost.crt --ssl-certificate-key config/localhost.key --ssl-port 3001 .После завершения установки используйте любой из этих учетных данных для входа на веб -сайт PL в вашей локальной среде разработки/тестирования, чтобы получить дополнительные разрешения только для регистрации в пользователях. Каждый поставляется со своим собственным набором разрешений; Тем не менее, опыт между ними в значительной степени такой же.
Имя пользователя : admin , moderator или user
Пароль : password
Подробнее о системах входа в систему см. Эта страница
Нажмите здесь, чтобы получить полное описание тестирования и здесь, чтобы узнать о системных тестах.
whenever --update-crontab для обновления заданий Cron.crontab -l Для некоторых будет необходимо подготовить ваши команды, связанные с драгоценными камнями, с помощью bundle exec . Например, bundle exec passenger start . Добавление bundle exec гарантирует, что вы используете версию пассажира, которую вы только что установили с помощью Bundler. bundle exec rake db:setup , bundle exec rake db:seed - другие примеры того, где это может потребоваться.
Public Lab теперь поддерживает функцию «Ответить по электронной почте на комментарий». Для получения более подробной информации перейдите к документации по электронной почте
Чтобы сообщить об ошибках и функциях запроса, используйте трекер выпуска GitHub
Для получения дополнительной поддержки присоединяйтесь к веб -сайту общедоступной лаборатории и списку рассылки по адресу http://publiclab.org/lists. Для срочных запросов по электронной почте [email protected]
Это приложение использует Recaptcha только через драгоценный камень Recaptcha в производстве. Для получения дополнительной информации нажмите здесь.
Publiclab.org теперь поддерживает интернационализацию и локализацию, хотя мы находимся на начальных этапах. Это было достигнуто с Rails-I8N.
Чтобы увидеть его в действии, нажмите на раскрывающую очередь «язык», расположенный в разделе нижнего колонтитула страницы. Все руководящие принципы и лучшие практики для I18N можно найти здесь.
Переводы расположены в файлах YAML здесь, которые установлены аналогично файлам представлений. Пример для добавления переводов можно найти здесь.
С момента реализации нашей новой системы перевода мы теперь используем помощника translation() , найденного здесь. Это предоставляет некоторые дополнительные функции перевода, такие как вставка подсказки, видимые для посетителей сайта, если перевод еще не существует. Вы можете узнать больше о нашей системе перевода, прочитав наши документы системы перевода.
Чтобы добавить новые языки или для дополнительной поддержки, пожалуйста, напишите по адресу [email protected]
Чтобы сообщить о уязвимости безопасности или для вопросов о безопасности, пожалуйста, свяжитесь с [email protected]. Наша веб -рабочая группа будет оцениваться и ответить быстро.
Помогите улучшить общественное лабораторное программное обеспечение!
Новичок в открытом исходном/свободном программном обеспечении? Вот подборку проблем, которые мы сделали , особенно для новичков . Мы здесь, чтобы помочь, так что спросите, выглядит ли кто -то интересным: https://code.publiclab.org
Вот ссылка на наш рабочий процесс GIT.
Хотите внести свой вклад в Publiclab как часть Hacktoberfest? Проверьте наши документы Hacktoberfest
