hugo-theme-fha/README.md

79 lines
1.9 KiB
Markdown
Raw Normal View History

2024-09-01 14:45:18 +00:00
# Theme hugo-theme-fha
2024-09-01 14:27:23 +00:00
## Features
### Search
Lightweight search functionality based on index file.
2024-09-01 14:45:18 +00:00
Requires
```toml
[outputs]
home = ["HTML", "RSS", "JSON"]
```
2024-09-01 14:27:23 +00:00
### Mermaid
Support for Mermaid schemas.
2024-09-01 14:45:18 +00:00
### Photos (soon)
2024-09-01 14:27:23 +00:00
Support photos albums based on Folders.
### Syntax Hightlighting
Required configuration to copy paste code :
2024-09-01 14:45:18 +00:00
```toml
2024-09-01 14:27:23 +00:00
[markup.highlight]
lineNos=true
lineNumbersInTable=true
noClasses = false
2024-09-01 14:45:18 +00:00
```
2024-09-01 14:27:23 +00:00
### Curriculum Vitae
Copy /layouts/section/cv.html to you local /layouts/section folder and edited the content.
Save your own picture under /static/img/avatar.jpeg
2024-09-01 14:32:27 +00:00
Add an entry in the about Menu:
2024-09-01 14:45:18 +00:00
```toml
[[menu.nav]]
name = 'About'
pageRef = '/about'
weight = 100
[[menu.nav]]
identifier = "pAbout"
name = "About"
url = "/about"
parent = "About"
weight = 10
[[menu.nav]]
identifier = "pCv"
name = "CV"
url = "/cv"
parent = "About"
weight = 20
```
It is possible to add cv in other languages
* Add the content is section (ex:cvfr.html).
* Add an entry in the nav menu.
2024-09-01 14:32:27 +00:00
## BlockQuotes Render Hook
Block quotes are now customizable in the markdown files.
The format is the following :
``` md
> [!IMPORTANT]
> Key information users need to know to achieve their goal.
```
Those are customizable in `assets/theme.css`.
Currently, the supported Tags are : CAUTION, Important, NOTE, TIP, WARNING, NATURE, CAMPING, METEO, MONEY, DANGER, WIFI.
New Tags can be added by customizing 'render-blockquote-alert.html'.
2024-09-01 14:27:23 +00:00
## Installation
## Configuration
### Favicons
Get Icons from [Flaticon](https://www.flaticon.com/).
Generate Favicons with [Freepik](https://www.freepik.com/).
Uncompress the icons in your /static folder.
## References
* [Bootstrap 5.2.3](https://getbootstrap.com/docs/5.2/getting-started/download/)
* [JQuery](https://jquery.com/download/)
* [Mermaid](https://cdn.jsdelivr.net/npm/mermaid@11.0.2/dist/)