[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v1 03/12] website: README: document how to build the website with
From: |
Denis 'GNUtoo' Carikli |
Subject: |
[PATCH v1 03/12] website: README: document how to build the website without Guix. |
Date: |
Mon, 4 Nov 2024 00:18:56 +0100 |
Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
---
website/README | 65 ++++++++++++++++++++++++++++++++++++++++----------
1 file changed, 52 insertions(+), 13 deletions(-)
diff --git a/website/README b/website/README
index 61495a5..0dd0424 100644
--- a/website/README
+++ b/website/README
@@ -2,22 +2,69 @@
This directory contains both the website in pages/ and build code to
easily build and deploy the GNU Boot website with very few commands.
-If you want to test your own modifications to the dependencies of this
-build code, you either need to use the configure options to use
-external repositories that have your modifications, or you could also
-modify the build.sh script to use different git repositories and/or
-revisions.
+== Dependencies ==
+
+If you don't want to install Guix just to test the website, you will
+need to install the following dependencies:
+
+* autoconf
+* automake
+* coreutils
+* gawk
+* git
+* graphviz
+* grep
+* gzip
+* lighttpd
+* make
+* pandoc
+* sed
+* tar
+
+$ ./autogen.sh
+$ ./configure --disable-guix
+$ make serve
+
+And if you want to use Guix instead you only need the following
+dependencies instead:
+
+* autoconf
+* automake
+* coreutils
+* guix
+* make
+* tar
+
+And you can use the following commands instead:
+$ ./autogen.sh
+$ ./configure
+$ make serve
== Local deployments ==
+
Here's how to deploy the website in a local webserver:
$ ./autogen.sh
$ ./configure
$ make serve
+If you don't use Guix, remember to do ./configure --disable-guix instead.
+
Then you can point a browser to http://localhost:8086/software/gnuboot/web/ or
to http://localhost:PORT/software/gnuboot/web/ if you changed the port through
./configure options.
+
+The GNU Boot website build system takes care of some of the
+dependencies for you (for instance the static website generator that
+is not packaged in any distributions) so you have less work to do to
+install or use them on your side.
+
+If you want to test your own modifications to the dependencies of this
+build code, you either need to use the configure options to use
+external repositories that have your modifications, or you could also
+modify the build.sh script to use different git repositories and/or
+revisions.
+
== Deployment on https://gnu.org/software/gnuboot/ ==
The deployment to https://gnu.org/software/gnuboot/ uses rsync. As
@@ -85,14 +132,6 @@ References:
SHA256:pmCf0NrBzSSYfg6DdgmlMzPWZzGpXXcPEz6LP1+o5Jc exists on the
server".
-== Dependencies ==
-* autoconf
-* automake
-* coreutils
-* guix
-* lighttpd: optional: for testing the website if you don't have Guix.
-* make
-* tar
== License ==
This project is free software:
--
2.46.0
- [PATCH v1 00/12] First patches for a proper manual., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 11/12] manual: Add sections about installing and building GNU Boot., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 04/12] website: use Guix v1.4.0., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 03/12] website: README: document how to build the website without Guix.,
Denis 'GNUtoo' Carikli <=
- [PATCH v1 08/12] manual: Add section about supported computer parts and peripherals., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 01/12] website: Makefile.am: wrap Guix commands instead of targets., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 12/12] manual: Add section about using GNU Boot., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 02/12] website: Makefile.am: use common guix shell command., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 07/12] manual: Add list of compatible computers., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 09/12] manual: Add section on supported operating systems., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 10/12] manual: add section about the images we released., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 05/12] Add minimalist GNU Boot manual., Denis 'GNUtoo' Carikli, 2024/11/03
- [PATCH v1 06/12] manual: Describe the GNU Boot project., Denis 'GNUtoo' Carikli, 2024/11/03