Skip to content

Commit 44379e6

Browse files
committed
Update Jekyll post with tag implementation section
1 parent 5ce50d9 commit 44379e6

18 files changed

+183
-64
lines changed

_posts/2025-02-09-jekyll.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,38 @@ I looked online first and found a lot of solutions that looked complicated and r
113113

114114
![Claude's LinkedIn solution](/assets/jekyll_site/linkedin.png)
115115

116+
### Issue 5: Implement tags
117+
118+
I wanted to implement tags on my site, so readers (and myself!) could sort my blog posts by topic. I found [this tutorial](https://emmatheeng.github.io/projects/blog_setup/blog-tags.html) right away. This was pretty much what I wanted, so I implemented it.
119+
120+
It looked good, except that this implementation had an archive page anchored to the header. I was fine with having an archive page but I didn’t want it so prominently featured on my site, .as sorting by tag is likely an edge case for users of my site. I wanted to maintain the archive page, but remove it from the header. Easier said than done! I went to Claude to get this done.
121+
122+
1. Claude gave me two suggestions. I tried the simplest-looking one first and added ```exclude:true``` to the archive page’s front matter. I tried this, but nothing changed.
123+
124+
![Claude's initial solution for excluding the archive page from nav](/assets/jekyll_site/exclude-true.png)
125+
126+
2. I tried Claude’s other suggestion, which involved editing the yaml file. This did remove the archive page from the navigation, but affected the site in a few other undesirable ways. When I clicked into individual posts, the header navigation disappeared entirely. I wasn’t really sure why this was happening.
127+
128+
3. Claude gave the same suggestion to use exclude syntax on the archive page’s front matter, but this time the actual syntax was different. I tried it. This fixed the navigation problem for posts, but when I clicked into the Books I’ve Read page, the header navigation once again disappeared.
129+
130+
4. Claude gave me some things to check in my code, including making sure the layout was designated as ```page```. I actually had all three of my pages (booklist, blog, archive) designated as ```default``` so I changed them all to ```page```. This fixed the navigation issue.
131+
132+
![Changing the layout](/assets/jekyll_site/page-layout.png)
133+
134+
5. Of course, this change introduced some additional issues. Titles now appeared on each page before all of the posts (“Blog,” “Books I’ve Read”) . I didn’t like this – it felt unnecessary and repetitive. I wanted to remove the title from all pages but keep it on the header. Claude suggested creating a custom layout file to fix this. However, since I wanted this style for all of my pages and not just one, I instead override the default Minima page layout.
135+
136+
![Claude's solution for excluding the archive page from nav](/assets/jekyll_site/remove-title-override.png)
137+
138+
I noticed a few other issues with my implementation.
139+
140+
1. I wanted the tags to appear in the excerpt part of the post on the blog homepage. In my current implementation, the tags only appeared when you actually clicked into a post. At Claude’s suggestion, I added code to the main blog page that checked to see if the post had tags and if so, displayed them as a link to the corresponding section of the archive page.
141+
142+
![Tags in excerpt on site](/assets/jekyll_site/tags-in-excerpt.png)
143+
144+
2. Finally, I noticed that the archive page didn’t handle Markdown in some of my blog post titles correctly. This was a familiar problem! At Claude’s recommendation, I added one additional line of code directly to the archive page to handle this formatting.
145+
146+
![Claude's solution for handling Markdown in titles on archive page](/assets/jekyll_site/archive-markdown-titles.png)
147+
116148
## Takeaways
117149

118150
1. **Claude works well for troubleshooting.** While building a Jekyll site certainly wasn’t painless, it was easier than I expected. Claude often gave me solutions that weren’t quite right for what I wanted. But Claude is pretty decent for troubleshooting for a specific problem and refining wrong solutions until they were correct. It beats looking at forum threads written by people who have related but different problems, and then trying to modify the solution to fit your own purposes.

_site/2024/01/05/recap.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,8 +45,8 @@
4545
</p>
4646
<h1 class="post-title p-name">2024 reading recap
4747
</h1>
48-
<a href="/archive.html#recap-year">
49-
#recap-year
48+
<a href="/archive.html#recaps">
49+
#recaps
5050
</a>
5151

5252
<a href="/archive.html#books">

_site/2025/01/10/librarykobo.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -45,8 +45,8 @@
4545
</p>
4646
<h1 class="post-title p-name">Managing library books on the Kobo Libra H2O
4747
</h1>
48-
<a href="/archive.html#tutorials,">
49-
#tutorials,
48+
<a href="/archive.html#tutorials">
49+
#tutorials
5050
</a>
5151

5252
<a href="/archive.html#tech">
@@ -56,13 +56,13 @@ <h1 class="post-title p-name">Managing library books on the Kobo Libra H2O
5656
<div class="post-content e-content">
5757
<p>This page describes how to set up a library account and manage library books on the <a href="https://us.kobobooks.com/products/kobo-libra-h2o">Kobo Libra H2O</a> device using OverDrive functionality. This page does not cover the<a href="https://www.kobo.com/us/en/p/apps"> Kobo app</a>, another tool you can use to check out books to both the app and your e-reader.</p>
5858

59-
<h1 id="background-overdrive-and-the-libra-h2o-model">Background: OverDrive and the Libra H2O model</h1>
59+
<h2 id="background-overdrive-and-the-libra-h2o-model">Background: OverDrive and the Libra H2O model</h2>
6060

6161
<p>The Kobo Libra H2O is a discontinued Rakuten Kobo model that is <a href="https://help.kobo.com/hc/en-us/articles/360019690433-Products-no-longer-manufactured-or-supported-by-Kobo">still supported by Kobo.</a></p>
6262

6363
<p>OverDrive is a digital platform that distributes library content to e-readers. Using OverDrive, you can directly access your library account on the Libra H2O and other e-readers. OverDrive also makes the Libby app, which <a href="https://company.overdrive.com/2021/08/09/important-update-regarding-libby-and-the-overdrive-app/">replaced the OverDrive platform functionality</a> on some Kobo models in 2023. However, OverDrive (not Libby) is still the only way to connect to your library directly from the Libra H2O model without using the Kobo iOS or Android app. Unlike newer Kobo e-readers, OverDrive is built directly into the Kobo Libra H2O so it’s not impacted by the Libby update. You aren’t able to download Libby or any other app directly onto the Libra H2O.</p>
6464

65-
<h1 id="getting-started-with-overdrive">Getting started with OverDrive</h1>
65+
<h2 id="getting-started-with-overdrive">Getting started with OverDrive</h2>
6666

6767
<p><img src="/assets/kobo/homepage.jpg" alt="Kobo homepage" class="smaller-image" /></p>
6868

@@ -95,7 +95,7 @@ <h1 id="getting-started-with-overdrive">Getting started with OverDrive</h1>
9595
</li>
9696
</ol>
9797

98-
<h2 id="switching-overdrive-accounts">Switching OverDrive accounts</h2>
98+
<h3 id="switching-overdrive-accounts">Switching OverDrive accounts</h3>
9999

100100
<p>You might have multiple OverDrive accounts with different library systems. This might be the case if you’re a student and have library accounts with your school and your town. It’s also common to have multiple accounts if you reside in multiple places over the course of a year or have recently moved. When you’re using the Libra H2O model, you can only be logged into a single OverDrive account at any given time, but you can manually switch between accounts.</p>
101101

@@ -114,11 +114,11 @@ <h2 id="switching-overdrive-accounts">Switching OverDrive accounts</h2>
114114
</li>
115115
</ol>
116116

117-
<h1 id="finding-and-checking-out-books">Finding and checking out books</h1>
117+
<h2 id="finding-and-checking-out-books">Finding and checking out books</h2>
118118

119119
<p>You can browse for library books directly on your library’s website or via the built-in search on your device.</p>
120120

121-
<h2 id="searching-for-books-on-your-librarys-catalog">Searching for books on your library’s catalog</h2>
121+
<h3 id="searching-for-books-on-your-librarys-catalog">Searching for books on your library’s catalog</h3>
122122

123123
<p>To use your library’s catalog to find an ebook to check out to your LIbra H2O:</p>
124124

@@ -145,7 +145,7 @@ <h2 id="searching-for-books-on-your-librarys-catalog">Searching for books on you
145145
</li>
146146
</ol>
147147

148-
<h2 id="searching-for-books-on-the-libra-h2o">Searching for books on the Libra H2O</h2>
148+
<h3 id="searching-for-books-on-the-libra-h2o">Searching for books on the Libra H2O</h3>
149149

150150
<blockquote>
151151
<p>Note: The built-in search functionality on the device is basic and slow. While you can filter searches by author, title, and other categories, the search results are often strange and unexpected. Searching directly from your library’s catalog is often the best bet if you’re looking for something specific. <img src="/assets/kobo/results.jpg" alt="Filtering search results" class="smaller-image" /></p>
@@ -171,7 +171,7 @@ <h2 id="searching-for-books-on-the-libra-h2o">Searching for books on the Libra H
171171

172172
<p>To check out a suggested book, click on the book. Note that the default option is to buy the book from the Kobo catalog, not check it out from the library. Select the <strong></strong> option to open an additional menu and then borrow the book from your library. If the book is available to check out, it will be checked out and added to your books. If it isn’t, you will have an option to place a library hold.</p>
173173

174-
<h2 id="other-ways-to-add-books">Other ways to add books</h2>
174+
<h3 id="other-ways-to-add-books">Other ways to add books</h3>
175175

176176
<p>If a book you want to read isn’t available on OverDrive, you can:</p>
177177

0 commit comments

Comments
 (0)