Skip to content

--- title: "Cambria-Labs.com contributor Boot-up" date: 2025-02-11

Cambria-Labs.com website contributor boot-up

How to start working on the website.

Required tools

  • VSCodium - Open-source code editor, similar to VSCode
  • Repository: https://codeberg.org/Cambria-Labs/Cambria-Labs.com_website

Open Website code in Editor

  • Drag /_Websites/Cambria-Labs.com folder onto VSCodium

Start Python environment

  • Open Terminal (Control + Option + ~Tilde)
  • source venv/bin/activate

Add SSH identity key to SSH agent

ssh-add ~/.ssh/id_jro_cambria-labs_codeberg

Check what's new

git status
git diff

Pull down remote changes from source repository

git pull

Pull in requirements

pip install -r requirements.txt

Test out website locally

mkdocs serve

Visit http://127.0.0.1:8000

Build site

# Exports HTML website to `/site`
./_TOOLS/build-site.sh

Save code to Remote Source Repository (Codeberg)

git commit -a -m "(Explanation of changes)

# -a: all changes
# -m: commit message

Verify SSH works

ssh -T git@codeberg.org

Git push

git push

Initial Git Repo setup

git remote add origin git@codeberg.org:Cambria-Labs/Cambria-Labs.com_website.git
git push -u origin main

Note: With Codeberg, I had problems using Git over HTTPS. Instead I used the SSH repository URL and had success

Useful resources

  • https://github.com/tdurtschi/block-game/blob/main/scripts/deploy.sh