- A relatively "modern" version of Perl (5.20+ recommended)
- PostgreSQL
These days, I recommend using plenv to install a local version of Perl that doesn't muck with your system perl binary.
To do that, just:
git clone git://github.com/tokuhirom/plenv.git ~/.plenv
echo 'export PATH="$HOME/.plenv/bin:$PATH"' >> ~/.bash_profile
echo 'eval "$(plenv init -)"' >> ~/.bash_profile
exec $SHELL -l
git clone git://github.com/tokuhirom/Perl-Build.git ~/.plenv/plugins/perl-build/
plenv install 5.20.0
For PostgreSQL, if you're on an Apple product, you'll probably want to use homebrew or the fancy, new Postgre app.
Once you've got those working, move on!
First, fork the repository so that you have your own copy. Then:
git clone [email protected]:yourusername/support.thetyee.ca.git
git checkout develop (Always work on the develop branch while developing!)
git submodule init && git submodule update (this installs the public files)
If you don't have NPM installed, you'll need to do that first by installing Node.js. Just download and install the package that's available for your operating system from the Node website.
Then, to install Bower, the JavaScript package manager, run:
npm install bower -g
Then, to install the project's JavaScript dependencies, run:
bower install inside of the public directory.
You should see output relating to Bootstrap, jQuery, and so on.
From here, if you don't have a global install of cpanm, you'll want to install that with the command plenv install-cpanm (this assumes that you installed Perl with plenv as described above).
Next, to localize the libraries that the project requires, you'll want to install Carton:
cpanm install Carton
Then install the project requirements into a local directory so that you know you're using the right ones:
cd support.thetyee.ca
carton install
At this point, you should probably go make a coffee or get a glass of wine or something, as it'll probably take a while to install all of the dependencies.
When that finishes, you should have a local directory full of libraries.
Get them from the secret repository!
You'll need:
- app.development.json
- sqitch/sqitch.conf
You'll want to udpate the values in app.development.json and sqitch/sqitch.conf to point to your local PostgreSQL database.
Next, you'll want to load the required table(s) into PostgreSQL using sqitch. You can do that like so:
cd sqitch
carton exec sqitch deploy
If that worked, you should see something like:
Deploying changes to db:pg:tyeedb_dev
- schema ................ ok
- transactions @v0.2.6 .. ok
- transactions @v0.3.0 .. ok
- transactions @v0.3.4 .. ok
- transactions @v1.0.4 .. ok
- transactions @v1.0.5 .. ok
- transactions .......... ok
At this point you should have everything needed to start developing. Run the app in development mode with:
carton exec morbo app.pl
And, if everything worked, you should see:
Server available at http://127.0.0.1:3000.
Do NOT pass go. Do NOT collect $200. Just enjoy the moment.
The development server will reload the app when any of the files are edited. So you can just edit the template files and the single-file application to your needs and refresh your browser to see the results.
Errors will be written to your terminal, as well as shown in the browser.
When you're done making changes, create a new pull request pointing from the branch that you're working on locally (probaby develop) pointing to the develop branch at https://github.com/phillipadsmith/support.thetyee.ca
Submit the pull request and congratulate yourself on a job well done. :)
First, you need to update the files on the server.
Using terminal, log in to the remote server (thetyee.ca)
cd preview.support.thetyee.ca/www/
Make sure you're on the develop branch:
git branch
Then sync up!
git pull
Then, redeploy the application:
MOJO_MODE='preview' MOJO_LOG_LEVEL='debug' hypnotoad app.pl
MOJE_MODE tells the app which config file to use. I.e. MOJO_MODE='preview' will look for the app.preview.json file.
Static files stored on a different part of the server.
To access, log in to thetyee.ca
cd static.thetyee.ca/www/support/[version]
git pull
For more substantial changes, you'll want to create a new directory.
Log in to thetyee.ca
cd static.thetyee.ca/www/support
git clone https://github.com/phillipadsmith/support.thetyee.ca-static.git v[version number]
cd v[version number]
bower install