Whatis
Quartz — static site generator, который собрал этот сайт.
Pros & cons
Ощущается как плохо написанный инструмент, но генерирует красивые странички. mkdocs (material) написан лучше, с ним приятнее работать, но страницы на выходе хуже, чем у quartz. Thats all.
Troubleshoot
Word higlighting is not working with asterisk symbol
В конструкции / / Asterisk symbol (*) не работает, даже если экранировать (\):
```go /*p/ /\*p/
...
*p *= *p
...
```
При чем явную ошибку в выводе ты не получишь даже с --verbose в команде:
npx quartz build --serve --verboseВсё, что ты получишь — зависшую сборку на этапе [process]. При чем, проблемного файла в выводе не будет, ибо он даже не process-ится, как я понимаю.
Допустим, проблемный файл — это go/go-pointers.md, значит вывод зависнет до его proccessing-а и в выводе его не будет:
...
[process] content/go/go-imports.md -> go/go-imports (13ms)
[process] content/go/go-packages.md -> go/go-packages (10ms)
<сборка зависла>
Resources: