Hugo Personal Site

This is web made by Hugo static site generator, Live Preview, more reference to example use this theme please check my blog repo

TODO:

• [] Integrate series in home
• [] Responsive chapter detail
• [] Update readme
• [] Setup demo repo

Instant Deploy

Content Management

Go to your forestry account and click on import your site now. declare your config.toml file [exampleSite] and fill up basic settings .

Or just click this button for one click installation

Now mark everything as done, then go to configuration to change the base url . You can put any url but this have to similar as netlify . So for now put a name which you are going to put in netlify as netlify subdomain.

Main Feature:

1. PWA
2. Fast Loading
3. Lazy loading
4. Full Responsive
5. Easy Customize
6. Dynamic Theme
7. Ready to Ads
8. Advance SEO (JSON-LD, OpenGraph, TwitterCard, Meta)
9. etc..

Test Result:

Preview

Light	Dark

Setup in your workspace

Before starting, please be sure that you have installed Hugo and created a new site. After that, you ready to install personal-site.

Create new project hugo

hugo new site site_name

Go to folder themes

cd site_name/themes

In your Hugo site themes directory, run:

git clone git@github.com:wisnuwiry/personal-site.git

Or, if you don’t plan to make any significant changes, but want to track and update the theme, you can add it as a git submodule via the following command:

git submodule add git@github.com:wisnuwiry/personal-site.git

Copy files exampleSite/content paste to site_name

Next, open config.toml and copy paste example config below.

Example Config

baseURL                       = "https://example.com/"
languageCode                  = "id"
title                         = "Wisnuwiry"
theme                         = "personal-site"
summaryLength                 = 10

[Author] # Used in authorbox
  name                        = "Jhon Doe"
  bio                         = ""
  avatar                      = "img/avatar.webp"
  job                         = "Software Engineer"
  gender                      = "male"
  email                       = "jhon-doe@gmail.com"


[Params]
  subTitle                    = "Personal site, Blog, and Portfolio"
  description                 = "Sebuah catatan dan blog pribadi saya. Saya juga akan membagi tentang pengalaman saya dan teknologi-teknolgi yang saya gunakan/pelajari atau yang sedang populer." # Site Description. Used in meta description
  images                      = ["img/avatar.webp"]
  copyright                   = "Wisnuwiry" # Copyright holder, otherwise will use .Site.Title
  opengraph                   = true # Enable OpenGraph if true
  twitter_cards               = true # Enable Twitter Cards if true
  mainSections                = ["post"] # Set main page sections
  dateFormat                  = "January 02, 2006" # Change the format of dates
  # customCSS                 = ["css/custom.css"] # Include custom CSS files
  customJS                    = []
  mainMenuAlignment           = "right" # Align main menu (desktop version) to the right side
  authorbox                   = true # Show authorbox at bottom of single pages if true
  comments                    = true # Enable comments for all site pages
  related                     = true # Enable Related content for single pages
  relatedMax                  = 5
  mathjax                     = false # Enable MathJax for all site pages
  hideNoPostsWarning          = false # Don't show no posts empty state warning in main page, if true
  fontUnit                    = "em"
  largestFontSize             = 2.5
  smallestFontSize            = 1
  googleSearchConsole         = ""
  # GoogleAnalytics             = ""
  # fb_admins                   = 
  # fb_app_id                   = 
  paginateLength              = 5
  # adsenseId                   = 

  # Google Search custom, more info: https://cse.google.com/cse/all
  customSearchId              = "004021659876411083349:a2ysxpichpc"

  endMessagePost              = "Wrong content? "
  
  # Link repo to edit content
  editContentPageLink         = "https://github.com/wisnuwiry/personal-site-demo/edit/master/content/"
  
  # Formspree form contact id, more info: https://cse.google.com/cse/all
  formspreeId                 = ""
  


[Params.Hero]
  title                       = "A Personal Site By Jhon Doe"
  desc                        = "Welcome to my Blog :)"

[Params.Entry]
  meta                        = ["date"] # Enable meta fields in given order
  toc                         = true # Enable Table of Contents
  tocOpen                     = false # Open Table of Contents block. Optional

[Params.Featured]
  previewOnly                 = false # Show only preview featured image

[Params.Comments]
  repository                  = "" # Repository to host your comment, ex: username/repo

# Navigation bar
[menu]

[[menu.main]]
identifier = "Post"
pre = "📝"
url = "/post" 
weight = 1 

[[menu.main]]
identifier = "Snippet"
pre = "⚒️"
url = "/snippet" 
weight = 2 

[[menu.main]]
identifier = "About"
pre = "😃"
url = "/about" 
weight = 4

[[menu.main]]
identifier = "Contact"
pre = "🤙"
url = "/contact" 
weight = 5

[Params.Breadcrumb]
  enable                      = true # Enable breadcrumb block globally
  homeText                    = "Home" # Home node text

[Params.Social]
  twitter                     = "jhon-doe"
  telegram                    = "jhon-doe"
# instagram                   = "jhon-doe"
  linkedin                    = "wisnu-saputra"
  github                      = "jhon-doe"
  gitlab                      = "jhon-doe"
  medium                      = "jhon-doe"

[Params.Share] # Entry Share block
  facebook                    = true
  twitter                     = true
  reddit                      = true
  telegram                    = true
  linkedin                    = true
  pinterest                   = true

# Web App Manifest settings
# https://www.w3.org/TR/appmanifest/
# https://developers.google.com/web/fundamentals/web-app-manifest/
[Params.Manifest]
  name                        = "Wisnuwiry"
  shortName                   = "Wisnuwiry"
  display                     = "standalone"
  startUrl                    = "/?utm_source=homescreen"
  backgroundColor             = "#8dc153"
  themeColor                  = "#1da1f2"
  description                 = "Personal Site By Wisnuwiry"
  orientation                 = "portrait"
  scope                       = "/"

[outputFormats]
  [outputFormats.MANIFEST]
    mediaType                 = "application/json"
    baseName                  = "manifest"
    isPlainText               = true
    notAlternative            = true

[outputs]
  home                        = ["HTML", "RSS", "MANIFEST"]

enableRobotsTXT               = true

# Pagination
Paginate                      = 3
 

# Code
[markup]
  # defaultMarkdownHandler    = "blackfriday"
  [markup.goldmark]
    [markup.goldmark.extensions]
      definitionList          = true
      footnote                = true
      linkify                 = true
      strikethrough           = true
      table                   = true
      taskList                = true
      typographer             = true
    [markup.goldmark.parser]
      attribute               = true
      autoHeadingID           = true
      autoHeadingIDType       = "github"
    [markup.goldmark.renderer]
      hardWraps               = false
      unsafe                  = true
      xhtml                   = false
  [markup.blackFriday]
    angledQuotes              = false
    footnoteAnchorPrefix      = ""
    footnoteReturnLinkContents= ""
    fractions                 = true
    hrefTargetBlank           = false
    latexDashes               = true
    nofollowLinks             = false
    noreferrerLinks           = false
    plainIDAnchors            = true
    skipHTML                  = false
    smartDashes               = true
    smartypants               = true
    smartypantsQuotesNBSP     = false
    taskLists                 = true
  [markup.highlight]
    codeFences                = true
    guessSyntax               = false
    hl_Lines                  = ""
    lineNoStart               = 1
    lineNos                   = false
    lineNumbersInTable        = false
    noClasses                 = false
    style                     = "dracula"
    tabWidth                  = 4
  [markup.tableOfContents]
    endLevel                  = 6
    ordered                   = false
    startLevel                = 2

Create new Post

hugo new content/post/name_post.md

Example Param:

---
title: "Atomic Design"
date: 2020-10-29T10:22:10+07:00
images: [
    https://miro.medium.com/max/1000/1*V5oi-JrH4RlEQuYdVrQXig.png,
    https://i.ibb.co/BTRn8m6/Untitled.png,
]
tags: ["atomic","design"]
---

Create new Page

hugo new content/about.md

Example params:

---
title: About 😃
menu: main
toc: false
authorBox: false
breadcrumb: false
comments: false
share: false
page: true
---

Set Featured Post

In any content post add this param, to set featured post.

featured: true

Support Us (Author)

This project needs you! If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, feel free to donate. Your donation is highly appreciated . Thank you!

• Donate $10: Thank's for creating this project, here's a tea (or some juice) for you!
• Donate $20: Wow, I am stunned. Let me take you to the movies!
• Donate $30: I really appreciate your work, let's grab some lunch!
• Donate $40: That's some awesome stuff you did right there, dinner is on me!
• Donate $50: I really really want to support this project, great job!
• Donate $100: You are the man! This project saved me hours (if not days) of struggle and hard work, simply awesome!
• Donate $1500: Go buddy, buy Macbook Pro for yourself!

Of course, you can also choose what you want to donate, all donations are awesome !

Showcase

1. Wisnuwiry Blog

Release Notes

Show more..

Maintainers

1. @wisnuwiry

   

Contributing

Have you found a bug or got an idea for a new feature? Feel free to use the issue tracker to let me know. Or make directly a pull request.

Thanks to

@bep @gohugoio