Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paulmartins/hugo-digital-garden-theme
Hugo Theme for digital gardening projects.
https://github.com/paulmartins/hugo-digital-garden-theme
hugo theme
Last synced: 2 months ago
JSON representation
Hugo Theme for digital gardening projects.
- Host: GitHub
- URL: https://github.com/paulmartins/hugo-digital-garden-theme
- Owner: paulmartins
- License: mit
- Created: 2021-08-17T21:26:04.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-11T02:52:58.000Z (11 months ago)
- Last Synced: 2024-08-02T16:49:50.149Z (5 months ago)
- Topics: hugo, theme
- Language: HTML
- Homepage:
- Size: 7.51 MB
- Stars: 79
- Watchers: 3
- Forks: 40
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome-github-stars - paulmartins/hugo-digital-garden-theme - Hugo Theme for digital gardening projects. (HTML)
README
[](https://github.com/paulmartins/hugo-digital-garden-theme/issues)
[](https://github.com/paulmartins/hugo-digital-garden-theme/network)
[](https://github.com/paulmartins/hugo-digital-garden-theme/stargazers)
[](https://github.com/paulmartins/hugo-digital-garden-theme/blob/main/LICENSE)
# Digital Garden Theme for Hugo
A simple Hugo theme for your digital garden, inspired by Maggie Appleton [website](https://maggieappleton.com/)
[**DEMO**](https://hugo-digital-garden-demo.netlify.app/)
This theme includes:
* a digital garden / blog
* a projects portfolio
* library notes
## Getting started
1. Install hugo and create a new website: [https://gohugo.io/getting-started/quick-start/](https://gohugo.io/getting-started/quick-start/)
2. Add the theme to your website
You can either use git submodule or clone the repo in your theme folder
```bash
git submodule add https://github.com/paulmartins/hugo-digital-garden-theme.git themes/hugo-digital-garden-theme
```
```bash
cd themes
git clone https://github.com/paulmartins/hugo-digital-garden-theme.git
```
3. Customize your site in your `config.toml`. An example is given in the theme folder: `themes/digital-garden/exampleSite/config.toml`
4. Run the server and check your [localhost:1313](http://localhost:1313)
```bash
hugo server
```
### Extra tips
You will write the content for your website in a `content` folder, for example in `content/garden/evergreen_example.md`. If you want to have your `content` folder in your root directory, you can copy that from the exampleSite folder to your root directory. In the root directory's `config.toml` you will need to change the themesdir to have `themesdir = "./themes"`. You now run `hugo server` in the root directory of your project, and Hugo will start your website locally on an available port.
If you want to compare the website from this to the example site, you can start `hugo server` in the exampleSite directory too. Hugo will use different ports for each server, so you can compare the rendered pages with each other.
To create custom styling, you can create `./static/css/my_style.css`. The CSS styling in here will override the theme's default styling. [Here](https://github.com/IdiosApps/IdiosApps.github.io/blob/main/static/css/my_style.css) is an example custom CSS file from a user's blog, and [here](https://idiosapps.github.io/garden/games-for-socials/) is one of their published pages looks. You can see the custom table formatting: custom header row colour, alternating row backgrounds, custom fonts, etc.
## Update to the latest version of the theme
If you used git submodule to add the theme (see Getting started) do
```bash
git submodule update --remote --rebase
```
If you clone the theme, just go in the theme folder and `pull`
```bash
cd themes/hugo-digital-garden-theme
git pull
```
[](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2Fpaulmartins%2Fhugo-digital-garden-theme)