From 8ddd5453d8dbf896fc0e6558122ac4154e2fa8fe Mon Sep 17 00:00:00 2001 From: Lieuwe Leene Date: Thu, 26 Aug 2021 23:06:51 +0200 Subject: [PATCH] First proper content update --- content/about.md | 19 ++++++++-- content/posts/afirst.md | 12 ------- content/posts/site-setup.md | 70 +++++++++++++++++++++++++++++++++++++ 3 files changed, 87 insertions(+), 14 deletions(-) delete mode 100644 content/posts/afirst.md create mode 100644 content/posts/site-setup.md diff --git a/content/about.md b/content/about.md index b3dcb78..f09fa69 100644 --- a/content/about.md +++ b/content/about.md @@ -1,8 +1,23 @@ --- -title: "About" +title: "Welcome" date: 2021-08-23T17:52:07+02:00 draft: false --- - Hello friend. + +### About This Site + +This site shares a bit of informal documentation and more blog-based recod +keeping. Providing commentary on design decisions should be just as useful as +some of the technical documentation however included in my repositories. + +### Setup + +| Environment | Development | Production | +--- | --- | --- +| Operating System | Fedora 33 | CentOS 8 | + +### About Me + +I do mixed signal circuit design and a bit of software development as a hobby. diff --git a/content/posts/afirst.md b/content/posts/afirst.md deleted file mode 100644 index 8629d66..0000000 --- a/content/posts/afirst.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "A first" -date: 2021-08-24T10:24:27+02:00 -draft: false -toc: false -images: -tags: - - website - - WIP ---- - -hello diff --git a/content/posts/site-setup.md b/content/posts/site-setup.md new file mode 100644 index 0000000..2298c20 --- /dev/null +++ b/content/posts/site-setup.md @@ -0,0 +1,70 @@ +--- +title: "Setting up a new site." +date: 2021-08-24T10:24:27+02:00 +draft: false +toc: false +images: +tags: + - website + - setup + - hugo +--- + +Previously I tried using grav with the intention to serve a simple website as +it is quite easy to setup and the interface seemed quite nice. However the +editing environment didn't feel good and after googling around a bit hugo +already seemed alot more appealing. It renders from markdown with some html/css +config files and can serve content statically or dynamically without superfluous +features. + +So far it looks like I will stick with hugo and in any case a markdown source is +highly portable. + +## Building Hugo + +Hugo is actually provided by ubuntu and centos repositories but building from +source is equally trivial. I went a head a built hugo from the main repository +using: `go version go1.15.14 linux/amd64` and placed the binary in +`/usr/local/bin`. + +```bash +git clone https://github.com/gohugoio/hugo.git +cd hugo +go install +``` +I started off with the hermit theme and initialized a repository for this site +and the theme to track changes separately. I will probably adjust the color and +type-setting to some extent. Then eventually adjusting the actual layouts and +templates as we go. + +## Git filter + +Currently I setup two branches: `master` which is deployed statically on +leene.dev, and `dev` which is just for local development as I try out different +things. I setup a clean-smudge git filter to manage deployment on a site-basis: + +```toml +[filter "hostmgmt"] + smudge = sed 's@\\$HOSTNAME\\$@http://localhost@' + clean = sed 's@http://localhost@\\$HOSTNAME\\$@' +``` + +But looking closer at the hugo documentation, it would be better to prepare a +similar development and production configuration. We'll see if this can evaluate +system environment variables. + +## Planned features and content + +I usually document most of my system administration work so that will be a large +part of the content here but I am planning to include some technical and +non-technical topics how I see fit. + +First I want to setup a clean flow of generating and serving svg content for +well formatted illustrations. Ideally the source code is contained in the +markdown and evaluated by hugo calling some external processing components but +we will see how that works. I will make some milestones as part of the +repository. + +Secondly I want to try a few style changes for the hermit template. Most of it +is pretty good but there are a few things that I'd rather customise such as the +main page and the footer.