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 repostiroy

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