Skip to content

alphagov-mirror/whitehall

 
 

Repository files navigation

whitehall

whitehall is a Ruby on Rails content management application for content published by government departments and agencies.

Running the Application

Startup using govuk-docker.

There are two different views within this App, a Publishing view and a Site view. Once running, whitehall does not have an index, some suggested starting pages are below:

Publishing view:

Site view:

Some pages will need data locally to display, whitehall uses mySQL. You'll need to gain relevant permissions to access data from AWS

Nomenclature

  • Govspeak A variation of Markdown used throughout whitehall as the general publishing format

Technical documentation

whitehall is a Ruby on Rails app built on a MySQL database. It is deployed in two modes: 'admin' for publishers to create and manage content and 'frontend' for rendering some content under https://www.gov.uk/government and https://www.gov.uk/world. whitehall also sends most content to the publishing-api and rummager.

Dependencies

Local development dependencies

This application uses Ruby dependencies installed via Bundler and npm dependencies installed via Yarn.

These can be installed with:

bundle install
yarn install

Dependent GOV.UK apps

Other documentation

Generating technical documentation

We use YARD for the technical documentation. You can generate a local copy with:

yard server --reload

You can also read the docs on rdoc.info.

Licence

MIT License

Packages

No packages published

Languages

  • Ruby 80.8%
  • HTML 10.0%
  • JavaScript 3.8%
  • SCSS 3.8%
  • Gherkin 1.4%
  • Shell 0.1%
  • Other 0.1%