This is created since I wasn't pleased with any of the themes on Hugo or Zola. I intend to use this exclusively for my personal blog.
- light mode
- pictures should not be required for article cards
- customizable side bars
- left or right side
- table of contents for page
- other articles/posts from a particular list
- this is kind of like a docs site
- nav bar (some don't have it)
- many layouts
- pages
- dependent on the presence of side bars
- lists/taxonomies/archive
- I've seen a couple layouts that I like
- one with short 1/2 liners per article, sorted by date
- cards with summary
- pages
- shortcodes
- I personally use a gallery that I would like to clean up
Other general goals include
- minimal JS (hopefully none)
- very efficient mobile layout
- for instance, minimal margins, no duplicate margins for code blocks
I'm going to use tailwindcss for the first time. Hopefully this helps eliminate decision paralysis and makes what I think I want actually turn out better than it has in the past.
Here's some links to existing template sites that I want to draw inspiration from.
Theme:
- Really good and clean card theme Stack
Articles:
- Really clean table of contents as sidebar (optional) DeepThought
- Card layout (ideally I'd be able to flip between card/not-card) DeepThought
- Side bar takes full height of page, including the navbar even
- TOC as drop down at top Kita
- external links to resources at top Kodama
- clean and extensible side bar for docs Hextra
Taxonomies/Lists:
- Tag counts could be one option, but not necessarily what I want DeepThought
- cards with nice tag buttons https://www.printlnhello.world/blog/
- Spacious but terse list of posts Zola Inky
- Generalized list for images (a gallery) Zola Inky
- Clean and simple archive Kita
- My favorite tag list, anchors and dedicated pages Mabuya
- post summary with images and not images Stack
- cards with icons Hinode
Navbar:
- Clean, modern-polybar-esk taskbar Duck Quill
- Side bar Stack
Shortcodes:
- Wide code blocks, with filenames Feather
Other:
- projects list, like article summaries but without an article Kita
- double side bar...interesting but not what I want? Digital Garden
- build more content
- markdown pages
- a series
- a subsection (the series?)
- build basic functionality in basic templates
- favicon
- page styles
- headings, paragraph, lists
- tables, large tables
- code blocks, inline code
- other: sup, sub, mark
- latex
- images
- navbar
- improve hover
- mobile: remove margins and change rounding
- get hot-reloading working
- tailwind cdn for faster reloading?
- page lists in section
- date
- title
- description
- summary (first line)
- pagination
Later priority
- basic shortcodes
- tip/important/warning banners
- code blocks with language
- image flipper
After getting hot reloading working I want to test it out by getting some styling feature done. I'm going to do some testing with the nav bar, and take inspiration from duck quill as noted above.
Now I think I'm going to work on getting a section and article cards sorted. I'm going to first start with a page that has a single left section.