The Science of Code

A Free and Open Source community.

Published at: https://thescienceofcode.com/

Current setup

The site now lives under src/ and runs on hugoplate, with local overrides under src/layouts/ to keep the current content/post structure and existing article front matter.

Local prerequisites

1. Install go.

2. Install the theme dependencies:

   cd src/themes/hugoplate
   npm install

3. Download Hugo 0.158.0 extended into:

   .tools/hugo-0.158.0/hugo
   

   The helper scripts will also use hugo from your PATH if the local binary is not present.

Run locally

Use the helper script from the repo root:

./run/dev.sh

That starts Hugo in draft mode (server -D) with the required PATH and HUGO_CACHEDIR. If src/themes/hugoplate/assets/css/generated-theme.css is missing, the script generates it automatically before starting. The helper scripts also recreate src/node_modules -> src/themes/hugoplate/node_modules when needed so Tailwind resolves correctly without leaving a root-level symlink.

If you want to pass custom Hugo arguments, they are forwarded directly:

./run/dev.sh --navigateToChanged
./run/dev.sh server --disableFastRender

If you need to force regeneration of the generated theme tokens:

./run/dev.sh --force-theme-css

Open: http://localhost:1313/

Build once

./run/build.sh

Legacy tranquilpeak

The Science of Code

A Free and Open Source community.

Published at: https://thescienceofcode.com/

Quick start

1. Pre-requisites:

   • Extract Hugo Binaries into the project's root folder.
     • Recommended 0.120.3
     • Fallback version 0.53
   • Install NodeJS
   • Recommended Github Desktop:
     • Linux
     • Win and mac

2. Clone the repo. Note: the theme is contained on a Git Submodule. If you're using Github desktop just clone this repo and it will download the submodule automatically.

   If you're going to modify the theme, you can add the submodule as a repo to Github Desktop (Add existing repository > location ./theme/tranquilpeak) and commit changes directly into the theme repository.

3. Download the repo and install dependencies for the theme:

   cd src/themes/tranquilpeak
   npm install -g grunt-cli
   npm install
   

4. Run theme (if you plan to actively edit it):

   cd src/themes/tranquilpeak
   npm start
   

   Otherwise, just build it!

   cd src/themes/tranquilpeak
   npm run build
   

5. Run the site (using another terminal):

   hugo serve -D
   

   If you are using Powershell:

   .\hugo serve -D
   

The Science of Code is a Free and Open Source initiative by Equilaterus.