www/content/docs/adyxax.org/services/www.md

48 lines
1.5 KiB
Markdown
Raw Normal View History

2020-04-28 17:29:52 +02:00
---
title: "www"
linkTitle: "www"
weight: 1
description: >
adyxax.org main entry website. www.adyxax.org, wiki.adyxax.org and blog.adyxax.org all point here.
---
This is the website you are currently reading. It is a static website built using [hugo](https://github.com/gohugoio/hugo). This article details how I
installed hugo, how I initialised this website and how I manage it. I often refer to it as wiki.adyxax.org because I hosted a unique dokuwiki for a long
time as my main website (and a pmwiki before that), but with hugo it has become more than that. It is now a mix of wiki, blog and showcase of my work and interests.
For a log of how I made the initial setup, see [this blog article.]({{< relref "/blog/hugo/switching-to-hugo.md" >}})
2020-04-28 17:29:52 +02:00
2020-11-29 15:01:07 +01:00
## Installing hugo
2020-04-28 17:29:52 +02:00
2020-11-29 15:01:07 +01:00
I am currently hosting this website on an OpenBSD server. Hugo is packaged on this system so the installation is as simple as :
2020-04-28 17:29:52 +02:00
{{< highlight sh >}}
2020-11-29 15:01:07 +01:00
pkg_add hugo--extended
2020-04-28 17:29:52 +02:00
{{< / highlight >}}
## Bootstraping this site
2020-11-29 15:01:07 +01:00
The website is on my gitea :
2020-04-28 17:29:52 +02:00
{{< highlight sh >}}
2020-11-29 15:01:07 +01:00
cd /var/www/htdocs
git clone --recurse-submodules _gitea@git.adyxax.org:adyxax/www.git
2020-04-28 17:29:52 +02:00
cd www
{{< / highlight >}}
The docsy theme requires two nodejs programs to run :
{{< highlight sh >}}
npm install -D --save autoprefixer
npm install -D --save postcss-cli
{{< / highlight >}}
## hugo commands
To publish the website in the `public` folder :
{{< highlight sh >}}
hugo --minify
{{< / highlight >}}
2020-11-29 15:01:07 +01:00
## TODO
TODO deploy on push to git.adyxax.org
TODO web server config