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.
convert to Quarto
integrate mailing list
promote
As you start routing information and putting out blog posts, you will begin to accumulate connections. Useful information will start to stream toward you, turning you into a small hub yourself. This will allow you to collect and curate information and route it back out, which will allow even more people to connect to you, in a flywheel that lets you do increasingly useful and good work. I especially enjoy it when intelligent people attack me; I then invite them to comment on upcoming drafts.
You can also post to subreddits and forums, like LessWrong or the SlateStarCodex subreddit, that act like intellectual cafés on the internet. Pasting your posts there, it is easy to find community when you are starting out; you don’t have to scream into the void.
Render to markdown
Instead of to HTML. Many benefit in terms of having better hugo hooks.
Emi Tanaka, Scientific and Technical Blogging: Radix vs. Blogdown. There are some rendering glitches when I include it here, not sure why?
update: hugodown supports this.
So does quarto.
What might break for me?
- figures lose caption?
- rename files, purge
.html
- theme updates
- test docs
r.Rmd
andlevy_processes.Rmd
. knitpages.R
,knit
andhugodownify.py
are points to intervene.- michael toth’s solution shows this is possible.
- Dr. Mowinckel, Changing your Blogdown Workflow
- blogdown 1.0 suggests the .Rmarkdown outut format
- Wannabe Rstats-fu: How Not To Knit All Rmd Files With Blogdown
Maths
mail subscription
link styling
- all the heading metadata on overview pages should be a link.
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
New themes method
This is via highlight.js
; I could use the server-side pandoc-based solutions such as pygments or chroma.
Explanations of those by Maëlle Salmon.
These look harder to integrate into Rmarkdown posts, but ok for native hugo.
Also code folding.
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?
publications
Searching
Get a search I can link to?
Fix safari search styling.
Go to page bundle structure
A lot of work; minimal gain for blogdown AFAICS.
Images
halftone This pure CSS one is nice.
- Image Processing and SVGs
- I Just Wanted to Serve Images · blog.jemu.name
- Bookdown is Neat and Automation is Hard · blog.jemu.name
media pipeline
Via page bundles?
- Laura Kalbag – Processing Responsive Images with Hugo
- Forestry.io, How To Use Hugo’s Image Processing With Forestry
- Clayson Design
- Mert Bakır, Image Processing in Hugo
I would need to restructure my content for that
Lightbox
minimal deps lightbox for all my beautiful high-res images.
I ended up using
Tracker
I would also like to display most popular pages; that would be fun. I was going to use the netlify analytics api for that but I gave up because
- They did not introduce the API after a year of waiting
- Their traffic tracking data was swamped by content indexing.
If I want to work around in the mean time, Jim Nielson shows how.
Link to tag indexes
TBD
Sort by certainty etc
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.
Fonts
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.
background
Also, paper texture? many seamless paper textures here
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.