Service Manual Publisher is used for publishing and maintaining https://gov.uk/service-manual. This application, together with service-manual-frontend replaced the previous Jekyll-based service manual.
- Guide: A service manual guide is the main document format used for manuals.
- Guide Community: A profile page that represents the community who curate a collection of guides.
- Topic: A collection of guides.
PostgreSQL-backed Rails 4 "Publishing 2.0" application for internal use, with no public facing aspect.
The Service manual's guide pages have a nested URL structure which is unusual for GOV.UK. The pros and cons to the nested URL structure are retrospectively documented.
- publishing-api
- PostgreSQL
To handle image uploads
To persist and render guides
To index and search published guides
NB: Every application above may have its own dependencies
You will need to clone down all these repositories, and run the following commands for each one:
bundle
bundle exec rake db:setup
You can use Bowler to automatically run
the application and all of its dependencies. To do this, you'll need to check
out the development repository where the
Pinfile is located.
cd /var/govuk/development
bowl service-manual-publisher service-manual-frontend
Alternatively, run ./startup.sh in the service-manual-publisher directory on
the development VM.
cd /var/govuk/service-manual-publisher
./startup.sh
The application runs on port 3111 by default. If you're using the GDS VM it's
exposed on http://service-manual-publisher.dev.gov.uk.
The application has a style guide that can be accessed on /style-guide.
bundle exec rake