diff options
| author | bt <bt@btxx.org> | 2024-06-08 13:22:19 -0400 |
|---|---|---|
| committer | bt <bt@btxx.org> | 2024-06-08 13:22:19 -0400 |
| commit | dcfb172704f3afb68a30425029ec834be2883274 (patch) | |
| tree | 02ac480745db802d7af03f3213a0c568322170e3 /build/simple-jekyll-navigation | |
| parent | e146f8a64c793c337999ce316b16ebe5fe6f2dab (diff) | |
More content porting, on-going markdown changes for lowdown support
Diffstat (limited to 'build/simple-jekyll-navigation')
| -rw-r--r-- | build/simple-jekyll-navigation/index.html | 59 |
1 files changed, 37 insertions, 22 deletions
diff --git a/build/simple-jekyll-navigation/index.html b/build/simple-jekyll-navigation/index.html index 1f6504d..bb97cc8 100644 --- a/build/simple-jekyll-navigation/index.html +++ b/build/simple-jekyll-navigation/index.html @@ -1,56 +1,71 @@ <!doctype html> -<html lang="en" id="top"> +<html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="icon" href="data:,"> <title>Simple Navigation Setup in Jekyll 3.9.0</title> - <link href="https://bt.ht/atom.xml" type="application/atom+xml" rel="alternate" title="Atom feed for blog posts" /> - <style>*{box-sizing:border-box;}body{font-family:sans-serif;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{overflow:auto;}table{text-align:left;width:100%;}</style> + <link href="/atom.xml" type="application/atom+xml" rel="alternate" title="Atom feed for blog posts" /> + <link href="/rss.xml" type="application/rss+xml" rel="alternate" title="RSS feed for blog posts" /> +<style>*{box-sizing:border-box;}body{font-family:sans-serif;line-height:1.33;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{border:1px solid;overflow:auto;padding:5px;}table{text-align:left;width:100%;}.footnotes{font-size:90%;}</style> </head> <nav> - <a href="#menu">Menu ↓</a> + <a href="#menu">Menu ↓</a> </nav> <main> -<h1>Simple Navigation Setup in Jekyll 3.9.0</h1> +<h1 id="simple-navigation-setup-in-jekyll-3.9.0">Simple Navigation Setup in Jekyll 3.9.0</h1> + <p>2020-09-29</p> -<p>I have found that there is a lot of information on the internet in regards to setting up "dynamic" navigation in Jekyll. The problem I've noticed is that a good amount of these implementations are overly complex. Here is the simplest way that I tend to use when building out <code>nav</code> elements in Jekyll (3.9.0 as of this writing).</p> -<h2>Creating the Directories & Files</h2> + +<p>I have found that there is a lot of information on the internet in regards to setting up “dynamic” navigation in Jekyll. The problem I’ve noticed is that a good amount of these implementations are overly complex. Here is the simplest way that I tend to use when building out <code>nav</code> elements in Jekyll (3.9.0 as of this writing).</p> + +<h2 id="creating-the-directories-files">Creating the Directories & Files</h2> + <p>In your Jekyll project, at the top level, you need to create a directory called <code>_data</code>. Inside this folder we will be creating a new file called <code>navigation.yml</code>. The contents of this file will contain all your navigation links and they are rendered like so:</p> + <pre><code>- title: Home -url: / +url: / - title: Articles -url: /articles/ +url: /articles/ - title: About -url: /about/ +url: /about/ </code></pre> -<h2>Dynamically Rendering the Navigation</h2> + +<h2 id="dynamically-rendering-the-navigation">Dynamically Rendering the Navigation</h2> + <p>The next and final step is rendering out the navigation with a simple loop:</p> + <pre><code>{% for item in site.data.navigation %} - <li> - <a href="{{ item.url }}"><span>{{ item.title }}</span></a> - </li> + <li> + <a href="{{ item.url }}"><span>{{ item.title }}</span></a> + </li> {% endfor %} </code></pre> -<h2>Highlight Current Page</h2> -<p>It's also very easy to extend this method to add a CSS class based on whether a user is on the currently selected page or not:</p> + +<h2 id="highlight-current-page">Highlight Current Page</h2> + +<p>It’s also very easy to extend this method to add a CSS class based on whether a user is on the currently selected page or not:</p> + <pre><code>{% for item in site.data.navigation %} - <li> + <li> {% if item.url == page.url %} - <a class="active" href="{{ item.url }}"><span>{{ item.title }}</span></a> + <a class="active" href="{{ item.url }}"><span>{{ item.title }}</span></a> {% else %} - <a href="{{ item.url }}"><span>{{ item.title }}</span></a> + <a href="{{ item.url }}"><span>{{ item.title }}</span></a> {% endif %} - </li> + </li> {% endfor %} -</code></pre> -<pre><code>/* Custom styling for active class */ + + + +/* Custom styling for active class */ li a.active { color: red; } </code></pre> + <p>Congrats! You now have fully functional, dynamic navigation on your Jekyll site.</p> <footer role="contentinfo"> <h2>Menu Navigation</h2> |