1. <em id="lgh8k"><acronym id="lgh8k"><u id="lgh8k"></u></acronym></em>

      2. <span id="lgh8k"></span>
        <span id="lgh8k"></span>
          <em id="lgh8k"><acronym id="lgh8k"><input id="lgh8k"></input></acronym></em>

          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: git@github.com:coapp/www.ustasia.com.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


          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 git@github.com:username/www.ustasia.com.git

          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 git@github.com:username/www.ustasia.com.git
          Cloning into www.ustasia.com...
          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\>cd www.ustasia.com
          c:\project\www.ustasia.com\>git remote add upstream git@github.com:username/www.ustasia.com.git
          c:\project\www.ustasia.com\>git fetch upstream
          c:\project\www.ustasia.com\>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 www.ustasia.com
          c:\project\www.ustasia.com\> 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 www.ustasia.com
          c:\project\www.ustasia.com\> 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.