Skip to content
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.github
_accessibility-inclusivity
_assets
_content-structure
_formatting
_includes
_layouts
_numbers-measurements
_pages
_plugins
_punctuation-grammar
_search-engines
_terms-phrases
_types-of-content
_writing-style
images/uikit/icons
.editorconfig
.gitignore
.ruby-version
CHANGELOG.md
Dockerfile
Gemfile
Gemfile.lock
LICENSE.md
README.md
_config.yml
android-chrome-192x192.png
android-chrome-512x512.png
apple-touch-icon.png
browserconfig.xml
favicon.ico
index.md
manifest-production.yml
manifest-staging.yml
manifest-testing.yml
manifest.json
manifest.yml
mstile-150x150.png
nginx.conf
robots-production.txt
robots.txt
safari-pinned-tab.svg

README.md

Content Guide

This guide is designed to help people working in the Australian Government create simpler, clearer and faster information.

Live site: https://guides.service.gov.au/content-guide/

Staging site: https://content-guide.apps.y.cld.gov.au/

Test sites: https://content-guide-[test-branchname].apps.y.cld.gov.au/

Visual tests: https://github.com/govau/backstop-content-guide-tests


Test environments (automatic provisioning)


Table of contents

  1. Feedback
  2. Contributing
  3. Developer information
  4. Copyright and license

Feedback

You can leave feedback to the guide in numerous ways:

  1. via the email feedback buttons and links in the guide (Please join our Content Design in Government Google Group to give feedback)
  2. via GitHub issues.

Contributing

ToDo: add useful information here :)

Markdown

To mark-up your content, write in Markdown. We use the 'kramdown' (default) markdown parser, which provides a couple of extra features. For a reference on what's possible see the kramdown quick reference.

Developer information

This guide is built with Jekyll.

Setup

You would only need to do the following if you are a developer. If you are a content editor you can access and editing content for the guide directly via GitHub. However, it can be nice having the guide locally to work and preview --- feel free to ask a developer if you would like to set up a local instance of the guide.

Prep:

git clone github.com:govau/content-guide
cd content-guide
git submodule init
git submodule update

You have two options to instantiate a local environment. Use the Docker option which handles dependency management automatically, or do it yourself.

Option 1: Docker

This option creates a Docker container with all required dependencies and their versions and allows you to keep your host clean. It lets you move between similar projects that require different versions of the same dependencies more easily.

Build the local Docker container:

docker build -t content-guide .

And run it while in the content-guide directory. This will resolve all application dependencies, serve over port 80 and watch over local changes.

docker run --rm --volume="$PWD:/workdir" -p 80:4000 -it content-guide

Point your browser to your docker host, eg http://localhost/content-guide/

Option 2: DIY

  • Ruby
  • Jekyll

We also pull in the 1.x version of the UI-Kit as a submodule.

We will likely change this, and instead package up everything needed to produce a new guide scaffold as a Ruby gem for Jekyll to consume.

Setup locally

gem install bundler
bundle install

Launch locally

bundle exec jekyll serve

If you get gem errors, try

rbenv rehash

If you still have troubles ask for help! (:

Broken link testing

Internal links are tested as part of the CI build pipeline in bin/citest.sh, however to keep test results reproducible external links are skipped.

You should periodically manually test external links with:

bin/checkexternal.sh

Copyright and license

Copyright Digital Transformation Agency. Licensed under the Creative Commons Attribution 4.0 International Public License. See LICENSE file for more details.

About the DTA

The Content Guide is maintained and funded by the Digital Transformation Agency.

You can’t perform that action at this time.