Commit 223e597e authored by yala's avatar yala

initialisation with content from 442f205a

parents
![](/logo.png)
from Witzenhausen with ♥
---
type: "page"
---
# Hello, meet Ecobytes
We are your friendly, community-led internet service provider.
---
type: "page"
title: "Association"
weight: 10
creatordisplayname: "Jon RICHTER"
creatoremail: "jon@allmende.io"
lastmodifierdisplayname: "Jon RICHTER"
lastmodifieremail: "jon@allmende.io"
---
# Ecobytes Association
---
title: "Commons"
type: "page"
weight: 20
---
# Ecobytes Commons
---
title: "Lab"
type: "page"
weight: 40
---
# Ecobytes Lab
---
title: "Building static websites with Hugo"
date: 2018-04-29T02:51:11+02:00
draft: false
---
This documentation covers building a landing page like ecobytes.net or setting up a knowledge repository like docs.ecobytes.net with a static site generator. We chose [Hugo](http://gohugo.io) which is configured via YAML-files.
## Create repositories
Two `git` repositories within your home git community are being used: one for the theme and the other for content and menu configuration.
- theme
`git@gitlab.domain.tld:gitname/project/website-theme.git`
- content + configuration
`git@gitlab.domain.tld:gitname/project/website.git`
## Install Hugo and create a new site
http://gohugo.io/getting-started/quick-start/
### Install Theme
1. Fork the chosen Hugo-theme on GitHub.
2. Create a repository on lab.allmende.io.
3. Clone the forked theme from GitHub.
```
cd themes
git clone git@github.com:gitname/themename.git myforkedtheme
cd myforkedtheme
```
### Find a new home for your fork on your home git community
For the sake of completeness the repo on GitHub is kept. So that we can push into two repos at once we add them to the new remote "both".
```
git remote add both git@github.com:gitname/themename.git
git remote set-url --add --push both git@github.com:gitname/themename.git
git remote set-url --add --push both git@gitlab.domain.tld:gitname/project/website-theme.git
```
Push to both repos simultaneously is done via:
```
git push both
```
## Clone existing site
- [`git@lab.allmende.io:ecobytes/association/website.git`](https://lab.allmende.io/ecobytes/association/website)
- [`git@lab.allmende.io:ecobytes/commons/documentation.git`](https://lab.allmende.io/ecobytes/commons/documentation)
```
git clone git@lab.allmende.io:ecobytes/association/website.git
# or git@lab.allmende.io:ecobytes/commons/documentation.git
cd website/
git submodule update --init --recursive --remote
```
## Display an existing site
Verify with by running
hugo serve
and opening http://localhost:1313 in your browser.
## Edit existing site
In your `tmux` session ...
```
tmux
# one pane for
hugo serve
# and another for
vim ...
# with live reload
```
### Deploy to staging
Sometimes one wishes to deploy a site in development to a staging environment. Assuming you know and use Dokku, the repositories are prepared to work with it. You can push your site to it with:
```
hugo
cd public
git remote add stage dokku@apps.allmende.io:ecobytes-website
# or dokku@apps.allmende.io:ecobytes-documentation
git push -u stage deploy:master
cd ..
```
### Deploy to production
Assuming you wish to deploy `master` to a `production` instance, simply issue
./deploy.sh
## branching model
- `master`
- untouchable manually, this can only be mutated by Merge Requests
- `stage`
- issue for issues (ideally branch from the issues on gitlab to have them automatically linked)
- merge request from the branch once finished, review by peers and merge
---
title: "Studios"
type: "page"
weight: 30
---
# Ecobytes Studios
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment