Website

This is the source for redox-os.org website.

Setup

To build this site, you must install Hugo and Nodejs and run the hugo.sh file.

Install Hugo

You can install Hugo from automated script using (webi)[https://webinstall.dev/hugo]

curl -sS https://webi.sh/hugo | sh; \
source ~/.config/envman/PATH.env

Or install it manually:

• Download the executable for your CPU architecture on this link
• Move the extracted hugo file to the ~/.local/bin directory on your user folder
• Verify if the ~/.local/bin is present on your PATH (run echo $PATH to verify)
• If the ~/.local/bin directory is not present on your PATH environment variable, you must add it on the configuration file of your terminal shell

Install Nodejs

NOTE: Nodejs is only needed for PostCSS during building the site. You can skip Node.js if you only want to preview the site.

You can install Nodejs from automated script using (webi)[https://webinstall.dev/node]

curl -sS https://webi.sh/node | sh; \
source ~/.config/envman/PATH.env

Or install it manually:

• Download the executable for your CPU architecture on this link
• Move the extracted node file to the ~/.local/bin directory on your user folder
• Verify if the ~/.local/bin is present on your PATH (run echo $PATH to verify)
• If the ~/.local/bin directory is not present on your PATH environment variable, you must add it on the configuration file of your terminal shell

Bash PATH

To add the ~/.local/bin directory on the PATH of your GNU Bash, add the following text on the end of the .bashrc file at your user folder:

export PATH=$PATH:$HOME/.local/bin

Preview

To preview the site, run the following command, wait it to finish and open the link http://localhost:1313

./hugo.sh serve

The hugo.sh is a script that enables content written for the English language webpage (in the content/ directory) to be visible in pages of other languages.

But this results in a quirk where hugo does not watch for changes in the content/ directory when you use ./hugo.sh serve command.

So, you can use the hugo serve command instead, which makes sure that content/ directory is also watched (just for when you're writing the pages).

Verify Broken Links

Use the lychee tool to verify broken links, it's very advanced and fast.

Read this page to install the tool.

Customizing Bulma

The bulma.css used in this page is a trimmed version from the production CSS. We're not using the v1 version because Netsurf can't use CSS variables which v1 is heavily using it.

To add more classes from Bulma, copy the full production CSS into bulma.css then run hugo to create another trimmed version of it using PostCSS, then copy the generated bulma.css back into the repository.

Usage

Run the following command inside the repository folder:

lychee content