Checking out the source code for CoApp Website

Version:1.0



Requirements:

You'll need the following in order to correctly set up your development environment for working on CoApp:

You don't need any other special software to work with the Website source code.

Fork the CoApp website

The CoApp website (the one you're currently reading) is available in source form from the GitHub project.

The Git repository for the CoApp project is found at: git@github.com:coapp/coapp.org.git

The easiest way to collaborate in the CoApp documentation development is to follow the Fork + Pull Model well defined and supported by GitHub.

Follow the Fork A Repo guide to set up your own fork of repository

git@github.com:coapp/coapp.org.git

at your own location:

git@github.com:username/coapp.org.git

where username is your GitHub user name.

Then, you will be ready to check out and work with the CoApp website source code.

Checking out the CoApp website

To check out the website's source code from the command prompt, you can run the following:

404 Not Found

Error: Not Found

The requested URL / was not found on this server.

It will run for a bit (it takes time to do the initial checkout):

When it's done you will see something similar to this:

404 Not Found

Error: Not Found

The requested URL / was not found on this server.

A quick reminder: username stands for your own GitHub user name.

Configuring Git remotes

If the CoApp website in the repository you forked from gets updated, you can add those updates to your fork:

404 Not Found

Error: Not Found

The requested URL / was not found on this server.

The overall workflow of fetching and merging upstream changes as well as pushing your commits to the fork is described in the Fork A Repo guide. So, refer to this guide for details if needed.

Running the DocPad site generator

The DocPad site generator runs in two modes: Server and Generate.

Generate just regenerates the website into the out folder and then exits.

Server starts a mini webserver and watches the src folder for changes, and regenerates the website every time a file is changed. The website generates in about 10-15 seconds. Once the server is running you can preview the website with a browser pointed to http://localhost:9778/index.html .

Running DocPad in Generate mode

You can run the DocPad in generate mode by just running the generate.cmd script found in the project folder:

404 Not Found

Error: Not Found

The requested URL / was not found on this server.

You should see:

Running docpad in Generate mode

Running DocPad in Server mode

You can run the DocPad by just running the server.cmd found in the project folder:

404 Not Found

Error: Not Found

The requested URL / was not found on this server.

You should see:

Running docpad in Server mode

and you can open up a browser:

Running docpad in Server mode

Press CTRL-C a couple of times to stop the server.