You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+24-17Lines changed: 24 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,6 +7,8 @@ of those will be an inspiration or of help.
7
7
8
8
# Getting started
9
9
10
+
Building the website can be done either using containers or by doing a manual install. The manual install is a bit fragile and may be hard to install on modern systems. Pull requests to support a more recent environment are very much welcome!
11
+
10
12
## Prerequisites
11
13
12
14
- Ruby 2.4 or newer
@@ -16,7 +18,7 @@ of those will be an inspiration or of help.
16
18
1. An export of the FOSDEM pentabarf system; or
17
19
2. Credentials to connect to the FOSDEM pentabarf database
18
20
19
-
### Debian 9 with rbenv
21
+
### Debian 9-12 with rbenv
20
22
21
23
Assuming you are running Debian or a derivative thereof, your system will need
22
24
to have the following packages installed:
@@ -72,26 +74,24 @@ initialisation file for your shell.
72
74
73
75
A site build consists of two steps:
74
76
75
-
1. Export the data from the FOSDEM Pentabarf database
77
+
1. Export the data from the FOSDEM Pretalx database
76
78
2. Generate the static site using the exported data
77
79
78
-
### Exporting from FOSDEM Pentabarf
80
+
### Exporting from FOSDEM Pretalx
79
81
80
-
To generate the schedule data from Pentabarf, you will first need to obtain a
81
-
Kerberos ticket for a principal with access to the Pentabarf database. Next,
82
-
you will be able to run the update command.
82
+
The schedule data is fetched as a large yaml file and the resources/thumbnails.
83
+
The best way is to clone these from the nanoc server (`nanoc update -y` should be repaired)
If you do not have access to the Pentabarf database, you can copy the `export/`
89
+
If you do not have access to the pretalx site or for, you can copy the `export/`
90
90
folder in the `sample/` directory to the root and go from there.
91
91
92
92
### Generating the site
93
93
94
-
> This section assumes you have an exported data from pentabarf already. If you
94
+
> This section assumes you have an exported data from pretalx already. If you
95
95
> haven't please see the section above first.
96
96
97
97
```bash
@@ -101,25 +101,32 @@ nanoc
101
101
The site will be generated in `/output`. To view the website, you can use the
102
102
`view` command and optionally specify a port to listen on:
103
103
104
-
```
104
+
```bash
105
105
nanoc view -p 1234
106
-
107
106
```
108
-
Don't forget to add the year when you check out the site, eg http://localhost:1234/2022 .
109
107
108
+
Don't forget to add the year when you check out the site, eg http://localhost:1234/2024 .
110
109
111
110
### Running with Docker
112
111
113
-
Rather than installing all dependencies on you machine, it is also possible to use a docker container with all specific versions.
112
+
Rather than installing all dependencies on you machine, it is also possible to use a docker container with all specific versions. You can either build a container yourself, or pull the one that is used in github actions.
114
113
114
+
To build yourself:
115
115
```bash
116
116
docker build -t fosdem/website .
117
+
```
118
+
119
+
Using the published image:
120
+
```bash
121
+
docker pull ghcr.io/johanvdw/fosdem-website
122
+
docker tag fosdem/website ghcr.io/johanvdw/fosdem-website
0 commit comments