mirror of
https://github.com/adityatelange/hugo-PaperMod.git
synced 2023-12-21 10:22:58 +01:00
184 lines
3.9 KiB
Markdown
184 lines
3.9 KiB
Markdown
---
|
|
title: "Papermod - Installation"
|
|
summary: Read Install and Update instructions here
|
|
date: 2020-09-15T11:30:03+05:30
|
|
series: ["PaperMod"]
|
|
weight: 1
|
|
aliases: ["/papermod-installation"]
|
|
tags: ["PaperMod"]
|
|
author: "Aditya Telange"
|
|
showToc: true
|
|
TocOpen: true
|
|
---
|
|
|
|
## Guide
|
|
|
|
Follow [this](https://gohugo.io/getting-started/quick-start/) guide to setup hugo and create a new site.
|
|
Make sure you install latest version of `hugo`(>=0.74.0).
|
|
|
|
After you have created a new site, at [Step 3](https://gohugo.io/getting-started/quick-start/#step-3-add-a-theme) follow the steps:
|
|
|
|
Inside the folder of your Hugo site, run:
|
|
|
|
> ```console
|
|
> git clone https://github.com/adityatelange/hugo-PaperMod themes/hugo-PaperMod --depth=1
|
|
> ```
|
|
>
|
|
> > Updating theme :
|
|
> >
|
|
> > ```console
|
|
> > cd themes/hugo-PaperMod
|
|
> > git pull
|
|
> > ```
|
|
|
|
**or** you can use as [submodule](https://www.atlassian.com/git/tutorials/git-submodule) with
|
|
|
|
> ```console
|
|
> git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/hugo-PaperMod
|
|
> git submodule update --init --recursive
|
|
> ```
|
|
>
|
|
> > Updating theme with submodule :
|
|
> >
|
|
> > ```console
|
|
> > git submodule update --remote --merge
|
|
> > ```
|
|
> >
|
|
> > Then change in `config.yml`:
|
|
|
|
```yml
|
|
theme: "hugo-PaperMod"
|
|
```
|
|
|
|
Example Site Structure is present here: [exampleSite](https://github.com/adityatelange/hugo-PaperMod/tree/exampleSite/)
|
|
|
|
---
|
|
|
|
### Sample `config.yml`
|
|
|
|
```yml
|
|
baseURL: "https://examplesite.com"
|
|
title: ExampleSite
|
|
paginate: 5
|
|
theme: hugo-PaperMod
|
|
|
|
enableRobotsTXT: true
|
|
buildDrafts: false
|
|
buildFuture: false
|
|
buildExpired: false
|
|
|
|
googleAnalytics: UA-123-45
|
|
|
|
minify:
|
|
disableXML: true
|
|
minifyOutput: true
|
|
|
|
params:
|
|
env: production # to enable google analytics, opengraph, twitter-cards and schema.
|
|
title: ExampleSite
|
|
description: "ExampleSite description"
|
|
author: Me
|
|
# author: ["Me", "You"] # multiple authors
|
|
|
|
images: ["<link or path of image for opengraph, twitter-cards>"]
|
|
|
|
ShowReadingTime: true
|
|
ShowShareButtons: true
|
|
comments: false
|
|
defaultTheme: auto
|
|
disableThemeToggle: false
|
|
disableSpecial1stPost: false
|
|
|
|
assets:
|
|
favicon: "<link / abs url>"
|
|
favicon16x16: "<link / abs url>"
|
|
favicon32x32: "<link / abs url>"
|
|
apple_touch_icon: "<link / abs url>"
|
|
safari_pinned_tab: "<link / abs url>"
|
|
|
|
label:
|
|
text: "Home"
|
|
icon: /apple-touch-icon.png
|
|
iconHeight: 35
|
|
|
|
# profile-mode
|
|
profileMode:
|
|
enabled: false # needs to be explicitly set
|
|
title: ExampleSite
|
|
# imageUrl: '<img location>'
|
|
# imageTitle: my image
|
|
buttons:
|
|
- name: Posts
|
|
url: posts
|
|
- name: Tags
|
|
url: tags
|
|
|
|
# home-info mode
|
|
homeInfoParams:
|
|
Title: "Hi there \U0001F44B"
|
|
Content: Welcome to my blog
|
|
|
|
socialIcons:
|
|
- name: twitter
|
|
url: "https://twitter.com/"
|
|
- name: stackoverflow
|
|
url: "https://stackoverflow.com"
|
|
- name: github
|
|
url: "https://github.com/"
|
|
|
|
analytics:
|
|
google:
|
|
SiteVerificationTag: "XYZabc"
|
|
|
|
menu:
|
|
main:
|
|
- identifier: categories
|
|
name: categories
|
|
url: /categories/
|
|
weight: 10
|
|
- identifier: tags
|
|
name: tags
|
|
url: /tags/
|
|
weight: 20
|
|
- identifier: example
|
|
name: example.org
|
|
url: https://example.org
|
|
weight: 30
|
|
```
|
|
|
|
---
|
|
|
|
### Sample `Page.md`
|
|
|
|
```yml
|
|
---
|
|
title: "My 1st post"
|
|
date: 2020-09-15T11:30:03+00:00
|
|
weight: 1
|
|
aliases: ["/first"]
|
|
tags: ["first"]
|
|
author: "Me"
|
|
# author: ["Me", "You"] # multiple authors
|
|
showToc: true
|
|
TocOpen: false
|
|
draft: false
|
|
hidemeta: false
|
|
disableShare: false
|
|
cover:
|
|
image: "<image path/url>"
|
|
alt: "<alt text>"
|
|
caption: "<text>"
|
|
relative: false
|
|
comments: false
|
|
---
|
|
|
|
```
|
|
|
|
---
|
|
|
|
### [Papermod - Features](../papermod-features)
|
|
|
|
### [Papermod - How to Guide](../papermod-how-to)
|
|
|
|
### [Papermod - Icons](../papermod-icons)
|