Live data from Hacker News

How to start a blog using Hugo

flaviocopes.com

101–110 of 111 posts

Re: How to start a blog using Hugo

#101
post #56

There is no lack of technical choices when it comes to starting a blog. I can start five blogs in the next 30 minutes, each one on a different platform/infrastructure. What I do lack is something interesting to write about, in a consistent manner. I have been writing code for a long time. I did build some interesting stuff. I'm currently working on a startup that does use some blog-worthy tech: any attempt ends up wi…

What's worked for me:

Find an interesting question.

Investigate it.

See where that leads.

In particular:

- What are the foundations of that question?

- What are the implicit assumptions or beliefs? Are those valid?

- What references or sources are frequently cited or quoted? Are those valid?

- What questions, concepts, or sources are studiously ignored or deprecated? Why? Are those valid or invalid?

- What are the dimensions / what is the internal structure of the question? What are its elements, dynamics, and/or relationships? Where do those lead?

- What are the issues encountered in trying to realise solutions, mitigations, or models of the problem? Working in idea-space is one thing, working in instance-space quite another. ("In theory, the same, in practice, different.")

- What new questions emerge? Rinse, wash, repeat.

My problem isn't that I don't have enough to write about, it's that I've far too much I'd like to address, and am looking for a structure and system that fits this.

If you're not at this stage, simply writing, regularly, is good practice. Things you have to say may not seem to be meaningful, and perhaps never will be. More likely though you'll discover a through-thread in the problems and approaches to those problems you're drawn to, though it may take years or decades to discover this.

Writing is a great way of documenting your sources, discoveries, thought process, and evolution of understanding or approaches. It took me several decades before I'd read my past writing without constantly crigning. I still frequently revise or correct older essays (even years old), and HN's very limited edit window is a constant frustration (as are Mastodon and Diaspora's complete lack of re-editability). Your own git-managed blog provides both for editability and a history of those edits.

I've found the process of exploring writing and research methods (tending strongly toward cross-referenced systems: index cards, Zettelkasten, POIC, Wikis) to be fascinating in its own right. Often to the exclusion of writing itself ;-)

Capabilities of a particular platform also matter. If you're writing-as-marketing (a frequent mode), there's one set of tools which may matter, generally fairly well addressed. If you're writing-as-dialectic, exploring ideas or seeking a better understanding of truth, there are others, less-well supported. I find that comprehensive search, thematic organisation (a very good tagging system), and, if feedback is supported (comments, etc.), an exceptionally effective, efficient, and low-cognitive-overhead moderation system matters a lot, as well as the ability to structure posts sufficiently to the needs of expression. A reasonably robust semantic structure (emphasis, lists, sections, tables, figure/images, footnotes, possibly equations) can really matter, and many solutions support this poorly (or require much wrestling).

Content-appropriate themes and styling also matter, with a narrow band between "not enough" and "too much". Again, many solutions support this poorly.

Finally, there's the ability to move your content elsewhere, when (not if) your current platform becomes inadequate or inappropriate, for whatever reason. Something I've come to discover is inevitable.

Another interesting discovery has been writing on microblogging sites. My preference is Mastodon, though Twitter is similar. I'd realised that Mastodon's default 500 character toot length is roughly the same as an index card, which means I can post in threads of roughly index-card-sized chunks. I know this is somewhat annoying for readers, but as a writer, the immediacy of feedback, at roughly paragraph-level granularity, to elements of a longer essay, is invaluable. There's also the notion of publishing in chunks, and committing yourself to a direction publicly, whilst still composing. Several of my longer "tootstorms" really just started as an aside or observation and grew on me.

A key distinction between writing and conversation is that in a conversation, you get immediate feedback. In writing, you commit yourself to a much longer exposition without having a good idea how your audience will respond. (Even speechwriting or presentations are like this, though in delivery you can adapt to audience response.) Microblogging has at least the possibility of bringing writing closer to the conversational mode, which is interesting.

Re: How to start a blog using Hugo

#102
post #84

Shameless plug: I built https://typehut.com as a simpler alternative to classic blog and publishing systems. It's super easy to get started and it has some nice things like email subscriptions built-in. If anybody tries it out let me know!

FYI, I ca'n't reach your site! If it works will check out!

Hmm, works on my side. What’s the error you’re seeing?

Re: How to start a blog using Hugo

#103
post #76

Earlier quoted context omitted.

But then why blog? Why not just journal in a notebook or on your "notes" app and be done?

You can definitely do it in a private journal and would likely experience many of the same effects. But putting it online gives other people a chance to learn from it.

If the blog has a commenting feature, it also provides the author with an opportunity to learn from the readers.

Re: How to start a blog using Hugo

#105
post #56

There is no lack of technical choices when it comes to starting a blog. I can start five blogs in the next 30 minutes, each one on a different platform/infrastructure. What I do lack is something interesting to write about, in a consistent manner. I have been writing code for a long time. I did build some interesting stuff. I'm currently working on a startup that does use some blog-worthy tech: any attempt ends up wi…

Start journaling. Just keep a daily log of stuff you do, that you either think is interesting or that you want to reference later. Focus on getting the key points out succintly, writing as you go and then (quickly) editing once you have the problem all worked out. If you do this regularly, you'll get better at producing short and interesting summaries which are great blog topics.

Re: How to start a blog using Hugo

#106
I've been using Hugo for a few years. I like it generally, but I have mixed feelings about using Go for templating. Compilation and generation is blazing fast, which is great for short edit-compile-debug cycles.

On the other hand, Go's lack of generics makes working with collections harder than it should be... and much of templating involves working with collections.

To give a concrete example, I wanted to create a page where I group categories by post count. Hugo has methods to group pages, but not categories, so I rolled my own imperative grouping code. It wasn't difficult, but it would have been simpler to do declaratively in many other ecosystems (say, .NET with LINQ).

Re: How to start a blog using Hugo

#107
post #6
post #5

Earlier quoted context omitted.

Similar issues from my side. Cryptic documentation, bad dissorganized forum and configuration,... I love the hugo idea but to find one detail you will get into chaos of strange wording and noise. I am using it but I try to configure as small amount as possible as I always get into some undesired behaviour. It seems like it was from begining build with idea and then continued by patch over patch over patch. Cant recom…

I decided I would make a static site the old fashioned way on neocities.org and happily got started. And then I remembered all the double work you have to do linking and making lists and repeating headers/footers (or use frames) and so on. Now I'm back to looking for some simple script that can output static sites without having to spend a month learning a new tool...

I'm not sure if I'd call it sound advice - but there's not much stopping you from building a site based around (client side) Javascript these days. Maybe a markdown parser in js, some json (js) data files (à "database") - etc.

Basically a variant of how:

https://tiddlywiki.com/

works. Or:

https://chrisdiana.dev/cms.js/

In a similar vein (but not solely client hosted and managed) there's:

https://vuelog.js.org/#/page/about

https://www.gatsbyjs.org/

If all you need is a blog, it's really just a bit of navigation you need js/ to help with. And you can of course add things like commenting as a SaaS that's essentially just an imported cross side scripting attack on yourself, much like with visitor tracking via Google analytics etc. See for example muut.com for comments.

Re: How to start a blog using Hugo

#108
post #19

I used hugo for a while, but found myself struggling against it more often than I liked. I have since moved on to using other options.

What other options?

nanoc with asciidoctor filter. I've also used pelican and Jekyll in the past, and they worked pretty well too.

Re: How to start a blog using Hugo

#109
post #76
post #72

Earlier quoted context omitted.

[in my opinion] Don't write to be read. Write for you, write because you enjoy the process and the exposition helps you process and crystallise a concept. Write because you are interested and engaged.

But then why blog? Why not just journal in a notebook or on your "notes" app and be done?

Sometimes because publishing helps people stick to doing it. Sometimes because publishing forces someone to a higher standard of care. Sometimes because the mere possibility of feedback or a connection is worth it. :)

Re: How to start a blog using Hugo

#110

Earlier quoted context omitted.

Those three concerns are one-off operations with minimal time investment, even if you don't automate most of the process.

There are not one-off since I'd have to perform them every time.

Every time? I'm confused. How frequently are you setting up new blogs? If it IS frequent, why have you not automated the process?
Post reply on HN