You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Sep 25, 2024. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+18-8Lines changed: 18 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,30 +37,40 @@ This repository contains the following examples and functionality:
37
37
38
38
```
39
39
---
40
-
title: Example Page
40
+
title: Collections Page
41
41
layout: data
42
-
permalink: /jobs
43
-
datafile: jobs
42
+
permalink: /collections
43
+
datafile: collections
44
44
---
45
45
```
46
46
47
-
The reference to `datafile` referers to the name of the file in `_data/jobs.yml` and loops through the values. Feel free to modify this as needed.
47
+
The reference to `datafile` referers to the name of the file in `_data/collections.yml` and loops through the values. Feel free to modify this as needed.
48
48
49
49
✅ There are two different kinds of `pages`, one does not have a side bar navigation, and the other uses `_includes/sidenav.html`. You can enable this option by adding `sidenav: true` to your page front matter.
50
50
51
51
```
52
52
---
53
-
title: Example Page with Sidebar
53
+
title: Document with Sidenav
54
54
layout: page
55
55
sidenav: true
56
-
permalink: /example-page-with-sidebar
56
+
permalink: /document-with-sidenav
57
57
---
58
58
```
59
59
60
-
61
60
✅ Enable search with [Search.gov](https://search.gov) by adding option to `_config.yml`.
62
61
63
62
63
+
```
64
+
---
65
+
searchgov:
66
+
endpoint: https://search.usa.gov # You should not change this.
67
+
affiliate: federalist-uswds-example # replace this with your search.gov account
68
+
access_key: your-access-key # This is placeholder. Not private.
69
+
inline: true #this renders the results on the same domain. Otherwise, it will render the results in the search.gov domain
70
+
---
71
+
```
72
+
73
+
64
74
## How to edit
65
75
- We try to keep configuration options to a minimum so you can easily remove functionality, but you can review `_config.yml` to see the options that are available to you. There are a few values on top that you **need** to change. They make reference to the agency name and contact information. The advanced options at the bottom should be changed only if you know what you know what you're doing.
66
76
- Do not edit files in the `assets/` folder. This folder is reserved for serving assets once the sites is compiled. If you want add your own custom code, add and edit files in `src/`, ideally mirroring the `assets/` folder structure. This will keep the code repository small and not include unneccessary files.
- You will most certainly need to edit files in `_includes/`, which include the primary menu, side navigation, logos etc
70
80
-`index.html` may not require much editing, depending on how you customize `hero.html` and `highlights.html`.
71
81
-`_layouts/` may require the least amount of editing of all the files since they are primarily responsible for printing the content.
82
+
-`blog/search.html` is by search.gov. If you need to stylize results page, this is where you will do it.
72
83
-`blog/index.html` can be edited, but be careful. It will impact the pagination system for the posts. If you do edit the file, be prepared to edit `_config.yml`. You should also familiarize yourself with [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2)
73
84
- Non-developers should focus only on `_posts` and `_pages`
74
85
@@ -108,7 +119,6 @@ Note that when built by Federalist, `npm run federalist` is used instead of the
108
119
-[Jekyll](https://jekyllrb.com/docs/) - The primary site engine that builds your code and content.
109
120
-[Front Matter](https://jekyllrb.com/docs/frontmatter) - The top of each page/post includes keywords within `--` tags. This is meta data that helps Jekyll build the site, but you can also use it to pass custom variables.
110
121
-[U.S. Web Design System v 2.0](https://v2.designsystem.digital.gov)
# We can add any kind of data in this _data folder and this file.
2
-
# In this example, we create a simple array of options and then in the _pages/jobs.md file we
2
+
# In this example, we create a simple array of options and then in the _pages/collections.md file we
3
3
# Reference this data file in 'datafile' in the Front Matter and _layouts/list.html renders it
4
4
# This is simple, hopefully provides you with a good enough example to make changes as needed
5
-
- name: Site Lead
6
-
url: https://join.tts.gsa.gov/
5
+
- name: GSA
6
+
url: https://gsa.gov
7
7
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
8
8
9
-
- name: Cloud Adoption Specialist
10
-
url: https://join.tts.gsa.gov/
9
+
- name: USDA
10
+
url: http://usda.gov/
11
11
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
12
12
13
-
- name: Contact Center Specialist
14
-
url: https://join.tts.gsa.gov/
13
+
- name: Performance.gov
14
+
url: http://performance.gov/
15
15
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
16
16
17
-
- name: Customer Experience Specialist
18
-
url: https://join.tts.gsa.gov/
17
+
- name: Login.gov
18
+
url: https://login.gov
19
19
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
20
-
21
-
- name: Data Analytics Specialist
22
-
url: https://join.tts.gsa.gov/
23
-
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
24
-
25
-
- name: IT Infrastructure Optimization Specialist
26
-
url: https://join.tts.gsa.gov/
27
-
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
0 commit comments