mirror of https://github.com/vacp2p/rfc.git
719 lines
13 KiB
HTML
719 lines
13 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en" dir="ltr">
|
|
|
|
<head>
|
|
<meta name="generator" content="Hugo 0.80.0" />
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="description" content="">
|
|
<meta name="theme-color" content="#FFFFFF"><meta property="og:title" content="Blog" />
|
|
<meta property="og:description" content="" />
|
|
<meta property="og:type" content="website" />
|
|
<meta property="og:url" content="http://example.org/posts/" />
|
|
<meta property="og:updated_time" content="2014-09-28T00:00:00+00:00" />
|
|
<title>Blog | My New Hugo Site</title>
|
|
<link rel="manifest" href="/manifest.json">
|
|
<link rel="icon" href="/favicon.png" type="image/x-icon">
|
|
<link rel="stylesheet" href="/book.min.6c7c6446dfdee7c8c933e9bbc6e80ee3ed6c913b2a59519f2092c3c6a9d63e55.css" integrity="sha256-bHxkRt/e58jJM+m7xugO4+1skTsqWVGfIJLDxqnWPlU=">
|
|
<script defer src="/en.search.min.b058edf587cc787855b3d071254fe14f8dde3f72958d02e619e4aa992f47ef07.js" integrity="sha256-sFjt9YfMeHhVs9BxJU/hT43eP3KVjQLmGeSqmS9H7wc="></script>
|
|
<link rel="alternate" type="application/rss+xml" href="http://example.org/posts/index.xml" title="My New Hugo Site" />
|
|
<!--
|
|
Made with Book Theme
|
|
https://github.com/alex-shpak/hugo-book
|
|
-->
|
|
|
|
|
|
</head>
|
|
|
|
<body dir="ltr">
|
|
<input type="checkbox" class="hidden toggle" id="menu-control" />
|
|
<input type="checkbox" class="hidden toggle" id="toc-control" />
|
|
<main class="container flex">
|
|
<aside class="book-menu">
|
|
<div class="book-menu-content">
|
|
|
|
<nav>
|
|
<h2 class="book-brand">
|
|
<a href="/"><span>My New Hugo Site</span>
|
|
</a>
|
|
</h2>
|
|
|
|
|
|
<div class="book-search">
|
|
<input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
|
|
<div class="book-search-spinner hidden"></div>
|
|
<ul id="book-search-results"></ul>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li class="book-section-flat" >
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/example/" class="">Example Site</a>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/example/table-of-contents/" class="">Table of Contents</a>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/example/table-of-contents/with-toc/" class="">With ToC</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/example/table-of-contents/without-toc/" class="">Without ToC</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<input type="checkbox" id="section-4e46b01272d410b3a99461d79326ddf4" class="toggle" />
|
|
<label for="section-4e46b01272d410b3a99461d79326ddf4" class="flex justify-between">
|
|
<a class="">Collapsed</a>
|
|
<span>▾</span>
|
|
</label>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/example/collapsed/3rd-level/" class="">3rd Level</a>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/example/collapsed/3rd-level/4th-level/" class="">4th Level</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li class="book-section-flat" >
|
|
|
|
|
|
|
|
|
|
|
|
<span>Shortcodes</span>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/buttons/" class="">Buttons</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/columns/" class="">Columns</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/details/" class="">Details</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/expand/" class="">Expand</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/hints/" class="">Hints</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/katex/" class="">Katex</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/mermaid/" class="">Mermaid</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<input type="checkbox" id="section-d3fc1bf6d66cd84b896a0af9f40cb1d5" class="toggle" />
|
|
<label for="section-d3fc1bf6d66cd84b896a0af9f40cb1d5" class="flex justify-between">
|
|
<a href="http://example.org/docs/shortcodes/section/" class="">Section</a>
|
|
<span>▾</span>
|
|
</label>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/section/page1/" class="">Page1</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/section/page2/" class="">Page2</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
|
|
|
|
|
|
<a href="http://example.org/docs/shortcodes/tabs/" class="">Tabs</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="/posts/" >
|
|
Blog
|
|
</a>
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</nav>
|
|
|
|
|
|
|
|
|
|
<script>(function(){var menu=document.querySelector("aside.book-menu nav");addEventListener("beforeunload",function(event){localStorage.setItem("menu.scrollTop",menu.scrollTop);});menu.scrollTop=localStorage.getItem("menu.scrollTop");})();</script>
|
|
|
|
|
|
|
|
</div>
|
|
</aside>
|
|
|
|
<div class="book-page">
|
|
<header class="book-header">
|
|
|
|
<div class="flex align-center justify-between">
|
|
<label for="menu-control">
|
|
<img src="/svg/menu.svg" class="book-icon" alt="Menu" />
|
|
</label>
|
|
|
|
<strong>Blog</strong>
|
|
|
|
<label for="toc-control">
|
|
|
|
<img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
|
|
|
|
</label>
|
|
</div>
|
|
|
|
|
|
|
|
<aside class="hidden clearfix">
|
|
|
|
<nav>
|
|
<ul>
|
|
|
|
|
|
<li class="book-section-flat">
|
|
<strong>Categories</strong>
|
|
<ul>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/categories/development/">Development</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/categories/golang/">golang</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
|
|
<li class="book-section-flat">
|
|
<strong>Tags</strong>
|
|
<ul>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/development/">development</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/go/">go</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/golang/">golang</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/hugo/">hugo</a>
|
|
<span>1</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/templates/">templates</a>
|
|
<span>1</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/themes/">themes</a>
|
|
<span>1</span>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
|
|
</aside>
|
|
|
|
|
|
</header>
|
|
|
|
|
|
|
|
|
|
<article class="markdown book-post">
|
|
<h2>
|
|
<a href="/posts/creating-a-new-theme/">Creating a New Theme</a>
|
|
</h2>
|
|
|
|
<h5>September 28, 2014</h5>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p>Introduction # 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.
|
|
We’ll start with creating a new site with a very basic template.
|
|
<a href="/posts/creating-a-new-theme/">...</a>
|
|
|
|
</p>
|
|
</article>
|
|
|
|
<article class="markdown book-post">
|
|
<h2>
|
|
<a href="/posts/migrate-from-jekyll/">Migrate to Hugo from Jekyll</a>
|
|
</h2>
|
|
|
|
<h5>March 10, 2014</h5>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p>Move static content to static # Jekyll has a rule that any directory not starting with _ will be copied as-is to the _site output. Hugo keeps all static content under static. You should therefore move it all there. With Jekyll, something that looked like
|
|
▾ <root>/ ▾ images/ logo.png should become
|
|
▾ <root>/ ▾ static/ ▾ images/ logo.png Additionally, you’ll want any files that should reside at the root (such as CNAME) to be moved to static.
|
|
<a href="/posts/migrate-from-jekyll/">...</a>
|
|
|
|
</p>
|
|
</article>
|
|
|
|
<article class="markdown book-post">
|
|
<h2>
|
|
<a href="/posts/goisforlovers/">(Hu)go Template Primer</a>
|
|
</h2>
|
|
|
|
<h5>April 2, 2014</h5>
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<a href="/categories/development/">Development</a>,
|
|
<a href="/categories/golang/">golang</a>
|
|
</div>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<a href="/tags/go/">go</a>,
|
|
<a href="/tags/golang/">golang</a>,
|
|
<a href="/tags/templates/">templates</a>,
|
|
<a href="/tags/themes/">themes</a>,
|
|
<a href="/tags/development/">development</a>
|
|
</div>
|
|
|
|
|
|
|
|
<p>Hugo uses the excellent Go html/template library for its template engine. It is an extremely lightweight engine that provides a very small amount of logic. In our experience that it is just the right amount of logic to be able to create a good static website. If you have used other template systems from different languages or frameworks you will find a lot of similarities in Go templates.
|
|
This document is a brief primer on using Go templates.
|
|
<a href="/posts/goisforlovers/">...</a>
|
|
|
|
</p>
|
|
</article>
|
|
|
|
<article class="markdown book-post">
|
|
<h2>
|
|
<a href="/posts/hugoisforlovers/">Getting Started with Hugo</a>
|
|
</h2>
|
|
|
|
<h5>April 2, 2014</h5>
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<a href="/categories/development/">Development</a>,
|
|
<a href="/categories/golang/">golang</a>
|
|
</div>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<a href="/tags/go/">go</a>,
|
|
<a href="/tags/golang/">golang</a>,
|
|
<a href="/tags/hugo/">hugo</a>,
|
|
<a href="/tags/development/">development</a>
|
|
</div>
|
|
|
|
|
|
|
|
<p>Step 1. Install Hugo # Go to Hugo releases and download the appropriate version for your OS and architecture.
|
|
Save it somewhere specific as we will be using it in the next step.
|
|
More complete instructions are available at Install Hugo
|
|
Step 2. Build the Docs # Hugo has its own example site which happens to also be the documentation site you are reading right now.
|
|
Follow the following steps:
|
|
<a href="/posts/hugoisforlovers/">...</a>
|
|
|
|
</p>
|
|
</article>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<footer class="book-footer">
|
|
|
|
<div class="flex flex-wrap justify-between">
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</footer>
|
|
|
|
|
|
|
|
|
|
|
|
<label for="menu-control" class="hidden book-menu-overlay"></label>
|
|
</div>
|
|
|
|
|
|
<aside class="book-toc">
|
|
<div class="book-toc-content">
|
|
|
|
<nav>
|
|
<ul>
|
|
|
|
|
|
<li class="book-section-flat">
|
|
<strong>Categories</strong>
|
|
<ul>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/categories/development/">Development</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/categories/golang/">golang</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
|
|
<li class="book-section-flat">
|
|
<strong>Tags</strong>
|
|
<ul>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/development/">development</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/go/">go</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/golang/">golang</a>
|
|
<span>2</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/hugo/">hugo</a>
|
|
<span>1</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/templates/">templates</a>
|
|
<span>1</span>
|
|
</li>
|
|
|
|
<li class="flex justify-between">
|
|
<a href="/tags/themes/">themes</a>
|
|
<span>1</span>
|
|
</li>
|
|
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
|
|
</div>
|
|
</aside>
|
|
|
|
</main>
|
|
|
|
|
|
</body>
|
|
|
|
</html>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|