update
Signed-off-by: weru <fromweru@gmail.com>
| | |
| | | |
| | | hr |
| | | border: none |
| | | padding: 0.5px |
| | | background: var(--text) |
| | | opacity: 0.5 |
| | | padding: 1px |
| | | background: var(--border-color) |
| | | margin: 1rem 0 |
| | | |
| | | .aside |
| | |
| | | .post |
| | | margin: 0 auto |
| | | width: 100% |
| | | p, h1, h2, h3, h4, h5, h6, blockquote, ol, ul |
| | | p, h1, h2, h3, h4, h5, h6, blockquote, ol, ul, .highlight_wrap, hr |
| | | max-width: 840px !important |
| | | margin-left: auto |
| | | margin-right: auto |
| | |
| | | |
| | | This tutorial will show you how to create a simple theme in Hugo. I assume that you are familiar with HTML, the bash command line, and that you are comfortable using Markdown to format content. I'll explain how Hugo uses templates and how you can organize your templates to create a theme. I won't cover using CSS to style your theme. |
| | | |
| | | {{< youtube "https://www.youtube.com/watch?v=aOC8E8z_ifw" >}} |
| | | |
| | | We'll start with creating a new site with a very basic template. Then we'll add in a few pages and posts. With small variations on that, you will be able to create many different types of web sites. |
| | | |
| | | In this tutorial, commands that you enter will start with the "$" prompt. The output will follow. Lines that start with "#" are comments that I've added to explain a point. When I show updates to a file, the ":wq" on the last line means to save the file. |
| | |
| | | |
| | | The `[emojify](https://gohugo.io/functions/emojify/)` function can be called directly in templates or [Inline Shortcodes](https://gohugo.io/templates/shortcode-templates/#inline-shortcodes). |
| | | |
| | | {{< youtube "https://www.youtube.com/watch?v=eW7Twd85m2g" >}} |
| | | |
| | | To enable emoji globally, set `enableEmoji` to `true` in your siteβs [configuration](https://gohugo.io/getting-started/configuration/) and then you can type emoji shorthand codes directly in content files; e.g. |
| | | |
| | | <p><span class="nowrap"><span class="emojify">π</span> <code>:see_no_evil:</code></span> <span class="nowrap"><span class="emojify">π</span> <code>:hear_no_evil:</code></span> <span class="nowrap"><span class="emojify">π</span> <code>:speak_no_evil:</code></span></p> |
| | |
| | | ## Create your Hugo configuration file |
| | | Hugo can read your configuration as JSON, YAML or TOML. Hugo supports parameters custom configuration too. Refer to the [Hugo configuration documentation](/overview/configuration/) for details. |
| | | |
| | | {{< youtube "https://www.youtube.com/watch?v=eW7Twd85m2g" >}} |
| | | |
| | | ## Set your configuration publish folder to `_site` |
| | | The default is for Jekyll to publish to `_site` and for Hugo to publish to `public`. If, like me, you have [`_site` mapped to a git submodule on the `gh-pages` branch](http://blog.blindgaenger.net/generate_github_pages_in_a_submodule.html), you'll want to do one of two alternatives: |
| | | |
| | |
| | | licenselink = "https://github.com/onweru/compose/blob/master/LICENSE" |
| | | description = "A hugo theme for documentation sites. It's inspired by forestry.io's docs page" |
| | | homepage = "https://docs.neuralvibes.com" |
| | | tags = ["technical", "docs", "dark", "blog", "search", "documentation"] |
| | | features = ["technical", "docs", "dark", "blog", "search", "documentation"] |
| | | tags = ["dark mode", "docs", "dark", "blog", "search", "documentation"] |
| | | features = ["dark mode", "docs", "dark", "blog", "search", "documentation"] |
| | | min_version = "0.76.0" |
| | | |
| | | [author] |