Skip to content

Commit 817a3e6

Browse files
committed
Updates organization to have six on learn landing page
1 parent c6bb7b7 commit 817a3e6

9 files changed

Lines changed: 6 additions & 35 deletions
File renamed without changes.
Lines changed: 2 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -11,31 +11,9 @@ Templates within static site generators enable you to use variables or metadata
1111
* Hugo has a packaged templating engine similar to liquid, but Go-based. Read more in [Introduction to Hugo Templating](https://gohugo.io/templates/introduction/).
1212
* Sphinx uses Python for any extensibility you need. I find it helpful to browse through the [Read the Docs Theme](https://github.com/rtfd/sphinx_rtd_theme) to find examples of templating.
1313

14-
When using a templating engine like Liquid in Jekyll, you can access the version value from a data file such as in the `_data` folder in a `navigation.yml` file. For example, when the URLs for versions are built to static folders with the version value, you can then put the version values into a data format along with the URls:
15-
16-
```
17-
versions:
18-
- title: "Latest (1.8)"
19-
url: http://docs.example.com/latest/
20-
- title: "Version 1.8"
21-
url: http://docs.example.com/1.8/
22-
- title: "Version 1.7"
23-
url: http://docs.example.com/1.7/
24-
```
25-
26-
Then, to create a drop-down menu for versions with an unordered list, use a `for` loop. You can see an example of this in the `versions-jekyll` repository at https://github.com/justwriteclick/versions-jekyll.
27-
28-
The Read the Docs theme for Sphinx does something similar to indicate the version, using values from the `conf.py` file for the project and a definition list rather than an unordered list:
29-
30-
```
31-
<dl>
32-
<dt>{{ _('Versions') }}</dt>
33-
{% for slug, url in versions %}
34-
<dd><a href="{{ url }}">{{ slug }}</a></dd>
35-
{% endfor %}
36-
</dl>
37-
```
14+
When using a templating engine like Liquid in Jekyll, you can access the version value from a data file. Read more in the Liquid documentation about [Iteration](https://shopify.github.io/liquid/tags/iteration/).
3815

16+
The Read the Docs theme for Sphinx uses Python variables to indicate the version, using values from the `conf.py` file for the project and a definition list rather than an unordered list.
3917

4018
## Additional resources
4119

File renamed without changes.
File renamed without changes.
File renamed without changes.

learn/index.md

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,6 @@ entries_layout: grid
66
last_modified_at: Sat Jul 28 10:56:38 CDT 2018
77
---
88

9-
{% include sign-up.html %}
10-
119
Sphinx, Jekyll, and Hugo, all are static site generators that teams use for web sites and documentation sites. Let's go through setting up a static site generator and a common CICD system with it.
1210

13-
Let's learn:
14-
* GitHub for documentation sites
15-
* Sphinx with Python
16-
* Jekyll with Ruby
17-
* Hugo with Go
18-
* Working with content in GitHub repositories
19-
* Deployment: Read the Docs, GitHub Pages, and Netlify
20-
* Testing: Travis CI and script examples
21-
* Advanced topics: themes, search, print, versions, and translations
11+
{% include sign-up.html %}

search/index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,3 +6,6 @@ image:
66
search: false
77
sitemap: false
88
---
9+
10+
11+
{% include sign-up.html %}

0 commit comments

Comments
 (0)