archetypes | ||
content | ||
i18n | ||
install/hugo | ||
public | ||
resources/_gen/assets/css/ananke/css | ||
themes | ||
.gitignore | ||
.gitmodules | ||
build.sh | ||
check.sh | ||
config.toml | ||
deploy.sh | ||
pull.sh | ||
push.sh | ||
README.md | ||
setup.sh | ||
test.sh |
Setup notes
Setup
Required Software
- bash terminal
- hugo
- ssh
- git
- rsync
Windows setup
Install and run git-bash
-
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"
-
Open git-bash
search for git-bash from the start menu and open it
-
Add a name and email address (for identifying your commits)
git config --global user.email "you@example.com" git config --global user.name "Your Name"
Set up SSH key
-
Set up SSH key for connecting to the server
ssh-keygen -t rsa -b 4096 -C "your_email@example.com" eval "$(ssh-agent -s)" ssh-add ~/.ssh/id_rsa
-
Copy your public key and add it to the Git repository account
To view the public key, type the following
cat ~/.ssh/id_rsa.pub
Then go the following page to add this output
-
Clone the repository
mkdir project-folder cd project-folder git clone --recursive git@git.disroot.org:ace/hugo-demo.git cd hugo-demo
-
Install Hugo
./install/hugo/git-bash.sh
-
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