feat: KeepIt => LoveIt

This commit is contained in:
Dillon ZENG 2019-08-06 23:49:02 +08:00
parent 7218a98618
commit 96029eac32
5 changed files with 59 additions and 48 deletions

View file

@ -1,7 +1,7 @@
The MIT License (MIT) The MIT License (MIT)
Copyright (c) 2018 LIUZHICHAO.COM Copyright (c) 2018 LIUZHICHAO.COM
Copyright (c) 2019 DILLONZQ.TOP Copyright (c) 2019 DILLONZQ.COM
Permission is hereby granted, free of charge, to any person obtaining a copy of Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in this software and associated documentation files (the "Software"), to deal in

View file

@ -1,19 +1,18 @@
KeepIt Hugo Theme # LoveIt Hugo Theme
========================
KeepIt is a clean, elegant, simple but not simpler blog theme for Hugo based on the original [LeaveIt Theme](https://raw.githubusercontent.com/liuzc/LeaveIt/) developed by [LiuZhichao](https://raw.githubusercontent.com/liuzc/). LoveIt is a clean, elegant, simple but not simpler blog theme for Hugo based on the original [LeaveIt Theme](https://github.com/liuzc/LeaveIt/) and [KeepIt Theme](https://github.com/liuzc/LeaveIt/) developed by [Dillon](https://dillonzq.com).
![hugo-theme-KeepIt](https://github.com/Fastbyte01/KeepIt/blob/master/images/screenshot.png) ![hugo-theme-LoveIt](https://github.com/dillonzq/LoveIt/blob/master/images/screenshot.png)
## Demo
# Demo
To see this theme in action, Here is a live [demo site](https://suspicious-archimedes-ab369d.netlify.com) which is rendered with this theme. To see this theme in action, Here is a live [demo site](https://suspicious-archimedes-ab369d.netlify.com) which is rendered with this theme.
People that are using **KeepIt**: People that are using **LoveIt**:
* [PapEr](https://page.codespaper.com) * [Dillon](https://dillonzq.com)
* [SilkeHenderickx](http://www.silkehenderickx.be)
# Features ## Features
* Optimized for performance: 99/100 on mobile and 100/100 on desktop in Google PageSpeed Insights * Optimized for performance: 99/100 on mobile and 100/100 on desktop in Google PageSpeed Insights
* Optimized SEO performance with a correct SEO SCHEMA based on JSON-LD * Optimized SEO performance with a correct SEO SCHEMA based on JSON-LD
@ -38,28 +37,32 @@ People that are using **KeepIt**:
* Automagical image gallery with [lightGallery](https://github.com/sachinchoolur/lightGallery) * Automagical image gallery with [lightGallery](https://github.com/sachinchoolur/lightGallery)
* ... * ...
# Getting Started ## Getting Started
Clone this repository to your hugo theme directory. Clone this repository to your hugo theme directory.
```bash ```bash
cd themes cd themes
git clone https://github.com/Fastbyte01/KeepIt.git git clone https://github.com/dillonzq/LoveIt.git
``` ```
Next, open config.toml in the base of the Hugo site and ensure the theme option is set to KeepIt: Next, open config.toml in the base of the Hugo site and ensure the theme option is set to KeepIt:
```bash ```bash
theme = "KeepIt" theme = "LoveIt"
``` ```
For more information read the [official setup guide](https://gohugo.io/documentation/) of Hugo. For more information read the [official setup guide](https://gohugo.io/documentation/) of Hugo.
# Site Configuration ## Site Configuration
Take a look in the `exampleSite` folder. Take a look in the `exampleSite` folder.
This directory contains an example config file and the content for the demo. It serves as an example setup for your documentation. This directory contains an example config file and the content for the demo. It serves as an example setup for your documentation.
Copy the `config.toml` in the root directory of your website. Overwrite the existing config file if necessary. Copy the `config.toml` in the root directory of your website. Overwrite the existing config file if necessary.
# Content Suggestions ## Content Suggestions
A few suggestions to help you get a good looking site quickly: A few suggestions to help you get a good looking site quickly:
@ -67,14 +70,14 @@ A few suggestions to help you get a good looking site quickly:
* Keep static pages in the content directory, for example: content/about.md * Keep static pages in the content directory, for example: content/about.md
* Keep media like images in the static directory, for example: static/images/2019/10/screenshot.png * Keep media like images in the static directory, for example: static/images/2019/10/screenshot.png
# Customizing styles for your website ## Customizing styles for your website
If you want to change some styling to fit your own website needs, you can edit them: If you want to change some styling to fit your own website needs, you can edit them:
* `assets/css/_varibales/default.scss`: You can override the variables in `_variables.scss` to customize the style * `assets/css/_varibales/default.scss`: You can override the variables in `_variables.scss` to customize the style
* `assets/css/_custom.scss` : You can put your custom css in this file * `assets/css/_custom.scss` : You can put your custom css in this file
# Favicons, Browserconfig, Manifest ## Favicons, Browserconfig, Manifest
It is recommended to put your own favicons It is recommended to put your own favicons
@ -85,54 +88,62 @@ It is recommended to put your own favicons
* android-chrome-192x192.png (192x192) * android-chrome-192x192.png (192x192)
* android-chrome-512x512.png (512x512) * android-chrome-512x512.png (512x512)
into `/static`. Theyre easily created via https://realfavicongenerator.net/. into `/static`. Theyre easily created via [https://realfavicongenerator.net/](https://realfavicongenerator.net/).
Customize browserconfig.xml and site.webmanifest to set theme-color and background-color for example. Customize browserconfig.xml and site.webmanifest to set theme-color and background-color for example.
# Tips ## Tips
#### Set production environment when generating site ### Set production environment when generating site
Because some functions are only in production mode, So you **need to add a production** environment variables when generating your site. Because some functions are only in production mode, So you **need to add a production** environment variables when generating your site.
```bash ```bash
HUGO_ENV=production hugo --gc --minify HUGO_ENV=production hugo --gc --minify
``` ```
#### Hugo “extended” Sass/SCSS version required ### Hugo “extended” Sass/SCSS version required
This theme write style with scss, So you must download and install the “extended” Sass/SCSS version This theme write style with scss, So you must download and install the “extended” Sass/SCSS version
#### How to toggle dark-light mode ### How to toggle dark-light mode
* You can click the sun logo to toggle dark-light mode. In the desktop version the sun logo is to the right and in the mobile version is positioned to the left, close to the site title. * You can click the sun logo to toggle dark-light mode. In the desktop version the sun logo is to the right and in the mobile version is positioned to the left, close to the site title.
* If you want to make your own theme toggle-able element, you can create an element with a class `.theme-switch`. See [here](https://github.com/Fastbyte01/KeepIt/blob/master/assets/js/main.js#L32) * If you want to make your own theme toggle-able element, you can create an element with a class `.theme-switch`. See [here](https://github.com/Fastbyte01/KeepIt/blob/master/assets/js/main.js#L32)
# Home Post model ## Home Post model
If you want to show posts on index instead of a personal profile, just open config.toml in the base of the Hugo site, add the following line to config.toml If you want to show posts on index instead of a personal profile, just open config.toml in the base of the Hugo site, add the following line to config.toml
```toml ```toml
[params] [params]
home_mode = "post" # post or other home_mode = "post" # post or other
``` ```
# Add logo and cover for SEO
## Add logo and cover for SEO
Add a logo image (127x40) and a cover image (800x600). This images are used for SEO. Add a logo image (127x40) and a cover image (800x600). This images are used for SEO.
# Questions, ideas, bugs, pull requests? ## Questions, ideas, bugs, pull requests
All feedback is welcome! Head over to the [issue tracker](https://github.com/Fastbyte01/KeepIt/issues).
For more configuration info or other tips you can see the [wiki](https://github.com/Fastbyte01/KeepIt/wiki). All feedback is welcome! Head over to the [issue tracker](https://github.com/dillonzq/LoveIt/issues).
For more configuration info or other tips you can see the [wiki](https://github.com/dillonzq/LoveIt/wiki).
## License
# License
LeaveIt is licensed under the MIT license. Check the LICENSE file for details. LeaveIt is licensed under the MIT license. Check the LICENSE file for details.
The following resources are included in the theme: The following resources are included in the theme:
* lazysizes - https://github.com/aFarkas/lazysizes * [lazysizes](https://github.com/aFarkas/lazysizes)
* lightGallery - https://github.com/sachinchoolur/lightGallery * [lightGallery](https://github.com/sachinchoolur/lightGallery)
* code-prettify - https://github.com/google/code-prettify * [code-prettify](https://github.com/google/code-prettify)
# Author ## Author
[Fastbyte01](https://github.com/Fastbyte01)
# See Also [Dillon](https://dillonzq.com)
## See Also
* [Hermitt](https://github.com/Track3/hermit) * [Hermitt](https://github.com/Track3/hermit)
* [Goa](https://github.com/shenoybr/hugo-goa) * [Goa](https://github.com/shenoybr/hugo-goa)

View file

@ -8,7 +8,7 @@
<span class="author" itemprop="copyrightHolder"><a href="{{ .Site.BaseURL }}">{{ .Site.Params.author }}</a> | <span class="author" itemprop="copyrightHolder"><a href="{{ .Site.BaseURL }}">{{ .Site.Params.author }}</a> |
</span> </span>
{{ end }} {{ end }}
<span>{{ (printf (T "powered") `<a href="https://gohugo.io/" target="_blank" rel="external nofollow noopener noreffer">Hugo</a>`) | safeHTML }} | {{ T "theme" }}<a href="https://github.com/dillonzq/KeepIt" target="_blank" rel="external nofollow noopener noreffer">KeepIt</a></span> <span>{{ (printf (T "powered") `<a href="https://gohugo.io/" target="_blank" rel="external nofollow noopener noreffer">Hugo</a>`) | safeHTML }} | {{ T "theme" }}<a href="https://github.com/dillonzq/LoveIt" target="_blank" rel="external nofollow noopener noreffer">LoveIt</a></span>
</div> </div>
</footer> </footer>

View file

@ -1,11 +1,11 @@
# theme.toml template for a Hugo theme # theme.toml template for a Hugo theme
# See https://github.com/gohugoio/hugoThemes#themetoml for an example # See https://github.com/gohugoio/hugoThemes#themetoml for an example
name = "KeepIt" name = "LoveIt"
license = "MIT" license = "MIT"
licenselink = "https://github.com/Fastbyte01/KeepIt/blob/master/LICENSE" licenselink = "https://github.com/dillonzq/LoveIt/blob/master/LICENSE"
description = "A minimal and responsive theme for Hugo." description = "A minimal and responsive theme for Hugo."
homepage = "https://www.fsb01.com/" homepage = "https://dillonzq.com/"
tags = [ tags = [
"blog", "blog",
"minimal", "minimal",
@ -27,10 +27,10 @@ features = [
min_version = "0.53" min_version = "0.53"
[author] [author]
name = "Fastbyte01" name = "Dillon"
homepage = "https://www.fsb01.com/" homepage = "https://dillonzq.com/"
[original] [original]
name = "LiuZhichao" name = "Fastbyte01"
homepage = "https://liuzhichao.com/" homepage = "https://www.fsb01.com/"
repo = "https://github.com/liuzc/LeaveIt/" repo = "https://github.com/Fastbyte01/KeepIt"