https://github.com/jsnjack/kraiklyn
A Hugo theme for one page documentation
https://github.com/jsnjack/kraiklyn
documentation hugo hugo-theme single-page-site theme
Last synced: 10 months ago
JSON representation
A Hugo theme for one page documentation
- Host: GitHub
- URL: https://github.com/jsnjack/kraiklyn
- Owner: jsnjack
- License: mit
- Created: 2018-01-28T19:59:39.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-06-30T15:54:20.000Z (12 months ago)
- Last Synced: 2025-08-18T22:42:30.331Z (10 months ago)
- Topics: documentation, hugo, hugo-theme, single-page-site, theme
- Language: HTML
- Size: 174 KB
- Stars: 51
- Watchers: 5
- Forks: 35
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
Kraiklyn
=====
A simple one page [Hugo](https://gohugo.io/) theme for documentation. Inspired by Hyde, Simpledoc and docDock themes
# Features
- all content is rendered on one page
- unlimited menu level
- mobile friendly
- customize website logo
- add links to the sidebar
# Installation
Clone the repository to your site’s themes directory.
# Usage
All content is rendered on the main page. Front-matter's `anchor` is used for the navigation. Content is ordered by Weight.
When creating a new section, make sure `_index.md` exists for correct cross-references.
## Shortcodes
### block
Create notes, tips and other blocks on the page
```markdown
{{< block note >}}
By default only ports 22, 80 and 443 are open
{{< /block >}}
```
Available types: `note`, `tip`, `warn`, `info`
### readfile
Reads a file and displays its contents, skipping the specified section.
```markdown
{{< readfile file="path/to/file" skip-to="section" lang="ini" >}}
```
### anchor
Returns `anchor` parameter (see `archetypes/default.md` file) of the article
```markdown
Check [Proxy environment]({{< anchor "installation/proxy-environment.md" >}}) section
```
Since the theme is a one-page theme, this is the way to make cross-references on the website
## Customizing sidebar
### Changing logo
Replace logo by creating `layouts/partials/logo.html` file
### Adding menu entries to the external links section
Customize the name of the section by adding to the `config.toml`
```toml
[params]
externalTitle = "Surfly docs"
```
Add new entries:
```toml
[[menu.shortcuts]]
name = "Javascript API"
url = "https://docs.surfly.com/javascript.html"
weight = 20
```
### Changing color
Customize the color of the sidebar by adding to the `config.toml`
```toml
[params]
sidebarColor = "green"
```
Available values : default, green, purple, pink, red, cyan, blue, grey, orange.
## Add favicon
Put `favicon.ico` inside `static` folder
## Add custom CSS
You can add your custom CSS files with the `customCss` parameter of the configuration file.
```toml
customCss = ["css/custom.css", "css/custom2.css"]
```
Just put your files in `static/css` directory.