Cant complete customization

[A3Bagged]

Hello, i'm trying to follow the Customization tutorial for insiders but once i get to Development mode it throws me some errors.
_I've cloned the repo from the directory itself since using Guthub Desktop said fatal: protocol 'https' is not supported using git clone with GH_TOKEN

Powershell 7: npm start

(venv) PS D:\Documenten\GitHub\mkdocs-material-insiders> npm start

> mkdocs-material@9.5.47+insiders-4.53.14 start
> ts-node -T tools/build --verbose --all --dirty --watch

18:30:04 + material/overrides\assets\stylesheets\custom.css
18:30:04 + material/templates\assets\stylesheets\palette.css
18:30:04 + material/overrides\assets\stylesheets\home.css
Error: EPERM: operation not permitted, symlink '..\..\src\extensions\emoji.py' -> 'D:\Documenten\GitHub\mkdocs-material-insiders\material\extensions\emoji.py'
    at async Object.symlink (node:internal/fs/promises:1001:10) {
  errno: -4048,
  code: 'EPERM',
  syscall: 'symlink',
  path: '..\\..\\src\\extensions\\emoji.py',
  dest: 'D:\\Documenten\\GitHub\\mkdocs-material-insiders\\material\\extensions\\emoji.py'

Error: EPERM: operation not permitted, symlink '..\..\..\src\overrides\hooks\shortcodes.py' -> 'D:\Documenten\GitHub\mkdocs-material-insiders\material\overrides\hooks\shortcodes.py'
    at async Object.symlink (node:internal/fs/promises:1001:10) {
  errno: -4048,
  code: 'EPERM',
  syscall: 'symlink',
  path: '..\\..\\..\\src\\overrides\\hooks\\shortcodes.py',
  dest: 'D:\\Documenten\\GitHub\\mkdocs-material-insiders\\material\\overrides\\hooks\\shortcodes.py'

I've tried adding these manually from he github but they get removed everytime.

---

Next i tried to see if it would run at all using mkdocs serve in a fresh Powershell 7 window and i got the following

PowerShell 7.4.6
PS C:\Users\Christoph> cd D:\Documenten\GitHub\mkdocs-material-insiders
PS D:\Documenten\GitHub\mkdocs-material-insiders> mkdocs serve
ERROR   -  Config value 'markdown_extensions': Failed to load extension 'material.extensions.preview'.
           ModuleNotFoundError: No module named 'material.extensions.preview'

Aborted with a configuration error!
PS D:\Documenten\GitHub\mkdocs-material-insiders>

I can't get the preview to work, any ideas?

[squidfunk]

I expect this issue to be a problem with Windows, but I don't have Windows at my disposal. Everything works as expected on macOS / Unix. Maybe somebody with access to Windows can help here. The second error might be caused by the fact that the build is not completing. Try to run it on a fresh checkout – all files are checked in. If that works, and you followed all steps in the customization guide, it's related to the symlink problem.

[kamilkrzyskow]

Hello @A3Bagged,

(venv) PS D:\Documenten\GitHub\mkdocs-material-insiders> npm start

The first issue shows errors with symlink creation. You need to run PowerShell with Administrator privileges or enable Developer mode, I run as admin personally.

PS D:\Documenten\GitHub\mkdocs-material-insiders> mkdocs serve
ModuleNotFoundError: No module named 'material.extensions.preview'

Second issue looks like you haven't enabled the venv with the Insiders version of the project, hence the lack of the preview module.
You can check pip show mkdocs-material --verbose

As for the issue with the https protocol, I don't know, I never used GitHub Desktop 🤔 . If you're planning to work with Insiders and perhaps plan to use the social plugin locally, better switch to MSYS2 environment with installed gcc, git etc.

• https://squidfunk.github.io/mkdocs-material/plugins/requirements/image-processing/#cairo-graphics-windows