This repository is no longer maintained.
Smartdown is a custom formatting language designed to generate HTML formatted questions. These questions can then be joined in a manner that articulates a full user journey.
Implementation details for each kind of question can be found in the documentation directory.
# A Formatting and Logic Language Smartdown helps GOV.UK users find the information they need without having to search through daunting official documentation. ## Some extra information you need to know before you start * Like bullet points * Can be used * Throughout this journey [start: step_1] ## Additional context after a start button Any more information down here
<div id="js-replaceable"> <header class="page-header group"> <div> <h1> A formatting and Logic Language </h1> </div> </header> <div class="article-container group"> <article role="article" class="group"> <div class="inner"> <div class="intro"> <p>Smartdown helps GOV.UK users find the information they need without having to search through daunting official documentation.</p> <h2 id="some-extra-information-you-need-to-know-before-you-start"> Some extra information you need to know before you start </h2> <ul> <li>Like bullet points</li> <li>Can be used</li> <li>Throughout this journey</li> </ul> <p class="get-started"> <a rel="nofollow" href="/step-1/y" class="big button"> Start now </a> </p> </div> <h2 id="additional-context-after-a-start-button"> Additional context after a start button </h2> <p>Any more information down here</p> </div> </article> </div> </div>
Which on GOV.UK will look like:
The language is designed to look like Markdown, but it has been extended to allow you to write in logic rules, questions and conditional blocks of text.
Start Pages, Questions and Outcomes are all a type of 'node'. A node represents a single user interaction (normally a web page, but in other media may be presented differently).
Each question and outcome is held in its own file. The name of the files are significant: they are used to identify each question.
Here's an example of the check-uk-visa flow:
-- check-uk-visa |-- outcomes | |-- general_y.txt | |-- joining_family_m.txt | |-- joining_family_y.txt | |-- marriage.txt | |-- medical_n.txt | |-- medical_y.txt | `-- ... |-- scenarios | |-- 1.txt | |-- 2.txt | `-- 3.txt |-- questions | |-- planning_to_leave_airport.txt | |-- purpose_of_visit.txt | |-- staying_for_how_long.txt | |-- what_passport_do_you_have.txt `-- check-uk-visa.txt
Currently smartdown relies on the Smart Answers application to run.
For GOV.UK developers you can
bowl smartanswers and navigate to an example flow such as http://smartanswers.dev.gov.uk/animal-example-multiple from within the GOV.UK VM.