summaryrefslogtreecommitdiff
path: root/content/docs/configure.md
diff options
context:
space:
mode:
authorRoger Gonzalez <roger@rogs.me>2023-01-09 19:57:39 -0300
committerRoger Gonzalez <roger@rogs.me>2023-01-09 19:57:39 -0300
commitbb298a0e8329889513c055a5984a4231980d96a0 (patch)
tree17f1535930aea9ea4e1eb1632cd3936f58269902 /content/docs/configure.md
parentc3476d0fcc37f846b055f46d658afc76a99b41d3 (diff)
Cleaned up docs directory
Diffstat (limited to 'content/docs/configure.md')
-rw-r--r--content/docs/configure.md53
1 files changed, 53 insertions, 0 deletions
diff --git a/content/docs/configure.md b/content/docs/configure.md
new file mode 100644
index 0000000..48d9e60
--- /dev/null
+++ b/content/docs/configure.md
@@ -0,0 +1,53 @@
+---
+title: 'Configuration'
+date: 2019-02-11T19:30:08+10:00
+draft: false
+weight: 4
+summary: Syntax highlighting and menus can be configured via `config.toml`.
+---
+
+## Syntax Highlighting
+
+Whisper uses the in-built code highlighting that ships with hugo. https://gohugo.io/content-management/syntax-highlighting/
+
+You can insert code snippets in any markdown file by using standard code fences syntax ie:
+
+````
+```
+insert code here
+```
+````
+
+You can specify the langauge by adding a declaration after the backticks
+
+````
+```javascript
+insert code here
+```
+````
+
+### Pygments Options
+
+The following code highlighting options are configured in the `config.toml`
+
+```toml
+pygmentsCodeFences = true
+pygmentsCodefencesGuessSyntax = true
+pygmentsUseClasses = true
+```
+
+## Main menu
+
+Configure the main menu by editing the `config.toml`
+
+```toml
+[[menu.main]]
+name = "Home"
+url = "/"
+weight = 1
+
+[[menu.main]]
+name = "Docs"
+url = "/docs/"
+weight = 2
+```