govuk_tech_docs 1.9.0.pre.rc2 → 2.0.0.pre.test.pre.release.pre.524

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. checksums.yaml +5 -5
  2. data/.ruby-version +1 -1
  3. data/.travis.yml +4 -1
  4. data/CHANGELOG.md +7 -2
  5. data/example/.ruby-version +1 -1
  6. data/govuk_tech_docs.gemspec +23 -4
  7. data/lib/assets/javascripts/govuk_tech_docs.js +2 -0
  8. data/lib/assets/stylesheets/_core.scss +0 -48
  9. data/lib/assets/stylesheets/_govuk_tech_docs.scss +4 -8
  10. data/lib/assets/stylesheets/modules/_anchored-heading.scss +6 -6
  11. data/lib/assets/stylesheets/modules/_app-pane.scss +46 -47
  12. data/lib/assets/stylesheets/modules/_collapsible.scss +7 -3
  13. data/lib/assets/stylesheets/modules/_contribution-banner.scss +9 -7
  14. data/lib/assets/stylesheets/modules/_footer.scss +6 -127
  15. data/lib/assets/stylesheets/modules/_page-review.scss +15 -14
  16. data/lib/assets/stylesheets/modules/_search.scss +53 -42
  17. data/lib/assets/stylesheets/modules/_technical-documentation.scss +65 -95
  18. data/lib/assets/stylesheets/modules/_toc.scss +76 -47
  19. data/lib/assets/stylesheets/palette/_syntax-highlighting.scss +5 -5
  20. data/lib/govuk_tech_docs.rb +13 -11
  21. data/lib/govuk_tech_docs/api_reference/api_reference_extension.rb +1 -1
  22. data/lib/govuk_tech_docs/api_reference/api_reference_renderer.rb +1 -0
  23. data/lib/govuk_tech_docs/api_reference/templates/api_reference_full.html.erb +1 -1
  24. data/lib/govuk_tech_docs/page_review.rb +1 -0
  25. data/lib/govuk_tech_docs/pages.rb +1 -1
  26. data/lib/govuk_tech_docs/redirects.rb +1 -1
  27. data/lib/govuk_tech_docs/table_of_contents/heading_tree_renderer.rb +1 -1
  28. data/lib/govuk_tech_docs/table_of_contents/headings_builder.rb +1 -1
  29. data/lib/govuk_tech_docs/table_of_contents/helpers.rb +1 -0
  30. data/lib/govuk_tech_docs/version.rb +1 -1
  31. data/lib/source/layouts/_footer.erb +32 -7
  32. data/lib/source/layouts/_header.erb +41 -27
  33. data/lib/source/layouts/_search.erb +4 -2
  34. data/lib/source/layouts/core.erb +7 -8
  35. data/lib/source/stylesheets/manifest.css +3 -0
  36. data/package-lock.json +3 -3
  37. data/package.json +3 -2
  38. metadata +38 -33
  39. data/lib/assets/stylesheets/_accessibility.scss +0 -9
  40. data/lib/assets/stylesheets/govuk_frontend_toolkit/_colours.scss +0 -2
  41. data/lib/assets/stylesheets/govuk_frontend_toolkit/_conditionals.scss +0 -81
  42. data/lib/assets/stylesheets/govuk_frontend_toolkit/_css3.scss +0 -90
  43. data/lib/assets/stylesheets/govuk_frontend_toolkit/_device-pixels.scss +0 -10
  44. data/lib/assets/stylesheets/govuk_frontend_toolkit/_font_stack.scss +0 -19
  45. data/lib/assets/stylesheets/govuk_frontend_toolkit/_grid_layout.scss +0 -136
  46. data/lib/assets/stylesheets/govuk_frontend_toolkit/_helpers.scss +0 -16
  47. data/lib/assets/stylesheets/govuk_frontend_toolkit/_measurements.scss +0 -14
  48. data/lib/assets/stylesheets/govuk_frontend_toolkit/_shims.scss +0 -55
  49. data/lib/assets/stylesheets/govuk_frontend_toolkit/_typography.scss +0 -249
  50. data/lib/assets/stylesheets/govuk_frontend_toolkit/_url-helpers.scss +0 -16
  51. data/lib/assets/stylesheets/govuk_frontend_toolkit/colours/_organisation.scss +0 -103
  52. data/lib/assets/stylesheets/govuk_frontend_toolkit/colours/_palette.scss +0 -77
  53. data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_alpha-beta.scss +0 -66
  54. data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_breadcrumbs.scss +0 -53
  55. data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_buttons.scss +0 -141
  56. data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_media-player.scss +0 -242
  57. data/lib/assets/stylesheets/modules/_govuk-logo.scss +0 -47
  58. data/lib/assets/stylesheets/modules/_header.scss +0 -289
  59. data/lib/assets/stylesheets/modules/_skip-link.scss +0 -31
  60. data/lib/source/images/gov.uk_logotype_crown-2x.png +0 -0
  61. data/lib/source/images/gov.uk_logotype_crown.png +0 -0
  62. data/lib/source/images/gov.uk_logotype_crown_invert_trans.png +0 -0
  63. data/lib/source/images/govuk-crest-2x.png +0 -0
  64. data/lib/source/images/govuk-crest.png +0 -0
  65. data/lib/source/images/open-government-licence.png +0 -0
  66. data/lib/source/images/open-government-licence_2x.png +0 -0
@@ -1,19 +0,0 @@
1
- // GOV.UK font stacks, referred to in typography.scss
2
-
3
- // Allow uppercase letters in font stack variable names
4
- // scss-lint:disable NameFormat
5
-
6
- // New Transport Light
7
- $NTA-Light: "nta", Arial, sans-serif;
8
- $NTA-Light-Tabular: "ntatabularnumbers", $NTA-Light;
9
-
10
- // Helvetica Regular
11
- $Helvetica-Regular: "HelveticaNeue", "Helvetica Neue", "Arial", "Helvetica", sans-serif;
12
-
13
- // Allow font stack to be overridden
14
- // Not all apps using toolkit use New Transport
15
- $toolkit-font-stack: $NTA-Light !default;
16
- $toolkit-font-stack-tabular: $NTA-Light-Tabular !default;
17
-
18
- // Font reset for print
19
- $Print-reset: sans-serif;
@@ -1,136 +0,0 @@
1
- @import 'conditionals';
2
- @import 'css3';
3
- @import 'measurements';
4
- @import 'shims';
5
-
6
- $site-width: 960px;
7
-
8
- // An extendable selector to wrap your entire site content block
9
- // It limits the sites width to be 960px wide and maintains consistent margins
10
- // on the site of the page and shrinks the margins for mobile.
11
- //
12
- // Usage:
13
- //
14
- // #page-container {
15
- // @extend %site-width-container;
16
- // }
17
-
18
- %site-width-container {
19
- max-width: $site-width;
20
-
21
- @include ie-lte(8) {
22
- width: $site-width;
23
- }
24
-
25
- margin: 0 $gutter-half;
26
-
27
- @include media(tablet) {
28
- margin: 0 $gutter;
29
- }
30
-
31
- @include media($min-width: ($site-width + $gutter * 2)) {
32
- margin: 0 auto;
33
- }
34
- }
35
-
36
- // An extendable selector to outdent to the full page-width
37
- // So that you can create elements that take up the gutters on the side of the
38
- // page and butt up to the edge of the browser on smaller screens (rather than
39
- // leaving a gutter at the edge of the page).
40
- //
41
- // Usage:
42
- //
43
- // .hero-image-container {
44
- // @extend %outdent-to-full-width;
45
- // }
46
- %outdent-to-full-width {
47
- margin-left: -$gutter-half;
48
- margin-right: -$gutter-half;
49
-
50
- @include media(tablet) {
51
- margin-left: -$gutter;
52
- margin-right: -$gutter;
53
- }
54
- }
55
-
56
- // An extendable selector to define a row for grid columns to sit in
57
- //
58
- // Usage:
59
- //
60
- // .grid-row {
61
- // @extend %grid-row;
62
- // }
63
-
64
- %grid-row {
65
- @extend %contain-floats;
66
- margin: 0 (-$gutter-half);
67
- }
68
-
69
- // A mixin for a grid column
70
- // Creates a cross browser grid column with a standardised gutter between the
71
- // columns. Widths should be defined as fractions of the full desktop width
72
- // they want to fill. By default they break to become full width at tablet size
73
- // but that can be configured to be desktop using the `$full-width` argument.
74
- //
75
- // Usage:
76
- //
77
- // .column-quarter {
78
- // @include grid-column( 1/4 );
79
- // }
80
- // .column-half {
81
- // @include grid-column( 1/2 );
82
- // }
83
- // .column-third {
84
- // @include grid-column( 1/3 );
85
- // }
86
- // .column-two-thirds {
87
- // @include grid-column( 2/3 );
88
- // }
89
- // .column-desktop-third {
90
- // @include grid-column( 1/3, $full-width: desktop );
91
- // }
92
-
93
- @mixin grid-column($width, $full-width: tablet, $float: left) {
94
-
95
- @include media($full-width) {
96
- float: $float;
97
- width: percentage($width);
98
- }
99
-
100
- @include ie-lte(7) {
101
- width: (($site-width + $gutter) * $width) - $gutter;
102
- }
103
-
104
- padding: 0 $gutter-half;
105
- @include box-sizing(border-box);
106
- }
107
-
108
-
109
- // OLD deprecated grid mixins
110
- // You should migrate to the mixins above in the future
111
-
112
- // Outer block sets a max width
113
- @mixin outer-block {
114
- @warn "The @mixin outer-block is deprecated and should be updated to use new grid helpers";
115
- margin: 0 auto;
116
- width: auto;
117
- max-width: 960 + $gutter * 2;
118
- @extend %contain-floats;
119
-
120
- @include ie-lte(8) {
121
- width: 1020px;
122
- }
123
- }
124
-
125
- // Inner block sets either margin or padding
126
- // to align content with header and footer
127
- @mixin inner-block($margin-or-padding: padding) {
128
- @warn "The @mixin inner-block is deprecated and should be updated to use new grid helpers";
129
- #{$margin-or-padding}-left: $gutter-half;
130
- #{$margin-or-padding}-right: $gutter-half;
131
-
132
- @include media(tablet) {
133
- #{$margin-or-padding}-left: $gutter;
134
- #{$margin-or-padding}-right: $gutter;
135
- }
136
- }
@@ -1,16 +0,0 @@
1
- // Base font size in pixels
2
- $base-font-size: 16;
3
-
4
- // Convert pixels to em
5
- @function pem($px, $base: $base-font-size) {
6
-
7
- @if (unitless($px)) {
8
- $px: $px * 1px;
9
- }
10
-
11
- @if (unitless($base)) {
12
- $base: $base * 1px;
13
- }
14
-
15
- @return $px / $base * 1em;
16
- }
@@ -1,14 +0,0 @@
1
- // Measurements used across GOV.UK
2
-
3
- $full-width: 100%;
4
- $one-quarter: $full-width / 4;
5
- $one-third: $full-width / 3;
6
- $half: $full-width / 2;
7
- $two-thirds: ($full-width) - ($one-third);
8
- $three-quarters: ($full-width) - ($one-quarter);
9
-
10
- $gutter: 30px;
11
- $gutter-one-quarter: $gutter / 4;
12
- $gutter-one-third: $gutter / 3;
13
- $gutter-half: $gutter / 2;
14
- $gutter-two-thirds: $gutter - $gutter-one-third;
@@ -1,55 +0,0 @@
1
- // Cross-browser shims
2
- // Ways of normalising properties across browsers.
3
-
4
- @import "conditionals";
5
-
6
- // From: https://blog.mozilla.org/webdev/2009/02/20/cross-browser-inline-block/
7
-
8
- // Usage:
9
- //
10
- // @include inline-block
11
- // or
12
- // @include inline-block("250px")
13
- //
14
- // which gives a min-height to the inline-block elements.
15
-
16
-
17
- @mixin inline-block($min-height: "") {
18
- display: -moz-inline-stack;
19
- display: inline-block;
20
-
21
- @if $min-height != "" {
22
- min-height: $min-height;
23
- }
24
-
25
- @include ie-lte(7) {
26
- zoom: 1;
27
- display: inline;
28
- }
29
-
30
- @include ie(6) {
31
- @if $min-height != "" {
32
- height: $min-height;
33
- }
34
- }
35
- }
36
-
37
-
38
- // Contain floats usage:
39
- //
40
- // .this-has-floated-children {
41
- // @extend %contain-floats;
42
- // }
43
-
44
-
45
- %contain-floats {
46
- &:after {
47
- content: "";
48
- display: block;
49
- clear: both;
50
- }
51
-
52
- @include ie-lte(7) {
53
- zoom: 1;
54
- }
55
- }
@@ -1,249 +0,0 @@
1
- @import 'font_stack';
2
- @import 'conditionals';
3
- @import 'device-pixels';
4
- @import 'url-helpers';
5
-
6
- // GOV.UK typography palettes
7
-
8
- // ANATOMY OF A TYPE STYLE
9
- // -----------------------
10
- // These are a collection of graphic styles. They are deliberately
11
- // abstracted from semantic HTML context to enable flexible re-use.
12
- // Although there is a lot of duplication within this file, as long
13
- // as you GZIP your CSS it shouldnt cause any bloat.
14
-
15
-
16
- // CORE FONTS - NEW TRANSPORT
17
-
18
- // Allow uppercase letters in font stack variable names
19
- // scss-lint:disable NameFormat
20
-
21
- $is-print: false !default;
22
-
23
- @mixin _core-font-generator($font-size: 19px, $font-size-640: 16px, $font-size-print: 14pt, $line-height: (25 / 19), $line-height-640: (20 / 16), $tabular-numbers: false, $font-weight: 400) {
24
- @if $tabular-numbers == true {
25
- font-family: $toolkit-font-stack-tabular;
26
- } @else if $is-print {
27
- font-family: $Print-reset;
28
- } @else {
29
- font-family: $toolkit-font-stack;
30
- @if $toolkit-font-stack == "$NTA-Light" {
31
- @if $font-weight > 400 {
32
- font-size-adjust: 0.525;
33
- } @else {
34
- font-size-adjust: 0.5;
35
- }
36
- }
37
- }
38
- font-weight: $font-weight;
39
- text-transform: none;
40
-
41
- @if $is-print {
42
- font-size: $font-size-print;
43
- line-height: $line-height;
44
-
45
- } @else {
46
- font-size: $font-size-640;
47
- line-height: $line-height-640;
48
-
49
- @include media(tablet) {
50
- font-size: $font-size;
51
- line-height: $line-height;
52
- }
53
- }
54
- }
55
- // scss-lint:enable NameFormat
56
-
57
- @mixin core-80($line-height: (80 / 80), $line-height-640: (55 / 53), $tabular-numbers: false, $font-weight: 400) {
58
- $font-size: 80px;
59
- $font-size-640: 53px;
60
- $font-size-print: 28pt;
61
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
62
- }
63
-
64
- @mixin core-48($line-height: (50 / 48), $line-height-640: (35 / 32), $tabular-numbers: false, $font-weight: 400) {
65
- $font-size: 48px;
66
- $font-size-640: 32px;
67
- $font-size-print: 18pt;
68
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
69
- }
70
-
71
- @mixin core-36($line-height: (40 / 36), $line-height-640: (25 / 24), $tabular-numbers: false, $font-weight: 400) {
72
- $font-size: 36px;
73
- $font-size-640: 24px;
74
- $font-size-print: 18pt;
75
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
76
- }
77
-
78
- @mixin core-27($line-height: (30 / 27), $line-height-640: (20 / 18), $tabular-numbers: false, $font-weight: 400) {
79
- $font-size: 27px;
80
- $font-size-640: 20px;
81
- $font-size-print: 16pt;
82
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
83
- }
84
-
85
- @mixin core-24($line-height: (30 / 24), $line-height-640: (24 / 20), $tabular-numbers: false, $font-weight: 400) {
86
- $font-size: 24px;
87
- $font-size-640: 18px;
88
- $font-size-print: 16pt;
89
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
90
- }
91
-
92
- @mixin core-19($line-height: (25 / 19), $line-height-640: (20 / 16), $tabular-numbers: false, $font-weight: 400) {
93
- $font-size: 19px;
94
- $font-size-640: 16px;
95
- $font-size-print: 14pt;
96
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
97
- }
98
-
99
- @mixin core-16($line-height: (20 / 16), $line-height-640: (16 / 14), $tabular-numbers: false, $font-weight: 400) {
100
- $font-size: 16px;
101
- $font-size-640: 14px;
102
- $font-size-print: 12pt;
103
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
104
- }
105
-
106
- @mixin core-14($line-height: (20 / 14), $line-height-640: (15 / 12), $tabular-numbers: false, $font-weight: 400) {
107
- $font-size: 14px;
108
- $font-size-640: 12px;
109
- $font-size-print: 11pt;
110
- @include _core-font-generator($font-size, $font-size-640, $font-size-print, $line-height, $line-height-640, $tabular-numbers, $font-weight);
111
- }
112
-
113
- @mixin bold-80($line-height: (80 / 80), $line-height-640: (55 / 53), $tabular-numbers: false) {
114
- @include core-80($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
115
- }
116
-
117
- @mixin bold-48($line-height: (50 / 48), $line-height-640: (35 / 32), $tabular-numbers: false) {
118
- @include core-48($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
119
- }
120
-
121
- @mixin bold-36($line-height: (40 / 36), $line-height-640: (25 / 24), $tabular-numbers: false) {
122
- @include core-36($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
123
- }
124
-
125
- @mixin bold-27($line-height: (30 / 27), $line-height-640: (20 / 18), $tabular-numbers: false) {
126
- @include core-27($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
127
- }
128
-
129
- @mixin bold-24($line-height: (30 / 24), $line-height-640: (24 / 20), $tabular-numbers: false) {
130
- @include core-24($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
131
- }
132
-
133
- @mixin bold-19($line-height: (25 / 19), $line-height-640: (20 / 16), $tabular-numbers: false) {
134
- @include core-19($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
135
- }
136
-
137
- @mixin bold-16($line-height: (20 / 16), $line-height-640: (16 / 14), $tabular-numbers: false) {
138
- @include core-16($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
139
- }
140
-
141
- @mixin bold-14($line-height: (20 / 14), $line-height-640: (15 / 12), $tabular-numbers: false) {
142
- @include core-14($line-height, $line-height-640, $tabular-numbers: $tabular-numbers, $font-weight: 700);
143
- }
144
-
145
- @mixin heading-80($tabular-numbers: false) {
146
- @include core-80($tabular-numbers: $tabular-numbers);
147
-
148
- display: block;
149
-
150
- padding-top: 8px;
151
- padding-bottom: 7px;
152
-
153
- @include media(tablet) {
154
- padding-top: 6px;
155
- padding-bottom: 14px;
156
- }
157
- }
158
-
159
- @mixin heading-48($tabular-numbers: false) {
160
- @include core-48($tabular-numbers: $tabular-numbers);
161
-
162
- display: block;
163
-
164
- padding-top: 10px;
165
- padding-bottom: 10px;
166
-
167
- @include media(tablet) {
168
- padding-top: 7px;
169
- padding-bottom: 13px;
170
- }
171
- }
172
-
173
- @mixin heading-36($tabular-numbers: false) {
174
- @include core-36($tabular-numbers: $tabular-numbers);
175
-
176
- display: block;
177
-
178
- padding-top: 8px;
179
- padding-bottom: 7px;
180
-
181
- @include media(tablet) {
182
- padding-top: 6px;
183
- padding-bottom: 9px;
184
- }
185
- }
186
-
187
- @mixin heading-27($tabular-numbers: false) {
188
- @include core-27($tabular-numbers: $tabular-numbers);
189
-
190
- display: block;
191
-
192
- padding-top: 8px;
193
- padding-bottom: 7px;
194
-
195
- @include media(tablet) {
196
- padding-top: 4px;
197
- padding-bottom: 6px;
198
- }
199
- }
200
-
201
- @mixin heading-24($tabular-numbers: false) {
202
- @include core-24($tabular-numbers: $tabular-numbers);
203
-
204
- display: block;
205
-
206
- padding-top: 9px;
207
- padding-bottom: 6px;
208
-
209
- @include media(tablet) {
210
- padding-top: 6px;
211
- padding-bottom: 4px;
212
- }
213
- }
214
-
215
- @mixin copy-19($tabular-numbers: false) {
216
- @include core-19($tabular-numbers: $tabular-numbers);
217
-
218
- padding-top: 2px;
219
- padding-bottom: 8px;
220
-
221
- @include media(tablet) {
222
- padding-top: 0;
223
- padding-bottom: 5px;
224
- }
225
- }
226
-
227
- @mixin copy-16($tabular-numbers: false) {
228
- @include core-16($tabular-numbers: $tabular-numbers);
229
-
230
- padding-top: 8px;
231
- padding-bottom: 7px;
232
-
233
- @include media(tablet) {
234
- padding-top: 5px;
235
- padding-bottom: 5px;
236
- }
237
- }
238
-
239
- @mixin copy-14($tabular-numbers: false) {
240
- @include core-14($tabular-numbers: $tabular-numbers);
241
-
242
- padding-top: 8px;
243
- padding-bottom: 7px;
244
-
245
- @include media(tablet) {
246
- padding-top: 5px;
247
- padding-bottom: 5px;
248
- }
249
- }