add FAQ for Using Hugo's Syntax highlighter "chroma"

Aditya Telange 2021-01-22 00:24:16 +05:30
parent 1825918477
commit 762533ab99
No known key found for this signature in database
GPG Key ID: 82E844EF3DA99E77
2 changed files with 47 additions and 0 deletions

38
FAQs.md

@ -9,6 +9,7 @@
- [Pin a Post](#pin-a-post)
- [Adding Custom Favicon(s)](#adding-custom-favicons)
- [Centering image in markdown](#centering-image-in-markdown)
- [Using Hugo's Syntax highlighter "chroma"](#using-hugos-syntax-highlighter-chroma)
- [References](#references)
---
@ -271,6 +272,43 @@ Add `#center` after image to center align an image
---
## Using Hugo's Syntax highlighter "chroma"
1. Disable Highlight.js in site `config.yml`
```yml
params:
assets:
disableHLJS: true
```
2. Set hugo's markdown styling in site `config.yml`
```yml
markup:
highlight:
# anchorLineNos: true
codeFences: true
guessSyntax: true
lineNos: true
# noClasses: false
style: monokai
```
3. If you want `lineNos: true`, the background won't be proper.
Add the following to `assets/css/extended/custom.css`
```css
.chroma {
background-color: unset;
}
```
More Info : [Configure Markup - Highlight](https://gohugo.io/getting-started/configuration-markup#highlight)
---
## References
- [Override a Hugo theme](https://zwbetz.com/override-a-hugo-theme/)

@ -191,6 +191,15 @@ menu:
name: example.org
url: https://example.org
weight: 30
# Read: https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs#using-hugos-syntax-highlighter-chroma
# markup:
# highlight:
# # anchorLineNos: true
# codeFences: true
# guessSyntax: true
# lineNos: true
# # noClasses: false
# style: monokai
```
---