Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wisnuwiry/personal-site
Hugo Theme for Personal Site (Blog & Portfolio)
https://github.com/wisnuwiry/personal-site
hacktoberfest hugo-blog hugo-documentation hugo-site hugo-theme netlify
Last synced: 3 months ago
JSON representation
Hugo Theme for Personal Site (Blog & Portfolio)
- Host: GitHub
- URL: https://github.com/wisnuwiry/personal-site
- Owner: wisnuwiry
- License: mit
- Created: 2020-11-08T03:17:51.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-02-01T16:31:46.000Z (about 2 years ago)
- Last Synced: 2024-10-12T05:46:39.529Z (4 months ago)
- Topics: hacktoberfest, hugo-blog, hugo-documentation, hugo-site, hugo-theme, netlify
- Language: HTML
- Homepage: https://wisnuwiry.netlify.app
- Size: 476 KB
- Stars: 13
- Watchers: 2
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Hugo Personal Site
[]() [](https://github.com/wisnuwiry/personal-site/releases) [](LICENSE)
[](https://app.netlify.com/sites/wisnuwiry/deploys)
This is web made by Hugo static site generator, [Live Preview](https://wisnuwiry.space), more reference to example use this theme please check [my blog repo](https://github.com/wisnuwiry/blog-v2)
## TODO:
- [] Integrate series in home
- [] Responsive chapter detail
- [] Update readme
- [] Setup demo repo
## Instant Deploy
[](https://app.netlify.com/start/deploy?repository=https://github.com/wisnuwiry/personal-site-demo)
## 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** [](https://app.forestry.io/quick-start?repo=wisnuwiry/personal-site-demo2&engine=hugo&version=0.74.3&config=exampleSite)
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](https://gohugo.io/getting-started/quick-start/#step-1-install-hugo) and [created a new site](https://gohugo.io/getting-started/quick-start/#step-2-create-a-new-site). After that, you ready to install **personal-site**.
Create new project hugo
```bash
hugo new site site_name
```
Go to folder themes
```bash
cd site_name/themes
```
In your Hugo site themes directory, run:
```bash
git clone [email protected]: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:
```bash
git submodule add [email protected]: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 = "[email protected]"
[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
```bash
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](https://www.paypal.me/wisnuwiry/10USD)**: Thank's for creating this project, here's a tea (or some juice) for you!
* **[Donate $20](https://www.paypal.me/wisnuwiry/20USD)**: Wow, I am stunned. Let me take you to the movies!
* **[Donate $30](https://www.paypal.me/wisnuwiry/30USD)**: I really appreciate your work, let's grab some lunch!
* **[Donate $40](https://www.paypal.me/wisnuwiry/40USD)**: That's some awesome stuff you did right there, dinner is on me!
* **[Donate $50](https://www.paypal.me/wisnuwiry/50USD)**: I really really want to support this project, great job!
* **[Donate $100](https://www.paypal.me/wisnuwiry/100USD)**: You are the man! This project saved me hours (if not days) of struggle and hard work, simply awesome!
* **[Donate $1500](https://www.paypal.me/wisnuwiry/1500USD)**: 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](https://wisnuwiry.space)
## Release Notes
[Show more..](CHANGELOG.md)
## Maintainers
1. @wisnuwiry
[](https://github.com/wisnuwiry)
## Contributing
Have you found a bug or got an idea for a new feature? Feel free to use the [issue tracker](https://github.com/Vimux/mainroad/issues) to let me know. Or make directly a [pull request](https://github.com/Vimux/mainroad/pulls).
## Thanks to
@bep
@gohugoio