Documentation site for cloud.gov Cloud Foundry
CSS JavaScript HTML
Pull request Compare This branch is 1263 commits behind 18F:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
archetypes
content
data
layouts
static
static_src
.gitignore
CONTRIBUTING.md
LICENSE.md
README.md
Staticfile
config.toml
manifest.yml
package.json
wercker.yml

README.md

18F CF Docs wercker status

This repository contains the site code for the 18F Cloud Foundry documentation.

Contributing

Hugo uses markdown to build the pages. Just add your page to the section you want inside the content folder.

Running the site locally

  1. This project uses Hugo to build the site. Once Hugo is installed, run hugo to build the site.
  2. Run npm install to download all the dependencies.
  3. Run npm run build to build all the assets.
  4. Run hugo server --renderToDisk and browse to http://localhost:1313.

Style development

This site uses a shared cloud.gov style, cg-style. This means any styling code has to be developed in cg-style.

  1. Download or clone the cg-style repository, git clone git@github.com:18F/cg-style.git
  2. Run the watching build task in the cg-style repository: npm run watch
  3. Run npm install in the cg-docs repository.
  4. Run npm link in cg-docs.
  5. Run the watching build task in cg-docs repository: npm run watch
  6. Edit code in the cg-style directory and they will propagate down to cg-docs

Acknowledgement

The theme for the site has been "forked" from the Hugo documentation.