This repository contains the sources for the Paylogic developer portal hosted at developer.paylogic.com. We use the static site generator Pelican to generate the web pages from content written in the reStructuredText format.

The git repository is hosted on our GitHub account and we use GitHub Pages with a custom DNS name for hosting.

To run the developer portal locally (e.g. to easily preview changes) the following steps should help you get started:

# Clone the git repository.
git clone [email protected]:paylogic/dev-portal.git

# Create, activate and initialize the virtual environment.
virtualenv ~/.virtualenvs/dev-portal
source ~/.virtualenvs/dev-portal/bin/activate
pip install -r dev-portal/requirements.txt

# Run Pelican and view the result in a web browser.
cd dev-portal
make devserver
gnome-open http://127.0.0.1:8000

If you 1) followed the steps above, 2) have push access to paylogic/dev-portal and 3) have activated the virtual environment, then all you need to publish the latest changes to the live website is to run the command make github. This will publish your changes using GitHub Pages.

This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License.