How to update passports

In short

The Skills Map is the master list of trainings. Every Training Passport is built from it. Change the map, run Update passports, then export the site.

When to run it

After every change to the Skills Map (for example after the weekly meeting).
After you make a new passport.

Steps

Open 07 - 🎓 Skills Map and make the change.
Tell the map which roles need a training. Add the role codes at the end of the line, between double percent signs, like the example. Codes are hidden on the website.
```
- [[Sales 101|Sales]] %%RM RC%%
```
To give a whole section to a role, put the codes on the section name instead:
```
**Client journey** %%SP NU%%
```
Induction and Core need no codes: every role gets them. Add codes to a Core line only if that one training is for some roles only.
Go to the folder ObsidianWiki (it holds the LeorWiki folder) and double-click Update passports.bat.
Read the window:
- UPDATED with + and - lines: trainings added to or removed from that passport.
- up to date: nothing changed.
- Lines starting with !: something to fix (see below).
Export the site as usual.

Role codes

Code	Role
SP	Skin practitioner
DR	Doctor
NU	Nurse
NT	Nutritionist
RM	Relationship manager
RC	Receptionist
HE	Hospitality executive
VA	Valet
FM	Floor manager
CM	Center manager
AS	Accounts & store executive

What changes in a passport

Rebuilt from the map: the part between the two marker lines. That is Induction, the first sign-off, Core and the team level.
Kept as you wrote it: the sheet fields at the top, the score table (Treatment skills or other hard skills), the sign-offs after it, and the Status.
Before a passport changes, a copy is saved in the folder _passport backups (next to Update passports.bat).

Do not edit between the marker lines in a passport

The next run replaces that part. Change the Skills Map instead.

The marker lines look like this (visible only in editing view):

> %% map:start | role: SP | team: Treatment team | timing: Months 1 to 2 %%
> %% map:end %%

role = the role code
team = the name of the level with the role's own trainings
timing = the line under that level name

New passport for a new role

In Training passports, make a new note from the template PASS00. Name it like PASS02 - Doctor.
In the map:start line, set the role code, team name and timing. Example: role: DR | team: Medical team | timing: Months 1 to 2.
In the Skills Map, add the role code to the trainings this role needs.
Run Update passports.
Fill in the score table and the sign-offs by hand.

Good to know

The team level shows up to 3 sections side by side. With more, the script makes one level per map tile and shows a ! line.
Training names in passports come from the map (the text after | in the link).
Rename a training note inside Obsidian, not in Windows Explorer, so all links update.
Status still works: a training whose note is Draft or not written shows grey in every passport.

Printing a passport

Open the passport on the website in Chrome or Edge and press Ctrl+P.
Paper: A4. Scale: Default (100%). Margins: Default.
Untick Headers and footers, so the web address and date do not print at the edges. Chrome remembers this.
Print quality Standard, not Draft: the thin row lines can disappear in Draft mode.
Black and white is fine. One passport fits on one A4 page; if the preview shows a second page, a level has grown too long.

If something goes wrong

Message	What to do
no map:start / map:end marker lines	Copy the two marker lines from PASS00 into the passport.
role code unknown	Use a code from the table above. A new role needs its code added to the script.
Unknown role code in the Skills Map	Fix the typo in the map (codes are capital letters).
Window closes at once or "python is not recognized"	Install Python 3 from python.org and tick "Add python.exe to PATH".
A passport looks wrong	Copy it back from _passport backups, then check the map.