Start an editing session
BNR info-hub Technical Manual
1 Start an editing session
1.1 Purpose
This guide explains how to begin routine work on the BNR info-hub.
Use it when the repository is already set up on your machine and you want to edit pages, run a briefing, preview the site, or prepare a commit.
1.2 Standard local path
C:\yoshimi-hot\output\analyse-bnr\info-hub
Future users may have a different path. They should record it in their local setup notes.
2 Stage 1: Open the repo
NoteStep 1. Open the project folder
Open VS Code and open:
C:\yoshimi-hot\output\analyse-bnr\info-hub
Open the terminal with:
Ctrl + J
NoteStep 2. Confirm the terminal location
Run:
pwdIf needed, move to the repo root:
cd C:\yoshimi-hot\output\analyse-bnr\info-hub3 Stage 2: Check current repo state
NoteStep 1. Check Git status
Run:
git statusReview existing changed or untracked files before starting new work.
TipWhat to look for
Expected changes may include:
site/...
scripts/stata/...
outputs/public/...
site/downloads/files/...
DECISIONS.md
CHANGELOG.md
Unexpected files may include:
site/_site/
site/.quarto/
*.log
*.dta
private data
local path files
4 Stage 3: Start preview if needed
NoteStep 1. Move to the site folder
cd C:\yoshimi-hot\output\analyse-bnr\info-hub\site
NoteStep 2. Start Quarto preview
quarto preview --port 42005 Stage 4: End cleanly
NoteStep 1. Stop preview
Press:
Ctrl + C
NoteStep 2. Check Git before leaving
cd C:\yoshimi-hot\output\analyse-bnr\info-hub
git status