Getting Started
-
you will need to install ruby on rails, which requires ruby…which requires a ruby manager. https://www.digitalocean.com/community/tutorials/how-to-install-ruby-on-rails-with-rbenv-on-ubuntu-16-04 look here if you dont know shit about that
-
you will need to install redis, imagemagick, and postgresql
-
Windows users – install ubuntu through virtualbox then go to the ubuntu guide
-
Mac users - https://meta.discourse.org/t/beginners-guide-to-install-discourse-on-macos-for-development/15772 (brew makes this easy)
-
Ubuntu - https://meta.discourse.org/t/beginners-guide-to-install-discourse-on-ubuntu-for-development/14727 (
Remember to:
- run rspec using bundle exec rspec to make sure your tests pass
- run redis (redis-server) and sidekiq (bundle exec sidekiq) whenever youre developing
- after the server boots up and you can access it locally create yourself an admin account with bundle exec rake admin:create (u can make normal users like this too)
- consider installing ember inspector, it might make it easier to write ember
Guides
- https://meta.discourse.org/t/beginners-guide-to-creating-discourse-plugins-part-1/30515
- How to start building stuff for Discourse if you’re newbie (like myself)
Misc Links
- Plugin list to learn from: https://github.com/discourse/all-the-plugins/tree/master/plugins
- Ember docs: https://guides.emberjs.com/v3.2.0/
- API Documentation for the discourse_api gem: https://docs.discourse.org/
- plugin api repo page - https://github.com/discourse/discourse/blob/master/app/assets/javascripts/discourse/lib/plugin-api.js.es6
- How connector classes work
- How to use Discourse core variables in your theme
Please ask any questions you have below so I can answer them and give help to everyohne else too.