diff options
-rw-r--r-- | README.md | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..a95c0aa --- /dev/null +++ b/README.md @@ -0,0 +1,56 @@ +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 + +## 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`, `warning`, `info` + +### 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 addind 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 +``` |