How to make FA26 Kannai site

Clone repo from remote

Terminal

yuichi@MacBookAir-M2 ~ %  cd repos
yuichi@MacBookAir-M2 ~/repos %  ls
fa25_kannai_site
yuichi@MacBookAir-M2 ~/repos %  git clone git@gitlab.fabcloud.org:academany/fabacademy/2026/labs/kannai/site.git fa26_kannai_site
Cloning into 'fa26_kannai_site'...
warning: You appear to have cloned an empty repository.
yuichi@MacBookAir-M2 ~/repos %  ls
fa25_kannai_site
fa26_kannai_site
yuichi@MacBookAir-M2 ~/repos %  cd fa26_kannai_site 
yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  ls -la
total 0
drwxr-xr-x   3 yuichi  staff   96  1月 21 10:13 .
drwxr-xr-x  17 yuichi  staff  544  1月 21 10:13 ..
drwxr-xr-x   9 yuichi  staff  288  1月 21 10:13 .git

Get Student template MkDocs as zip

https://gitlab.fabcloud.org/academany/fabacademy/templates/student-template-mkdocs

Download

Unzip and open in Terminal

Right click -> Service -> New Terminal at Folder

Get the path

Copy

cp -a ~/Downloads/student-template-mkdocs-master/. ~/repos/fa26_kannai_site/

Terminal

yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  cp -a ~/Downloads/student-template-mkdocs-master/. ~/repos/fa26_kannai_site/
yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  ls  
docs            README.md
mkdocs.yml      requirements.txt
yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  ls -la
total 40
drwxrwxr-x@  9 yuichi  staff   288  1月 26  2023 .
drwxr-xr-x  17 yuichi  staff   544  1月 21 10:13 ..
drwxr-xr-x   9 yuichi  staff   288  1月 21 10:13 .git
-rw-rw-r--@  1 yuichi  staff    21  1月 26  2023 .gitignore
-rw-rw-r--@  1 yuichi  staff   622  1月 26  2023 .gitlab-ci.yml
drwxrwxr-x@  8 yuichi  staff   256  1月 26  2023 docs
-rw-rw-r--@  1 yuichi  staff  1608  1月 26  2023 mkdocs.yml
-rw-rw-r--@  1 yuichi  staff  2189  1月 26  2023 README.md
-rw-rw-r--@  1 yuichi  staff   244  1月 26  2023 requirements.txt

Python

Terminal

yuichi@MacBookAir-M2 ~ %  for p in $(which -a python3); do
  echo "-----"
  $p --version
  $p -c "import sys; print(sys.executable)"
done
-----
Python 3.13.5
/Library/Frameworks/Python.framework/Versions/3.13/bin/python3
-----
Python 3.13.5
/usr/local/bin/python3
-----
Python 3.9.6
/Library/Developer/CommandLineTools/usr/bin/python3

%  ls -l /usr/local/bin/python3
lrwxr-xr-x  1 root  wheel  70  7月  6  2025 /usr/local/bin/python3 -> ../../../Library/Frameworks/Python.framework/Versions/3.13/bin/python3

Note

There are two python3 existed.
- Python 3.13.5
- installed python installer
- /usr/local/bin/python3 is parmanent link of ../../../Library/Frameworks/Python.framework/Versions/3.13/bin/python3
- Python 3.9.6
- from macOS

Terminal

yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  which python3  
/Library/Frameworks/Python.framework/Versions/3.13/bin/python3  
yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  which pip  
/Users/yuichi/Library/Python/3.9/bin/pip  
yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  which pip3  
/Users/yuichi/Library/Python/3.9/bin/pip3  

Note

If I use pip or pip3, it will be install to python3.9 environment, not python3.13.5 .

venv

Create vertual environmant (venv)

Terminal

yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  python3 -m venv venv
yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  source venv/bin/activate
(venv) yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  python --version
Python 3.13.5
(venv) yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site % which pip  
/Users/yuichi/repos/fa26_kannai_site/venv/bin/pip  

Install from requiremants.txt

Terminal

(venv) yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  cat requirements.txt    
# Documentation static site generator
mkdocs ~= 1.4

# Add your custom theme if not inside a theme_dir
# (https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes)
mkdocs-material ~= 9.0

# Plugins
mkdocs-git-revision-date-localized-plugin ~= 1.1.0
(venv) yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  python -m pip install -r requirements.txt
(venv) yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  mkdocs serve

Note

This mkdocs serve can not update site -> install mkdocs into Python3.9.6

deactivate venv

Terminal

(venv) yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site %  deactivate
yuichi@MacBookAir-M2 ~/repos/fa26_kannai_site % 

Note

source venv/bin/activate

deactivate

Alias

Setting

Terminal

% nano ~/.zshrc

nano

alias venv="source venv/bin/activate"

Terminal

% source ~/.zshrc

Usage

Terminal

% venv

Note

venv

deactivate