I started using Hugo back in 2015. It’s so weird to think that I’ve been using this piece of software for 5 years already and it has evolved so much in the meanwhile. At the time, I started using v0.16. We’re now at v0.75.1!

Just created a subdomain with my notes, or wiki, or digital garden. Whatever you want to call it. It’s mostly for personal reference if I need it, but you can take a look too 😉

So… replying to myself. Probably what I’m going to do is quite similar to what I had before: statically generate the notes from source markdown (or something else). I first need to decide the best language. Markdown is simples, yes, but sometimes I feel I need to add HTML to make it look exactly how I want it to. For example, I can’t just do this in markdown without using HTML. Some other markup languages allow for much more customization, such as Asciidoc.

Let me review the features I wrote yesterday to know if I can accomplish what I want this way. First, the must-haves:

Self hosted and open source Notes stored in plain text files Backlinking feature Supports LaTeX math Supports Mermaid diagrams

Yes, yes, yes, yes and yes even if I have to create some script to adapt it to whatever static website generator I’m using. Unfortunately Hugo does not easily allow me to process backlinks on its own. I may try a different, more flexible, static generator for this. It’s an experiment and that way I’ll learn more. Maybe Gatsby or even Eleventy.

Clean layout and possible to easily edit on mobile

Yes and kinda. Need to find a good app. There’s some such as iA Writer that I know work very well. But I need to find a way to make it easily work with a Git repository.

Web editor (maybe WYSIWYG)

GitHub editor works. Not WYSIWYG though.

Simple and humanly readable markup language (markdown or other)

Yes.

Search

Can be implemented, although a bit harder.

Now let’s finally review the good to have features.

Full-text search

Can be implemented too.

Mind map visualization

Yes.

Public/private stuff

Possible, harder, but possible.

I’ve been in spring cleanup mode since yesterday and I started on GitHub and ended up archiving and deprecating dozens of repos that were either unmaintained or actually supposed to be deprecated.

On this website, I just removed the ActivityPub support of my website because of two reasons: it had bugs and wasn’t working properly (I think) and there were only two or three people following me, being 2 of them bots. The other one also follows me through RSS so I hope I don’t affect them very much.

Today and tomorrow I’ll also proceed to make some internal upgrades and decouple the webmentions from the static generation process of this website, inspired by Jan-Luka’s post. I need to upgrade to Caddy 2 as well as some other changes I might share later.

That’s really interesting. Even though my mother tongue is clearly not English, sometimes I find it much easier to express some thoughts in English rather in Portuguese. I feel the best for me would be to write in both at the same time but that’s obviously not good for readers 😂

Wow! Thanks Jan. I’m still trying to understand why replacing links that start with / work because my feed was printing relative URLs with ... It seems to work though. I’m happy 🤯

There are some srcsets from some older articles that have relative URLs but let’s hope no one will take a look at those old posts. Maybe I’ll try to figure out a way to parse those attributes. Would be a bit more complicated though.

Love the animated GIFs! The background!

Thanks 😁

One thing: my feed reader has a hard time handling the relative image URLs in your RSS…

Thanks for letting me know that. I didn’t know that was an issue. May I ask which RSS reader you’re using? That’ll be hard to do with Hugo. There’s no way to tell it to use absolute URLs in the feeds only. I’ll need to set up an extra step of some kind. I’ll check it out.

(Also, I couldn’t help but notice that RSS items lack the “context” that makes replies and such so much more understandable. Not a huge issue, just thought I’d let you know.)

Interesting, I noticed today my ActivityPub feeds had that problem and I already fixed them to include the “reply” part. I’m not aware if the RSS can have that kind of context. Can they? Also, just checked and the JSON feeds don’t support that kind of things. However, my page’s all use microformats and I just checked and they’re correctly parsed.