- Better HTML HEAD metadata
- Social interactions
- better code highlighting
- steal tricks from gwern
- knit to markdown
- Site search
- Mathjax update
- Link to tag indexes
- Sort by certainty etc
- Look nice
How did you get in here? How did you get inside the sausage factory? Watch your fingers.
Things I am doing to spruce this place up as part of yak shaving my academic writing workflow.
Better HTML HEAD metadata
HEAD documents the recommended tags for maximising social spread and suchlike from a website.
better code highlighting
For new themes, via https://bookdown.org/yihui/blogdown/templates.html#how-to
Alternatively for my theme it is just in the config. https://github.com/rstudio/blogdown/issues/360#issuecomment-457395421
these are both bia
highlight.js; I could use the server-side pandoc-based solutions such as pygments or chroma.
Explanations of those by Maëlle Salmon : https://ropensci.org/technotes/2020/04/30/code-highlighting/
These look harder to integrate into Rmarkdown posts, but ok for native hugo https://gohugo.io/content-management/syntax-highlighting/
Also code folding.
steal tricks from gwern
especially regarding linkrot
knit to markdown
Instead of to HTML. Many benefit in terms of having better hugo hooks. michael toth’s solution.
render citations as data? Or at least link to the bib file? See how radix does this?
Why are citations showing up as a sub div of the last div? Can I change that?
e.g google custom search https://developers.google.com/custom-search/docs/element
<script async src="https://cse.google.com/cse.js?cx=014927561102415572478:eoepgzqrs0t"></script> <div class="gcse-search" data-personalizedAds="false"></div>
- google/bing site search?
Via page bundles? https://laurakalbag.com/processing-responsive-images-with-hugo/ https://nilsnh.no/2018/06/10/hugo-how-to-add-support-for-responsive-images-trough-image-processing-and-page-bundles-3/
I would need to restructure my code for that
Generic image processing goes https://gohugo.io/content-management/image-processing/
Put images in front matter, or even page bundles. The latter looks fragile and harder to navigate; I’ll probably settle for a minimum-viable option that puts images in header metadata. I wonder if there is a pandoc pipe that could make that easier, or if I should do it with a python markdown parser e.g. with a TreeProcessor, or a BeautifulSoup parser, or the syntax tree-friendly Mistletoe.
minimal deps lightbox for all my beautiful high-res images.
https://github.com/andreknieriem/simplelightbox (dependency free) https://dimsemenov.com/plugins/magnific-popup/documentation.html (old jquery)
https://github.com/liwenyip/hugo-easy-gallery (markup integration)
I would also like to display most popular pages; that would be fun. But I will wait for netlify to release their API rather than getting prematurely excited about that.
If I want to work around in the mean time, Jim Nielson shows how.
NEtlify API spec https://open-api.netlify.com/ Python client https://pypi.org/project/openapi-core/ community https://community.netlify.com/t/support-guide-understanding-and-using-netlifys-api/160
Sort by certainty etc
I made my own theme; it has various wonderful features such as being simple and easy to understand. However, it has the problem that I am no graphical designer.
I was using Merriwether which is not great; the punctuation annoys me.
TBD: choose a monospace font so I can control the size better.
- https://github.com/avianto/hugo-kiera (essay-oriented, support figure syntax)