====== Switching from Hugo to Dokuwiki ======

When I first started to make a little website for myself as a hobby, I made it in Hugo, using the Cupper theme. But I've switched to Dokwiki now, and I feel much more at home.

======  ======

When I first decided to make a little website for myself, I found a blog that described setting it up on a  [[https://www.digitalocean.com/|Digital Ocean App]], with which you can host a website for free. After some online searching, I found that setting the website up using [[https://gohugo.io/|Hugo]] was probably my best bet. Hugo is a "framework for building websites": you write the content in simple Markdown, and Hugo turns it into a website for you. Using templates, you can change the way your website looks, and how it works. I chose the [[https://github.com/zwbetz-gh/cupper-hugo-theme|Cupper]] theme because it looked simple, and not too standard.

<row>
<card image=":en:posts:pasted:20231220-213316.png" footer="The old Hugo with Cupper website" no-body>
</card>
</row>

Setting it up turned out to be a bit more complicated than I thought - writing text was easy((although linking has a surprisingly weird syntax: ''%%[This is the link text]({{< ref "some-weird-link" >}})%%'', why!?)), but everything else felt too complicated for a simple personal website. I spent too much time poking at weird CSS files ((which I don't understand)), i18n((which I also don't understand)), and git submodules((which I definitely don't understand)). And that is okay, if I need to do it occasionally have to do it, but I felt like I had to relearn it every 6 months when I wanted to change something. But I also did not want to change something that was working okay, so I left it as it is.

But, unfortunately, since the beginning of 2023, the Cupper theme is no longer maintained, meaning that if there are bugs ore problems, I will need to fix them myself. And since then, I have been looking for a replacement. And since [[en:stuff:computers:selfhosting-favs|I love Dokuwiki]], I wondered whether I could not make it in Dokuwiki somehow. And lo and behold, [[https://www.dokuwiki.org/template:mikio|I found Mikio]], which basically just makes Dokuwiki look less... Dokuwiki. 

The rest is actually surprisingly easy. Just install a bunch of extensions to make it behave more like a blog or personal website , and things just work™. The most important ones are:

  * The [[https://www.dokuwiki.org/template:mikio|Mikio]] template, and its sister [[https://www.dokuwiki.org/plugin:mikioplugin|Mikioplugin]]
  * The [[https://www.dokuwiki.org/plugin:blog|Blog]], [[https://www.dokuwiki.org/plugin:tag|Tag]], [[https://www.dokuwiki.org/plugin:semantic|Semantic]], [[https://www.dokuwiki.org/plugin:fontface|Fontface]], and [[https://www.dokuwiki.org/plugin:discussion|Discussion]] plugin to make it behave Dokuwiki more like a "normal" website.
  * The [[https://www.dokuwiki.org/plugin:translation|Translation]] plugin for translations
  * The [[https://www.dokuwiki.org/plugin:mathjax|MathJax]] and [[https://www.dokuwiki.org/plugin:doi|doi]] plugins, because this is useful for sciency pages
  * The [[https://www.dokuwiki.org/plugin:smtp|smtp]] plugin for notifications of the website to myself, and the [[https://www.dokuwiki.org/plugin:bureaucracy|bureaucracy]] plugin for the [[en:contact|contact form]].

And of we go! Now, to fill the website with content, I just convert the content of the old website (written in Markdown) into the Dokuwiki language - easy using pandoc. Some things need some manual intervention (references mostly), but it really is minimal. Finally, I added some stylish new elements, and we end up with the new website!


<row>
<card image=":en:posts:pasted:20231221-222902.png" footer="The new Dokuwiki website" no-body>
</card>
</row>

Hopefully, it is a bit more permanent this time!

{{tag>pandoc markdown dokuwiki self_hosting computer_stuff}}

~~LINKBACK~~

~~DISCUSSION|Comments~~