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
By default, this does not include guides. To include guides, use `podman compose --file docker-compose_with_guides.yml up`. If the guides build terminates abruptly before completion, make sure your [container engine has enough memory allocated](https://podman-desktop.io/docs/podman/creating-a-podman-machine#procedure) (it will need at least 5GB).
29
-
30
-
> **Note:** The startup process may take several minutes, depending on your system. During this time, you might see logs with warnings or configuration messages (e.g., AutoPages and asciidoctor warnings). This is normal behavior as Jekyll builds the site. Once the server is running, you will see output like this:
31
-
17
+
```sh
18
+
cd quarkusio.github.io
32
19
```
33
-
jekyll-1 | Server address: http://0.0.0.0:4000/
34
-
jekyll-1 | Server running... press ctrl-c to stop.
20
+
4. Run Docker Compose or Podman Compose:
21
+
```sh
22
+
docker compose up
35
23
```
24
+
or
36
25
37
-
If any error occurs mentioning a name conflict, try:
26
+
```sh
27
+
podman compose up
28
+
```
38
29
39
-
docker compose up --force-recreate
30
+
By default, this does not include guides. To include guides, use:
31
+
```sh
32
+
docker compose --file docker-compose_with_guides.yml up
33
+
```
34
+
If the guides build terminates abruptly before completion, make sure your [container engine has enough memory allocated](https://podman-desktop.io/docs/podman/creating-a-podman-machine#procedure) (it will need at least 5GB).
35
+
36
+
> [!NOTE]
37
+
> The startup process may take several minutes, depending on your system. During this time, you might see logs with warnings or configuration messages (e.g., AutoPages and asciidoctor warnings). This is normal behavior as Jekyll builds the site. Once the server is running, you will see output like this:
38
+
>
39
+
>```
40
+
> jekyll-1 | Server address: http://0.0.0.0:4000/
41
+
> jekyll-1 | Server running... press ctrl-c to stop.
42
+
>```
43
+
44
+
If an error occurs mentioning a name conflict, try:
45
+
```sh
46
+
docker compose up --force-recreate
47
+
```
40
48
41
49
5. Now browse to [http://localhost:4000](http://localhost:4000).
42
50
#### Using a local Ruby environment
43
51
[Jekyll static site generator docs](https://jekyllrb.com/docs/).
44
52
45
53
1. Install a full [Ruby development environment](https://jekyllrb.com/docs/installation/). If you use `rvm`, run: `rvm use 3.2.3`.
5. Use bundler to fetch all required gems in their respective versions
59
-
60
-
bundle install
61
-
67
+
```sh
68
+
bundle install
69
+
```
62
70
6. Build the site and make it available on a local server
63
-
64
-
./serve.sh
65
-
71
+
```sh
72
+
./serve.sh
73
+
```
66
74
Or if you want it faster and okay to not have guides included use the following:
67
75
68
-
./serve-noguides.sh
76
+
```sh
77
+
./serve-noguides.sh
78
+
```
69
79
70
80
71
81
7. Now browse to http://localhost:4000
72
82
73
-
> If you encounter any unexpected errors during the above, please refer to the [troubleshooting](https://jekyllrb.com/docs/troubleshooting/#configuration-problems) page or the [requirements](https://jekyllrb.com/docs/installation/#requirements) page, as you might be missing development headers or other prerequisites.
83
+
>[!NOTE]
84
+
>If you encounter any unexpected errors during the above, please refer to the [troubleshooting](https://jekyllrb.com/docs/troubleshooting/#configuration-problems) page or the [requirements](https://jekyllrb.com/docs/installation/#requirements) page, as you might be missing development headers or other prerequisites.
74
85
75
86
**For more regarding the use of Jekyll, please refer to the [Jekyll Step by Step Tutorial](https://jekyllrb.com/docs/step-by-step/01-setup/).**
76
87
@@ -84,9 +95,9 @@ If for some reason you need to deploy from your local machine, follow these inst
84
95
85
96
## Writing a blog
86
97
87
-
> **NOTE:** Using generative AI in *assisting* writing is fine, but please don't use it to write entire posts.
88
-
> Used badly, generative AI has a tendency to use complex words and phrasing. This makes
89
-
the content hard to read and understand. Always review your blog with a human reader in mind, make sure it's factually correct and especially keep the human touch and opinions in the content.
98
+
>[!WARNING]
99
+
>Using generative AI in*assisting* writing is fine, but please don't use it to write entire posts.
100
+
> Used badly, generative AI has a tendency to use complex words and phrasing. This makes the content hard to read and understand. Always review your blog with a human reader in mind, make sure it's factually correct and especially keep the human touch and opinions in the content.
90
101
91
102
To write a blog:
92
103
@@ -141,8 +152,8 @@ See Step 5 on https://docs.github.com/en/github/working-with-github-pages/managi
141
152
142
153
Please read [CONTRIBUTING.md](https://github.com/quarkusio/quarkusio.github.io/tree/main/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
143
154
144
-
**Important:** the guides are maintained in the main Quarkus repository and pull requests should be submitted there:
> The guides are maintained in the main Quarkus repository and pull requests should be submitted there: https://github.com/quarkusio/quarkus/tree/main/docs/src/main/asciidoc.
0 commit comments