blob: d4f0d40fe885cb94e0b0bafed6915eb228d65ca1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
# Bootstrap-BP hugo startpage
Bootstrap based Hugo startpage theme which provides out of the box best practices.
This theme is a combination of my [Bootstrap-BP hugo theme](https://github.com/spech66/bootstrap-bp-hugo-theme) and my [startpage](https://github.com/spech66/startpage).
Instead of rendering the items on-the-fly as in the startpage theme the **Bootstrap-BP hugo startpage** will generate a complete single page site.
## Install the theme
With Git installed, run the following commands inside the Hugo site folder. If Hugo has not yet been installed, read the setup guide [here](https://gohugo.io/overview/installing/).
```sh
mkdir themes
cd themes
git clone https://github.com/spech66/bootstrap-bp-hugo-startpage.git
```
You can get a zip of the latest version of the theme from the [home page](https://github.com/spech66/bootstrap-bp-hugo-theme) and extract it to the themes folder.
## Theme settings
Most settings should be done with hugo specific variables. There are only a few (optional) additional `[params]`.
* `welcomeText = "Startpage!"` is the text above the search box
* `showGoogleSearch = true` to switch Google search box on/off
* `showBingSearch = true` to switch Bing search box on/off
* `showDuckDuckGoSearch = true` to switch DuckDuckGo search box on/off
* `startPageColumns = true` will show the start page in grouped lists
Define the links in a file in `data/links.yml`. This needs to be structured like this.
```yml
---
- group: Social media
items:
- title: reddit
url: https://www.reddit.com
icon: fab fa-reddit
- title: Facebook
url: https://www.facebook.com
icon: fab fa-facebook
- group: Utilities
items:
- title: GitHub
url: https://www.github.com
icon: fab fa-github
```
Icons are taken from [Font Awesome](https://fontawesome.com/icons?d=gallery).
## Sources
* Background image by [Mikael Gustafsson](https://www.artstation.com/artwork/Y2Wew)
Inspired by:
* [Reddit - r/startpages](https://www.reddit.com/r/startpages/)
* [Github - 0-Tikaro - Minimum Viable Startpage](https://github.com/0-Tikaro/minimum-viable-startpage), Searchbox code
* [Github - ViktorKare - startpage](https://github.com/ViktorKare/startpage)
|
