arbejdsfaellesskab.dk/README.rst

47 lines
1.5 KiB
ReStructuredText
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

arbejdsfaellesskab.dk
=====================
Hele dette projekt er på engelsk. Deal with it ┌༼▀̿ Ĺ̯▀̿༽┐
This project contains a ``hugo_site/`` folder, which is the
`Hugo <https://gohugo.io/>`__ project for static site generation (the main
site)::
.
└── hugo_site # <= Hugo project
   ├── content # <= This is where all the content lives!
   │   └── ...
   └── themes
   └── tranetheme # <= The theme
   ├── layouts # <= HTML templates
   ├── static # <= CSS etc
   └── ...
Developing the Hugo site
------------------------
We use a **static main site** because we want to archive the main conference
website as easily as possible. We are using the latest Hugo from the Debian
repositories, but the version from Ubuntu 18.04 is too old.
See below method to directly fetch 2 .deb files from a Debian mirror and
install them.
NB! If any of the links in the below commands are broken, then browse the
mirror to find a newer version of Hugo / libsass.
.. code-block:: console
# Install Hugo
$ wget https://mirror.csclub.uwaterloo.ca/debian/pool/main/libs/libsass/libsass1_3.6.1-1_amd64.deb -O /tmp/libsass1.deb
$ wget https://mirror.csclub.uwaterloo.ca/debian/pool/main/h/hugo/hugo_0.58.3-1_amd64.deb -O /tmp/hugo.deb
$ sudo dpkg -i /tmp/hugo.deb /tmp/libsass1.deb
# Go to project directory
$ cd hugo_site
# Run dev server
$ hugo server