Open graham2 opened 6 years ago
Hi @graham2
Nice to hear you are willing to contribute!
1) Install the project locally
You may face some missing dependencies, if so, please comment for us to document, we already know that python3-dev is needed if you are on Ubuntu Linux.
git clone https://github.com/rochacbruno/quokka
cd quokka
python3 -m venv venv
. venv/bin/activate
make install
make adduser
make devserver
Then access http://localhost:5000 and http://localhost:5000/admin
With the project running you can start posting new articles and pages and exploring the admin UI and also the front-end theme, also you can hack the quokka/project_template/quokka.yml
and play with different options there to see the result, for example, you can change the theme:ACTIVE
for one of those in the themes
folder (bootstrap3, malt, etc..) and then report new issues if you find some.
1) Report issues you may find 2) By exploring the CMS you can add some kind of documentation, how to install, how to create an article, how to change the theme, how to enable/disable the debug toolbar etc...
Then I think you will be able to pick some of the opened issues to implement.
Hi Bruno, This seems the simplest way to send you a message - so - I did say a few months ago that I was interested and could probably contribute and now that time has arrived. However while I have done plenty of coding (since the 70s) I've only just moved to Python. Having said that the first project (a Pyside application) does seem to work; I also had a look at Flask some months ago, so it's not completely new. I have forked quokka and had a quick look at the code so my real request is, apart from asking if there is any program design documentation, is which 'issues' would be a reasonable place to start ? If you could offer some suggestions that would be relatively small and offer a good introduction to the code.
graham