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
Copy file name to clipboardExpand all lines: pages/add_new_pages.md
+35-8
Original file line number
Diff line number
Diff line change
@@ -36,30 +36,57 @@ type: guides
36
36
{:start="5"}
37
37
5. Each new page that is included needs to be added to the `main.yml` file so that it appears in the left hand navigation menu.
38
38
39
-
An example of this code is provided below for the current How-to Guide:
39
+
Below is the `main.yml` from the template repository:
40
+
```yaml
41
+
subitems:
42
+
- title: Home
43
+
url: /index
44
+
- title: Example page
45
+
url: /example_page
46
+
- title: Contributors
47
+
url: /contributors
48
+
```
49
+
50
+
To create the guide you are currently viewing, this code was updated as follows:
40
51
41
52
```yaml
42
53
subitems:
43
-
- title: About
44
-
url: /
54
+
- title: Quick start
55
+
url: /quick_start
45
56
- title: 1. Create a new repository
46
57
url: /create_new
47
58
- title: 2. Update your landing page content
48
59
url: /update_index
49
60
- title: 3. Add new pages to your guide
50
61
url: /add_new_pages
51
-
- title: 4. Update configuration files
52
-
url: /structure
53
-
- title: 5. Test and improve your guide content
62
+
- title: 4. Test & improve your guide content
54
63
url: /improve_content
55
-
- title: 6. Make your guide citable
64
+
- title: 5. Make your guide citable
56
65
url: /zenodo
57
-
- title: Optional extra features
66
+
- title: Adding optional features
58
67
url: /extras
68
+
- title: About
69
+
url: /
70
+
```
71
+
72
+
Note a few things:
73
+
- The landing page url can be either `/index` or `/`
74
+
- You can specify the order and structure of the navigation bar in `main.yml`
75
+
- You can also add a title element and a link: this is shown below, with the `title_url` set to the landing page `index.md` for the guide
76
+
77
+
```yaml
78
+
title: Navigation bar title
79
+
title_url: /
80
+
subitems:
81
+
- title: Home
82
+
url: /index
83
+
- title: Example page
84
+
url: /example_page
59
85
- title: Contributors
60
86
url: /contributors
61
87
```
62
88
89
+
63
90
There are many other options for configuring your guide web page differently and adding more complicated page and navigation structures. For more information please visit the [ELIXIR Toolkit theme documentation](https://elixir-belgium.github.io/elixir-toolkit-theme/).
64
91
65
92
{% include callout.html type="important" content="You will only need to modify the `_config.yml` if you wish to make major changes to the way your new guide repository makes use of the remote ELIXIR ToolKit theme. Instructions for how to do this, and what the different options are, can be [found here](https://elixir-belgium.github.io/elixir-toolkit-theme/configuring_theme). " %}
0 commit comments