Skip to content
This repository was archived by the owner on Sep 25, 2024. It is now read-only.

Commit 8eba541

Browse files
authored
update documentation and examples (#40)
update documentation and examples
2 parents 888730a + 7aeb0dd commit 8eba541

File tree

3 files changed

+30
-29
lines changed

3 files changed

+30
-29
lines changed

README.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -37,30 +37,40 @@ This repository contains the following examples and functionality:
3737

3838
```
3939
---
40-
title: Example Page
40+
title: Collections Page
4141
layout: data
42-
permalink: /jobs
43-
datafile: jobs
42+
permalink: /collections
43+
datafile: collections
4444
---
4545
```
4646

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.
4848

4949
✅ 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.
5050

5151
```
5252
---
53-
title: Example Page with Sidebar
53+
title: Document with Sidenav
5454
layout: page
5555
sidenav: true
56-
permalink: /example-page-with-sidebar
56+
permalink: /document-with-sidenav
5757
---
5858
```
5959

60-
6160
✅ Enable search with [Search.gov](https://search.gov) by adding option to `_config.yml`.
6261

6362

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+
6474
## How to edit
6575
- 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.
6676
- 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.
@@ -69,6 +79,7 @@ permalink: /example-page-with-sidebar
6979
- You will most certainly need to edit files in `_includes/`, which include the primary menu, side navigation, logos etc
7080
- `index.html` may not require much editing, depending on how you customize `hero.html` and `highlights.html`.
7181
- `_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.
7283
- `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)
7384
- Non-developers should focus only on `_posts` and `_pages`
7485

@@ -108,7 +119,6 @@ Note that when built by Federalist, `npm run federalist` is used instead of the
108119
- [Jekyll](https://jekyllrb.com/docs/) - The primary site engine that builds your code and content.
109120
- [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.
110121
- [U.S. Web Design System v 2.0](https://v2.designsystem.digital.gov)
111-
- [Jekyll Search](https://github.com/18F/jekyll_pages_api_search/)
112122

113123

114124
## Contributing
Lines changed: 9 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,19 @@
11
# 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
33
# Reference this data file in 'datafile' in the Front Matter and _layouts/list.html renders it
44
# 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
77
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
88

9-
- name: Cloud Adoption Specialist
10-
url: https://join.tts.gsa.gov/
9+
- name: USDA
10+
url: http://usda.gov/
1111
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
1212

13-
- name: Contact Center Specialist
14-
url: https://join.tts.gsa.gov/
13+
- name: Performance.gov
14+
url: http://performance.gov/
1515
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec dapibus interdum pellentesque. Integer eu vehicula elit. Sed cursus magna in dui suscipit rhoncus.
1616

17-
- name: Customer Experience Specialist
18-
url: https://join.tts.gsa.gov/
17+
- name: Login.gov
18+
url: https://login.gov
1919
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.
28-
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: Jobs
2+
title: Collections
33
layout: data
4-
permalink: /jobs
5-
datafile: jobs
4+
permalink: /collections
5+
datafile: collections
66
---
77

88
This is an example for list data file contents

0 commit comments

Comments
 (0)