https://github.com/rosedu/omniopencon
OmniOpenCon website
https://github.com/rosedu/omniopencon
community conference free-software hackathons open open-data open-education open-hardware open-science open-source workshops
Last synced: 20 days ago
JSON representation
OmniOpenCon website
- Host: GitHub
- URL: https://github.com/rosedu/omniopencon
- Owner: rosedu
- Created: 2024-08-24T14:14:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-16T17:04:15.000Z (4 months ago)
- Last Synced: 2025-10-17T19:33:37.781Z (4 months ago)
- Topics: community, conference, free-software, hackathons, open, open-data, open-education, open-hardware, open-science, open-source, workshops
- Language: CSS
- Homepage: https://omniopencon.org/
- Size: 16.8 MB
- Stars: 0
- Watchers: 9
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# OmniOpenCon Website
This is the website (landing page) of the OmniOpenCon conference.
It is generated using [Hugo](https://gohugo.io/) and the [`hugo-conference` theme](https://github.com/jweslley/hugo-conference).
## Running Locally with Docker
To run the website locally, it is easiest to use [Docker](https://www.docker.com/).
You need to have [Docker installed](https://docs.docker.com/engine/install/).
You can use [`docker compose`](https://docs.docker.com/compose/install/) based on the configuration in `docker-compose.yml`:
```console
docker compose up
```
Or you can use `make` based on the configuration in `Makefile`:
```console
make
```
Any of the two approaches will fire up a Docker container that runs Hugo on the website.
Hugo generates the website contents in the `public/` directory.
And then it starts a custom web server to serve the generated contents.
Point your browser to http://localhost:1313 to see thwe website.
Changes you make in the `public/` directory will become visible in the website.
## Runnnig Locally with Hugo
To run the website locally, install [Hugo](https://gohugo.io/installation/).
Then, generate and serve the website using:
```console
hugo server
```
Point your browser to http://localhost:1313 to see the website.
## Initializing the Website Contents
The website contents have already been initialized, as currently in the repository.
The first step was to create the initial Hugo website contents in the current directory:
```
hugo init .
```
Then we added the [`hugo-conference` theme](https://github.com/jweslley/hugo-conference):
```console
git clone --depth=1 https://github.com/jweslley/hugo-conference themes/hugo-conference
rm -fr themes/hugo-conference/.git
```
Then we did the basic configuration:
* Add configuration file:
```console
rm hugo.toml
cp themes/hugo-conference/exampleSite/config.yml .
```
* Update older configurations:
```console
sed -i '/\.Hugo\.Generator/d' themes/hugo-conference/layouts/index.html
sed -i 's/template "_internal\/google_analytics_sync.html"/template "_internal\/google_analytics.html"/g' themes/hugo-conference/layouts/index.html
```
* Add `baseurl` configuration:
```console
sed -i 's/^baseurl: .*$/baseurl: "https:\/\/omniopencon.fra0.kraft.host\/"/g' config.yml
```
* Copy static files (images):
```console
cp -r themes/hugo-conference/exampleSite/static/* static/
```
* Remove the `exampleSite` files from the theme:
```console
rm -fr themes/hugo-conference/exampleSite
```