Utvecklingsmiljö för Callistas hemsida

Introduktion

mise är en programvara som används för att sätta upp en utvecklingsmiljö. Man använder sig av konfigurationsfil(er), mise.toml, mise.local.toml, mise/config.toml, etc. för att beskriva miljön.

När man sedan stegar sig in i en katalog som innehåller en konfigurationsfil så aktiveras miljön. När miljön är aktiverad så har man tillgång till de programvaror (tools) som är definierade och man har även tillgång till eventuellt beskrivna uppgifter (tasks).

Kom igång

1. Installera mise, om du inte redan gjort det:

curl https://mise.run | sh

2. Aktivera mise i ditt shell så att det aktiveras automatiskt per katalog. Lägg till detta i ditt shells init-fil (t.ex ~/.zshrc):

eval "$(mise activate zsh)"

och starta sedan om din terminal (eller source ~/.zshrc).

En sak som akn göras samtidigt är att kommentera ut eller ta bort radne rbenv init i ~/.zshrc om den finns där.

Använd följande uttryck för att se om kommandot finns

rg "rbenv init" ~ --hidden -g '!.git' -g '!node_modules' -g '!Library' 2>/dev/null

3. Trust och installera

cd /path/to/callistaenterprise.github.io
mise trust
mise install

mise trust körs en gång per projekt - mise exekverar inte konfiguration som den inte litar på. mise install laddar ned och bygger sedan Ruby med den version som har specificerats i mise.toml.

4. Verifiera att mise är aktivt

mise current
ruby -v          # should print 3.3.4

5. Starta upp Jekyll

mise run setup
mise run serve

6. Felsökning

För att visa Jekylls byggfel lokalt, kör

mise run safe