Hi there 👋
Welcome to my blog
404
Categories
A introduction to my blog!
Hi, my name is Shay Power, I have created this blog to document my journey as a software developer. Im not very good at writing, so i will be trying to keep these blog posts short. let me introduce who i am and what I do. +I started programming at the age of 14, when i built my first PC. I originally began with python and used that for the past 4 years for both personal and professional projects....
My 1st post
Desc Text.
Posts +
A introduction to my blog!
Hi, my name is Shay Power, I have created this blog to document my journey as a software developer. Im not very good at writing, so i will be trying to keep these blog posts short. let me introduce who i am and what I do. +I started programming at the age of 14, when i built my first PC. I originally began with python and used that for the past 4 years for both personal and professional projects....
A introduction to my blog!
“Welcome to my Blog!”
Hi, my name is Shay Power, I have created this blog to document my journey as a software developer. +Im not very good at writing, so i will be trying to keep these blog posts short. let me introduce +who i am and what I do.
I started programming at the age of 14, when i built my first PC. I originally began with python and +used that for the past 4 years for both personal and professional projects. i have a deep knowledge of the +django framework, and worked as a freelance contractor developing web applications using it. I also run +a home server as a hobby, and a 3d printing farm (both FDM and M/SLA), I also am a strong advocate for FOSS (Free and open-source software).
In terms of academics, i was the first person to achieve a H1 in computer science in my secondary school, and have completed +a QQI course in software development, with 8/8 disctinctions. I am currently enrolled in the University Of Limerick and expect +to graduate in 2028.
Search
First +
My 1st post
Tags
-
-
-
diff --git a/themes/PaperMod/.github/ISSUE_TEMPLATE/bug.yaml b/themes/PaperMod/.github/ISSUE_TEMPLATE/bug.yaml
new file mode 100644
index 0000000..e7168f0
--- /dev/null
+++ b/themes/PaperMod/.github/ISSUE_TEMPLATE/bug.yaml
@@ -0,0 +1,112 @@
+name: Bug Report 🐞
+description: Create a report to help us improve
+title: "[Bug]: "
+labels: ["bug", "triage"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for taking the time to fill out this bug report :)
+ - Kindly **DO NOT** ask for instructions.
+ - Use [Discussions](https://github.com/adityatelange/hugo-PaperMod/discussions) section if you have a query or doubts or any orther relevant question.
+ - You may join [Discord community](https://discord.gg/ahpmTvhVmp) to interact with fellow contributors and users
+ - Read project's [Wiki](https://github.com/adityatelange/hugo-PaperMod/wiki) for detailed documentation.
+ - Read project's [FAQs](https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs) section for Frequently asked questions.
+ - Search for previous [Issues](https://github.com/adityatelange/hugo-PaperMod/issues)/[Pull Requests](https://github.com/adityatelange/hugo-PaperMod/pulls) if this issue is already reported or fix has been created.
+ - type: textarea
+ id: what_happened
+ attributes:
+ label: What happened?
+ description: Also tell us, what did you expect to happen?
+ placeholder: A bug happened! Here are the screenshots.. Tell us what you see!
+ validations:
+ required: true
+ - type: textarea
+ id: steps_to_reproduce
+ attributes:
+ label: Steps to reproduce
+ description: How to reproduce this issue. Here are the steps...
+ placeholder: |
+ 1. Go to '...'
+ 2. Click on '....'
+ 3. Scroll down to '....'
+ 4. See error
+ validations:
+ required: true
+ - type: dropdown
+ id: hugo_version
+ attributes:
+ label: Hugo Version
+ description: What version of Hugo are you running?
+ options:
+ - Hugo >= 0.125.7 (Recommended - Minimum version required for PaperMod)
+ - Hugo < 0.125.7 (Incompatible - Not recommended to build PaperMod on lower verions)
+ validations:
+ required: true
+ - type: input
+ id: papermod_version
+ attributes:
+ label: PaperMod Version
+ description: What version of PaperMod are you running?
+ placeholder: |
+ PaperMod v7.0 or
+ Branch master or
+ Commit-id: 3f50861a0ced88f9b614a43662edeb4c0bc45da8
+ validations:
+ required: true
+ - type: dropdown
+ id: browser_type
+ attributes:
+ label: What kind of devices are you seeing the problem on?
+ multiple: true
+ options:
+ - Mobile
+ - Desktop
+ validations:
+ required: false
+ - type: dropdown
+ id: browsers
+ attributes:
+ label: What browsers are you seeing the problem on?
+ multiple: true
+ options:
+ - Firefox
+ - Chrome
+ - Safari
+ - Microsoft Edge
+ validations:
+ required: false
+ - type: input
+ id: browser_version
+ attributes:
+ label: Browser Version
+ description: Please add browser version or enter user agent string (navigator.userAgent)
+ placeholder: ex. Google Chrome 86.0
+ validations:
+ required: false
+ - type: textarea
+ id: logs
+ attributes:
+ label: Relevant log output
+ description: Please copy and paste any relevant log output. This will be automatically formatted into code, so no need for backticks.
+ render: shell
+ validations:
+ required: true
+ - type: input
+ id: repo_url
+ attributes:
+ label: Repository/Source Code link where this issue can be reproduced
+ description: Please add url of the repository where this issue can be reproduced
+ placeholder: https://github.com/Hello World!
-All hail Skynet!! now it should work
-Hugo PaperMod | Demo
+ +☄️ Fast | ☁️ Fluent | 🌙 Smooth | 📱 Responsive
++ +> Hugo PaperMod is a theme based on [hugo-paper](https://github.com/nanxiaobei/hugo-paper/tree/4330c8b12aa48bfdecbcad6ad66145f679a430b3).
+> The goal of this project is to add more features and customization to the og theme. + +**Documentation** can be found here: [**📚 Wiki**](https://github.com/adityatelange/hugo-PaperMod/wiki) + +**ExampleSite** can be found here: [**exampleSite**](https://github.com/adityatelange/hugo-PaperMod/tree/exampleSite). Demo is built up with [exampleSite](https://github.com/adityatelange/hugo-PaperMod/tree/exampleSite) as source. + +[](https://themes.gohugo.io/themes/hugo-papermod/) +[](https://github.com/gohugoio/hugo/releases/tag/v0.125.7) +[](https://discord.gg/ahpmTvhVmp) +[](https://github.com/adityatelange/hugo-PaperMod/blob/master/LICENSE) + +[](https://x.com/intent/tweet/?text=Checkout%20Hugo%20PaperMod%20%E2%9C%A8%0AA%20fast,%20clean,%20responsive%20Hugo%20theme.&url=https://github.com/adityatelange/hugo-PaperMod&hashtags=Hugo,PaperMod) + + +--- + +
+ 
+
404
+{{- end }}{{/* end main */ -}}
diff --git a/themes/PaperMod/layouts/_default/_markup/render-image.html b/themes/PaperMod/layouts/_default/_markup/render-image.html
new file mode 100644
index 0000000..f368ff8
--- /dev/null
+++ b/themes/PaperMod/layouts/_default/_markup/render-image.html
@@ -0,0 +1,22 @@
+{{- $u := urls.Parse .Destination -}}
+{{- $src := $u.String -}}
+{{- if not $u.IsAbs -}}
+ {{- $path := strings.TrimPrefix "./" $u.Path }}
+ {{- with or (.PageInner.Resources.Get $path) (resources.Get $path) -}}
+ {{- $src = .RelPermalink -}}
+ {{- with $u.RawQuery -}}
+ {{- $src = printf "%s?%s" $src . -}}
+ {{- end -}}
+ {{- with $u.Fragment -}}
+ {{- $src = printf "%s#%s" $src . -}}
+ {{- end -}}
+ {{- end -}}
+{{- end -}}
+{{- $attributes := merge .Attributes (dict "alt" .Text "src" $src "title" (.Title | transform.HTMLEscape) "loading" "lazy") -}}
++ {{ .Title }} + {{- if (.Param "ShowRssButtonInSectionTermList") }} + {{- $rss := (.OutputFormats.Get "rss") }} + {{- if (eq .Kind `page`) }} + {{- $rss = (.Parent.OutputFormats.Get "rss") }} + {{- end }} + {{- with $rss }} + + + + {{- end }} + {{- end }} +
+ {{- if .Description }} +
+ {{ .Description }}
+
+ {{- end }}
+
+ {{- $year := replace .Key "0001" "" }}
+
+{{- end }}
+{{- end }}
+
+{{- end }}{{/* end main */}}
diff --git a/themes/PaperMod/layouts/_default/baseof.html b/themes/PaperMod/layouts/_default/baseof.html
new file mode 100644
index 0000000..94e7d58
--- /dev/null
+++ b/themes/PaperMod/layouts/_default/baseof.html
@@ -0,0 +1,27 @@
+{{- if lt hugo.Version "0.125.7" }}
+{{- errorf "=> hugo v0.125.7 or greater is required for hugo-PaperMod to build " }}
+{{- end -}}
+
+
+
+
+
+ {{- partial "head.html" . }}
+
+
+
+ {{- partialCached "header.html" . .Page -}}
+ + + {{- $year -}} + + {{ len .Pages }} +
+ {{- range .Pages.GroupByDate "January" }} +
+
+ {{- end }}
++ + {{- .Key -}} + + {{ len .Pages }} +
+ ++ {{ .Title }} + {{- if and (or (eq .Kind `term`) (eq .Kind `section`)) (.Param "ShowRssButtonInSectionTermList") }} + {{- with .OutputFormats.Get "rss" }} + + + + {{- end }} + {{- end }} +
+ {{- if .Description }} +
+ {{ .Description | markdownify }}
+
+ {{- end }}
+
+ {{- if not (.Param "disableAnchoredHeadings") }}
+ {{- partial "anchored_headings.html" .Content -}}
+ {{- else }}{{ .Content }}{{ end }}
+
+{{- end }}
+
+{{- $pages := union .RegularPages .Sections }}
+
+{{- if .IsHome }}
+{{- $pages = where site.RegularPages "Type" "in" site.Params.mainSections }}
+{{- $pages = where $pages "Params.hiddenInHomeList" "!=" "true" }}
+{{- end }}
+
+{{- $paginator := .Paginate $pages }}
+
+{{- if and .IsHome site.Params.homeInfoParams (eq $paginator.PageNumber 1) }}
+{{- partial "home_info.html" . }}
+{{- end }}
+
+{{- $term := .Data.Term }}
+{{- range $index, $page := $paginator.Pages }}
+
+{{- $class := "post-entry" }}
+
+{{- $user_preferred := or site.Params.disableSpecial1stPost site.Params.homeInfoParams }}
+{{- if (and $.IsHome (eq $paginator.PageNumber 1) (eq $index 0) (not $user_preferred)) }}
+{{- $class = "first-entry" }}
+{{- else if $term }}
+{{- $class = "post-entry tag-entry" }}
+{{- end }}
+
++ {{- .Title }} + {{- if .Draft }} + + + + {{- end }} +
+
+
+ {{- end }}
+ {{- if not (.Param "hideMeta") }}
+
+ {{- end }}
+
+{{ .Summary | plainify | htmlUnescape }}{{ if .Truncated }}...{{ end }}
+{{- (printf "%s " .Title ) | htmlUnescape -}} + +
+ {{- if .Description }} +
+ {{ .Description }}
+
+ {{- end }}
+ {{- if not (.Param "hideMeta") }}
+
+ {{- end }}
+
+
+
+
+{{- end }}{{/* end main */}}
diff --git a/themes/PaperMod/layouts/_default/single.html b/themes/PaperMod/layouts/_default/single.html
new file mode 100644
index 0000000..19a624f
--- /dev/null
+++ b/themes/PaperMod/layouts/_default/single.html
@@ -0,0 +1,65 @@
+{{- define "main" }}
+
++ {{ .Title }} + {{- if .Draft }} + + + + {{- end }} +
+ {{- if .Description }} +
+ {{ .Description }}
+
+ {{- end }}
+ {{- if not (.Param "hideMeta") }}
+
+ {{- end }}
+
+ {{- if not (.Param "disableAnchoredHeadings") }}
+ {{- partial "anchored_headings.html" .Content -}}
+ {{- else }}{{ .Content }}{{ end }}
+
+ {{- end }}
+
+
+
+ {{- if (.Param "comments") }}
+ {{- partial "comments.html" . }}
+ {{- end }}
+{{ .Title }}
+ {{- if .Description }} +
+ {{ .Description }}
+
+ {{- end }}
+{{ . | markdownify }}
{{- end }} + {{- end }} +{{ .Title | markdownify }}
+
+ {{ .Content | markdownify }}
+
+
+
+ {{- with site.Params.profileMode }}
+
diff --git a/themes/PaperMod/layouts/partials/post_canonical.html b/themes/PaperMod/layouts/partials/post_canonical.html
new file mode 100644
index 0000000..abfc1e3
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/post_canonical.html
@@ -0,0 +1,9 @@
+{{ if and (.Params.canonicalURL) (.Params.ShowCanonicalLink ) -}}
+{{ $url := urls.Parse .Params.canonicalURL }}
+
+{{- if or .Params.author site.Params.author (.Param "ShowReadingTime") (not .Date.IsZero) .IsTranslated (or .Params.editPost.URL site.Params.editPost.URL) }} | {{- end -}}
+
+ {{- (site.Params.CanonicalLinkText | default .Params.CanonicalLinkText) | default "Originally published at" -}}
+ {{ $url.Host }}
+
+{{- end }}
diff --git a/themes/PaperMod/layouts/partials/post_meta.html b/themes/PaperMod/layouts/partials/post_meta.html
new file mode 100644
index 0000000..b0c0417
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/post_meta.html
@@ -0,0 +1,23 @@
+{{- $scratch := newScratch }}
+
+{{- if not .Date.IsZero -}}
+{{- $scratch.Add "meta" (slice (printf "%s" (.Date) (.Date | time.Format (default "January 2, 2006" site.Params.DateFormat)))) }}
+{{- end }}
+
+{{- if (.Param "ShowReadingTime") -}}
+{{- $scratch.Add "meta" (slice (i18n "read_time" .ReadingTime | default (printf "%d min" .ReadingTime))) }}
+{{- end }}
+
+{{- if (.Param "ShowWordCount") -}}
+{{- $scratch.Add "meta" (slice (i18n "words" .WordCount | default (printf "%d words" .WordCount))) }}
+{{- end }}
+
+{{- if not (.Param "hideAuthor") -}}
+{{- with (partial "author.html" .) }}
+{{- $scratch.Add "meta" (slice .) }}
+{{- end }}
+{{- end }}
+
+{{- with ($scratch.Get "meta") }}
+{{- delimit . " · " | safeHTML -}}
+{{- end -}}
diff --git a/themes/PaperMod/layouts/partials/post_nav_links.html b/themes/PaperMod/layouts/partials/post_nav_links.html
new file mode 100644
index 0000000..b988641
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/post_nav_links.html
@@ -0,0 +1,19 @@
+{{- $pages := where site.RegularPages "Type" "in" site.Params.mainSections }}
+{{- if and (gt (len $pages) 1) (in $pages . ) }}
+
+{{- end }}
diff --git a/themes/PaperMod/layouts/partials/share_icons.html b/themes/PaperMod/layouts/partials/share_icons.html
new file mode 100644
index 0000000..910ba7f
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/share_icons.html
@@ -0,0 +1,95 @@
+{{- $pageurl := .Permalink }}
+{{- $title := .Title }}
+
+{{- $.Scratch.Set "tags" ""}}
+
+{{- with .Params.Tags }}
+{{- $hashtags := newScratch}}
+{{- range . }}{{ $hashtags.Add "tags" (slice (replaceRE "(\\s)" "" . ))}}{{end}}
+{{- $.Scratch.Set "tags" (delimit ($hashtags.Get "tags") ",") }}
+{{- end -}}
+
+{{- $custom := false }}
+{{- $ShareButtons := (.Param "ShareButtons")}}
+{{- with $ShareButtons }}{{ $custom = true }}{{ end }}
+
+
diff --git a/themes/PaperMod/layouts/partials/social_icons.html b/themes/PaperMod/layouts/partials/social_icons.html
new file mode 100644
index 0000000..ce76a30
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/social_icons.html
@@ -0,0 +1,8 @@
+
diff --git a/themes/PaperMod/layouts/partials/svg.html b/themes/PaperMod/layouts/partials/svg.html
new file mode 100644
index 0000000..890b909
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/svg.html
@@ -0,0 +1,949 @@
+{{- $icon_name := ( trim .name " " | lower )}}
+{{- if (eq $icon_name "123rf") -}}
+
+{{- else if (eq $icon_name "500px") -}}
+
+{{- else if (eq $icon_name "adobestock") -}}
+
+{{- else if (eq $icon_name "anilist") -}}
+
+{{- else if or (eq $icon_name "ao3") (eq $icon_name "archiveofourown") -}}
+
+{{- else if (eq $icon_name "applemusic") -}}
+
+{{- else if (eq $icon_name "applepodcasts") -}}
+
+{{- else if (eq $icon_name "bandcamp") -}}
+
+{{- else if (eq $icon_name "behance") -}}
+
+{{- else if (eq $icon_name "bilibili") -}}
+
+{{- else if (eq $icon_name "bitcoin") -}}
+
+{{- else if (eq $icon_name "bluesky") -}}
+
+{{- else if (eq $icon_name "bugcrowd") -}}
+
+{{- else if (eq $icon_name "buttondown") -}}
+
+{{- else if (eq $icon_name "buymeacoffee") -}}
+
+{{- else if (eq $icon_name "codeberg") -}}
+
+{{- else if (eq $icon_name "codeforces") -}}
+
+{{- else if (eq $icon_name "codepen") -}}
+
+{{- else if (eq $icon_name "credly") -}}
+
+{{- else if (eq $icon_name "cryptohack") -}}
+
+{{- else if (eq $icon_name "ctftime") -}}
+
+{{- else if (eq $icon_name "cv") -}}
+
+{{- else if (eq $icon_name "deezer") -}}
+
+{{- else if (eq $icon_name "dev") -}}
+
+{{- else if (eq $icon_name "deviantart") -}}
+
+{{- else if (eq $icon_name "discogs") -}}
+
+{{- else if (eq $icon_name "discord") -}}
+
+{{- else if (eq $icon_name "douban") -}}
+
+{{- else if (eq $icon_name "dreamstime") -}}
+
+{{- else if (eq $icon_name "dribbble") -}}
+
+{{- else if (eq $icon_name "dzen") -}}
+
+{{- else if (eq $icon_name "email") -}}
+
+{{- else if (eq $icon_name "ethereum") -}}
+
+{{- else if (eq $icon_name "exercism") -}}
+
+{{- else if (eq $icon_name "facebook") -}}
+
+{{- else if (eq $icon_name "fediverse") -}}
+
+{{- else if (eq $icon_name "firefish") -}}
+
+{{- else if (eq $icon_name "flickr") -}}
+
+{{- else if (eq $icon_name "freepik") -}}
+
+{{- else if (eq $icon_name "git") -}}
+
+{{- else if (eq $icon_name "gitea") -}}
+
+{{- else if (eq $icon_name "github") -}}
+
+{{- else if (eq $icon_name "gitlab") -}}
+
+{{- else if (eq $icon_name "goodreads") -}}
+
+{{- else if (eq $icon_name "googleplaystore") -}}
+
+{{- else if (eq $icon_name "googlepodcasts") -}}
+
+{{- else if (eq $icon_name "googlescholar") -}}
+
+{{- else if (eq $icon_name "gurushots") -}}
+
+{{- else if (eq $icon_name "hackerone") -}}
+
+{{- else if (eq $icon_name "hackerrank") -}}
+
+{{- else if (eq $icon_name "hackthebox") -}}
+
+{{- else if (eq $icon_name "imdb") -}}
+
+{{- else if (eq $icon_name "instagram") -}}
+
+{{- else if (eq $icon_name "intigriti") -}}
+
+{{- else if (eq $icon_name "itchio") -}}
+
+{{- else if (eq $icon_name "juejin") -}}
+
+{{- else if (eq $icon_name "kaggle") -}}
+
+{{- else if (eq $icon_name "kakaotalk") -}}
+
+{{- else if (eq $icon_name "keybase") -}}
+
+{{- else if (eq $icon_name "keyoxide") -}}
+
+{{- else if (eq $icon_name "kofi") -}}
+
+{{- else if (eq $icon_name "komoot") -}}
+
+{{- else if (eq $icon_name "lastfm") -}}
+
+{{- else if (eq $icon_name "leetcode") -}}
+
+{{- else if (eq $icon_name "letterboxd") -}}
+
+{{- else if (eq $icon_name "liberapay") -}}
+
+{{- else if (eq $icon_name "lichess" ) -}}
+
+{{- else if (eq $icon_name "linkedin") -}}
+
+{{- else if (eq $icon_name "mastodon") -}}
+
+{{- else if (eq $icon_name "matrix") -}}
+
+{{- else if (eq $icon_name "medium") -}}
+
+{{- else if (eq $icon_name "microblog") -}}
+
+{{- else if (eq $icon_name "mixcloud") -}}
+
+{{- else if (eq $icon_name "monero") -}}
+
+{{- else if (eq $icon_name "neteasecloudmusic") -}}
+
+{{- else if (eq $icon_name "nuget") -}}
+
+{{- else if (eq $icon_name "orcid") -}}
+
+{{- else if (eq $icon_name "osu!") -}}
+
+{{- else if (eq $icon_name "overcast") -}}
+
+{{- else if (eq $icon_name "patreon") -}}
+
+{{- else if (eq $icon_name "paypal") -}}
+
+{{- else if (eq $icon_name "peertube") -}}
+
+{{- else if or (eq $icon_name "pgpkey") (eq $icon_name "key") -}}
+
+{{- else if (eq $icon_name "phone") -}}
+
+{{- else if (eq $icon_name "pinterest") -}}
+
+{{- else if (eq $icon_name "pixelfed") -}}
+
+{{- else if (eq $icon_name "pleroma") -}}
+
+{{- else if (eq $icon_name "pocketcasts") -}}
+
+{{- else if (eq $icon_name "polywork") -}}
+
+{{- else if (eq $icon_name "printables") -}}
+
+{{- else if (eq $icon_name "qq") -}}
+
+{{- else if (eq $icon_name "reddit") -}}
+
+{{- else if (eq $icon_name "raycast") -}}
+
+{{- else if (eq $icon_name "researchgate") -}}
+
+{{- else if (eq $icon_name "rootme") -}}
+
+{{- else if (eq $icon_name "rss") -}}
+
+{{- else if (eq $icon_name "serverfault") -}}
+
+{{- else if (eq $icon_name "sessionmessenger") -}}
+
+{{- else if (eq $icon_name "shutterstock") -}}
+
+{{- else if (eq $icon_name "signal") -}}
+
+{{- else if (eq $icon_name "sketchfab") -}}
+
+{{- else if (eq $icon_name "slack") -}}
+
+{{- else if (eq $icon_name "snapchat") -}}
+
+{{- else if (eq $icon_name "soundcloud") -}}
+
+{{- else if (eq $icon_name "sourcehut") -}}
+
+{{- else if (eq $icon_name "spacehey") -}}
+
+{{- else if (eq $icon_name "spotify") -}}
+
+{{- else if (eq $icon_name "stackoverflow") -}}
+
+{{- else if (eq $icon_name "steam") -}}
+
+{{- else if (eq $icon_name "strava") -}}
+
+
+{{- else if (eq $icon_name "substack") -}}
+
+{{- else if (eq $icon_name "tableau") -}}
+
+{{- else if (eq $icon_name "telegram") -}}
+
+{{- else if (eq $icon_name "thingiverse") -}}
+
+{{- else if (eq $icon_name "threads") -}}
+
+{{- else if (eq $icon_name "threema") -}}
+
+{{- else if (eq $icon_name "tidal") -}}
+
+{{- else if (eq $icon_name "tiktok") -}}
+
+{{- else if (eq $icon_name "tryhackme") -}}
+
+{{- else if (eq $icon_name "tumblr") -}}
+
+{{- else if (eq $icon_name "twitch") -}}
+
+{{- else if (eq $icon_name "twitter") -}}
+
+{{- else if (eq $icon_name "unsplash") -}}
+
+{{- else if (eq $icon_name "vimeo") -}}
+
+{{- else if or (eq $icon_name "vk") (eq $icon_name "vkontakte") -}}
+
+{{- else if (eq $icon_name "wantedly") -}}
+
+{{- else if (eq $icon_name "wechat") -}}
+
+{{- else if or (eq $icon_name "wikipedia") (eq $icon_name "wiki") -}}
+
+{{- else if (eq $icon_name "wordpress") -}}
+
+{{- else if (eq $icon_name "x") -}}
+
+{{- else if (eq $icon_name "xda") -}}
+
+{{- else if (eq $icon_name "xing") -}}
+
+{{- else if (eq $icon_name "xmpp") -}}
+
+{{- else if (eq $icon_name "ycombinator") -}}
+
+{{- else if (eq $icon_name "youtube") -}}
+
+{{- else if (eq $icon_name "zhihu") -}}
+
+{{- else if $icon_name -}}
+
+{{- end -}}
diff --git a/themes/PaperMod/layouts/partials/templates/_funcs/get-page-images.html b/themes/PaperMod/layouts/partials/templates/_funcs/get-page-images.html
new file mode 100644
index 0000000..268ceb4
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/templates/_funcs/get-page-images.html
@@ -0,0 +1,47 @@
+{{- $imgs := slice }}
+{{- $imgParams := .Params.images }}
+{{- $resources := .Resources.ByType "image" -}}
+{{/* Find featured image resources if the images parameter is empty. */}}
+{{- if not $imgParams }}
+ {{- $featured := $resources.GetMatch "*feature*" -}}
+ {{- if not $featured }}{{ $featured = $resources.GetMatch "{*cover*,*thumbnail*}" }}{{ end -}}
+ {{- with $featured }}
+ {{- $imgs = $imgs | append (dict
+ "Image" .
+ "RelPermalink" .RelPermalink
+ "Permalink" .Permalink) }}
+ {{- end }}
+{{- end }}
+{{/* Use the first one of site images as the fallback. */}}
+{{- if and (not $imgParams) (not $imgs) }}
+ {{- with site.Params.images }}
+ {{- $imgParams = first 1 . }}
+ {{- end }}
+{{- end }}
+{{/* Parse page's images parameter. */}}
+{{- range $imgParams }}
+ {{- $img := . }}
+ {{- $url := urls.Parse $img }}
+ {{- if eq $url.Scheme "" }}
+ {{/* Internal image. */}}
+ {{- with $resources.GetMatch $img -}}
+ {{/* Image resource. */}}
+ {{- $imgs = $imgs | append (dict
+ "Image" .
+ "RelPermalink" .RelPermalink
+ "Permalink" .Permalink) }}
+ {{- else }}
+ {{- $imgs = $imgs | append (dict
+ "RelPermalink" (relURL $img)
+ "Permalink" (absURL $img)
+ ) }}
+ {{- end }}
+ {{- else }}
+ {{/* External image */}}
+ {{- $imgs = $imgs | append (dict
+ "RelPermalink" $img
+ "Permalink" $img
+ ) }}
+ {{- end }}
+{{- end }}
+{{- return $imgs }}
diff --git a/themes/PaperMod/layouts/partials/templates/opengraph.html b/themes/PaperMod/layouts/partials/templates/opengraph.html
new file mode 100644
index 0000000..90b91d2
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/templates/opengraph.html
@@ -0,0 +1,82 @@
+
+
+{{- with or site.Title site.Params.title | plainify }}
+
+{{- end }}
+
+{{- with or .Title site.Title site.Params.title | plainify }}
+
+{{- end }}
+
+{{- with or .Description .Summary site.Params.description | plainify | htmlUnescape | chomp }}
+
+{{- end }}
+
+{{- with or .Params.locale site.Language.LanguageCode site.Language.Lang }}
+
+{{- end }}
+
+{{- if .IsPage }}
+
+ {{- with .Section }}
+
+ {{- end }}
+ {{- $ISO8601 := "2006-01-02T15:04:05-07:00" }}
+ {{- with .PublishDate }}
+
+ {{- end }}
+ {{- with .Lastmod }}
+
+ {{- end }}
+ {{- range .GetTerms "tags" | first 6 }}
+
+ {{- end }}
+{{- else }}
+
+{{- end }}
+
+{{- if .Params.cover.image -}}
+ {{- if (ne .Params.cover.relative true) }}
+
+ {{- else}}
+
+ {{- end}}
+{{- else }}
+ {{- with partial "_funcs/get-page-images" . }}
+ {{- range . | first 6 }}
+
+ {{- end }}
+ {{- end }}
+{{- end }}
+
+{{- with .Params.audio }}
+ {{- range . | first 6 }}
+
+ {{- end }}
+{{- end }}
+
+{{- with .Params.videos }}
+ {{- range . | first 6 }}
+
+ {{- end }}
+{{- end }}
+
+{{- range .GetTerms "series" }}
+ {{- range .Pages | first 7 }}
+ {{- if ne $ . }}
+
+ {{- end }}
+ {{- end }}
+{{- end }}
+
+{{- with site.Params.social }}
+ {{- if reflect.IsMap . }}
+ {{- with .facebook_app_id }}
+
+ {{- else }}
+ {{- with .facebook_admin }}
+
+ {{- end }}
+ {{- end }}
+ {{- end }}
+{{- end }}
diff --git a/themes/PaperMod/layouts/partials/templates/schema_json.html b/themes/PaperMod/layouts/partials/templates/schema_json.html
new file mode 100644
index 0000000..dc3bfd6
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/templates/schema_json.html
@@ -0,0 +1,128 @@
+{{ if .IsHome }}
+
+{{- else if (or .IsPage .IsSection) }}
+{{/* BreadcrumbList */}}
+{{- $url := replace .Parent.Permalink ( printf "%s" site.Home.Permalink) "" }}
+{{- $lang_url := strings.TrimPrefix ( printf "%s/" .Lang) $url }}
+{{- $bc_list := (split $lang_url "/")}}
+
+{{- $scratch := newScratch }}
+
+{{- if .IsPage }}
+
+{{- end }}{{/* .IsPage end */}}
+
+{{- end -}}
diff --git a/themes/PaperMod/layouts/partials/templates/twitter_cards.html b/themes/PaperMod/layouts/partials/templates/twitter_cards.html
new file mode 100644
index 0000000..6b0d59b
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/templates/twitter_cards.html
@@ -0,0 +1,31 @@
+{{- if .Params.cover.image -}}
+
+{{- if (ne $.Params.cover.relative true) }}
+
+{{- else }}
+
+{{- end}}
+{{- else }}
+{{- $images := partial "partials/templates/_funcs/get-page-images" . -}}
+{{- with index $images 0 -}}
+
+
+{{- else -}}
+
+{{- end -}}
+{{- end }}
+
+
+
+{{- $twitterSite := "" }}
+{{- with site.Params.social }}
+ {{- if reflect.IsMap . }}
+ {{- with .twitter }}
+ {{- $content := . }}
+ {{- if not (strings.HasPrefix . "@") }}
+ {{- $content = printf "@%v" . }}
+ {{- end }}
+
+ {{- end }}
+ {{- end }}
+{{- end }}
diff --git a/themes/PaperMod/layouts/partials/toc.html b/themes/PaperMod/layouts/partials/toc.html
new file mode 100644
index 0000000..28f8694
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/toc.html
@@ -0,0 +1,97 @@
+{{- $headers := findRE "
+ {{- if .imageUrl -}}
+ {{- $img := "" }}
+ {{- if not (urls.Parse .imageUrl).IsAbs }}
+ {{- $img = resources.Get .imageUrl }}
+ {{- end }}
+ {{- if $img }}
+ {{- $processableFormats := (slice "jpg" "jpeg" "png" "tif" "bmp" "gif") -}}
+ {{- if hugo.IsExtended -}}
+ {{- $processableFormats = $processableFormats | append "webp" -}}
+ {{- end -}}
+ {{- $prod := (hugo.IsProduction | or (eq site.Params.env "production")) }}
+ {{- if and (in $processableFormats $img.MediaType.SubType) (eq $prod true)}}
+ {{- if (not (and (not .imageHeight) (not .imageWidth))) }}
+ {{- $img = $img.Resize (printf "%dx%d" .imageWidth .imageHeight) }}
+ {{- else if .imageHeight }}
+ {{- $img = $img.Resize (printf "x%d" .imageHeight) }}
+ {{ else if .imageWidth }}
+ {{- $img = $img.Resize (printf "%dx" .imageWidth) }}
+ {{ else }}
+ {{- $img = $img.Resize "150x150" }}
+ {{- end }}
+ {{- end }}
+ 
+ {{- else }}
+ 
+ {{- end }}
+ {{- end }}
+
+ {{- end}}
+{{ .title | default site.Title | markdownify }}
+ {{ .subtitle | markdownify }} + {{- partial "social_icons.html" -}} + + {{- with .buttons }} + + {{- end }} +
+
+{{- end }}
diff --git a/themes/PaperMod/layouts/partials/translation_list.html b/themes/PaperMod/layouts/partials/translation_list.html
new file mode 100644
index 0000000..0028251
--- /dev/null
+++ b/themes/PaperMod/layouts/partials/translation_list.html
@@ -0,0 +1,19 @@
+{{- if .IsTranslated -}}
+{{- if (ne .Layout "search") }}
+{{- if or .Params.author site.Params.author (.Param "ShowReadingTime") (not .Date.IsZero) }} | {{- end -}}
+{{- end }}
+{{- i18n "translations" | default "Translations" }}:
+
+
++ {{- i18n "toc" | default "Table of Contents" }} +
+ +
+ {{- if (.Param "UseHugoToc") }}
+ {{- .TableOfContents -}}
+ {{- else }}
+ {{- $largest := 6 -}}
+ {{- range $headers -}}
+ {{- $headerLevel := index (findRE "[1-6]" . 1) 0 -}}
+ {{- $headerLevel := len (seq $headerLevel) -}}
+ {{- if lt $headerLevel $largest -}}
+ {{- $largest = $headerLevel -}}
+ {{- end -}}
+ {{- end -}}
+
+ {{- $firstHeaderLevel := len (seq (index (findRE "[1-6]" (index $headers 0) 1) 0)) -}}
+
+ {{- $.Scratch.Set "bareul" slice -}}
+
+ -
+ {{- range seq (sub $firstHeaderLevel $largest) -}}
+
- + {{- $header | plainify | safeHTML -}} + {{- else }} +
- + {{- $header | plainify | safeHTML -}} + {{- end -}} + {{- end -}} + + {{- $firstHeaderLevel := $largest }} + {{- $lastHeaderLevel := len (seq (index (findRE "[1-6]" (index $headers (sub (len $headers) 1)) 1) 0)) }} + + {{- range seq (sub $lastHeaderLevel $firstHeaderLevel) -}} + {{- if in ($.Scratch.Get "bareul") (add . $firstHeaderLevel) }} +
-
+ {{- $.Scratch.Add "bareul" (sub (add $largest .) 1) -}}
+ {{- end -}}
+ {{- range $i, $header := $headers -}}
+ {{- $headerLevel := index (findRE "[1-6]" . 1) 0 -}}
+ {{- $headerLevel := len (seq $headerLevel) -}}
+
+ {{/* get id="xyz" */}}
+ {{- $id := index (findRE "(id=\"(.*?)\")" $header 9) 0 }}
+
+ {{- /* strip id="" to leave xyz, no way to get regex capturing groups in hugo */ -}}
+ {{- $cleanedID := replace (replace $id "id=\"" "") "\"" "" }}
+ {{- $header := replaceRE "
-
+ {{/* the first should not be recorded */}}
+ {{- if ne $prevHeaderLevel . -}}
+ {{- $.Scratch.Add "bareul" . -}}
+ {{- end -}}
+ {{- end -}}
+ {{- else -}}
+
+ {{- if lt $headerLevel $prevHeaderLevel -}}
+ {{- range seq (sub $prevHeaderLevel 1) -1 $headerLevel -}}
+ {{- if in ($.Scratch.Get "bareul") . -}}
+
-
+ {{- range .Translations }}
+
- + + {{- if (and site.Params.displayFullLangName (.Language.LanguageName)) }} + {{- .Language.LanguageName | emojify -}} + {{- else }} + {{- .Lang | title -}} + {{- end -}} + + + {{- end }} +
+ {{ .Get "summary" | markdownify }}
+ {{ .Inner | markdownify }}
+
+ {{- .Get "caption" | markdownify -}} + {{- with .Get "attrlink" }} + + {{- end -}} + {{- .Get "attr" | markdownify -}} + {{- if .Get "attrlink" }}{{ end }}
+ {{- end }} +
+ {{ if eq ($.Scratch.Get "md") false }}
+ {{ .Inner }}
+ {{ else }}
+ {{ .Inner | markdownify }}
+ {{ end }}
+
diff --git a/themes/PaperMod/layouts/shortcodes/rawhtml.html b/themes/PaperMod/layouts/shortcodes/rawhtml.html
new file mode 100644
index 0000000..9350c13
--- /dev/null
+++ b/themes/PaperMod/layouts/shortcodes/rawhtml.html
@@ -0,0 +1,2 @@
+
+{{- .Inner -}}
\ No newline at end of file
diff --git a/themes/PaperMod/layouts/shortcodes/rtl.html b/themes/PaperMod/layouts/shortcodes/rtl.html
new file mode 100644
index 0000000..a69b8ce
--- /dev/null
+++ b/themes/PaperMod/layouts/shortcodes/rtl.html
@@ -0,0 +1,15 @@
+{{ $.Scratch.Set "md" false }}
+
+{{ if .IsNamedParams }}
+{{ $.Scratch.Set "md" (.Get "md") }}
+{{ else }}
+{{ $.Scratch.Set "md" (.Get 0) }}
+{{ end }}
+
+
+ {{ if eq ($.Scratch.Get "md") false }}
+ {{ .Inner }}
+ {{ else }}
+ {{ .Inner | markdownify }}
+ {{ end }}
+
diff --git a/themes/PaperMod/theme.toml b/themes/PaperMod/theme.toml
new file mode 100644
index 0000000..85c7b73
--- /dev/null
+++ b/themes/PaperMod/theme.toml
@@ -0,0 +1,51 @@
+# theme.toml template for a Hugo theme
+# See https://github.com/gohugoio/hugoThemes#themetoml for an example
+
+name = "PaperMod"
+license = "MIT"
+licenselink = "https://github.com/adityatelange/hugo-PaperMod/blob/master/LICENSE"
+description = "A fast, clean, responsive Hugo theme"
+homepage = "https://adityatelange.github.io/hugo-PaperMod/"
+tags = [
+ "responsive",
+ "simple",
+ "clean",
+ "light",
+ "dark",
+ "blog",
+ "minimalist",
+ "highlight.js",
+ "search"
+]
+features = [
+ "responsive",
+ "single-column",
+ "blog",
+ "cover-image",
+ "table-of-contents",
+ "opengraph",
+ "highlight.js",
+ "favicon",
+ "archive",
+ "share-icons",
+ "cover",
+ "multilingual",
+ "social-icons",
+ "minified-assets",
+ "theme-toggle",
+ "menu-location-indicator",
+ "scroll-to-top",
+ "search"
+]
+min_version = "0.125.7"
+
+[author]
+ name = "Aditya Telange"
+ homepage = "https://github.com/adityatelange/"
+
+# If porting an existing theme
+[original]
+ name = "Paper"
+ author = "nanxiaobei"
+ homepage = "https://github.com/nanxiaobei"
+ repo = "https://github.com/nanxiaobei/hugo-paper/"