Setup notes

Setup

Required Software

• bash terminal
• hugo
• ssh
• git
• rsync

Windows setup

Install and run git-bash

1. Download and install Git for Windows

   This can be downloaded from https://git-scm.com/download/win

   Make sure to install "git-bash" during the setup process"

2. Open git-bash

   search for git-bash from the start menu and open it

Set up SSH key

1. Set up SSH key for connecting to the server

   ssh-keygen -t ed25519 -C "your_email@example.com"
   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519
   

2. Copy your public key and add it to the Git repository account

   To view the public key, type the following

   cat ~/.ssh/id_ed25519.pub
   

3. Clone the repository

   mkdir project-folder
   cd project-folder
   git clone --recursive git@git.disroot.org:ace/hugo-demo.git
   cd hugo-demo
   

4. Install Hugo

   ./install/git-bash.sh
   

5. Run setup script

   ./setup.sh
   

Workflow

Start local test server

./test.sh

Push changes to remote git repositories

./push.sh

Build changes locally

./build.sh

Build and deploy changes

./deploy.sh

Check remote servers for changes

./check.sh

Pull changes

./pull.sh