hugo-theme-introduction/README.md

118 lines
3.8 KiB
Markdown
Raw Normal View History

2018-05-22 00:15:05 +00:00
# <a href="https://vickylai.com/introduction/" target="_blank" rel="noopener">Introduction theme for Hugo</a>
2018-06-10 10:23:51 +00:00
[![Build Status](https://travis-ci.com/vickylai/hugo-theme-introduction.svg?branch=master)](https://travis-ci.com/vickylai/hugo-theme-introduction)
2017-03-13 09:14:02 +00:00
A minimal, single page, smooth scrolling theme for Hugo.
2018-05-22 00:15:05 +00:00
![Main page screenshot](https://github.com/vickylai/hugo-theme-introduction/blob/master/images/screenshot.png)
2017-03-13 09:45:32 +00:00
2017-03-13 09:14:02 +00:00
Features:
- Single scrolling home page
2017-04-22 01:37:11 +00:00
- About section with profile photo
- Contact section with option to show your local timezone
- Optional Projects and Blog sections
2017-05-14 07:19:04 +00:00
- Light and Dark themes
- Browser friendly CSS fade-in effect for some pizzaz
2017-04-22 01:37:11 +00:00
- Smooth scroll-to-section navigation
- Responsive and fast
2017-03-13 09:14:02 +00:00
## Quick start
### Get the theme
From the root of your Hugo site:
```sh
$ cd themes
2018-05-22 00:15:05 +00:00
$ git clone https://github.com/vickylai/hugo-theme-introduction.git introduction
2017-03-13 09:14:02 +00:00
```
### Configure your site
From the exampleSite, copy `config.toml` to the root folder of your Hugo site and change the fields as you like.
Start with:
2017-03-13 09:45:32 +00:00
2017-11-13 21:01:53 +00:00
1. Set your baseurl to your site's domain
1. Set your blog's title and your first name
1. Set your introduction header height (use "medium", "large", or "fullheight")
1. Choose "light" or "dark" theme
1. Set your avatar image
1. Set your timezone, if you choose to show it
1. Choose whether or not to show the Blog and Projects sections, and configure them to your liking
1. Input your social site urls and font-awesome icon names - use as many as you like
2017-03-13 09:14:02 +00:00
### Create About and Contact pages
Run:
2017-04-22 01:37:11 +00:00
```sh
2018-06-10 10:23:51 +00:00
$ hugo new about.md
2017-03-13 09:14:02 +00:00
$ hugo new contact.md
```
Then edit the markdown files with the content you'd like shown in your main page's About and Contact sections.
## Preview your site locally
Use Hugo's built-in server to see your site in action as you make changes.
```
2017-11-13 21:01:53 +00:00
$ hugo serve -t introduction
2017-03-13 09:14:02 +00:00
```
Visit `localhost:1313` in your browser to see a live preview of your site.
## Blog posts
To create a new blog post, run:
```
2017-11-13 21:01:53 +00:00
$ hugo new blog/your-post-title.md
2017-03-13 09:14:02 +00:00
```
2017-11-13 21:01:53 +00:00
## Projects
To create a new project entry, run:
```
$ hugo new projects/your-project-name.md
```
### Project front matter
Project parameters look like this:
```
---
title: "Design"
date: 2017-11-13T12:21:16-05:00
image: "img/plant.jpg"
external_link: ""
weight: 2
---
```
Projects are ordered on the main page by `weight` first, then by `date`.
The `image` will show up on the main page and in the project's details view. If you don't specify an image, the `placeholderimg` from your site's `config.toml` file will be used.
2017-11-14 16:55:02 +00:00
If you don't specify a `title`, only the photo will show. You can still add content to the file to "caption" the image, and this will show in the popup. (Great way to create a simple gallery!)
2017-11-13 21:01:53 +00:00
If you leave `external_link` empty, clicking on a project on your main page will pop up a window with the project's details. If you specify a url instead, clicking on the project on your main page will take you to that url.
## Contributing
Pull requests for bug fixes and suggestions are welcome.
2018-05-22 00:15:05 +00:00
Contributors are listed in [CHANGELOG.md](https://github.com/vickylai/hugo-theme-introduction/blob/master/CHANGELOG.md). Thank you so much! 🖤
2018-06-08 21:31:55 +00:00
## License
Copyright (C) 2018 Vicky Lai
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
2018-06-10 10:23:51 +00:00
along with this program. If not, see <https://www.gnu.org/licenses/>.