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.
render better
- https://github.com/rbind/yihui
- https://github.com/rstudio/blogdown/blob/8b488d92e6134a1ca673b5a8ea9327db09f8f9ab/NEWS.md#changes-in-blogdown-version-10 recommends
blogdown::build_site(build_rmd = "timestamp")or even
options(blogdown.files_filter = blogdown::timestamp_filter)
blogdown::build_site(build_rmd = TRUE)should I smooth this by switching to cutting-edge blogdown?
remotes::install_github('rstudio/blogdown')render to markdown
Instead of to HTML. Many benefit in terms of having better hugo hooks. michael toth’s solution.
update: hugodown supports this.
figures lose caption
!\[(.*)\]\(/images/([^[]*)\)toupdates horribly broken pathsrename files, purge
.htmltheme updates
test docs
r.Rmdandlevy_processes.Rmd.knitpages.R,knitandhugodownify.pyare points to intervene.Server-side KaTeX With Hugo: Part 2 - graeme phillips posting
Math expressions do not require protection in backticks · Issue #466 · rstudio/blogdown
Adding R Markdown documents of other output formats - A minimal example website using blogdown
keep_md option not used by blogdown::html_page · Issue #445 · rstudio/blogdown ### general
https://bookdown.org/yihui/blogdown/local-preview.html#local-preview
tidyverse/tidyverse.org at ee03715f1038d0c594bf0d4f3ac000f22b5fecc4
Savvy Statistics: Scientific and Technical Blogging: Radix vs. Blogdown
link styling
- all the heading metadata on overview pages should be a link.
Better HTML HEAD metadata
HEAD documents the recommended tags for maximising social spread and suchlike from a website.
Webmentions
theming and integration work required.
ActivityPub
A.k.a. ActivityStreams 2.0. I think this standard is real and is sometimes claimed to subsume comments and webmentions 🤷♂ It looks like there is variable effort involved in enabling the suite of features and widges here. Verifying my id in ActivityPub is chill. All the mutual sharing of data involves cryptographical signing etc. Out of scope for now.
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 via 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.
Eliminate extraneous javascript
citations
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?
make an explicit header?
Searching
Get a search I can link to?
Fix safari search styling
Images
apply a filter to images to match background. (but how to opt out?)
media pipeline
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/
thumbnails
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.
Lightbox
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)
Tracker
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
Mathjax update
Link to tag indexes
TBD
Sort by certainty etc
AMP
Google’s accelerated mobile pages. Seems a huge effort. https://themes.gohugo.io/tags/amp/ https://gohugo-amp.gohugohq.com/
Look nice
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.
TBD: choose a monospace font so I can control the size better. I'm currently using Jetbrains mono, which is fine, but not perfect. I would like a serifed code font that was for the cheezy old-timey typewriter feel, but also with low ambiguity of custom characters, and that supported a good range of characters. These desiderata do not seem to be available in free monospace fonts.
Other nice header fonts?
Credit font designers. Also, paper texture? https://www.wildtextures.com/free-textures/seamless-paper-texture/
margin notes
- https://gertjanvandenburg.com/blog/how_i_made/
- hugo-tufte is a fairly active hugo theme for this. AFAICT it needs deeper support for hugo shortcodes than RMarkdown has
- https://github.com/nstrayer/tuftesque seems more blogdown-focused
- rmarkdown has built-in support but it’s crazy
Comments
Embedded serverless comments would be nice comments.