Checking out the source code for CoApp Website



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:

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

at your own location:

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:

REM Assuming that you want to work in the c:\project\ folder:

c:\> mkdir c:\project
c:\> cd c:\project

c:\project\> git clone --recursive

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:

c:\project>git clone --recursive
Cloning into
remote: Counting objects: 4542, done.
remote: Compressing objects: 100% (3352/3352), done.
remote: Total 4542 (delta 899), reused 4359 (delta 716)
Receiving objects: 100% (4542/4542), 8.46 MiB | 130 KiB/s, done.
Resolving deltas: 100% (899/899), done.


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:

c:\project\\>git remote add upstream
c:\project\\>git fetch upstream
c:\project\\>git merge upstream/master

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:

c:\project\> cd

c:\project\\> generate.cmd 

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:

c:\project\> cd

c:\project\\> server.cmd 

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.