Giter VIP home page Giter VIP logo

hugo-wiki's Introduction

Hugo Wiki Theme

Wiki theme for Hugo static website generator. Inspired by http://wiki.xxiivv.com/ and my hate to modern webdev. Designed for artists/developers.

Features

  • blog: just standard blog
  • wiki: post notes, projects etc.
  • support for default Hugo's taxonomies categories and tags
  • no JavaScript by default: everything is static HTML. TODO: Optional KaTeX, Discuss, Google Analytics, zoom.js
  • lightweight - about 300 lines of simple CSS.
  • leverage Hugo features whenever possible: syntax highlighting, RSS, pagination, shortcodes
  • easy to deploy on Zeronet or Dat, TODO: builtin Dat reduction support

Config

config.toml

baseURL = "http://example.org/"
languageCode = "en-us"
title = "My Title"
copyright = "Jonh Dee 2017"

pygmentsCodeFences = true
# https://help.farbox.com/pygments.html
pygmentsStyle = "manni"
GoogleAnalytics = 'UA-URCODE'

# Optional - output json (for custom search)
[outputs]
    home = [ "HTML", "RSS", "JSON"]


[author]
    name = "John Dee"

[params]
    # Put your logo in /static directory
    logo = "/logo.svg"

sectionPagesMenu = "main"
[[ menu.main ]]
   name="Github"
   url="https://github.com/jdee"
   weight = 300

[[ menu.main ]]
   name="Posts"
   url="/post/"
   identifier="post"
   weight = -300

[[ menu.main ]]
   name="Wiki"
   url="/wiki/"
   identifier="wiki"
   weight = -200

Favicon

Use https://realfavicongenerator.net/ and put all generated files into static directory. Set RealFaviconGenerator param to true.

[params]
   RealFaviconGenerator = true

Content

Index page

Crete index page using hugo new _index.md

Posts

Create post using standard hugo command hugo new post/post-name.md Optionally add tags to Front Matter

tags: ["art", "music"]

Don't use categories here.

Wiki

Wiki support two types of content: projects and notes.

  • project: use categories: ["project"]
  • notes: use categories: ["note"]

You should set description for project pages:

description: "Awesome project"

Description is shown only for projects. Tags are optional both for project and notes.

Shorcodes

Standard hugo shorcodes like yt works. This theme ships with following additional shortcodes:

ig

Create image that opens in full size when clicked.

{{< ig "link" "description" >}}

kbd

Renders keyboard keys.

{{< kbd CTRL ALT DEL >}}

hugo-wiki's People

Contributors

teddydd avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.