* [PATCH] website: Enhance instructions on how to test the website locally.
@ 2016-11-20 1:45 sirgazil
2016-11-21 14:04 ` Ludovic Courtès
0 siblings, 1 reply; 3+ messages in thread
From: sirgazil @ 2016-11-20 1:45 UTC (permalink / raw)
To: guix-devel
* website/README: Indicate usage of GUIX_WEB_SITE_LOCAL.
---
website/README | 44 ++++++++++++++++++++++++++++++--------------
1 file changed, 30 insertions(+), 14 deletions(-)
diff --git a/website/README b/website/README
index 5438a5d..f8dee4a 100644
--- a/website/README
+++ b/website/README
@@ -2,26 +2,42 @@
#+TITLE: GuixSD website
-The files in this directory are intended to be used as assets for the [[https://www.gnu.org/software/guix][GuixSD
-website]] which is implemented in [[https://www.gnu.org/software/guile][Guile]] Scheme.
+This directory contains the source files for the GuixSD website,
+available at https://www.gnu.org/software/guix/.
- - =www.scm= and =www= provides ‘(www)’ guile module which offers services for
- building the website locally.
+ - =www.scm= and =www= provide the =(www)= guile module which
+ offers services for building the website locally.
- =static= contains images and css for the website.
- - =mockup.svg= illustrates a homepage aimed at average users. This is for use
- when GuixSD is getting closer to a production-ready system.
- - =mockup-techie.svg= illustrates a homepage aimed at skilled devs and
- sysadmins. This is for use during the alpha phase of development.
+ - =mockup.svg= illustrates a homepage aimed at average users.
+ This is for use when GuixSD is getting closer to a
+ production-ready system.
+ - =mockup-techie.svg= illustrates a homepage aimed at
+ skilled devs and sysadmins. This is for use during the
+ alpha phase of development.
-* Building
+* Dependencies
-Building the website depends on the static site generator:
+To be able to work on the website, you need the following software:
- - [[http://haunt.dthompson.us/][Haunt]]
+ - [[https://www.gnu.org/software/guile/][GNU Guile]] (programming language)
+ - [[http://haunt.dthompson.us/][Haunt]] (static site generator)
-To build the site, run ‘haunt build’ to compile all of the HTML pages.
-To view the results, run ‘haunt serve’ and visit <http://localhost:8080>
-in a web browser.
+* Building and running
+
+To try out the website locally while you work on it, run the following
+commands:
+
+#+BEGIN_EXAMPLE
+$ cd path/to/guix-artwork/website
+$ GUIX_WEB_SITE_LOCAL=yes haunt build
+$ haunt serve
+#+END_EXAMPLE
+
+Then, visit http://localhost:8080/ in a web browser.
+
+* Deploying
+
+Pending...
* Copying
--
2.1.4
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] website: Enhance instructions on how to test the website locally.
2016-11-20 1:45 [PATCH] website: Enhance instructions on how to test the website locally sirgazil
@ 2016-11-21 14:04 ` Ludovic Courtès
2016-11-21 16:14 ` Luis Felipe López Acevedo
0 siblings, 1 reply; 3+ messages in thread
From: Ludovic Courtès @ 2016-11-21 14:04 UTC (permalink / raw)
To: sirgazil; +Cc: guix-devel
sirgazil <felipe.lopez@openmailbox.org> skribis:
> * website/README: Indicate usage of GUIX_WEB_SITE_LOCAL.
LGTM, please push!
Ludo’.
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH] website: Enhance instructions on how to test the website locally.
2016-11-21 14:04 ` Ludovic Courtès
@ 2016-11-21 16:14 ` Luis Felipe López Acevedo
0 siblings, 0 replies; 3+ messages in thread
From: Luis Felipe López Acevedo @ 2016-11-21 16:14 UTC (permalink / raw)
To: ludo; +Cc: guix-devel
On 2016-11-21 09:04, ludo@gnu.org wrote:
> sirgazil <felipe.lopez@openmailbox.org> skribis:
>
>> * website/README: Indicate usage of GUIX_WEB_SITE_LOCAL.
>
> LGTM, please push!
>
> Ludo’.
Done.
--
Luis Felipe López Acevedo
http://sirgazil.bitbucket.org/
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2016-11-21 16:14 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-11-20 1:45 [PATCH] website: Enhance instructions on how to test the website locally sirgazil
2016-11-21 14:04 ` Ludovic Courtès
2016-11-21 16:14 ` Luis Felipe López Acevedo
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/guix.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).