gnuboot-patches
[Top][All Lists]
Advanced

[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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]